From 2566ddefdf24d54f18ccb6335fa5bb3cfff527c1 Mon Sep 17 00:00:00 2001 From: "G. Branden Robinson" Date: Sat, 2 May 2026 03:44:55 -0500 Subject: [PATCH] doc/*.6: Break input lines at sentence endings ...pacifying a warning from the forthcoming groff 1.25. Fixes: troff:doc/dlb.6:159: warning: end of sentence detected before end of text line [-w style] troff:doc/makedefs.6:53: warning: end of sentence detected before end of text line [-w style] troff:doc/makedefs.6:55: warning: end of sentence detected before end of text line [-w style] troff:doc/makedefs.6:58: warning: end of sentence detected before end of text line [-w style] troff:doc/makedefs.6:153: warning: end of sentence detected before end of text line [-w style] troff:doc/makedefs.6:159: warning: end of sentence detected before end of text line [-w style] troff:doc/makedefs.6:166: warning: end of sentence detected before end of text line [-w style] troff:doc/makedefs.6:222: warning: end of sentence detected before end of text line [-w style] troff:doc/makedefs.6:245: warning: end of sentence detected before end of text line [-w style] troff:doc/makedefs.6:279: warning: end of sentence detected before end of text line [-w style] troff:doc/mnh.7:30: warning: end of sentence detected before end of text line [-w style] troff:doc/nethack.6:225: warning: end of sentence detected before end of text line [-w style] troff:doc/nethack.6:226: warning: end of sentence detected before end of text line [-w style] troff:doc/nethack.6:230: warning: end of sentence detected before end of text line [-w style] troff:doc/nethack.6:234: warning: end of sentence detected before end of text line [-w style] troff:doc/nethack.6:236: warning: end of sentence detected before end of text line [-w style] troff:doc/nethack.6:524: warning: end of sentence detected before end of text line [-w style] troff:doc/nethack.6:577: warning: end of sentence detected before end of text line [-w style] troff:doc/recover.6:155: warning: end of sentence detected before end of text line [-w style] --- doc/dlb.6 | 3 ++- doc/makedefs.6 | 34 ++++++++++++++++++++++------------ doc/mnh.7 | 3 ++- doc/nethack.6 | 21 ++++++++++++++------- doc/recover.6 | 3 ++- 5 files changed, 42 insertions(+), 22 deletions(-) diff --git a/doc/dlb.6 b/doc/dlb.6 index ca01bd8c7..86ce7c6f2 100644 --- a/doc/dlb.6 +++ b/doc/dlb.6 @@ -159,4 +159,5 @@ examining the source is the only way to know which files can be. .ds co \(co .if !\n(.g .if n .ds co (C)\" in principle, should be just "c" This file is Copyright \*(co \*(Na, \*(Nd for version \*(Nb:\*(Nr. -NetHack may be freely redistributed. See license for details. +NetHack may be freely redistributed. +See license for details. diff --git a/doc/makedefs.6 b/doc/makedefs.6 index 1af27082f..260bb3ce5 100644 --- a/doc/makedefs.6 +++ b/doc/makedefs.6 @@ -50,14 +50,18 @@ makedefs \- NetHack miscellaneous build-time functions .B Makedefs is a build-time tool used for a variety of .BR NetHack (6) -source file creation and modification tasks. For historical reasons, +source file creation and modification tasks. +For historical reasons, .B makedefs -takes two types of command lines. When invoked with a short option, the -files operated on are determined when +takes two types of command lines. +When invoked with a short option, +the files operated on are determined when .B makedefs -is compiled. When invoked with a long option, the +is compiled. +When invoked with a long option, +the .B --input -and +and .B --output options are used to specify the files for the .BI -- command. @@ -150,20 +154,23 @@ Show debugging output. .br .TP .B --make \fR[\fIcommand\fR] -Execute a short command. Command is given without preceding dash. -.br +Execute a short command. +.I Command +is given without preceding dash. .TP .BI --input " file" Specify the input .I file -for the command (if needed). If the file is - standard +for the command (if needed). +If the file is - standard input is read. .br .TP .BI --output " file" Specify the output .I file -for the command (if needed). If the file is - standard +for the command (if needed). +If the file is - standard output is written. .br .TP @@ -219,7 +226,8 @@ command (and certain other commands) filter their input, on a line-by-line basis, according to control lines embedded in the input and on information gleaned from the .BR NetHack (6) -configuration. This allows certain changes such as embedding platform-specific +configuration. +This allows certain changes such as embedding platform-specific documentation into the master documentation files. .P Rules: @@ -242,7 +250,8 @@ Conditionals may be nested. will exit with an error code if any errors are detected; processing will continue (if it can) to allow as many errors as possible to be detected. .IP - 4 -Unknown identifiers are treated as both TRUE and as an error. Note that +Unknown identifiers are treated as both TRUE and as an error. +Note that .BR --undef " or " #undef in the .BR NetHack (6) @@ -279,4 +288,5 @@ The NetHack Development Team .ds co \(co .if !\n(.g .if n .ds co (C)\" in principle, should be just "c" This file is Copyright \*(co \*(Na, \*(Nd for version \*(Nb:\*(Nr. -NetHack may be freely redistributed. See license for details. +NetHack may be freely redistributed. +See license for details. diff --git a/doc/mnh.7 b/doc/mnh.7 index 23c684925..dd3b7e7a8 100644 --- a/doc/mnh.7 +++ b/doc/mnh.7 @@ -27,7 +27,8 @@ and .IR troff (1) macro definitions extends .IR tmac.n (7) -for the NetHack Guidebook. This document should be +for the NetHack Guidebook. +This document should be read as an addendum to the documentation for .IR tmac.n . .PP diff --git a/doc/nethack.6 b/doc/nethack.6 index 290d56932..526742958 100644 --- a/doc/nethack.6 +++ b/doc/nethack.6 @@ -222,18 +222,23 @@ Conversely, you must use the appropriate player name to restore a saved game. A .I playername suffix can be used to specify the profession, race, alignment and/or gender -of the character. The full syntax of the playername that includes a -suffix is "name-ppp-rrr-aaa-ggg". "ppp" are at least the first three letters +of the character. +The full syntax of the playername that includes a +suffix is "name-ppp-rrr-aaa-ggg". +"ppp" are at least the first three letters of the profession (this can also be specified using a separate .B \-p .I profession -option). "rrr" are at least the first three letters of the character's +option). +"rrr" are at least the first three letters of the character's race (this can also be specified using a separate .B \-r .I race -option). "aaa" are at least the first three letters of the character's +option). +"aaa" are at least the first three letters of the character's alignment, and "ggg" are at least the first three letters of the -character's gender. Any of the parts of the suffix may be left out. +character's gender. +Any of the parts of the suffix may be left out. .PP .B \-p .I profession @@ -521,7 +526,8 @@ save/ A subdirectory containing saved games. .\"following line should contain \ .br -sysconf System-wide options. Required if +sysconf System-wide options. +Required if .br \ program is built with 'SYSCF' option .br @@ -577,6 +583,7 @@ Probably infinite. .ds co \(co .if !\n(.g .if n .ds co (C)\" in principle, should be just "c" This file is Copyright \*(co \*(Na, \*(Nd for version \*(Nb:\*(Nr. -NetHack may be freely redistributed. See license for details. +NetHack may be freely redistributed. +See license for details. .PP Dungeons & Dragons is a Trademark of Wizards of the Coast, Inc. diff --git a/doc/recover.6 b/doc/recover.6 index 818ee18f1..cf116e09d 100644 --- a/doc/recover.6 +++ b/doc/recover.6 @@ -155,4 +155,5 @@ avoid conflicts. .ds co \(co .if !\n(.g .if n .ds co (C)\" in principle, should be just "c" This file is Copyright \*(co \*(Na, \*(Nd for version \*(Nb:\*(Nr. -NetHack may be freely redistributed. See license for details. +NetHack may be freely redistributed. +See license for details.