From 3e801240986af911e5d97828a2743b04237c9f9c Mon Sep 17 00:00:00 2001 From: Eli Zaretskii Date: Sat, 18 Nov 2017 11:42:06 +0200 Subject: [PATCH] Improve documentation of dired-next/prev-marked-file * lisp/dired.el (dired-next-marked-file, dired-prev-marked-file): Doc fixes. (Bug#29340) --- lisp/dired.el | 19 +++++++++++++------ 1 file changed, 13 insertions(+), 6 deletions(-) diff --git a/lisp/dired.el b/lisp/dired.el index f1a74639a94..eb88e273758 100644 --- a/lisp/dired.el +++ b/lisp/dired.el @@ -3363,9 +3363,14 @@ argument or confirmation)." (save-excursion (not (dired-move-to-filename)))) (defun dired-next-marked-file (arg &optional wrap opoint) - "Move to the next marked file. -If WRAP is non-nil, wrap around to the beginning of the buffer if -we reach the end." + "Move to the ARGth next marked file. +ARG is the numeric prefix argument and defaults to 1. +If WRAP is non-nil, which happens interactively, wrap around +to the beginning of the buffer and search from there, if no +marked file is found after this line. +Optional argument OPOINT specifies the buffer position to +return to if no ARGth marked file is found; it defaults to +the position where this command was invoked." (interactive "p\np") (or opoint (setq opoint (point)));; return to where interactively started (if (if (> arg 0) @@ -3382,9 +3387,11 @@ we reach the end." (dired-next-marked-file arg nil opoint)))) (defun dired-prev-marked-file (arg &optional wrap) - "Move to the previous marked file. -If WRAP is non-nil, wrap around to the end of the buffer if we -reach the beginning of the buffer." + "Move to the ARGth previous marked file. +ARG is the numeric prefix argument and defaults to 1. +If WRAP is non-nil, which happens interactively, wrap around +to the end of the buffer and search backwards from there, if +no ARGth marked file is found before this line." (interactive "p\np") (dired-next-marked-file (- arg) wrap)) -- 2.39.2