procyberian/emacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Adjudicate review comments for the "Text" chapter of user manual

Browse source 
* 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 <petterih@iki.fi> in emacs-manual-bugs@gnu.org.
This commit is contained in:
Eli Zaretskii 2017-12-24 20:47:06 +02:00
parent d7d3b14a99
commit 7850b7620e
1 changed files with 24 additions and 16 deletions
Download patch file Download diff file Expand all files Collapse all files

40
doc/emacs/text.texi
View file

@ -22,13 +22,17 @@ are also often useful for editing programs.
the file contains ordinary text, use Text mode, which customizes Emacs the file contains ordinary text, use Text mode, which customizes Emacs
in small ways for the syntactic conventions of text. Outline mode in small ways for the syntactic conventions of text. Outline mode
provides special commands for operating on text with an outline provides special commands for operating on text with an outline
structure. Org mode extends Outline mode and turn Emacs into a structure. @xref{Outline Mode}.
full-fledged organizer: you can manage TODO lists, store notes and
publish them in many formats.
@iftex Org mode extends Outline mode and turns Emacs into a full-fledged
@xref{Outline Mode}. organizer: you can manage TODO lists, store notes and publish them in
@end iftex many formats.
@ifinfo
@xref{Top, The Org Manual,,org, The Org Manual}.
@end ifinfo
@ifnotinfo
See the Org Info manual, which is distributed with Emacs.
@end ifnotinfo
@cindex nXML mode @cindex nXML mode
@cindex mode, XML @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 @w{@code{"\f\\|[ in Fundamental mode, @code{paragraph-start} is @w{@code{"\f\\|[
\t]*$"}}, and @code{paragraph-separate} is @w{@code{"[ \t\f]*$"}}. \t]*$"}}, and @code{paragraph-separate} is @w{@code{"[ \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 @node Pages
@section Pages @section Pages
@ -479,8 +489,8 @@ text.
@cindex mode, Auto Fill @cindex mode, Auto Fill
@dfn{Auto Fill} mode is a buffer-local minor mode (@pxref{Minor @dfn{Auto Fill} mode is a buffer-local minor mode (@pxref{Minor
Modes}) in which lines are broken automatically when they become too Modes}) in which lines are broken automatically at spaces when the
wide. Breaking happens only when you type a @key{SPC} or @key{RET}. line becomes too wide.
@table @kbd @table @kbd
@item M-x auto-fill-mode @item M-x auto-fill-mode
@ -492,14 +502,12 @@ In Auto Fill mode, break lines when appropriate.
@findex auto-fill-mode @findex auto-fill-mode
The mode command @kbd{M-x auto-fill-mode} toggles Auto Fill mode in 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 the current buffer. Like any other minor mode, with a positive
Fill mode, and with a negative argument it disables it. If numeric argument, it enables Auto Fill mode, and with a negative
@code{auto-fill-mode} is called from Lisp with an omitted or argument it disables it. To enable Auto Fill mode automatically in
@code{nil} argument, it enables Auto Fill mode. To enable Auto Fill certain major modes, add @code{auto-fill-mode} to the mode hooks
mode automatically in certain major modes, add @code{auto-fill-mode} (@pxref{Major Modes}). When Auto Fill mode is enabled, the mode
to the mode hooks (@pxref{Major Modes}). When Auto Fill mode is indicator @samp{Fill} appears in the mode line (@pxref{Mode Line}).
enabled, the mode indicator @samp{Fill} appears in the mode line
(@pxref{Mode Line}).
Auto Fill mode breaks lines automatically at spaces whenever they Auto Fill mode breaks lines automatically at spaces whenever they
get longer than the desired width. This line breaking occurs only get longer than the desired width. This line breaking occurs only