Improve docs of transient-mark-mode (Bug#19841)

src/buffer.c (syms_of_buffer): Doc fix.

 lisp/simple.el (transient-mark-mode): Doc fix.

lisp/ChangeLog

@@ -1,3 +1,7 @@
+2015-02-13  Eli Zaretskii  <eliz@gnu.org>
+
+	* simple.el (transient-mark-mode): Doc fix.  (Bug#19841)
+
 2015-02-12  Agustín Martín Domingo <agustin6martin@gmail.com>
 
 	Improve string search in `flyspell-word-search-*`. (Bug#16800)

lisp/simple.el

@@ -4810,10 +4810,11 @@ positive, and disable it otherwise.  If called from Lisp, enable
 Transient Mark mode if ARG is omitted or nil.
 
 Transient Mark mode is a global minor mode.  When enabled, the
-region is highlighted whenever the mark is active.  The mark is
+region is highlighted with the `region' face whenever the mark
-\"deactivated\" by changing the buffer, and after certain other
+is active.  The mark is \"deactivated\" by changing the buffer,
-operations that set the mark but whose main purpose is something
+and after certain other operations that set the mark but whose
-else--for example, incremental search, \\[beginning-of-buffer], and \\[end-of-buffer].
+main purpose is something else--for example, incremental search,
+\\[beginning-of-buffer], and \\[end-of-buffer].
 
 You can also deactivate the mark by typing \\[keyboard-quit] or
 \\[keyboard-escape-quit].

src/ChangeLog

@@ -1,3 +1,7 @@
+2015-02-13  Eli Zaretskii  <eliz@gnu.org>
+
+	* buffer.c (syms_of_buffer): Doc fix.  (Bug#19841)
+
 2015-02-08  Eli Zaretskii  <eliz@gnu.org>
 
 	* xfaces.c (map_tty_color): Use assoc_no_quit instead of

src/buffer.c

@@ -6242,6 +6242,7 @@ If the buffer has never been shown in a window, the value is nil.  */);
 See the command `transient-mark-mode' for a description of this minor mode.
 
 Non-nil also enables highlighting of the region whenever the mark is active.
+The region is highlighted with the `region' face.
 The variable `highlight-nonselected-windows' controls whether to highlight
 all windows or just the selected window.