[Emacs-diffs] /srv/bzr/emacs/emacs-23 r99738: Document new commands for manipulating local variable lists.

[Glenn Morris]

------------------------------------------------------------
revno: 99738
committer: Glenn Morris <address@hidden>
branch nick: emacs-23
timestamp: Wed 2010-04-14 19:05:36 -0700
message:
  Document new commands for manipulating local variable lists.
  
  * custom.texi (Specifying File Variables, Directory Variables):
  Document new commands for manipulating local variable lists.
modified:
  doc/emacs/ChangeLog
  doc/emacs/custom.texi
  etc/NEWS

=== modified file 'doc/emacs/ChangeLog'
--- a/doc/emacs/ChangeLog       2010-04-09 01:20:45 +0000
+++ b/doc/emacs/ChangeLog       2010-04-15 02:05:36 +0000
@@ -1,3 +1,8 @@
+2010-04-15  Glenn Morris  <address@hidden>
+
+       * custom.texi (Specifying File Variables, Directory Variables):
+       Document new commands for manipulating local variable lists.
+
 2010-04-09  Glenn Morris  <address@hidden>
 
        * trouble.texi (Contributing): Add cindex entry.

=== modified file 'doc/emacs/custom.texi'
--- a/doc/emacs/custom.texi     2010-03-28 03:41:34 +0000
+++ b/doc/emacs/custom.texi     2010-04-15 02:05:36 +0000
@@ -1,6 +1,7 @@
 @c This is part of the Emacs manual.
 @c Copyright (C) 1985, 1986, 1987, 1993, 1994, 1995, 1997, 2000, 2001,
address@hidden   2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010 Free 
Software Foundation, Inc.
address@hidden   2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010
address@hidden   Free Software Foundation, Inc.
 @c See file emacs.texi for copying conditions.
 @node Customization, Quitting, Amusements, Top
 @chapter Customization
@@ -1086,11 +1087,22 @@
 pair with a colon and semicolon as shown above.  The special
 variable/value pair @code{mode: @var{modename};}, if present,
 specifies a major or minor mode; if you use this to specify a major
-mode, it should come first in the line.  The @var{value}s are are used
+mode, it should come first in the line.  The @var{value}s are used
 literally, and not evaluated.
 
-  Here is an example that specifies Lisp mode and sets two variables
-with numeric values:
address@hidden add-file-local-variable-prop-line
address@hidden delete-file-local-variable-prop-line
address@hidden copy-dir-locals-to-file-locals-prop-line
+  You can use the command @code{add-file-local-variable-prop-line}
+instead of adding entries by hand.  It prompts for a variable
+and value, and adds them to the first line in the appropriate way.
+The command @code{delete-file-local-variable-prop-line} deletes a
+variable from the line.  The command
address@hidden copies directory-local
+variables (@pxref{Directory Variables}) to the first line.
+
+  Here is an example first line that specifies Lisp mode and sets two
+variables with numeric values:
 
 @smallexample
 ;; -*- mode: Lisp; fill-column: 75; comment-column: 50; -*-
@@ -1144,6 +1156,17 @@
 example above is for the C programming language, where comment lines
 start with @samp{/*} and end with @samp{*/}.
 
address@hidden add-file-local-variable
address@hidden delete-file-local-variable
address@hidden copy-dir-locals-to-file-locals
+  You can construct the local variables list yourself, or use the
+command @code{add-file-local-variable}.  This prompts for a variable
+and value, and adds them to the list.  If necessary, it also adds the
+start and end markers.  The command @code{delete-file-local-variable}
+deletes a variable from the list.  The command
address@hidden copies directory-local variables
+(@pxref{Directory Variables}) to the list.
+
   As with the @samp{-*-} line, the variables in a local variables list
 are used literally, and are not evaluated first.  If you want to split
 a long string across multiple lines of the file, you can use
@@ -1323,6 +1346,16 @@
 subdirectory of the directory where you put the @file{.dir-locals.el}
 file.
 
address@hidden add-dir-local-variable
address@hidden delete-dir-local-variable
address@hidden copy-file-locals-to-dir-locals
+  You can edit the @file{.dir-locals.el} file by hand, or use the
+command @code{add-dir-local-variable}.  This prompts for a mode (or
+subdirectory), variable and value, and adds an entry to the file.
+The command @code{delete-dir-local-variable} deletes an entry.  The
+command @code{copy-file-locals-to-dir-locals} copies file local
+variables (@pxref{File Variables}) to the @file{.dir-locals.el} file.
+
 @findex dir-locals-set-class-variables
 @findex dir-locals-set-directory-class
   Another method of specifying directory-local variables is to explicitly

=== modified file 'etc/NEWS'
--- a/etc/NEWS  2010-04-03 00:42:10 +0000
+++ b/etc/NEWS  2010-04-15 02:05:36 +0000
@@ -95,12 +95,14 @@
 unconditionally.  The previous behavior, toggling the mode, was
 neither reliable nor generally desirable.
 
-*** New commands for adding and removing file-local variables:
++++
+*** There are new commands for adding and removing file-local variables:
 `add-file-local-variable', `delete-file-local-variable',
 `add-file-local-variable-prop-line', and
 `delete-file-local-variable-prop-line'.
 
-*** New commands for adding and removing directory-local variables,
++++
+*** There are new commands for adding and removing directory-local variables,
 and copying them to and from file-local variable lists:
 `add-dir-local-variable', `delete-dir-local-variable',
 `copy-dir-locals-to-file-locals',