[COMMIT] Documentation tweaks

NOTE: This patch has been committed. man/ChangeLog addition: 2006-07-16 Aidan Kehoe <kehoea(a)parhasard.net&gt; * xemacs/custom.texi (File Variables): Make it clearer that file variables are buffer-local. * xemacs/custom.texi (Faces): "must be encoding" -> "must be encoded". 2006-07-16 Aidan Kehoe <kehoea(a)parhasard.net&gt; * lispref/variables.texi (Creating Buffer-Local): Mention that buffer-local variables are created when file local variables are set. XEmacs Trunk source patch: Diff command: cvs -q diff -u Files affected: man/xemacs/custom.texi man/lispref/variables.texi Index: man/lispref/variables.texi =================================================================== RCS file: /pack/xemacscvs/XEmacs/xemacs/man/lispref/variables.texi,v retrieving revision 1.7 diff -u -u -r1.7 variables.texi --- man/lispref/variables.texi 2005/01/21 09:43:12 1.7 +++ man/lispref/variables.texi 2006/07/16 10:43:55 ＠＠ -1045,6 +1045,12 ＠＠ ＠node Creating Buffer-Local ＠subsection Creating and Deleting Buffer-Local Bindings + Besides the functions mentioned here, buffer-local variables are also +created when file-local variables are set. ＠xref{Auto Major Mode} +. There is no way (outside of `eval' lines, which are normally disabled) +to set the global value of a variable from the file local variable +specifications. + ＠deffn Command make-local-variable variable This function creates a buffer-local binding in the current buffer for ＠var{variable} (a symbol). Other buffers are not affected. The value Index: man/xemacs/custom.texi =================================================================== RCS file: /pack/xemacscvs/XEmacs/xemacs/man/xemacs/custom.texi,v retrieving revision 1.22 diff -u -u -r1.22 custom.texi --- man/xemacs/custom.texi 2006/05/09 05:00:30 1.22 +++ man/xemacs/custom.texi 2006/07/16 10:43:56 ＠＠ -774,10 +774,10 ＠＠ ＠cindex local variables in files A file can contain a ＠dfn{local variables list}, which specifies the -values to use for certain Emacs variables when that file is edited. -Visiting the file checks for a local variables list and makes each variable -in the list local to the buffer in which the file is visited, with the -value specified in the file. +buffer-local values to use for certain Emacs variables when that file is +edited. Visiting the file checks for a local variables list and makes +each variable in the list local to the buffer in which the file is +visited, with the value specified in the file. A 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 variables list ＠＠ -2184,7 +2184,7 ＠＠ specified, too. Here's our example font in XLFD syntax: ＠code{"-*-courier-bold-r-*-*-*-140-*-*-*-*-iso8859-*"}. The XLFD syntax is also used for GTK+ version 1. XLFD names must be -encoding in ISO-8859-1. +encoded in ISO-8859-1. ＠item Xft The Xft syntax is defined by the ＠file{fontconfig} library -- Santa Maradona, priez pour moi!