[groff] 08/08: groff(7): Update space and newline descriptions.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 9a39832ccd6542b769921303bebd371e79dcda9b
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Wed Mar 24 17:29:15 2021 +1100

    groff(7): Update space and newline descriptions.
    
    * man/groff.7.man (Control Characters) <space>: Clarify context of when
      spaces separate arguments--when requests, macros, and strings are
      dereferenced, not when they're defined.  Discuss end-of-sentence
      detection before filling and adjustment for clarity, since the first
      always happens and the last two can be disabled.  Clarify that
      inter-word space expansion only occurs when adjustment is both enabled
      and set to both-margins mode.
      <newline>: Describe in its own terms instead of in terms of the space.
      Mention what the \c escape is for.  (It's much less mysterious to me
      now than it was four years ago.)
    
      Break input lines at commas and around multi-word parentheticals.
    
      Use two empty requests where vertical space is expected.
---
 man/groff.7.man | 28 +++++++++++++++++++---------
 1 file changed, 19 insertions(+), 9 deletions(-)

diff --git a/man/groff.7.man b/man/groff.7.man
index ded4c3b..7c2df5c 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -687,17 +687,17 @@ it terminates a long escape name or long escape argument.
 .
 Otherwise, it is non-special.
 .
+.
 .TP
 \f[CI]space\f[]
-Space characters separate arguments in requests, macros, and strings.
-.
-In text, they separate words.
+Space characters separate arguments in request invocations,
+macro calls,
+and string interpolations.
 .
-When filling is enabled
-(the default),
-a line may be broken at a space.
+In text,
+they separate words.
 .
-Multiple adjacent space characters cause
+Multiple adjacent space characters in text cause
 .I groff
 to attempt end-of-sentence detection on the preceding word
 (and trailing punctuation).
@@ -706,7 +706,12 @@ The amount of space between words and sentences is 
controlled by the
 .request .ss
 request.
 .
-When adjustment is enabled,
+When filling is enabled
+(the default),
+a line may be broken at a space.
+.
+When adjustment is enabled and set to both margins
+(the default),
 inter-word spaces may be expanded to justify the line.
 .
 To get a space of definite width,
@@ -723,10 +728,15 @@ see section \[lq]Escape Sequences\[rq] below.
 An adjustable but non-breaking space is available with
 .esc \[ti] .
 .
+.
 .IP \f[CI]newline\f[]
-In text, newlines behave like space characters and trigger
+In text,
+a newline puts an inter-word space onto the output and triggers
 end-of-sentence recognition on the preceding text.
 .
+.esc c
+at the end of an input line suppresses these functions.
+.
 Continuation lines can be specified by an escaped newline, i.e., by
 specifying a backslash
 .squoted_char \[rs]