mirrors/emacs
1
Fork 0
mirror of git://git.sv.gnu.org/emacs.git synced 2025-12-23 06:00:41 -08:00
Code Issues Projects Releases Wiki Activity

Doc updates

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

* modes.texi (Auto Major Mode): Document interpreter-mode-alist change.
This commit is contained in:
Chong Yidong 2013-12-28 12:30:19 +08:00
parent a544fbe1d1
commit 4364185f73
4 changed files with 19 additions and 20 deletions
Download patch file Download diff file Expand all files Collapse all files

8
doc/lispref/ChangeLog
View file

@ -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> 2013-12-28 Glenn Morris <rgm@gnu.org>
* control.texi (Pattern matching case statement): Brevity. * control.texi (Pattern matching case statement): Brevity.

17
doc/lispref/buffers.texi
View file

@ -632,13 +632,12 @@ exceptional places where the usual test to avoid overwriting a changed
file should not be done. file should not be done.
@end defun @end defun
@c Emacs 19 feature
@defun visited-file-modtime @defun visited-file-modtime
This function returns the current buffer's recorded last file This function returns the current buffer's recorded last file
modification time, as a list of the form @code{(@var{high} @var{low} modification time, as a list of the form @code{(@var{high} @var{low}
@var{microsec} @var{picosec})}. @var{microsec} @var{picosec})}. (This is the same format that
(This is the same format that @code{file-attributes} uses to return @code{file-attributes} uses to return time values; @pxref{File
time values; see @ref{File Attributes}.) Attributes}.)
If the buffer has no recorded last modification time, this function If the buffer has no recorded last modification time, this function
returns zero. This case occurs, for instance, if the buffer is not 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 too. For instance, in a Dired buffer listing a directory, it returns
the last modification time of that directory, as recorded by Dired. the last modification time of that directory, as recorded by Dired.
For a new buffer visiting a not yet existing file, @var{high} is If the buffer is not visiting a file, this function returns -1.
@minus{}1 and @var{low} is 65535, that is,
@ifnottex
@w{2**16 @minus{} 1.}
@end ifnottex
@tex
@math{2^{16}-1}.
@end tex
@end defun @end defun
@c Emacs 19 feature
@defun set-visited-file-modtime &optional time @defun set-visited-file-modtime &optional time
This function updates the buffer's record of the last modification 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} of the visited file, to the value specified by @var{time} if @var{time}

8
doc/lispref/modes.texi
View file

@ -646,10 +646,10 @@ mode command. The default value is @code{lisp-interaction-mode}.
@defvar interpreter-mode-alist @defvar interpreter-mode-alist
This variable specifies major modes to use for scripts that specify a This variable specifies major modes to use for scripts that specify a
command interpreter in a @samp{#!} line. Its value is an alist with command interpreter in a @samp{#!} line. Its value is an alist with
elements of the form @code{(@var{interpreter} . @var{mode})}; for elements of the form @code{(@var{regexp} . @var{mode})}; this says to
example, @code{("perl" . perl-mode)} is one element present by use mode @var{mode} if the file specifies an interpreter which matches
default. The element says to use mode @var{mode} if the file @code{\\`@var{regexp}\\'}. For example, one of the default elements
specifies an interpreter which matches @var{interpreter}. is @code{("python[0-9.]*" . python-mode)}.
@end defvar @end defvar
@defvar magic-mode-alist @defvar magic-mode-alist

6
etc/NEWS
View file

@ -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-extended-attributes'. The attributes can be applied to another
file using `set-file-extended-attributes'. file using `set-file-extended-attributes'.
+++
** `visited-file-modtime' now returns -1 for nonexistent files. ** `visited-file-modtime' now returns -1 for nonexistent files.
Formerly it returned a list (-1 LOW USEC PSEC), but this was ambiguous Formerly it returned a list (-1 LOW USEC PSEC), but this was ambiguous
in the presence of files with negative time stamps. 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 treated as regexps rather than literal strings.
not affect you unless you are using `interpreter-mode-alist' for
something (not just adding elements to it).
* Lisp Changes in Emacs 24.4 * Lisp Changes in Emacs 24.4