[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

master 9c04760: Document file-backup-file-names

From: Lars Ingebrigtsen
Subject: master 9c04760: Document file-backup-file-names
Date: Mon, 24 Aug 2020 14:11:34 -0400 (EDT)

branch: master
commit 9c04760f169904fc56745a29227f1d4219f16e0a
Author: Lars Ingebrigtsen <larsi@gnus.org>
Commit: Lars Ingebrigtsen <larsi@gnus.org>

    Document file-backup-file-names
    * doc/lispref/backups.texi (Backup Names): Document
 doc/lispref/backups.texi | 11 ++++++++---
 etc/NEWS                 |  2 +-
 2 files changed, 9 insertions(+), 4 deletions(-)

diff --git a/doc/lispref/backups.texi b/doc/lispref/backups.texi
index 4ed1a10..55b8d72 100644
--- a/doc/lispref/backups.texi
+++ b/doc/lispref/backups.texi
@@ -414,10 +414,15 @@ version that the caller should consider deleting now.
 @end smallexample
 @end defun
-@c Emacs 19 feature
+@defun file-backup-file-names filename
+This function returns a list of all the backup file names for
+@var{filename}, or @code{nil} if there are none.  The files are sorted
+so that the most recent backup file comes first in the list.
+@end defun
 @defun file-newest-backup filename
-This function returns the name of the most recent backup file for
-@var{filename}, or @code{nil} if that file has no backup files.
+This function returns the first element of the list returned by
 Some file comparison commands use this function so that they can
 automatically compare a file with its most recent backup.
diff --git a/etc/NEWS b/etc/NEWS
index 734d649..03516bf 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -1113,7 +1113,7 @@ ledit.el, lmenu.el, lucid.el and old-whitespace.el.
 * Lisp Changes in Emacs 28.1
 *** New function 'file-backup-file-names'.
 This function returns the list of file names of all the backup files
 of its file argument.

reply via email to

[Prev in Thread] Current Thread [Next in Thread]