[groff] 08/17: groff_diff(7): Drop displayed examples (cont'd).

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 745949339596af3e0ecd9eea2169d0ff3ab9f12c
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Fri Aug 4 11:33:14 2023 -0500

    groff_diff(7): Drop displayed examples (cont'd).
    
    Continues commit b330df5b11, 2 August.
    
    Adjust pagination with poor man's keeps.
---
 man/groff_diff.7.man | 211 ++-------------------------------------------------
 1 file changed, 7 insertions(+), 204 deletions(-)

diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index 77f758481..64a4471cf 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -1751,31 +1751,6 @@ Initially,
 no characters have this property.
 .
 .
-.IP
-For example,
-if you need an automatic break point after
-the en-dash in numeric ranges like \[lq]3000\[en]5000\[rq],
-insert
-.RS
-.RS
-.EX
-\&.cflags 68 \[rs][en]
-.EE
-.RE
-into your document.
-.
-However,
-this can lead to bad layout if done without thinking;
-in most situations,
-a better solution than
-changing the
-.B cflags
-value is inserting
-.RB \[lq] \[rs]: \[rq]
-right after the hyphen at the places that really need a break point.
-.RE
-.
-.
 .P
 The remaining values were implemented for East Asian language support;
 those who use alphabetic scripts exclusively can disregard them.
@@ -1972,15 +1947,6 @@ each
 is a character
 (or special character).
 .
-.RS
-.RS
-.EX
-\&.class [quotes] \[aq] \[rs][aq] \[rs][dq] \[rs][oq] \[rs][cq] \
-\[rs][lq] \[rs][rq]
-.EE
-.RE
-.RE
-.
 .
 .IP
 Since class and special character names share the same name space,
@@ -2027,21 +1993,6 @@ the class definition is skipped.
 Furthermore,
 classes can be nested.
 .
-.RS
-.RS
-.EX
-\&.class [prepunct] , : ; > }
-\&.class [prepunctx] \[rs]C\[aq][prepunct]\[aq] \
-\[rs][u2013]\-\[rs][u2016]
-.EE
-.RE
-The class
-.RB \[lq] [prepunctx] \[rq]
-thus contains the contents of the class
-.RB \[lq] [prepunct] \[rq]
-and characters in the range U+2013\[en]U+2016.
-.RE
-.
 .
 .IP
 If you want to include
@@ -2064,20 +2015,6 @@ the
 .B cflags
 request.
 .
-For example,
-to inhibit line breaks before the characters belonging to the
-.RB \[lq] [prepunctx] \[rq]
-class defined in the previous example,
-you can write the following.
-.
-.RS
-.RS
-.EX
-\&.cflags 2 \[rs]C\[aq][prepunctx]\[aq]
-.EE
-.RE
-.RE
-.
 .
 .TP
 .BI .close\~ stream
@@ -2280,42 +2217,6 @@ or
 requests.
 .
 .
-.IP
-For example,
-.RS
-.RS \" one "extra" RS to get us inboard of this indented paragraph
-.EX
-\&.de mac1
-FOO
-\&..
-\&.de1 mac2
-groff
-\&.mac1
-\&..
-\&.de mac3
-compatibility
-\&.mac1
-\&..
-\&.de ma
-\[rs]\[rs]$1
-\&..
-\&.cp 1
-\&.do mac1
-\&.do mac2 \[rs]" mac2, defined with .de1, calls "mac1"
-\&.do mac3 \[rs]" mac3 calls "ma" with argument "c1"
-\&.do mac3 \[rs][ti] \[rs]" groff syntax accepted in .do arguments
-.EE
-.RE
-results in
-.RS
-.EX
-FOO groff FOO compatibility c1 \[ti]
-.EE
-.RE
-as output.
-.RE \" this "extra" RE avoids indentation of the remaining paragraphs
-.
-.
 .TP
 .BI .ds1\~ "name contents"
 As
@@ -2378,6 +2279,8 @@ the activation status of temporary indentation;
 input traps and their associated data;
 .
 .
+.br
+.ne 4v
 .IP \[bu]
 the activation status of line numbering
 (which can be reactivated with
@@ -2966,20 +2869,8 @@ it is created.
 is read in copy mode.
 .
 .
-.RS
-.IP
-.EX
-.B .ds xxx abcd\eh\[aq]3i\[aq]efgh
-.B .length yyy \e*[xxx]
-.B \en[yyy]
-14
-.EE
-.RE
-.
-.
 .TP
 .BI .linetabs\~ n
-.RS
 If
 .I n
 is non-zero or missing,
@@ -2995,46 +2886,6 @@ line.
 Line-tabs mode is a property of the environment.
 .
 .
-.P
-For example,
-the following
-.
-.
-.RS
-.P
-.ne 6v+\n(.Vu
-.EX
-\&.ds x a\[rs]t\[rs]c
-\&.ds y b\[rs]t\[rs]c
-\&.ds z c
-\&.ta 1i 3i
-\&\[rs]*x
-\&\[rs]*y
-\&\[rs]*z
-.EE
-.RE
-.
-yields
-.
-.RS
-.EX
-a         b         c
-.EE
-.RE
-.
-whereas in line-tabs mode,
-the same input gives
-.
-.RS
-.EX
-a         b                   c
-.EE
-.RE
-.
-instead.
-.RE
-.
-.
 .TP
 .BR .lsm\~ [\c
 .IR name ]
@@ -3608,26 +3459,6 @@ that are invalid as input to GNU
 .IR troff . \" GNU
 .
 .
-.IP
-For example,
-you can define a macro\~\c
-.I x
-containing the contents of file\~\c
-.IR f ,
-using
-.
-.
-.RS
-.IP
-.ne 2v+\n(.Vu
-.EX
-\&.di x
-\&.trf f
-\&.di
-.EE
-.RE
-.
-.
 .TP
 .BI .trin\~ abcd
 This is the same as the
@@ -3660,6 +3491,8 @@ See
 .BR nroff .
 .
 .
+.br
+.ne 5v
 .TP
 .BI .unformat\~ div
 Unformat the diversion
@@ -4605,6 +4438,8 @@ command-line option,
 and 0\~otherwise.
 .
 .
+.br
+.ne 3v
 .P
 A font not listed in the output device's
 .I DESC
@@ -4701,16 +4536,7 @@ a right bracket
 .B ]
 does not end the sequence unless it occurs at the same interpolation
 depth as the
-.RB opening\~ [ ,
-so input like
-.
-.RS
-.EX
-\[rs]f[\[rs]*[my-family]\[rs]*[my-style]]
-.EE
-.RE
-.
-works as desired.
+.RB opening\~ [ .
 .
 In compatibility mode,
 no attention is paid to the interpolation depth.
@@ -5463,29 +5289,6 @@ turns compatibility mode
 .I off
 while it interprets its argument list.
 .
-What you need is:
-.
-.RS
-.EX
-\&.do nr _my_saved_C \[rs]n[.cp]
-\&.cp 0
-.EE
-.RE
-.
-at the beginning of your file,
-followed by
-.RS
-.EX
-\&.cp \[rs]n[_my_saved_C]
-\&.do rr _my_saved_C
-.EE
-.RE
-at the end.
-.
-As in the C language,
-we all have to share one big name space,
-so choose a register name that is unlikely to collide with other uses.
-.
 .
 .P
 The existence of the