[Emacs-diffs] /srv/bzr/emacs/emacs-23 r100507: Doc fix for bug#3577.

[Glenn Morris]

------------------------------------------------------------
revno: 100507
committer: Glenn Morris <address@hidden>
branch nick: emacs-23
timestamp: Thu 2011-02-24 23:59:40 -0800
message:
  Doc fix for bug#3577.
  
  * doc/lispref/variables.texi (Directory Local Variables):
  Mention the optional mtime argument of dir-locals-set-directory-class.
modified:
  doc/lispref/ChangeLog
  doc/lispref/variables.texi

=== modified file 'doc/lispref/ChangeLog'
--- a/doc/lispref/ChangeLog     2011-02-18 19:03:59 +0000
+++ b/doc/lispref/ChangeLog     2011-02-25 07:59:40 +0000
@@ -1,3 +1,8 @@
+2011-02-25  Glenn Morris  <address@hidden>
+
+       * variables.texi (Directory Local Variables): Mention the optional
+       mtime argument of dir-locals-set-directory-class.  (Bug#3577)
+
 2011-02-18  Eli Zaretskii  <address@hidden>
 
        * elisp.texi: Sync @dircategory with ../../info/dir.

=== modified file 'doc/lispref/variables.texi'
--- a/doc/lispref/variables.texi        2011-02-18 10:04:48 +0000
+++ b/doc/lispref/variables.texi        2011-02-25 07:59:40 +0000
@@ -1759,12 +1759,19 @@
 of the two forms accepted by this function in @var{variables}.
 @end defun
 
address@hidden dir-locals-set-directory-class directory class
address@hidden dir-locals-set-directory-class directory class &optional mtime
 This function assigns @var{class} to all the files in @code{directory}
 and its subdirectories.  Thereafter, all the variable settings
 specified for @var{class} will be applied to any visited file in
 @var{directory} and its children.  @var{class} must have been already
-defined by @code{dir-locals-set-class-variables}
+defined by @code{dir-locals-set-class-variables}.
+
+Emacs uses this function internally when it loads directory variables
+from a @code{.dir-locals.el} file.  In that case, the optional
+argument @var{mtime} holds the file modification time (as returned by
address@hidden).  Emacs uses this time to check stored
+local variables are still valid.  If you are assigning a class
+directly, not via a file, this argument should be @code{nil}.
 @end defun
 
 @defvar dir-locals-class-alist
@@ -1774,8 +1781,9 @@
 
 @defvar dir-locals-directory-cache
 This alist holds directory names, their assigned class names, and
-modification times of the associated directory local variables file.
-It is updated by @code{dir-locals-set-directory-class}.
+modification times of the associated directory local variables file
+(if there is one).  The function @code{dir-locals-set-directory-class}
+updates this list.
 @end defvar
 
 @node Frame-Local Variables