From: Richard M. Stallman <rms@gnu.org>
Date: Sun, 11 Dec 2005 04:42:52 +0000 (+0000)
Subject: (Common Keywords): State caveats for use of :tag.
X-Git-Tag: emacs-pretest-22.0.90~5353
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=912ea554bc5232764710188ce4e286c8b473f648;p=emacs.git

(Common Keywords): State caveats for use of :tag.
---

diff --git a/lispref/customize.texi b/lispref/customize.texi
index 1bf54f4f210..1170a909118 100644
--- a/lispref/customize.texi
+++ b/lispref/customize.texi
@@ -34,8 +34,16 @@ display one name.
 
 @table @code
 @item :tag @var{label}
-Use @var{label}, a string, instead of the item's name, to label the item
-in customization menus and buffers.
+Use @var{label}, a string, instead of the item's name, to label the
+item in customization menus and buffers.  @strong{Don't use a tag
+which is substantially different from the item's real name; that would
+cause confusion.}  One legitimate case for use of @code{:tag} is to
+specify a dash where normally a hyphen would be converted to a space:
+
+@example
+(defcustom cursor-in-non-selected-windows @dots{}
+  :tag "Cursor In Non-selected Windows"
+@end example
 
 @item :group @var{group}
 Put this customization item in group @var{group}.  When you use