1
0
mirror of https://git.savannah.gnu.org/git/emacs.git synced 2024-11-23 07:19:15 +00:00

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.
This commit is contained in:
Lars Ingebrigtsen 2020-08-24 22:04:28 +02:00
parent 517285f7ca
commit 519fc10f12
2 changed files with 4 additions and 2 deletions

View File

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

View File

@ -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'.