# HG changeset patch # User Werner LEMBERG # Date 1195200405 0 # Node ID e89df09acf64bd15b586f400ef4da5d435bfe66c # Parent fb22331f18da72a19dbb7d977a0413239fa451ee * custom.texi (Specifying File Variables), major.texi (Choosing Modes): Mention '\" in man pages. diff -r fb22331f18da -r e89df09acf64 doc/emacs/ChangeLog --- a/doc/emacs/ChangeLog Fri Nov 16 08:03:45 2007 +0000 +++ b/doc/emacs/ChangeLog Fri Nov 16 08:06:45 2007 +0000 @@ -1,3 +1,8 @@ +2007-11-16 Werner Lemberg + + * custom.texi (Specifying File Variables), major.texi (Choosing + Modes): Mention '\" in man pages. + 2007-11-16 Kenichi Handa * mule.texi (Communication Coding): Mention x-select-request-type. diff -r fb22331f18da -r e89df09acf64 doc/emacs/custom.texi --- a/doc/emacs/custom.texi Fri Nov 16 08:03:45 2007 +0000 +++ b/doc/emacs/custom.texi Fri Nov 16 08:06:45 2007 +0000 @@ -1099,10 +1099,14 @@ the first line as well. @cindex shell scripts, and local file variables +@cindex man pages, and local file variables In shell scripts, the first line is used to identify the script interpreter, so you cannot put any local variables there. To accommodate this, Emacs looks for local variable specifications in the @emph{second} line when the first line specifies an interpreter. +The same is true for man pages which start with the magic string +@samp{'\"} to specify a list of troff preprocessors (not all do, +however). A @dfn{local variables list} goes near the end of the file, in the last page. (It is often best to put it on a page by itself.) The local diff -r fb22331f18da -r e89df09acf64 doc/emacs/major.texi --- a/doc/emacs/major.texi Fri Nov 16 08:03:45 2007 +0000 +++ b/doc/emacs/major.texi Fri Nov 16 08:06:45 2007 +0000 @@ -174,7 +174,10 @@ systems) use the @samp{-*-} feature on the first line, because the system would get confused when running the interpreter. So Emacs looks for @samp{-*-} on the second line in such files as well as on the -first line. +first line. The same is true for man pages which start with the magic +string @samp{'\"} to specify a list of troff preprocessors (not all do, +however). + @vindex default-major-mode When you visit a file that does not specify a major mode to use, or