changeset 27218:ff77115434db

Doc recent changes in Custom. Warn about keybinding 8-bit chars.

--- a/man/custom.texi	Wed Jan 05 23:28:19 2000 +0000
+++ b/man/custom.texi	Wed Jan 05 23:31:27 2000 +0000
@@ -1,5 +1,5 @@
 @c This is part of the Emacs manual.
-@c Copyright (C) 1985, 86, 87, 93, 94, 95, 1997 Free Software Foundation, Inc.
+@c Copyright (C) 1985, 86, 87, 93-95, 97, 2000 Free Software Foundation, Inc.
 @c See file emacs.texi for copying conditions.
 @node Customization, Quitting, Amusements, Top
 @chapter Customization
@@ -96,7 +96,7 @@
   ISO Accents mode makes the characters @samp{`}, @samp{'}, @samp{"},
 @samp{^}, @samp{/} and @samp{~} combine with the following letter, to
 produce an accented letter in the ISO Latin-1 character set.
-@xref{Single-Byte European Support}.
+@xref{Single-Byte Character Support}.
 
   Outline minor mode provides the same facilities as the major mode
 called Outline mode; but since it is a minor mode instead, you can
@@ -492,7 +492,7 @@
 operation.
 
   You can also restore the option to its standard value by invoking
-@samp{[State]} and selecting the @samp{Reset to Standard Settings}
+@samp{[State]} and selecting the @samp{Erase Customization}
 operation.  There are actually three reset operations:
 
 @table @samp
@@ -505,12 +505,18 @@
 This restores the value of the option to the last saved value,
 and updates the text accordingly.
 
-@item Reset to Standard Settings
+@item Erase Customization
 This sets the option to its standard value, and updates the text
 accordingly.  This also eliminates any saved value for the option,
 so that you will get the standard value in future Emacs sessions.
 @end table
 
+@cindex comments on customized options
+Sometimes it is useful to record a comment on the value of an option
+which you have customized.  Use the @samp{Add Comment} item from the
+@samp{[State]} menu to provide a field in which to edit a comment which
+will be saved and redisplayed if you re-customize the option later.
+
   The state of a group indicates whether anything in that group has been
 edited, set or saved.  You can select @samp{Set for Current Session},
 @samp{Save for Future Sessions} and the various kinds of @samp{Reset}
@@ -522,13 +528,17 @@
 
 @smallexample
  [Set for Current Session] [Save for Future Sessions]
- [Reset] [Reset to Saved] [Reset to Standard]   [Bury Buffer]
+ [Reset] [Reset to Saved] [Erase Customization]   [Finish]
 @end smallexample
 
+@vindex Custom-buffer-done
 @noindent
-Invoking @samp{[Bury Buffer]} buries this customization buffer.  Each of
-the other fields performs an operation---set, save or reset---on each of
-the items in the buffer that could meaningfully be set, saved or reset.
+Invoking @samp{[Finish]} either buries or kills this customization
+buffer according to the setting of the option @code{Custom-buffer-done};
+the default is to bury the buffer.
+Each of the other fields performs an operation---set, save or reset---on
+each of the items in the buffer that could meaningfully be set, saved or
+reset.
 
 @node Face Customization
 @subsubsection Customizing Faces
@@ -1695,7 +1705,10 @@
 accented letters, rebinding these keys is a bit tricky.  There are
 two solutions you can use.  One is to specify a keyboard coding system,
 using @code{set-keyboard-coding-system} (@pxref{Specify Coding}).
-Then you can bind these keys in the usual way, but writing
+Then you can bind these keys in the usual way,@footnote{Note that you
+should avoid the string syntax for binding 8-bit characters, since
+they will be interpreted as meta keys.  @xref{(elisp)Strings of
+Events}.} by writing
 
 @example
 (global-set-key [?@var{char}] 'some-function)
@@ -1721,6 +1734,9 @@
 (global-set-key [@var{decimal-code}] 'some-function)
 @end example
 
+If you bind 8-bit characters like this in your init file, you my find it
+convenient to specify that it is unibyte.  @xref{Enabling Multibyte}.
+
 @node Mouse Buttons
 @subsection Rebinding Mouse Buttons
 @cindex mouse button events