[Emacs-diffs] emacs-26 7850b76: Adjudicate review comments for the "Text" chapter of user manual

[Eli Zaretskii]

branch: emacs-26
commit 7850b7620e2bc6cb9ed43ea00f84a0ad04193fe3
Author: Eli Zaretskii <address@hidden>
Commit: Eli Zaretskii <address@hidden>

    Adjudicate review comments for the "Text" chapter of user manual
    
    * doc/emacs/text.texi (Text): Rearrange text for clarity.  Add
    cross-reference to the Org manual.  Make the cross-reference to
    Outline Mode appear in online manuals as well (the conditional was
    a forgotten remnant from time immemoriam).
    (Paragraphs): Add a note that 'paragraph-start' and
    'paragraph-separate' should not be anchored.
    (Auto Fill): Remove redundant text.  Suggested by Petteri
    Hintsanen <address@hidden> in address@hidden
---
 doc/emacs/text.texi | 40 ++++++++++++++++++++++++----------------
 1 file changed, 24 insertions(+), 16 deletions(-)

diff --git a/doc/emacs/text.texi b/doc/emacs/text.texi
index 67c279a..3561956 100644
--- a/doc/emacs/text.texi
+++ b/doc/emacs/text.texi
@@ -22,13 +22,17 @@ are also often useful for editing programs.
 the file contains ordinary text, use Text mode, which customizes Emacs
 in small ways for the syntactic conventions of text.  Outline mode
 provides special commands for operating on text with an outline
-structure.  Org mode extends Outline mode and turn Emacs into a
-full-fledged organizer: you can manage TODO lists, store notes and
-publish them in many formats.
+structure.  @xref{Outline Mode}.
 
address@hidden
address@hidden Mode}.
address@hidden iftex
+  Org mode extends Outline mode and turns Emacs into a full-fledged
+organizer: you can manage TODO lists, store notes and publish them in
+many formats.
address@hidden
address@hidden, The Org Manual,,org, The Org Manual}.
address@hidden ifinfo
address@hidden
+See the Org Info manual, which is distributed with Emacs.
address@hidden ifnotinfo
 
 @cindex nXML mode
 @cindex mode, XML
@@ -324,6 +328,12 @@ that start a new paragraph and are contained in it must 
match only
 in Fundamental mode, @code{paragraph-start} is @address@hidden"\f\\|[
 \t]*$"}}, and @code{paragraph-separate} is @address@hidden"[ \t\f]*$"}}.
 
+  Note that @code{paragraph-start} and @code{paragraph-separate} are
+matched against the text at the left margin, which is not necessarily
+the beginning of the line, so these regexps should not use @samp{^} as
+an anchor, to ensure that the paragraph functions will work equally
+within a region of text indented by a margin setting.
+
 @node Pages
 @section Pages
 
@@ -479,8 +489,8 @@ text.
 @cindex mode, Auto Fill
 
   @dfn{Auto Fill} mode is a buffer-local minor mode (@pxref{Minor
-Modes}) in which lines are broken automatically when they become too
-wide.  Breaking happens only when you type a @key{SPC} or @key{RET}.
+Modes}) in which lines are broken automatically at spaces when the
+line becomes too wide.
 
 @table @kbd
 @item M-x auto-fill-mode
@@ -492,14 +502,12 @@ In Auto Fill mode, break lines when appropriate.
 
 @findex auto-fill-mode
   The mode command @kbd{M-x auto-fill-mode} toggles Auto Fill mode in
-the current buffer.  With a positive numeric argument, it enables Auto
-Fill mode, and with a negative argument it disables it.  If
address@hidden is called from Lisp with an omitted or
address@hidden argument, it enables Auto Fill mode.  To enable Auto Fill
-mode automatically in certain major modes, add @code{auto-fill-mode}
-to the mode hooks (@pxref{Major Modes}).  When Auto Fill mode is
-enabled, the mode indicator @samp{Fill} appears in the mode line
-(@pxref{Mode Line}).
+the current buffer.  Like any other minor mode, with a positive
+numeric argument, it enables Auto Fill mode, and with a negative
+argument it disables it.  To enable Auto Fill mode automatically in
+certain major modes, add @code{auto-fill-mode} to the mode hooks
+(@pxref{Major Modes}).  When Auto Fill mode is enabled, the mode
+indicator @samp{Fill} appears in the mode line (@pxref{Mode Line}).
 
   Auto Fill mode breaks lines automatically at spaces whenever they
 get longer than the desired width.  This line breaking occurs only