]> code.delx.au - gnu-emacs/blobdiff - man/custom.texi
(remove-overlays): Fix last change.
[gnu-emacs] / man / custom.texi
index f0f8fcee398e64ea3b7c045decad5a5e9f21a453..d20558dd06b997c1d81dde89eb5f19ec22c68dbe 100644 (file)
@@ -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
@@ -1112,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.
@@ -1129,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.
 
@@ -2063,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