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 b86ab722764d7043dda00b73c68c59b1e313d8d0..2ebab6955140730f53dedccfd724d2ae7a675c26 100644 (file)
--- 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.
 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 01269851250fd946c1196de1ec2cf601bc310513..bb33cb3a7008fe0838686522af3e49ed53039b3c 100644 (file)
--- 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
 
 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}
 @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
 
 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.
 
 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
 
 @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}
 @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 f04c0c1ea9f58323267762dd11df7c50d18f6154..4388fb2f6eb184902dafe4d59a9f05804f4f0aed 100644 (file)
--- 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
 @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
 @end defvar
 
 @defvar magic-mode-alist

diff --git a/etc/NEWS b/etc/NEWS
index a83f7d0742ce05ad39f9213da489aad6adfbf6ee..49a2d8e6c9b086c210f422aaa71d7cebfb7580ba 100644 (file)
--- 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'.
 
 `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.
 
 ** `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
 ** 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.

 
 \f
 * Lisp Changes in Emacs 24.4
 
 \f
 * Lisp Changes in Emacs 24.4