foxygit / doom Log in
commit 3c044b85ac2007d009ba000e9cec5829f7493717
Author:     G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Fri Sep 13 15:06:30 2024 -0500
Commit:     Fabian Greffrath <fabian@greffrath.com>
CommitDate: Wed Jul 2 08:24:12 2025 +0200

    man/*.template: Tweak synopsis style.

    Use man(7) font alternation macros instead of *roff font selection
    escape sequences.  Stop shouting the "OPTIONS" metasyntactic variable
    name; this is sometimes the custom of usage messages (where formatting
    in multiple typefaces, even bold, is impractical), but not of man pages.

    groff_man_style(7):
         Unlike the above font style macros, the font style alternation
         macros below set no input traps; they must be given arguments to
         have effect.  They apply italic corrections as appropriate.
    ...
         .RI roman‐text italic‐text ...
                Set each argument in roman and italics, alternately.

                       .RI ( tpic
                       was a fork of AT&T
                       .I pic
                       by Tim Morgan of the University of California at Irvine
---
 man/doom.template    | 2 +-
 man/heretic.template | 2 +-
 man/hexen.template   | 2 +-
 man/server.template  | 2 +-
 man/setup.template   | 2 +-
 man/strife.template  | 2 +-
 6 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/man/doom.template b/man/doom.template
index 787ff96a..0450ec19 100644
--- a/man/doom.template
+++ b/man/doom.template
@@ -3,7 +3,7 @@
 @PROGRAM_SPREFIX@\-doom \- historically compatible Doom engine
 .SH SYNOPSIS
 .B @PROGRAM_SPREFIX@\-doom
-[\fIOPTIONS\fR]
+.RI [ options ]
 .SH DESCRIPTION
 .PP
 @PACKAGE_SHORTNAME@ Doom is a port of Id Software's 1993 game "Doom" that is designed
diff --git a/man/heretic.template b/man/heretic.template
index a928fa2d..96153856 100644
--- a/man/heretic.template
+++ b/man/heretic.template
@@ -3,7 +3,7 @@
 @PROGRAM_SPREFIX@\-heretic \- historically compatible Heretic engine
 .SH SYNOPSIS
 .B @PROGRAM_SPREFIX@\-heretic
-[\fIOPTIONS\fR]
+.RI [ options ]
 .SH DESCRIPTION
 .PP
 @PACKAGE_SHORTNAME@ Heretic is a port of Raven Software's 1994 game "Heretic" that
diff --git a/man/hexen.template b/man/hexen.template
index b0a32b0a..6540c0d1 100644
--- a/man/hexen.template
+++ b/man/hexen.template
@@ -3,7 +3,7 @@
 @PROGRAM_SPREFIX@\-hexen \- historically compatible Hexen engine
 .SH SYNOPSIS
 .B @PROGRAM_SPREFIX@\-hexen
-[\fIOPTIONS\fR]
+.RI [ options ]
 .SH DESCRIPTION
 .PP
 @PACKAGE_SHORTNAME@ Hexen is a port of Raven Software's 1995 game "Hexen" that
diff --git a/man/server.template b/man/server.template
index 33226154..6bdbf627 100644
--- a/man/server.template
+++ b/man/server.template
@@ -3,7 +3,7 @@
 @PROGRAM_SPREFIX@\-server \- dedicated server for @PROGRAM_SPREFIX@\-doom
 .SH SYNOPSIS
 .B @PROGRAM_SPREFIX@\-server
-[OPTIONS]
+.RI [ options ]
 .SH DESCRIPTION
 .PP
 @PACKAGE_NAME@ is a modern doom engine designed to behave
diff --git a/man/setup.template b/man/setup.template
index e28e310e..e8977c1c 100644
--- a/man/setup.template
+++ b/man/setup.template
@@ -3,7 +3,7 @@
 @PROGRAM_SPREFIX@\-@GAME@-setup \- configuration tool for @PROGRAM_SPREFIX@\-@GAME@
 .SH SYNOPSIS
 .B @PROGRAM_SPREFIX@\-@GAME@-setup
-[OPTIONS]
+.RI [ options ]
 .SH DESCRIPTION
 .PP
 @PACKAGE_SHORTNAME@ @GAME_UPPER@ is a modern @GAME_UPPER@ engine designed to behave
diff --git a/man/strife.template b/man/strife.template
index 4e329bd4..0441d471 100644
--- a/man/strife.template
+++ b/man/strife.template
@@ -3,7 +3,7 @@
 @PROGRAM_SPREFIX@\-strife \- historically compatible Strife engine
 .SH SYNOPSIS
 .B @PROGRAM_SPREFIX@\-strife
-[\fIOPTIONS\fR]
+.RI [ options ]
 .SH DESCRIPTION
 .PP
 @PACKAGE_SHORTNAME@ Strife is an accurate and complete recreation of Rogue