[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[groff] 03/03: groff_man_style(7): Add § "Fundamental Concepts".
From: |
G. Branden Robinson |
Subject: |
[groff] 03/03: groff_man_style(7): Add § "Fundamental Concepts". |
Date: |
Tue, 3 Jan 2023 00:26:55 -0500 (EST) |
gbranden pushed a commit to branch master
in repository groff.
commit 93497a98073eb4286da76520b3c46f441a567083
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Mon Jan 2 23:13:18 2023 -0600
groff_man_style(7): Add § "Fundamental Concepts".
Define typographical terms the novice man page author needs to know.
---
tmac/groff_man.7.man.in | 54 ++++++++++++++++++++++++++++++++++++-------------
1 file changed, 40 insertions(+), 14 deletions(-)
diff --git a/tmac/groff_man.7.man.in b/tmac/groff_man.7.man.in
index 21a8871e7..ed7a4f7e2 100644
--- a/tmac/groff_man.7.man.in
+++ b/tmac/groff_man.7.man.in
@@ -201,19 +201,6 @@ _ifstyle()dnl
.
.
.\" ====================================================================
-.\" .SS "Fundamental concepts"
-.\" ====================================================================
-.\" TODO: Write an introduction for non-typographers. Cover the
-.\" following:
-.\"
-.\" filling, hyphenation, breaking, adjustment (elsewhere known as
-.\" justification)
-.\" font (family, style [elsewhere known as face])
-.\" type size
-.\" typesetter (troff device, PostScript, PDF)
-.\" terminal (nroff device, emulator, typewriter, TTY)
-.\"
-.\" ====================================================================
.\" .SS "Input file format"
.\" ====================================================================
.P
@@ -231,7 +218,46 @@ and employ the Unix line-ending convention
.\" Don't fill your input text yourself; let groff do the work.
.\" Also good for diffs.
.\" escape sequences--pretty much just "see Portability"
-.\"
+.
+.\" ====================================================================
+.SS "Fundamental concepts"
+.\" ====================================================================
+.\" font (family, style [elsewhere known as face])
+.\" type size
+.\" typesetter (troff device, PostScript, PDF)
+.\" terminal (nroff device, emulator, typewriter, TTY)
+.
+The formatter collects words from the input and
+.I fills
+output lines with as many as will fit.
+.
+A transition to a new output line is called a
+.I break.
+.
+A word may be split across output lines at hyphens,
+at
+.B \e%
+or
+.B \e:
+escape sequences
+(see subsection \(lqPortability\(rq below),
+or at predetermined locations
+if automatic hyphenation is enabled
+(see the
+.B \-rHY
+flag in section \(lqOptions\(rq below).
+.
+An output line may be supplemented with
+.I inter-sentence space
+and
+.I adjusted
+to form a straight right margin
+(see the
+.B \-dAD
+flag in section \(lqOptions\(rq below).
+.
+.MR roff @MAN7EXT@
+details these processes.
.\" ====================================================================
.\" .SS "Why have a tutorial and style guide?"
.\" ====================================================================
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 03/03: groff_man_style(7): Add § "Fundamental Concepts".,
G. Branden Robinson <=