branch: externals/spacious-padding
commit ac518dbe3bb6b533fab19437033a7264fb7eb355
Author: Protesilaos Stavrou <i...@protesilaos.com>
Commit: Protesilaos Stavrou <i...@protesilaos.com>

    Expand doc string of spacious-padding-widths
---
 spacious-padding.el | 19 ++++++++++++++++++-
 1 file changed, 18 insertions(+), 1 deletion(-)

diff --git a/spacious-padding.el b/spacious-padding.el
index a965243397..5679da38f6 100644
--- a/spacious-padding.el
+++ b/spacious-padding.el
@@ -59,7 +59,24 @@
      :tab-width 4
      :right-divider-width 30
      :scroll-bar-width 8)
-  "Number of pixels for frame and window divider border width."
+  "Set the pixel width of individual User Interface elements.
+This is a plist of the form (:key1 value1 :key2 value2).  The
+value is always a natural number.  Keys are keywords among the
+following:
+
+- `:internal-border-width' refers to the space between the
+  boundaries of the Emacs frame and where the text contents
+  start.
+
+- `:right-divider-width' is the space between two side-by-side
+  windows.
+
+- `:tab-width' concerns the padding around tab buttons.  For the
+  time being, `tab-bar-mode' is the only one affected.
+
+- `:header-line-width', `mode-line-width', `scroll-bar-width'
+  point to the header-line, mode-line, and scroll-bar,
+  respectively."
   :type '(plist
           :key-type (choice (const :internal-border-width)
                             (const :right-divider-width)

Reply via email to