From: Chong Yidong <cyd@gnu.org>
Date: Sat, 28 Dec 2013 04:30:19 +0000 (+0800)
Subject: Doc updates
X-Git-Tag: emacs-24.3.90~173^2^2~42^2~45^2~387^2~149
X-Git-Url: https://code.delx.au/gnu-emacs/commitdiff_plain/4364185f73c426c17de2892d41992f080c6d433c

Doc updates

* buffers.texi (Modification Time): Document visited-file-modtime change.

* modes.texi (Auto Major Mode): Document interpreter-mode-alist change.
---

diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index b86ab72276..2ebab69551 100644
--- a/doc/lispref/ChangeLog
+++ b/doc/lispref/ChangeLog
@@ -1,3 +1,11 @@
+2013-12-28  Chong Yidong  <cyd@gnu.org>
+
+	* modes.texi (Auto Major Mode): Document interpreter-mode-alist
+	change.
+
+	* buffers.texi (Modification Time): Document visited-file-modtime
+	change.
+
 2013-12-28  Glenn Morris  <rgm@gnu.org>
 
 	* control.texi (Pattern matching case statement): Brevity.
diff --git a/doc/lispref/buffers.texi b/doc/lispref/buffers.texi
index 0126985125..bb33cb3a70 100644
--- a/doc/lispref/buffers.texi
+++ b/doc/lispref/buffers.texi
@@ -632,13 +632,12 @@ exceptional places where the usual test to avoid overwriting a changed
 file should not be done.
 @end defun
 
-@c Emacs 19 feature
 @defun visited-file-modtime
 This function returns the current buffer's recorded last file
 modification time, as a list of the form @code{(@var{high} @var{low}
-@var{microsec} @var{picosec})}.
-(This is the same format that @code{file-attributes} uses to return
-time values; see @ref{File Attributes}.)
+@var{microsec} @var{picosec})}.  (This is the same format that
+@code{file-attributes} uses to return time values; @pxref{File
+Attributes}.)
 
 If the buffer has no recorded last modification time, this function
 returns zero.  This case occurs, for instance, if the buffer is not
@@ -648,17 +647,9 @@ visiting a file or if the time has been explicitly cleared by
 too.  For instance, in a Dired buffer listing a directory, it returns
 the last modification time of that directory, as recorded by Dired.
 
-For a new buffer visiting a not yet existing file, @var{high} is
-@minus{}1 and @var{low} is 65535, that is,
-@ifnottex
-@w{2**16 @minus{} 1.}
-@end ifnottex
-@tex
-@math{2^{16}-1}.
-@end tex
+If the buffer is not visiting a file, this function returns -1.
 @end defun
 
-@c Emacs 19 feature
 @defun set-visited-file-modtime &optional time
 This function updates the buffer's record of the last modification time
 of the visited file, to the value specified by @var{time} if @var{time}
diff --git a/doc/lispref/modes.texi b/doc/lispref/modes.texi
index f04c0c1ea9..4388fb2f6e 100644
--- a/doc/lispref/modes.texi
+++ b/doc/lispref/modes.texi
@@ -646,10 +646,10 @@ mode command.  The default value is @code{lisp-interaction-mode}.
 @defvar interpreter-mode-alist
 This variable specifies major modes to use for scripts that specify a
 command interpreter in a @samp{#!} line.  Its value is an alist with
-elements of the form @code{(@var{interpreter} . @var{mode})}; for
-example, @code{("perl" . perl-mode)} is one element present by
-default.  The element says to use mode @var{mode} if the file
-specifies an interpreter which matches @var{interpreter}.
+elements of the form @code{(@var{regexp} . @var{mode})}; this says to
+use mode @var{mode} if the file specifies an interpreter which matches
+@code{\\`@var{regexp}\\'}.  For example, one of the default elements
+is @code{("python[0-9.]*" . python-mode)}.
 @end defvar
 
 @defvar magic-mode-alist
diff --git a/etc/NEWS b/etc/NEWS
index a83f7d0742..49a2d8e6c9 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -952,14 +952,14 @@ alist of extended attributes as returned by the new function
 `file-extended-attributes'.  The attributes can be applied to another
 file using `set-file-extended-attributes'.
 
++++
 ** `visited-file-modtime' now returns -1 for nonexistent files.
 Formerly it returned a list (-1 LOW USEC PSEC), but this was ambiguous
 in the presence of files with negative time stamps.
 
++++
 ** The cars of the elements in `interpreter-mode-alist' are now
-treated as regexps rather than literal strings.  This change should
-not affect you unless you are using `interpreter-mode-alist' for
-something (not just adding elements to it).
+treated as regexps rather than literal strings.
 
 
 * Lisp Changes in Emacs 24.4