[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] externals/exwm 4ac0d6c 1/2: Clarify the usage of `exwm-manage-con
From: |
Chris Feng |
Subject: |
[elpa] externals/exwm 4ac0d6c 1/2: Clarify the usage of `exwm-manage-configurations' |
Date: |
Sun, 14 Apr 2019 02:06:00 -0400 (EDT) |
branch: externals/exwm
commit 4ac0d6c1fd00ffd9229ef2d5fd1c63ee6151ed2d
Author: Chris Feng <address@hidden>
Commit: Chris Feng <address@hidden>
Clarify the usage of `exwm-manage-configurations'
---
exwm-manage.el | 24 +++++++++++++++++++++++-
1 file changed, 23 insertions(+), 1 deletion(-)
diff --git a/exwm-manage.el b/exwm-manage.el
index 8f8f6e4..6f89fff 100644
--- a/exwm-manage.el
+++ b/exwm-manage.el
@@ -48,7 +48,29 @@ You can still make the X windows floating afterwards."
:type 'integer)
(defcustom exwm-manage-configurations nil
- "Per-application configurations."
+ "Per-application configurations.
+
+Configuration options allow to override various default behaviors of EXWM
+and only take effect when they are present. Note for certain options
+specifying nil is not exactly the same as leaving them out. Currently
+possible choices:
+* floating: Force floating (non-nil) or tiling (nil) on startup.
+* x/y/width/height: Override the initial geometry (floating X window only).
+* border-width: Override the border width (only visible when floating).
+* fullscreen: Force full screen (non-nil) on startup.
+* floating-mode-line: `mode-line-format' used when floating.
+* tiling-mode-line: `mode-line-format' used when tiling.
+* floating-header-line: `header-line-format' used when floating.
+* tiling-header-line: `header-line-format' used when tiling.
+* char-mode: Force char-mode (non-nil) on startup.
+* prefix-keys: `exwm-input-prefix-keys' local to this X window.
+* simulation-keys: `exwm-input-simulation-keys' local to this X window.
+* workspace: The initial workspace.
+* managed: Force to manage (non-nil) or not manage (nil) the X window.
+
+For each X window managed for the first time, matching criteria (sexps) are
+evaluated sequentially and the first configuration with a non-nil matching
+criterion would be applied."
:type '(alist :key-type (sexp :tag "Matching criterion" nil)
:value-type
(plist :tag "Configurations"