X-Git-Url: https://code.delx.au/gnu-emacs/blobdiff_plain/444246ca3894cda71f5ce221bd6d7f2b0ae22b02..dc6cc05f5c36bfc65379f3fa25267669402635ca:/man/custom.texi diff --git a/man/custom.texi b/man/custom.texi index f0f8fcee39..682cb5b931 100644 --- a/man/custom.texi +++ b/man/custom.texi @@ -1112,16 +1112,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. @@ -1129,8 +1129,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. @@ -2063,9 +2063,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