groff-commit
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[groff] 17/20: groff_diff(7): Drop displayed examples.


From: G. Branden Robinson
Subject: [groff] 17/20: groff_diff(7): Drop displayed examples.
Date: Wed, 2 Aug 2023 12:46:42 -0400 (EDT)

gbranden pushed a commit to branch master
in repository groff.

commit b330df5b1155f49eea7ba61fab4928ba9d1ce09e
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Wed Aug 2 10:58:45 2023 -0500

    groff_diff(7): Drop displayed examples.
    
    Man pages' honor as references, not tutorials, has been vigorously
    championed on the groff mailing list.  Accordingly, drop displayed
    examples from this page; all are available in groff's Texinfo manual.
---
 man/groff_diff.7.man | 201 ---------------------------------------------------
 1 file changed, 201 deletions(-)

diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index 08045124c..6623f28d7 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -1273,37 +1273,6 @@ The escape sequence
 is also recognized in copy mode and becomes an internal code;
 it is this code that terminates
 .IR anything .
-Thus
-.
-.
-.RS
-.IP
-.EX
-.ne 14v+\n(.Vu
-\&.nr x 1
-\&.nf
-\&.di d
-\&\[rs]?\[rs]\[rs]?\[rs]\[rs]\[rs]\[rs]?\[rs]\[rs]\[rs]\[rs]\[rs]\[rs]\
-\[rs]\c
-\&\[rs]nx\[rs]\[rs]\[rs]\[rs]?\[rs]\[rs]?\[rs]?
-\&.di
-\&.nr x 2
-\&.di e
-\&.d
-\&.di
-\&.nr x 3
-\&.di f
-\&.e
-\&.di
-\&.nr x 4
-\&.f
-.EE
-.RE
-.
-.
-.IP
-prints\~\c
-.BR 4 .
 .
 .
 .TP
@@ -1552,22 +1521,6 @@ the following sets
 to\~1.
 .
 .
-.RS
-.IP
-.EX
-.ne 8v+\n(.Vu
-\&.tr @.
-\&.di x
-\&@nr n 1
-\&.br
-\&.di
-\&.tr @@
-\&.asciify x
-\&.x
-.EE
-.RE
-.
-.
 .IP
 .B asciify
 cannot return all items in a diversion to their source equivalent:
@@ -3557,22 +3510,6 @@ When they do not,
 use substrings and/or catenation.
 .
 .
-.IP
-.RS
-.RS
-.EX
-.B .ds resume R\e[\[aq]e]sum\e[\[aq]e]\e"
-.B \e*[resume]
-.B .stringdown resume
-.B \e*[resume]
-.B .stringup resume
-.B \e*[resume]
-R\['e]sum\['e] r\['e]sum\['e] R\['E]SUM\['E]
-.EE
-.RE
-.RE
-.
-.
 .TP
 .BI .sty\~ n\~s
 Associate abstract
@@ -3606,20 +3543,6 @@ the character before the last has index\~\-2,
 and so on.
 .
 .
-.RS
-.IP
-.EX
-.B .ds xxx abcdefgh
-.B .substring xxx 1 \-4
-.B \e*[xxx]
-bcde
-.B .substring xxx 2
-.B \e*[xxx]
-de
-.EE
-.RE
-.
-.
 .TP
 .BI .tkf\~ f\~s1\~n1\~s2\~n2
 Enable track kerning for font\~\c
@@ -3714,32 +3637,6 @@ request uses the character code
 (if any)
 before the character translation.
 .
-Example:
-.
-.
-.RS
-.IP
-.EX
-\&.trin ax
-\&.di xxx
-\&a
-\&.br
-\&.di
-\&.xxx
-\&.trin aa
-\&.asciify xxx
-\&.xxx
-.EE
-.RE
-.
-.
-.IP
-The result is \[lq]x\~a\[rq].
-.
-Using
-.BR tr ,
-the result would be \[lq]x\~x\[rq].
-.
 .
 .TP
 .BI .trnt\~ abcd
@@ -3748,30 +3645,6 @@ This is the same as the
 request except that the translations do not apply to text that is
 transparently throughput into a diversion with
 .BR \[rs]! .
-For example,
-.
-.
-.RS
-.IP
-.EX
-\&.tr ab
-\&.di x
-\&\[rs]!.tm a
-\&.di
-\&.x
-.EE
-.RE
-.
-.
-.IP
-prints\~\c
-.BR b ;
-if
-.B trnt
-is used instead of
-.B tr
-it prints\~\c
-.BR a .
 .
 .
 .TP
@@ -4133,21 +4006,6 @@ This facility allows the reliable modification of 
requests.
 Using this register outside of a macro definition makes no sense.
 .
 .
-.RS
-.IP
-.ne 6v+\n(.Vu
-.EX
-\&.als bp*orig bp
-\&.de bp
-\&.tm before bp
-\&.ie \[rs]\[rs]n[.br] .bp*orig
-\&.el \[aq]bp*orig
-\&.tm after bp
-\&..
-.EE
-.RE
-.
-.
 .TP
 .B \[rs]n[.C]
 Interpolate 1\~if compatibility mode is in effect,
@@ -4912,17 +4770,6 @@ GNU
 permits tabs and spaces after the first dot on a control line that ends
 a macro definition.
 .
-.RS
-.ne 5v+\n(.Vu
-.EX
-\&.if t \[rs]{\[rs]
-\&.\&  de bar
-\&.\&    nop Hello, I\[aq]m \[aq]bar\[aq].
-\&.\&  .
-\&.\[rs]}
-.EE
-.RS
-.
 .
 .\" ====================================================================
 .SH "Formatter output"
@@ -5721,22 +5568,6 @@ or properties of the environment
 (the rest)
 and therefore do not create output nodes.
 .
-For example,
-this code produces bold output in both cases,
-but the text differs,
-.
-.RS
-.EX
-\&.de xx \[aq]
-Hello!
-\&..
-\&\[rs]fB.xx\[rs]fP
-.EE
-.RE
-.
-formatting \[lq].xx\[rq] normally and \[lq]Hello!\[rq] in compatibility
-mode.
-.
 .
 .P
 GNU
@@ -5969,38 +5800,6 @@ by a macro:
 it does not inherit any of the special properties that the character
 from which it was constructed might have had.
 .
-For example,
-the input
-.
-.br
-.ne 5v
-.RS
-.EX
-\&.di x
-\[rs]\[rs]\[rs]\[rs]
-\&.br
-\&.di
-\&.x
-.EE
-.RE
-.
-produces
-.RB \[lq]\^ \[rs]\[rs] \[rq]
-in GNU
-.IR troff . \" GNU
-Each pair of backslashes becomes one backslash
-.I glyph;
-the resulting backslashes are thus not interpreted as escape
-.I characters
-when they are interpolated as the diversion is output.
-.
-AT&T
-.I troff \" AT&T
-.I would
-interpret them as escape characters when interpolating them and end up
-printing one
-.RB \[lq] \[rs] \[rq].
-.
 .
 .P
 One way to format a backslash in most documents is with the



reply via email to

[Prev in Thread] Current Thread [Next in Thread]