summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorA Frederick Christensen <dwl@ivories.org>2025-12-27 23:06:27 +0000
committerA Frederick Christensen <dwl@ivories.org>2025-12-27 23:08:32 +0000
commit9b11a49cb757b80f8589088b487b5f1e56643aa1 (patch)
tree73608a38c7cb2f5fe4bfc788a89c9dedfe2006ce
parent53e3e60d4de4ee3c8521ae0896bf1cf3d96c7222 (diff)
config.def.h clarify Rule and MonitorRule comments closes #660
-rw-r--r--config.def.h18
1 files changed, 7 insertions, 11 deletions
diff --git a/config.def.h b/config.def.h
index bcaa8a0..8a6eda0 100644
--- a/config.def.h
+++ b/config.def.h
@@ -20,12 +20,11 @@ static const float fullscreen_bg[] = {0.0f, 0.0f, 0.0f, 1.0f}; /* You ca
/* logging */
static int log_level = WLR_ERROR;
-/* NOTE: ALWAYS keep a rule declared even if you don't use rules (e.g leave at least one example) */
static const Rule rules[] = {
/* app_id title tags mask isfloating monitor */
- /* examples: */
{ "Gimp_EXAMPLE", NULL, 0, 1, -1 }, /* Start on currently visible tags floating, not tiled */
{ "firefox_EXAMPLE", NULL, 1 << 8, 0, -1 }, /* Start on ONLY tag "9" */
+ /* default/example rule: can be changed but cannot be eliminated; at least one rule must exist */
};
/* layout(s) */
@@ -38,17 +37,14 @@ static const Layout layouts[] = {
/* monitors */
/* (x=-1, y=-1) is reserved as an "autoconfigure" monitor position indicator
- * WARNING: negative values other than (-1, -1) cause problems with Xwayland clients
- * https://gitlab.freedesktop.org/xorg/xserver/-/issues/899
-*/
-/* NOTE: ALWAYS add a fallback rule, even if you are completely sure it won't be used */
+ * WARNING: negative values other than (-1, -1) cause problems with Xwayland clients due to
+ * https://gitlab.freedesktop.org/xorg/xserver/-/issues/899 */
static const MonitorRule monrules[] = {
- /* name mfact nmaster scale layout rotate/reflect x y */
- /* example of a HiDPI laptop monitor:
- { "eDP-1", 0.5f, 1, 2, &layouts[0], WL_OUTPUT_TRANSFORM_NORMAL, -1, -1 },
- */
- /* defaults */
+ /* name mfact nmaster scale layout rotate/reflect x y
+ * example of a HiDPI laptop monitor:
+ { "eDP-1", 0.5f, 1, 2, &layouts[0], WL_OUTPUT_TRANSFORM_NORMAL, -1, -1 }, */
{ NULL, 0.55f, 1, 1, &layouts[0], WL_OUTPUT_TRANSFORM_NORMAL, -1, -1 },
+ /* default monitor rule: can be changed but cannot be eliminated; at least one monitor rule must exist */
};
/* keyboard */