[Emacs-diffs] trunk r115789: Doc updates

[Chong Yidong]

------------------------------------------------------------
revno: 115789
revision-id: address@hidden
parent: address@hidden
committer: Chong Yidong <address@hidden>
branch nick: trunk
timestamp: Sat 2013-12-28 12:30:19 +0800
message:
  Doc updates
  
  * buffers.texi (Modification Time): Document visited-file-modtime change.
  
  * modes.texi (Auto Major Mode): Document interpreter-mode-alist change.
modified:
  doc/lispref/ChangeLog          changelog-20091113204419-o5vbwnq5f7feedwu-6155
  doc/lispref/buffers.texi       
buffers.texi-20091113204419-o5vbwnq5f7feedwu-6164
  doc/lispref/modes.texi         modes.texi-20091113204419-o5vbwnq5f7feedwu-6201
  etc/NEWS                       news-20100311060928-aoit31wvzf25yr1z-1

=== modified file 'doc/lispref/ChangeLog'
--- a/doc/lispref/ChangeLog     2013-12-28 00:47:15 +0000
+++ b/doc/lispref/ChangeLog     2013-12-28 04:30:19 +0000
@@ -1,3 +1,11 @@
+2013-12-28  Chong Yidong  <address@hidden>
+
+       * modes.texi (Auto Major Mode): Document interpreter-mode-alist
+       change.
+
+       * buffers.texi (Modification Time): Document visited-file-modtime
+       change.
+
 2013-12-28  Glenn Morris  <address@hidden>
 
        * control.texi (Pattern matching case statement): Brevity.

=== modified file 'doc/lispref/buffers.texi'
--- a/doc/lispref/buffers.texi  2013-06-30 22:29:23 +0000
+++ b/doc/lispref/buffers.texi  2013-12-28 04:30:19 +0000
@@ -632,13 +632,12 @@
 file should not be done.
 @end defun
 
address@hidden 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}
address@hidden @var{picosec})}.
-(This is the same format that @code{file-attributes} uses to return
-time values; see @ref{File Attributes}.)
address@hidden @var{picosec})}.  (This is the same format that
address@hidden 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 @@
 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
address@hidden and @var{low} is 65535, that is,
address@hidden
address@hidden @minus{} 1.}
address@hidden ifnottex
address@hidden
address@hidden
address@hidden tex
+If the buffer is not visiting a file, this function returns -1.
 @end defun
 
address@hidden 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}

=== modified file 'doc/lispref/modes.texi'
--- a/doc/lispref/modes.texi    2013-12-18 05:31:11 +0000
+++ b/doc/lispref/modes.texi    2013-12-28 04:30:19 +0000
@@ -646,10 +646,10 @@
 @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
address@hidden@var{regexp}\\'}.  For example, one of the default elements
+is @code{("python[0-9.]*" . python-mode)}.
 @end defvar
 
 @defvar magic-mode-alist

=== modified file 'etc/NEWS'
--- a/etc/NEWS  2013-12-27 10:43:11 +0000
+++ b/etc/NEWS  2013-12-28 04:30:19 +0000
@@ -952,14 +952,14 @@
 `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