Clarify sorting order by file-backup-file-names

* doc/lispref/backups.texi (Backup Names): Ditto.

* lisp/files.el (file-backup-file-names): Clarify sorting order.

diff --git a/doc/lispref/backups.texi b/doc/lispref/backups.texi
index 55b8d7215d3feb90e00a05d51c2265034d200413..e14f77f9fc4f4822e2099a3c13432f74c8f6fa17 100644 (file)
--- a/doc/lispref/backups.texi
+++ b/doc/lispref/backups.texi
@@ -417,7 +417,8 @@ version that the caller should consider deleting now.
 @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.
+by modification time, descending, so that the most recent files are
+first.
 @end defun
 
 @defun file-newest-backup filename

diff --git a/lisp/files.el b/lisp/files.el
index 5102585d7de5daddbd4edc4284b45cdabcbe6e9e..873f362dd59a437d5dee997187c744dba1e23c4f 100644 (file)
--- a/lisp/files.el
+++ b/lisp/files.el
@@ -5659,7 +5659,8 @@ like `write-region' does."
 
 (defun file-backup-file-names (filename)
   "Return a list of backup files for FILENAME.
-The list will be sorted by newness."
+The list will be sorted by modification time so that the most
+recent files are first."
   ;; `make-backup-file-name' will get us the right directory for
   ;; ordinary or numeric backups.  It might create a directory for
   ;; backups as a side-effect, according to `backup-directory-alist'.