mirror/emacs
1
0
Fork 0
mirror of https://git.savannah.gnu.org/git/emacs.git synced 2025-02-05 20:43:08 +00:00
Code Issues Releases Activity

Doc recent changes in Custom.

Browse Source 
Warn about keybinding 8-bit chars.
This commit is contained in:
Dave Love 2000-01-05 23:31:27 +00:00
parent 1de69f0c3d
commit 0a7790e0fd
1 changed files with 25 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

34
man/custom.texi
View File

@ -1,5 +1,5 @@
@c This is part of the Emacs manual. @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. @c See file emacs.texi for copying conditions.
@node Customization, Quitting, Amusements, Top @node Customization, Quitting, Amusements, Top
@chapter Customization @chapter Customization
@ -96,7 +96,7 @@ to keep point on the screen. @xref{Horizontal Scrolling}.
ISO Accents mode makes the characters @samp{`}, @samp{'}, @samp{"}, ISO Accents mode makes the characters @samp{`}, @samp{'}, @samp{"},
@samp{^}, @samp{/} and @samp{~} combine with the following letter, to @samp{^}, @samp{/} and @samp{~} combine with the following letter, to
produce an accented letter in the ISO Latin-1 character set. 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 Outline minor mode provides the same facilities as the major mode
called Outline mode; but since it is a minor mode instead, you can called Outline mode; but since it is a minor mode instead, you can
@ -492,7 +492,7 @@ invoke @samp{[State]} and select the @samp{Save for Future Sessions}
operation. operation.
You can also restore the option to its standard value by invoking 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: operation. There are actually three reset operations:
@table @samp @table @samp
@ -505,12 +505,18 @@ the actual value.
This restores the value of the option to the last saved value, This restores the value of the option to the last saved value,
and updates the text accordingly. 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 This sets the option to its standard value, and updates the text
accordingly. This also eliminates any saved value for the option, accordingly. This also eliminates any saved value for the option,
so that you will get the standard value in future Emacs sessions. so that you will get the standard value in future Emacs sessions.
@end table @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 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}, edited, set or saved. You can select @samp{Set for Current Session},
@samp{Save for Future Sessions} and the various kinds of @samp{Reset} @samp{Save for Future Sessions} and the various kinds of @samp{Reset}
@ -522,13 +528,17 @@ containing several active fields:
@smallexample @smallexample
[Set for Current Session] [Save for Future Sessions] [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 @end smallexample
@vindex Custom-buffer-done
@noindent @noindent
Invoking @samp{[Bury Buffer]} buries this customization buffer. Each of Invoking @samp{[Finish]} either buries or kills this customization
the other fields performs an operation---set, save or reset---on each of buffer according to the setting of the option @code{Custom-buffer-done};
the items in the buffer that could meaningfully be set, saved or reset. 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 @node Face Customization
@subsubsection Customizing Faces @subsubsection Customizing Faces
@ -1695,7 +1705,10 @@ If your keyboard has keys that send non-ASCII characters, such as
accented letters, rebinding these keys is a bit tricky. There are accented letters, rebinding these keys is a bit tricky. There are
two solutions you can use. One is to specify a keyboard coding system, two solutions you can use. One is to specify a keyboard coding system,
using @code{set-keyboard-coding-system} (@pxref{Specify Coding}). 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 @example
(global-set-key [?@var{char}] 'some-function) (global-set-key [?@var{char}] 'some-function)
@ -1721,6 +1734,9 @@ inside the vector to bind:
(global-set-key [@var{decimal-code}] 'some-function) (global-set-key [@var{decimal-code}] 'some-function)
@end example @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 @node Mouse Buttons
@subsection Rebinding Mouse Buttons @subsection Rebinding Mouse Buttons
@cindex mouse button events @cindex mouse button events