diff options
author | Chong Yidong <cyd@gnu.org> | 2012-09-18 13:14:42 +0800 |
---|---|---|
committer | Chong Yidong <cyd@gnu.org> | 2012-09-18 13:14:42 +0800 |
commit | ed1f0bd388e83e5ee065f7dde0f52bbfe9031933 (patch) | |
tree | 7b0251ea23f7191194f5f0739ae43975e56c3db6 /lisp/cus-edit.el | |
parent | a11035b8cd0ef80bc118cc97be53373b36475da0 (diff) | |
download | emacs-ed1f0bd388e83e5ee065f7dde0f52bbfe9031933.tar.gz |
Doc fixes for defface and friends.
* lisp/cus-edit.el (custom-unlispify-remove-prefixes): Add warning.
* lisp/custom.el (defface): Doc fix.
* doc/lispref/customize.texi (Customization): Define customization more
carefully.
(Common Keywords): Add xref to Constant Variables.
* doc/lispref/display.texi (Faces): Discuss anonymous faces.
(Face Attributes): Tweak intro.
(Defining Faces): Move after the Face Attributes node. Copyedits.
(Displaying Faces): Describe role of inheritance.
* doc/lispref/variables.texi (Defining Variables): Link to defcustom's node
instead of the higher-level Customization chapter.
Fixes: debbugs:11440
Diffstat (limited to 'lisp/cus-edit.el')
-rw-r--r-- | lisp/cus-edit.el | 5 |
1 files changed, 4 insertions, 1 deletions
diff --git a/lisp/cus-edit.el b/lisp/cus-edit.el index 86a19131569..2e6f2b14625 100644 --- a/lisp/cus-edit.el +++ b/lisp/cus-edit.el @@ -526,7 +526,10 @@ WIDGET is the widget to apply the filter entries of MENU on." :type 'boolean) (defcustom custom-unlispify-remove-prefixes nil - "Non-nil means remove group prefixes from option names in buffer." + "Non-nil means remove group prefixes from option names in buffer. +Discarding prefixes often leads to confusing names for options +and faces in Customize buffers, so do not set this to a non-nil +value unless you are sure you know what it does." :group 'custom-menu :group 'custom-buffer :type 'boolean) |