commit 59780925f3a5d17cf6d9d9ddb4ab92f28beff976
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sat Sep 14 02:37:32 2024 -0500
Commit: Fabian Greffrath <fabian@greffrath.com>
CommitDate: Wed Jul 2 08:24:12 2025 +0200
man/*.template: Parallelize "AUTHORS" sections
Break input lines at sentence endings.
roff(7):
A roff formatter attempts to detect boundaries between sentences,
and supplies additional inter‐sentence space between them. It
flags certain characters (normally “!”, “?”, and “.”) as
potentially ending a sentence. When the formatter encounters one
of these end‐of‐sentence characters at the end of an input line, or
one of them is followed by two (unescaped) spaces on the same input
line, it appends an inter‐word space followed by an inter‐sentence
space in the output. ...
Input conventions
Since troff fills text automatically, it is common practice in the
roff language to avoid visual composition of text in input files:
the esthetic appeal of the formatted output is what matters.
Therefore, roff input should be arranged such that it is easy for
authors and maintainers to compose and develop the document,
understand the syntax of roff requests, macro calls, and
preprocessor languages used, and predict the behavior of the
formatter. Several traditions have accrued in service of these
goals.
• Follow sentence endings in the input with newlines to ease their
recognition. It is frequently convenient to end text lines
after colons and semicolons as well, as these typically precede
independent clauses. Consider doing so after commas; they often
occur in lists that become easy to scan when itemized by line,
or constitute supplements to the sentence that are added,
deleted, or updated to clarify it. Parenthetical and quoted
phrases are also good candidates for placement on text lines by
themselves.
---
man/doom.template | 4 ++--
man/heretic.template | 3 ++-
man/hexen.template | 3 ++-
man/strife.template | 6 +++---
4 files changed, 9 insertions(+), 7 deletions(-)
diff --git a/man/doom.template b/man/doom.template
index f7ab80e8..bbf1c62a 100644
--- a/man/doom.template
+++ b/man/doom.template
@@ -34,8 +34,8 @@ See \fB@PROGRAM_SPREFIX@\-doom.cfg\fR(5).
\fB@PROGRAM_SPREFIX@\-hexen\fR(6),
\fB@PROGRAM_SPREFIX@\-strife\fR(6)
.SH AUTHOR
-Chocolate Doom is written and maintained by Simon Howard. It is based on
-the LinuxDoom source code, released by Id Software.
+Chocolate Doom is written and maintained by Simon Howard.
+It is based on the LinuxDoom source code, released by Id Software.
.SH COPYRIGHT
Copyright \(co id Software Inc.
Copyright \(co 2005-2016 Simon Howard.
diff --git a/man/heretic.template b/man/heretic.template
index 71098822..394af610 100644
--- a/man/heretic.template
+++ b/man/heretic.template
@@ -34,7 +34,8 @@ See \fB@PROGRAM_SPREFIX@\-heretic.cfg\fR(5).
\fB@PROGRAM_SPREFIX@\-setup\fR(6)
.SH AUTHOR
Chocolate Heretic is part of the Chocolate Doom project, written and
-maintained by Simon Howard. It is based on the Heretic source code,
+maintained by Simon Howard.
+It is based on the Heretic source code,
released by Raven Software.
.SH COPYRIGHT
Copyright \(co id Software Inc.
diff --git a/man/hexen.template b/man/hexen.template
index dc35715e..22e900f0 100644
--- a/man/hexen.template
+++ b/man/hexen.template
@@ -34,7 +34,8 @@ See \fB@PROGRAM_SPREFIX@\-hexen.cfg\fR(5).
\fB@PROGRAM_SPREFIX@\-setup\fR(6)
.SH AUTHOR
Chocolate Hexen is part of the Chocolate Doom project, written and
-maintained by Simon Howard. It is based on the Hexen source code,
+maintained by Simon Howard.
+It is based on the Hexen source code,
released by Raven Software.
.SH COPYRIGHT
Copyright \(co id Software Inc.
diff --git a/man/strife.template b/man/strife.template
index f1a2bb83..75ca91b4 100644
--- a/man/strife.template
+++ b/man/strife.template
@@ -67,9 +67,9 @@ case, @PACKAGE_SHORTNAME@ Strife has erred on the side of not crashing the progr
for example by initializing pointers to NULL rather than using them without
setting a value first.
.SH AUTHORS
-Chocolate Strife is part of the Chocolate Doom project. It was reverse
-engineered from the DOS versions of Strife by James Haley and Samuel
-Villarreal.
+Chocolate Strife is part of the Chocolate Doom project.
+It was reverse engineered from the DOS versions of Strife by James Haley
+and Samuel Villarreal.
Chocolate Doom was written and maintained by Simon Howard, and is based
on the LinuxDoom source code released by Id Software.
.SH COPYRIGHT