foxygit / doom Log in
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