(mark-paragraph): Clarify doc. Clarify

error message.  Suggestion from Richard M. Stallman.

diff --git a/lisp/ChangeLog b/lisp/ChangeLog
index 9e513ddf253dc1d0ffbdb5dae85992905de93ff3..d4e3d12b3f6cd3af31c06ee8ac374af2c0f2e7a6 100644 (file)
--- a/lisp/ChangeLog
+++ b/lisp/ChangeLog
@@ -1,3 +1,12 @@
+2001-11-30  Kai Gro\e,A_\e(Bjohann  <Kai.Grossjohann@CS.Uni-Dortmund.DE>
+
+       * textmodes/paragraphs.el (mark-paragraph): Clarify doc.  Clarify
+       error message.  Suggestion from Richard Stallman.
+
+2001-11-29  Kai Grossjohann  <Kai.Grossjohann@CS.Uni-Dortmund.DE>
+
+       * textmodes/paragraphs.el (mark-paragraph): Allow prefix arg.
+
 2001-11-30  Andre Spiegel  <spiegel@gnu.org>
 
        * vc-cvs.el (vc-cvs-parse-status): Store file state in property,

diff --git a/lisp/textmodes/paragraphs.el b/lisp/textmodes/paragraphs.el
index 8b9ca150ea9e56b06e11a2d24aeeb55282246bc5..ed9a78696fd78f14a1d9ed69a243393f9ce612ef 100644 (file)
--- a/lisp/textmodes/paragraphs.el
+++ b/lisp/textmodes/paragraphs.el
@@ -317,13 +317,22 @@ See `forward-paragraph' for more information."
   (or arg (setq arg 1))
   (forward-paragraph (- arg)))
 
-(defun mark-paragraph ()
+(defun mark-paragraph (&optional arg)
   "Put point at beginning of this paragraph, mark at end.
-The paragraph marked is the one that contains point or follows point."
-  (interactive)
-  (forward-paragraph 1)
+The paragraph marked is the one that contains point or follows point.
+
+With argument ARG, puts mark at end of a following paragraph, so that
+the number of paragraphs marked equals ARG.
+
+If ARG is negative, point is put at end of this paragraph, mark is put
+at beginning of this or a previous paragraph."
+  (interactive "p")
+  (unless arg (setq arg 1))
+  (when (zerop arg)
+    (error "Cannot mark zero paragraphs"))
+  (forward-paragraph arg)
   (push-mark nil t t)
-  (backward-paragraph 1))
+  (backward-paragraph arg))
 
 (defun kill-paragraph (arg)
   "Kill forward to end of paragraph.