Document file-backup-file-names

* doc/lispref/backups.texi (Backup Names): Document
file-backup-file-names.

diff --git a/doc/lispref/backups.texi b/doc/lispref/backups.texi
index 4ed1a10fcf6a40e83c4090b00438f207e50ee92d..55b8d7215d3feb90e00a05d51c2265034d200413 100644 (file)
--- 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
+@code{file-backup-file-names}.
 
 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 734d649dfa824fc0d4e58f1d560eb55bf0db2f01..03516bf4d3a1af31d1b13e96bd8e6fb9ef6b9b4e 100644 (file)
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -1113,7 +1113,7 @@ ledit.el, lmenu.el, lucid.el and old-whitespace.el.
 \f
 * 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.