commit ff46e94c2e1bdc8947dea429775d8686af92f297
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Fri Sep 13 15:20:50 2024 -0500
Commit: Fabian Greffrath <fabian@greffrath.com>
CommitDate: Wed Jul 2 08:24:12 2025 +0200
man/setup.template: Adjust formatting of options
1. Escape hyphens used as option dashes, for ease of copy and paste.[1]
2. Use man(7) font alternation macros instead of *roff font selection
escape sequences. In my opinion, these look cleaner.
3. Set file names in italics, not bold, as suggested in
groff_man_style(7) and for consistency with "default.cfg.template"
and "extra.cfg.template".
There are a few ways to force spacing between font alternation macro
arguments. I selected `\~` because it is generally useful. It is,
however, an extension.
\~ Adjustable non‐breaking space. Use this escape sequence
to prevent a break inside a short phrase or between a
numerical quantity and its corresponding unit(s).
```
Before starting the motor,
set the output speed to\~1.
There are 1,024\~bytes in 1\~KiB.
CSTR\~#8 documents the B\~language.
```
\~ is a GNU extension also supported by Heirloom Doctools
troff 050915 (September 2005), mandoc 1.9.14
(2009‐11‐16), neatroff (commit 1c6ab0f6e, 2016‐09‐13),
and Plan 9 from User Space troff (commit 93f8143600,
2022‐08‐12), but not by Solaris or Documenter’s Workbench
troffs.
[1] brouhaha alert: https://lwn.net/Articles/947941/
---
man/setup.template | 12 ++++++++----
1 file changed, 8 insertions(+), 4 deletions(-)
diff --git a/man/setup.template b/man/setup.template
index e8977c1c..f1ba627b 100644
--- a/man/setup.template
+++ b/man/setup.template
@@ -19,11 +19,15 @@ can also be used to start and join network games.
.PP
.SH OPTIONS
.TP
-\fB-config <file>\fR
-Load configuration from the specified file, instead of @CFGFILE@.
+.BI \-config\~ file
+Load configuration from the specified file,
+instead of
+.IR @CFGFILE@ .
.TP
-\fB-extraconfig <file>\fR
-Load extra configuration from the specified file, instead of @PROGRAM_SPREFIX@\-@GAME@.cfg.
+.BI \-extraconfig\~ file
+Load extra configuration from the specified file,
+instead of
+.IR @PROGRAM_SPREFIX@\-@GAME@.cfg .
.SH SEE ALSO
\fB@PROGRAM_SPREFIX@\-@GAME@\fR(6),
\fBdefault.cfg\fR(5),