From 1ca0da0e83867f2f24820acbfd099007d2f7e3f5 Mon Sep 17 00:00:00 2001 From: Lars Magne Ingebrigtsen Date: Sun, 3 Jul 2011 15:25:18 +0200 Subject: [PATCH] * dired.el (dired-map-over-marks): Refill the doc string (bug#6814). --- lisp/ChangeLog | 2 ++ lisp/dired.el | 37 ++++++++++++++++++++++--------------- 2 files changed, 24 insertions(+), 15 deletions(-) diff --git a/lisp/ChangeLog b/lisp/ChangeLog index 169793ebc4..12404f496c 100644 --- a/lisp/ChangeLog +++ b/lisp/ChangeLog @@ -1,5 +1,7 @@ 2011-07-03 Lars Magne Ingebrigtsen + * dired.el (dired-map-over-marks): Refill the doc string (bug#6814). + * fringe.el (fringe-query-style): Remove redundant text " (type ? for list)" (bug#6475). diff --git a/lisp/dired.el b/lisp/dired.el index 92f3a46306..929d44440d 100644 --- a/lisp/dired.el +++ b/lisp/dired.el @@ -515,24 +515,31 @@ Return value is the number of files marked, or nil if none were marked." (defmacro dired-map-over-marks (body arg &optional show-progress distinguish-one-marked) "Eval BODY with point on each marked line. Return a list of BODY's results. -If no marked file could be found, execute BODY on the current line. -ARG, if non-nil, specifies the files to use instead of the marked files. - If ARG is an integer, use the next ARG (or previous -ARG, if - ARG<0) files. In that case, point is dragged along. This is - so that commands on the next ARG (instead of the marked) files - can be chained easily. - For any other non-nil value of ARG, use the current file. +If no marked file could be found, execute BODY on the current +line. ARG, if non-nil, specifies the files to use instead of the +marked files. + +If ARG is an integer, use the next ARG (or previous -ARG, if +ARG<0) files. In that case, point is dragged along. This is so +that commands on the next ARG (instead of the marked) files can +be chained easily. +For any other non-nil value of ARG, use the current file. + If optional third arg SHOW-PROGRESS evaluates to non-nil, - redisplay the dired buffer after each file is processed. -No guarantee is made about the position on the marked line. - BODY must ensure this itself if it depends on this. -Search starts at the beginning of the buffer, thus the car of the list - corresponds to the line nearest to the buffer's bottom. This - is also true for (positive and negative) integer values of ARG. +redisplay the dired buffer after each file is processed. + +No guarantee is made about the position on the marked line. BODY +must ensure this itself if it depends on this. + +Search starts at the beginning of the buffer, thus the car of the +list corresponds to the line nearest to the buffer's bottom. +This is also true for (positive and negative) integer values of +ARG. + BODY should not be too long as it is expanded four times. -If DISTINGUISH-ONE-MARKED is non-nil, then if we find just one marked file, -return (t FILENAME) instead of (FILENAME)." +If DISTINGUISH-ONE-MARKED is non-nil, then if we find just one +marked file, return (t FILENAME) instead of (FILENAME)." ;; ;;Warning: BODY must not add new lines before point - this may cause an ;;endless loop. -- 2.39.2