[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[groff] 04/09: doc/groff.texi: Define "control" and "text" lines.
From: |
G. Branden Robinson |
Subject: |
[groff] 04/09: doc/groff.texi: Define "control" and "text" lines. |
Date: |
Sun, 24 Jan 2021 01:19:30 -0500 (EST) |
gbranden pushed a commit to branch master
in repository groff.
commit bd033d82884f87621c5cc7a1bec5097885c4f5ff
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sun Jan 24 15:51:30 2021 +1100
doc/groff.texi: Define "control" and "text" lines.
Also make style fixes.
* Move @codequote* commands to mark node "Diversions" as reviewed for
correct grave accent and apostrophe glyph usage.
* Drop superfluous concept index entry.
* Use the more idiomatic noun "adjustment" instead of "adjusting".
* Make minor clarification regarding inter-sentence space placement.
* Fix typo and grammar goof.
---
doc/groff.texi | 24 ++++++++++++++----------
1 file changed, 14 insertions(+), 10 deletions(-)
diff --git a/doc/groff.texi b/doc/groff.texi
index 777d2ad..bbc1fcf 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -787,7 +787,7 @@ the most important operations supported by @code{groff}:
@itemize @bullet
@item
-text filling, adjusting, and centering
+text filling, adjustment, and centering
@item
hyphenation
@@ -4439,7 +4439,7 @@ both sides of the sentence-spacing debate can be found at
@uref{https://web.archive.org@//web@//20171217060354@//http://www.heracliteanriver.com@//?p=324}.}
GNU @code{troff} follows the example of @acronym{AT&T} @code{troff},
attempting to detect the boundaries between sentences, and supplying
-additional inter-sentence space.
+additional inter-sentence space between them.
@Example
Hello, world!
@@ -4727,6 +4727,11 @@ no-break control character. These characters were
chosen because it is
uncommon for lines of text in natural languages to begin with periods or
apostrophes.
+@cindex control line
+Lines beginning with a control character are called @dfn{control lines}.
+@cindex text line
+Every line of input that is not a control line is a @dfn{text line}.
+
GNU @code{troff} requests, combined with its escape sequences, comprise
the control language of the formatter. Of key importance are the
requests that define macros. Macros are invoked like requests, enabling
@@ -4735,7 +4740,6 @@ handling in macros is more flexible but also more complex.
@xref{Request and Macro Arguments}.}
@cindex macro
-@cindex macro, defined
@cindex interpolation
A @dfn{macro} can be thought of as an abbreviation you can define that
is replaced with what it stands for when it is called. In @code{roff}
@@ -4870,7 +4874,7 @@ Macro definitions can be collected into @dfn{macro
files}, @code{roff}
input files designed to produce no output themselves but instead ease
the preparation of other @code{roff} documents. There is no syntactical
difference between a macro file and any other @code{roff} document; only
-its purpose distinguishes it. When a macro file it installed into a
+its purpose distinguishes it. When a macro file is installed into a
standard location and suitable for use by a general audience, it is
often termed a @dfn{macro package}.@footnote{Macro packages frequently
define registers and strings as well.} Macro packages can be loaded by
@@ -13424,9 +13428,6 @@ solution would be to append the above macro to the
macro package's
end-of-input macro using the @code{am} request.
@endDefreq
-@codequotebacktick off
-@codequoteundirected off
-
@c =====================================================================
@@ -13441,9 +13442,9 @@ for such @emph{diversions} as for strings and macros.
Such text is
sometimes said to be ``stored in a macro'', but this coinage obscures
the important distinction between macros and strings on one hand and
diversions on the other; the former store @emph{unformatted} input text,
-and latter captures @emph{formatted} output. Applications of diversions
-include ``keeps'' (preventing a page break from occurring at an
-inconvenient place by forcing a set of output lines to be set as a
+and the latter capture @emph{formatted} output. Applications of
+diversions include ``keeps'' (preventing a page break from occurring at
+an inconvenient place by forcing a set of output lines to be set as a
group), footnotes, tables of contents, and indices.
@cindex top-level diversion
@cindex diversion, top-level
@@ -13738,6 +13739,9 @@ The vertical sizes of lines are not preserved, but
glyph information
be useful in conjunction with the @code{box} and @code{boxa} requests.
@endDefreq
+@codequotebacktick off
+@codequoteundirected off
+
@c =====================================================================
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 04/09: doc/groff.texi: Define "control" and "text" lines.,
G. Branden Robinson <=