[Emacs-diffs] Changes to emacs/lispref/customize.texi

[Luc Teirlinck]

Index: emacs/lispref/customize.texi
diff -u emacs/lispref/customize.texi:1.50 emacs/lispref/customize.texi:1.51
--- emacs/lispref/customize.texi:1.50   Sun Dec 11 04:42:52 2005
+++ emacs/lispref/customize.texi        Tue Dec 20 03:19:50 2005
@@ -76,7 +76,7 @@
 Link to a web page; @var{url} is a string which specifies the
 @acronym{URL}.  The link appears in the customization buffer as
 @var{url} and invokes the WWW browser specified by
address@hidden
address@hidden
 
 @item (emacs-commentary-link @var{library})
 Link to the commentary section of a library; @var{library} is a string
@@ -155,8 +155,7 @@
 @defmac defgroup group members doc [keyword address@hidden
 Declare @var{group} as a customization group containing @var{members}.
 Do not quote the symbol @var{group}.  The argument @var{doc} specifies
-the documentation string for the group.  It should not start with a
address@hidden as in @code{defcustom}; that convention is for variables only.
+the documentation string for the group.
 
 The argument @var{members} is a list specifying an initial set of
 customization items to be members of the group.  However, most often
@@ -211,12 +210,9 @@
 @defmac defcustom option default doc [keyword address@hidden
 Declare @var{option} as a customizable user option variable.  Do not
 quote @var{option}.  The argument @var{doc} specifies the documentation
-string for the variable.  It should often start with a @samp{*} to mark
-it as a @dfn{user option} (@pxref{Defining Variables}).  Do not start
-the documentation string with @samp{*} for options which cannot or
-normally should not be set with @code{set-variable}; examples of the
-former are global minor mode options such as
address@hidden and examples of the latter are hooks.
+string for the variable.  There is no need to start it with a @samp{*}
+because @code{defcustom} automatically marks @var{option} as a
address@hidden option} (@pxref{Defining Variables}).
 
 If @var{option} is void, @code{defcustom} initializes it to
 @var{default}.  @var{default} should be an expression to compute the