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