[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
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 17/20: groff_diff(7): Drop displayed examples.,
G. Branden Robinson <=