commit ffaf88ad2a5337ba7868db16dd0bfbf7c3bfd39f
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sat Sep 14 10:41:02 2024 -0500
Commit: Fabian Greffrath <fabian@greffrath.com>
CommitDate: Wed Jul 2 08:24:12 2025 +0200
src/*: Fix sentence detection in generated docs
Use two spaces between sentences in C comments destined for inlining
into generated man(7) documents. This way the formatter can tell where
the sentence endings are, which affects how much space it puts between
them. (This amount of space is configurable at formatting time by the
readers of man pages, if man(7) authors accommodate them. Some people
have strong preferences here.)
/usr/share/groff/site-tmac/man.local
Put site‐local changes and customizations into this file.
.\" Put only one space after the end of a sentence.
.ss 12 0 \" See groff(7).
---
src/heretic/d_main.c | 2 +-
src/hexen/h2_main.c | 2 +-
src/i_video.c | 12 ++++++------
src/m_argv.c | 2 +-
src/m_config.c | 4 ++--
5 files changed, 11 insertions(+), 11 deletions(-)
diff --git a/src/heretic/d_main.c b/src/heretic/d_main.c
index e140a745..9f6668c2 100644
--- a/src/heretic/d_main.c
+++ b/src/heretic/d_main.c
@@ -413,7 +413,7 @@ void D_CheckRecordFrom(void)
// @category demo
// @arg <savenum> <demofile>
//
- // Record a demo, loading from the given filename. Equivalent
+ // Record a demo, loading from the given filename. Equivalent
// to -loadgame <savenum> -record <demofile>.
p = M_CheckParmWithArgs("-recordfrom", 2);
diff --git a/src/hexen/h2_main.c b/src/hexen/h2_main.c
index e84ee332..a3a8d004 100644
--- a/src/hexen/h2_main.c
+++ b/src/hexen/h2_main.c
@@ -1186,7 +1186,7 @@ static void CheckRecordFrom(void)
// @category demo
// @arg <savenum> <demofile>
//
- // Record a demo, loading from the given filename. Equivalent
+ // Record a demo, loading from the given filename. Equivalent
// to -loadgame <savenum> -record <demofile>.
//
p = M_CheckParm("-recordfrom");
diff --git a/src/i_video.c b/src/i_video.c
index 45e417c6..e14ce970 100644
--- a/src/i_video.c
+++ b/src/i_video.c
@@ -1008,7 +1008,7 @@ void I_GraphicsCheckCommandLine(void)
// @category video
// @arg <x>
//
- // Specify the screen width, in pixels. Implies -window.
+ // Specify the screen width, in pixels. Implies -window.
//
i = M_CheckParmWithArgs("-width", 1);
@@ -1023,7 +1023,7 @@ void I_GraphicsCheckCommandLine(void)
// @category video
// @arg <y>
//
- // Specify the screen height, in pixels. Implies -window.
+ // Specify the screen height, in pixels. Implies -window.
//
i = M_CheckParmWithArgs("-height", 1);
@@ -1038,7 +1038,7 @@ void I_GraphicsCheckCommandLine(void)
// @category video
// @arg <WxY>
//
- // Specify the dimensions of the window. Implies -window.
+ // Specify the dimensions of the window. Implies -window.
//
i = M_CheckParmWithArgs("-geometry", 1);
@@ -1077,7 +1077,7 @@ void I_GraphicsCheckCommandLine(void)
//!
// @category video
//
- // Don't scale up the screen. Implies -window.
+ // Don't scale up the screen. Implies -window.
//
if (M_CheckParm("-1"))
@@ -1088,7 +1088,7 @@ void I_GraphicsCheckCommandLine(void)
//!
// @category video
//
- // Double up the screen to 2x its normal size. Implies -window.
+ // Double up the screen to 2x its normal size. Implies -window.
//
if (M_CheckParm("-2"))
@@ -1099,7 +1099,7 @@ void I_GraphicsCheckCommandLine(void)
//!
// @category video
//
- // Double up the screen to 3x its normal size. Implies -window.
+ // Double up the screen to 3x its normal size. Implies -window.
//
if (M_CheckParm("-3"))
diff --git a/src/m_argv.c b/src/m_argv.c
index a6be5841..c53578e9 100644
--- a/src/m_argv.c
+++ b/src/m_argv.c
@@ -290,7 +290,7 @@ void M_FindResponseFile(void)
//
// Load extra command line arguments from the given response file.
// Arguments read from the file will be inserted into the command
- // line replacing this argument. A response file can also be loaded
+ // line replacing this argument. A response file can also be loaded
// using the abbreviated syntax '@filename.rsp'.
//
i = M_CheckParmWithArgs("-response", 1);
diff --git a/src/m_config.c b/src/m_config.c
index 0ef35ac8..e1a0260a 100644
--- a/src/m_config.c
+++ b/src/m_config.c
@@ -2726,8 +2726,8 @@ char *M_GetSaveGameDir(const char *iwadname)
//!
// @arg <directory>
//
- // Specify a path from which to load and save games. If the directory
- // does not exist then it will automatically be created.
+ // Specify a path from which to load and save games. If the
+ // directory does not exist then it will automatically be created.
//
p = M_CheckParmWithArgs("-savedir", 1);