[groff] 22/35: groff_man_style(7): Add material.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit e291f7b965f91bfe2fdd8e310d6d49972530be79
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Mon Feb 21 02:19:21 2022 +1100

    groff_man_style(7): Add material.
    
    * tmac/groff_man.7.man.in (Document structure macros) <EX, EE> [style]:
      Add material cautioning writers against asoociating the disablement of
      filling with some sort of "literal mode".  Document still-operational
      status of inter-sentence space supplementation.
    
      (Notes) [style]: Describe an alternative (and macro call-symmetrical)
      means of using `RS` and `RE` with `TP`.
---
 ChangeLog               | 10 ++++++++++
 tmac/groff_man.7.man.in | 50 +++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 60 insertions(+)

diff --git a/ChangeLog b/ChangeLog
index ac12832d..71ba7818 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,13 @@
+2022-02-21  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+       * tmac/groff_man.7.man.in (Document structure macros) <EX, EE>
+       [style]: Add material cautioning writers against asoociating
+       the disablement of filling with some sort of "literal mode".
+       Document still-operational status of inter-sentence space
+       supplementation.
+       (Notes) [style]: Describe an alternative (and macro
+       call-symmetrical) means of using `RS` and `RE` with `TP`.
+
 2022-02-20  G. Branden Robinson <g.branden.robinson@gmail.com>
 
        * doc/doc.am: Add phony targets "man-all" and "man-clean" to
diff --git a/tmac/groff_man.7.man.in b/tmac/groff_man.7.man.in
index da16f0da..bf090c0b 100644
--- a/tmac/groff_man.7.man.in
+++ b/tmac/groff_man.7.man.in
@@ -578,6 +578,38 @@ Example regions are useful for formatting code,
 shell sessions,
 and text file contents.
 .
+An example region is not
+a \(lqliteral mode\(rq
+of any sort:
+special character escape sequences must still be used to produce correct
+glyphs for
+.BR \(aq ,
+.BR \- ,
+.BR \(rs ,
+.BR \(ha ,
+.BR \(ga ,
+and
+.BR \(ti ,
+and sentence endings are still detected and inter-sentence spacing
+applied.
+.
+If a user
+(or one of
+.IR groff 's
+localization support macro files)
+has changed the inter-sentence spacing amount,
+the latter process can change the rendering of,
+for instance,
+regular expressions using
+.B .\&
+or
+.B ?\&
+followed by multiple spaces.
+.
+Use the non-printing input break escape sequence
+.B \(rs&
+before the spaces.
+.
 .
 _endif()dnl
 .IP
@@ -3757,6 +3789,24 @@ See subsection \(lqHorizontal and vertical spacing\(rq 
above for the
 values.
 .
 .
+.IP
+Another approach you can use with tagged paragraphs is to place an
+.B .RS
+call immediately after the paragraph tag;
+this will also force a break regardless of the width of the tag,
+which some authors prefer.
+.
+Follow-up paragraphs under the tag can then be set with
+.B .P
+instead of
+.BR .IP .
+.
+Remember to use
+.B .RE
+to end the indented region before starting the next tagged paragraph
+(at the appropriate nesting level).
+.
+.
 .TP
 .RB \(bu " .RE" " doesn't move the inset back to the expected level."
 .TQ