Re: Documentation of transient-mark-mode is sloppy, wrong, and confused.

[Stefan Monnier]

>   The region can be in one of two states: active or inactive.  When
>   the region is active, certain Emacs commands automatically operate
>   on the text in the region, instead of on the whole buffer.  For
>   example, bla-bla-bla.  By contrast, an inactive region can only be
>   operated upon by commands specially designed for that job, such as
>   @code{call-process-region}, @code{count-lines-region},
>   @code{write-region}, etc.

>   When the region is active, the function @code{region-active-p}
>   returns a address@hidden value.

>   The region becomes active when:

>   <describe here the various ways of activating the region>

That looks pretty good to me.  Of course it also needs to say when the
region becomes inactive.


        Stefan