]> code.delx.au - gnu-emacs/blobdiff - man/mark.texi
etags
[gnu-emacs] / man / mark.texi
index ad57c95958c69601561d5745bf3f69ea63d54cc5..4b3c28814a4b165034667737ea17b74f2d1fd5bc 100644 (file)
@@ -278,7 +278,9 @@ Put region around current page (@code{mark-page}).
 @kbd{M-@@} (@code{mark-word}) puts the mark at the end of the next
 word, while @kbd{C-M-@@} (@code{mark-sexp}) puts it at the end of the
 next balanced expression (@pxref{Expressions}).  These commands handle
-arguments just like @kbd{M-f} and @kbd{C-M-f}.
+arguments just like @kbd{M-f} and @kbd{C-M-f}.  If you repeat these
+commands, the region is extended.  For example, you can type either
+@kbd{C-u 2 M-@@} or @kbd{M-@@ M-@@} to mark the next two words.
 
 @kindex C-x h
 @findex mark-whole-buffer
@@ -288,22 +290,24 @@ the beginning of the paragraph that surrounds or follows point, and
 puts the mark at the end of that paragraph (@pxref{Paragraphs}).  It
 prepares the region so you can indent, case-convert, or kill a whole
 paragraph.  With prefix argument, if the argument's value is positive,
-@kbd{M-h} marks that many paragraphs, the paragraph surrounding point
-plus some following paragraphs.  If the prefix argument is negative,
-@kbd{M-h} also marks that many paragraphs, but the preceding ones
-instead of the following.  (With a positive argument, point is put
-at the beginning and mark at end, with a negative argument, point is
-at end and mark at the beginning.)
+@kbd{M-h} marks that many paragraphs starting with the one surrounding
+point.  If the prefix argument is @minus{}@var{n}, @kbd{M-h} also
+marks @var{n} paragraphs, running back form the one surrounding point.
+In that last case, point moves forward to the end of that paragraph,
+and the mark goes at the start of the region.  The @kbd{M-h} command
+also supports the extension of the region, similar to @kbd{M-@@} and
+@kbd{C-M-@@}.
 
   @kbd{C-M-h} (@code{mark-defun}) similarly puts point before, and the
 mark after, the current (or following) major top-level definition, or
-defun (@pxref{Moving by Defuns}).  @kbd{C-x C-p} (@code{mark-page})
-puts point before the current page, and mark at the end
-(@pxref{Pages}).  The mark goes after the terminating page delimiter
-(to include it in the region), while point goes after the preceding
-page delimiter (to exclude it).  A numeric argument specifies a later
-page (if positive) or an earlier page (if negative) instead of the
-current page.
+defun (@pxref{Moving by Defuns}).  (Currently it only marks one defun,
+but repeating it marks more defuns, like for @kbd{M-@@}.)  @kbd{C-x
+C-p} (@code{mark-page}) puts point before the current page, and mark
+at the end (@pxref{Pages}).  The mark goes after the terminating page
+delimiter (to include it in the region), while point goes after the
+preceding page delimiter (to exclude it).  A numeric argument
+specifies a later page (if positive) or an earlier page (if negative)
+instead of the current page.
 
   Finally, @kbd{C-x h} (@code{mark-whole-buffer}) sets up the entire
 buffer as the region, by putting point at the beginning and the mark at