X-Git-Url: https://code.delx.au/gnu-emacs/blobdiff_plain/bd9f6fe3c4defdddbc220eb7f1a9bea971c58ae4..90e4b32d3a45b460f8155389ceb857c9473a0793:/man/custom.texi diff --git a/man/custom.texi b/man/custom.texi index f133e890b0..d20558dd06 100644 --- a/man/custom.texi +++ b/man/custom.texi @@ -231,7 +231,11 @@ the way up to a master group called @code{Emacs}. top-level @code{Emacs} group and the second-level groups immediately under it. It looks like this, in part: +@c we want the buffer example to all be on one page, but unfortunately +@c that's quite a bit of text, so force all space to the bottom. +@page @smallexample +@group /- Emacs group: ---------------------------------------------------\ [State]: visible group members are all at standard values. Customization of the One True Editor. @@ -246,7 +250,7 @@ Interfacing to external utilities. @var{more second-level groups} \- Emacs group end ------------------------------------------------/ - +@end group @end smallexample @noindent @@ -664,12 +668,12 @@ appear as well (even if not already loaded). However, the subgroups' own contents are not included. @findex customize-apropos - To control more precisely what to customize, you can use @kbd{M-x -customize-apropos}. You specify a regular expression as argument; -then all @emph{loaded} settings and groups whose names match this -regular expression are set up in the customization buffer. If you -specify an empty regular expression, this includes @emph{all} loaded -groups and settings---which takes a long time to set up. + For a more general way of controlling what to customize, you can use +@kbd{M-x customize-apropos}. You specify a regular expression as +argument; then all @emph{loaded} settings and groups whose names match +this regular expression are set up in the customization buffer. If +you specify an empty regular expression, this includes @emph{all} +loaded groups and settings---which takes a long time to set up. @findex customize-changed When you upgrade to a new Emacs version, you might want to consider @@ -822,6 +826,9 @@ fill-column's value is 70 Local in buffer custom.texi; global value is 70 Automatically becomes buffer-local when set in any fashion. +This variable is safe to use as a file local variable only if its value +satisfies the predicate `integerp'. + Documentation: *Column beyond which automatic line-wrapping should happen. Interactively, you can set the buffer local value using C-x f. @@ -1109,16 +1116,16 @@ variables list afterward. Here is an example of a local variables list: @example -;;; Local Variables: *** -;;; mode:lisp *** -;;; comment-column:0 *** -;;; comment-start: ";;; " *** -;;; comment-end:"***" *** -;;; End: *** +;; Local Variables: ** +;; mode:lisp ** +;; comment-column:0 ** +;; comment-start: ";; " ** +;; comment-end:"**" ** +;; End: ** @end example - Each line starts with the prefix @samp{;;; } and each line ends with -the suffix @samp{ ***}. Emacs recognizes these as the prefix and + Each line starts with the prefix @samp{;; } and each line ends with +the suffix @samp{ **}. Emacs recognizes these as the prefix and suffix based on the first line of the list, by finding them surrounding the magic string @samp{Local Variables:}; then it automatically discards them from the other lines of the list. @@ -1126,8 +1133,8 @@ automatically discards them from the other lines of the list. The usual reason for using a prefix and/or suffix is to embed the local variables list in a comment, so it won't confuse other programs that the file is intended as input for. The example above is for a -language where comment lines start with @samp{;;; } and end with -@samp{***}; the local values for @code{comment-start} and +language where comment lines start with @samp{;; } and end with +@samp{**}; the local values for @code{comment-start} and @code{comment-end} customize the rest of Emacs for this unusual syntax. Don't use a prefix (or a suffix) if you don't need one. @@ -1201,7 +1208,7 @@ variables list, and asks you for confirmation before setting them. You can type @kbd{y} or @key{SPC} to put the local variables list into effect, or @kbd{n} to ignore it. When Emacs is run in batch mode (@pxref{Initial Options}), it can't really ask you, so it assumes the -answer @samp{n}. +answer @kbd{n}. Emacs normally recognizes certain variables/value pairs as safe. For instance, it is safe to give @code{comment-column} or @@ -1479,7 +1486,7 @@ just like @key{RET}. This is used mainly for Mocklisp compatibility. @code{minibuffer-local-must-match-map} is for strict completion and for cautious completion. @item -@code{minibuffer-local-filename-completion-map} and +Finally, @code{minibuffer-local-filename-completion-map} and @code{minibuffer-local-must-match-filename-map} are like the two previous ones, but they are specifically for file name completion. They do not bind @key{SPC}. @@ -1974,11 +1981,12 @@ usual to do so. @subsection Disabling Commands @cindex disabled command - Disabling a command menas it requires confirmation before it can be -executed. The purpose of disabling a command is to prevent users from -executing it by accident and being confused. + Disabling a command means that invoking it interactively asks for +confirmation from the user. The purpose of disabling a command is to +prevent users from executing it by accident; we do this for commands +that might be confusing to the uninitiated. - An attempt to invoke a disabled command interactively in Emacs + Attempting to invoke a disabled command interactively in Emacs displays a window containing the command's name, its documentation, and some instructions on what to do immediately; then Emacs asks for input saying whether to execute the command as requested, enable it @@ -2018,8 +2026,8 @@ because Emacs has not read your init file. Whether a command is disabled is independent of what key is used to invoke it; disabling also applies if the command is invoked using -@kbd{M-x}. Disabling a command has no effect on calling it as a -function from Lisp programs. +@kbd{M-x}. However, disabling a command has no effect on calling it +as a function from Lisp programs. @node Syntax @section The Syntax Table @@ -2059,9 +2067,8 @@ Reference Manual}. @cindex rebinding keys, permanently @cindex startup (init file) - When Emacs is started, it normally loads a Lisp program from the -file @file{.emacs} or @file{.emacs.el} in your home directory -(see @ref{General Variables, HOME}, if you don't know where that is). + When Emacs is started, it normally loads a Lisp program from the file +@file{.emacs} or @file{.emacs.el} in your home directory (@pxref{Find Init}). We call this file your @dfn{init file} because it specifies how to initialize Emacs for you. You can use the command line switch @samp{-q} to prevent loading your init file, and @samp{-u} (or @@ -2107,10 +2114,10 @@ for more information about compiling Emacs Lisp programs. If you are going to write actual Emacs Lisp programs that go beyond minor customization, you should read the @cite{Emacs Lisp Reference Manual}. -@ifinfo +@ifnottex @xref{Top, Emacs Lisp, Emacs Lisp, elisp, the Emacs Lisp Reference Manual}. -@end ifinfo +@end ifnottex @menu * Init Syntax:: Syntax of constants in Emacs Lisp.