Re: C-u C-SPC: doc string and behavior if mark = point

[Eli Zaretskii]

> From: "Drew Adams" <address@hidden>
> Date: Sun, 8 Apr 2007 10:43:55 -0700
> 
> 1. Doc string for `set-mark-command':

Thanks, I implemented some of your suggestions.  The new doc string
appears at the end of this message.

> Get rid of "e.g. C-u C-@".

I don't see any reason to get rid of this, as it's a valuable advice
to novices who could otherwise do something like M-1, which is much
less convenient.

> Get rid of "With a double C-u prefix argument, e.g. C-u C-u C-@"; just
> say "With `C-u C-u'".

Ditto.

> Remove quotes around "region". Remove ", which is the closest
> thing...". Remove the paragraph about setting the region altogether
> (the region is not "set"). Just say "The region is the buffer area
> between the mark and the cursor position. Some people call it the
> "selection"."

Didn't change any of these, since I see nothing wrong with the current
wording.
---------------------

set-mark-command is an interactive compiled Lisp function in `simple.el'.
It is bound to C-@, C-SPC.
(set-mark-command arg)

Set mark where point is, or jump to mark.
Setting the mark also sets the "region", which is the closest
equivalent in Emacs to what some editors call the "selection".

With no prefix argument, set mark and push old mark position on local
mark ring.  Also, push mark on global mark ring if last mark was set in
another buffer.  Immediately repeating the command activates
`transient-mark-mode' temporarily.

With prefix argument (e.g., C-u C-@), jump to mark, and set mark from
position popped off the local mark ring (this does not affect the global
mark ring).  Use C-x C-@ to jump to a mark popped off the global
mark ring (see `pop-global-mark').

If `set-mark-command-repeat-pop' is non-nil, repeating
the C-@ command with no prefix argument pops the next position
off the local (or global) mark ring and jumps there.

With a double C-u prefix argument (e.g., C-u C-u C-@), unconditionally
set mark where point is, even if `set-mark-command-repeat-pop' is non-nil.

Novice Emacs Lisp programmers often try to use the mark for the wrong
purposes.  See the documentation of `set-mark' for more information.