procyberian/emacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

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
Show stats 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>
* 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.
@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}

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
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

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 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