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

[Drew Adams]

> > 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.

Looks better. Thanks, Eli.

You can drop the quote marks around "region", but not around "selection".
`C-@' defines (sets, if you like) the region itself, not the word "region".

You can drop "e.g.", because `C-u C-u C-@' is not an example of a double
prefix arg with C-@; it is the same thing as using a double prefix arg with
address@hidden If you want, you can use "i.e." or, better, "that is", but 
neither is
needed here.