commit 51a552f5bc67cf0c2b444414c988367a0c3ff946
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sat Sep 14 10:24:05 2024 -0500
Commit: Fabian Greffrath <fabian@greffrath.com>
CommitDate: Wed Jul 2 08:24:12 2025 +0200
man/setup.template: Improve sentence separation
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/setup.template | 6 +++---
1 file changed, 3 insertions(+), 3 deletions(-)
diff --git a/man/setup.template b/man/setup.template
index 7f6081f4..1fd057c6 100644
--- a/man/setup.template
+++ b/man/setup.template
@@ -11,9 +11,9 @@ designed to behave as similarly to the original @GAME_UPPER@ game as is
possible.
.PP
.I @PROGRAM_SPREFIX@\-@GAME@-setup
-is a tool for configuring @PACKAGE_SHORTNAME@ @GAME_UPPER@. It provides a menu\-based
-interface for the display, joystick, keyboard, mouse, sound and
-compatibility settings.
+is a tool for configuring @PACKAGE_SHORTNAME@ @GAME_UPPER@.
+It provides a menu-based interface for the display, joystick, keyboard,
+mouse, sound and compatibility settings.
.PP
.I @PROGRAM_SPREFIX@\-@GAME@-setup
can also be used to start and join network games.