From: Werner LEMBERG Date: Fri, 16 Nov 2007 08:06:45 +0000 (+0000) Subject: * custom.texi (Specifying File Variables), major.texi (Choosing X-Git-Tag: emacs-pretest-23.0.90~9694 X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=1ab397c1cdd6a1baf97e4af66ea5bc03ca55a790;p=emacs.git * custom.texi (Specifying File Variables), major.texi (Choosing Modes): Mention '\" in man pages. --- diff --git a/doc/emacs/ChangeLog b/doc/emacs/ChangeLog index e71ee05f2e5..edb155216d3 100644 --- a/doc/emacs/ChangeLog +++ b/doc/emacs/ChangeLog @@ -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 --git a/doc/emacs/custom.texi b/doc/emacs/custom.texi index 29d1c902b7c..4bd1ba66df7 100644 --- a/doc/emacs/custom.texi +++ b/doc/emacs/custom.texi @@ -1099,10 +1099,14 @@ particular Lisp file. @xref{Enabling Multibyte}. 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 --git a/doc/emacs/major.texi b/doc/emacs/major.texi index 1cb76ee5fdf..3980c5de003 100644 --- a/doc/emacs/major.texi +++ b/doc/emacs/major.texi @@ -174,7 +174,10 @@ interpreter program names and major modes. 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