[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
emacs-29 042f0d6a14c: ; Fix documentation of ':box' face attribute
From: |
Eli Zaretskii |
Subject: |
emacs-29 042f0d6a14c: ; Fix documentation of ':box' face attribute |
Date: |
Thu, 29 Jun 2023 03:47:35 -0400 (EDT) |
branch: emacs-29
commit 042f0d6a14cd99eb9d33cfccc6239534bc40e712
Author: Eli Zaretskii <eliz@gnu.org>
Commit: Eli Zaretskii <eliz@gnu.org>
; Fix documentation of ':box' face attribute
* lisp/faces.el (set-face-attribute): Update the documentation of
WIDTH in the :box face attribute. (Bug#64344)
---
lisp/faces.el | 32 +++++++++++++++++++-------------
1 file changed, 19 insertions(+), 13 deletions(-)
diff --git a/lisp/faces.el b/lisp/faces.el
index 8bf7e4429d9..696634b4ef7 100644
--- a/lisp/faces.el
+++ b/lisp/faces.el
@@ -794,19 +794,25 @@ around them. If VALUE is nil, explicitly don't draw
boxes. If
VALUE is t, draw a box with lines of width 1 in the foreground color
of the face. If VALUE is a string, the string must be a color name,
and the box is drawn in that color with a line width of 1. Otherwise,
-VALUE must be a property list of the form `(:line-width WIDTH
-:color COLOR :style STYLE)'. If a keyword/value pair is missing from
-the property list, a default value will be used for the value, as
-specified below. WIDTH specifies the width of the lines to draw; it
-defaults to 1. If WIDTH is negative, the absolute value is the width
-of the lines, and draw top/bottom lines inside the characters area,
-not around it. COLOR is the name of the color to draw in, default is
-the background color of the face for 3D boxes and `flat-button', and
-the foreground color of the face for other boxes. STYLE specifies
-whether a 3D box should be draw. If STYLE is `released-button', draw
-a box looking like a released 3D button. If STYLE is `pressed-button'
-draw a box that appears like a pressed button. If STYLE is nil,
-`flat-button' or omitted, draw a 2D box.
+VALUE must be a property list of the following form:
+
+ (:line-width WIDTH :color COLOR :style STYLE)
+
+If a keyword/value pair is missing from the property list, a default
+value will be used for the value, as specified below.
+
+WIDTH specifies the width of the lines to draw; it defaults to 1.
+If WIDTH is negative, the absolute value is the width of the lines,
+and draw top/bottom lines inside the characters area, not around it.
+WIDTH can also be a cons (VWIDTH . HWIDTH), which specifies different
+values for the vertical and the horizontal line width.
+COLOR is the name of the color to use for the box lines, default is
+the background color of the face for 3D and `flat-button' boxes, and
+the foreground color of the face for the other boxes.
+STYLE specifies whether a 3D box should be drawn. If STYLE
+is `released-button', draw a box looking like a released 3D button.
+If STYLE is `pressed-button', draw a box that looks like a pressed
+button. If STYLE is nil, `flat-button', or omitted, draw a 2D box.
`:inverse-video'
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- emacs-29 042f0d6a14c: ; Fix documentation of ':box' face attribute,
Eli Zaretskii <=