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

Improve documentation of 'file-has-changed-p'

Browse source 
* etc/NEWS:
* doc/lispref/files.texi (File Attributes): Improve wording of the
documentation of 'file-has-changed-p'.
This commit is contained in:
Eli Zaretskii 2021-11-01 17:09:52 +02:00
parent a5d79fcfe8
commit dfc89318ce
2 changed files with 10 additions and 8 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

14
doc/lispref/files.texi
View file

@ -1315,12 +1315,14 @@ on the 19th, @file{aug-20} was written on the 20th, and the file
@end defun
@defun file-has-changed-p filename
This convenience function is useful when, for instance, parsing files
run-time, and you typically want to re-read a file when it has
changed. This function returns non-@code{nil} the first time it's
called on @var{filename} in an Emacs session, but will return
@code{nil} on subsequent calls in that session (unless the file
changes its modification time).
This function returns non-@code{nil} if the time stamp of
@var{filename} has changed since the last call. When called for the
first time for some @var{filename}, it records the last modification
time of the file and returns non-@code{nil}. Thereafter, when called
for the same @var{filename}, it compares the current time stamp with
the recorded one and returns non-@code{nil} only if they are
different. This is useful when a Lisp program wants to re-read a file
whenever it changes.
@end defun
@defun file-attributes filename &optional id-format

4
etc/NEWS
View file

@ -369,8 +369,8 @@ Use 'exif-parse-file' and 'exif-field' instead.
+++
*** New function 'file-has-changed-p'.
This convenience function is useful when writing code that parses
files run-time, and allows you to easily re-parse files when they have
changed (but not otherwise).
files at run-time, and allows Lisp programs to re-parse files only
when they have changed.
---
*** New function 'font-has-char-p'.