Trivial manual fixes.

For literal strings, we need to use \- instead of just - as some troff
processors turn plain "-" into "proper" unicode hyphens (as opposed to
hyphen-minus), which breaks copy+paste and searching.

Ensure that .Os follows .Dt in the mdoc prologue as apparently not doing
this results in broken manpage headings with groff 1.23.

diff --git a/doc/cdecl99.1 b/doc/cdecl99.1
index d458380ed42a91ddf4a1d08e35a9009dff4937ff..f93aded448d10ce23f4d8f70bab0034d9ad74fb8 100644 (file)
--- a/doc/cdecl99.1
+++ b/doc/cdecl99.1
@@ -1,6 +1,6 @@
-.Dd March 6, 2021
-.Os cdecl99
+.Dd November 18, 2023
 .Dt CDECL99 \&1 "Cdecl99 User's Manual"
+.Os cdecl99
 .Sh NAME
 .Nm cdecl99
 .Nd Make sense of C declarations
@@ -34,20 +34,20 @@ and will reject many invalid declarations that
 would accept.
 .Sh OPTIONS
 .Bl -tag -width indent
-.It Fl q , -quiet
+.It Fl q , \-quiet
 Suppress the welcome message when starting
 .Nm .
-.It Fl b , -batch
+.It Fl b , \-batch
 Run in batch (non-interactive) mode.
 Execute the commands provided on standard input as usual, but do not print any
 prompts.
 Exit with status 0 if and only if all commands complete successfully.
 .Pp
 This option implies
-.Fl -quiet .
-.It Fl i , -interactive
+.Fl \-quiet .
+.It Fl i , \-interactive
 Run in interactive mode.  This is the default.
-.It Fl e , -execute Ar command
+.It Fl e , \-execute Ar command
 Execute
 .Ar command
 as if it were entered at the prompt, then exit.
@@ -55,23 +55,23 @@ This option can be specified multiple times; all commands are run in the same
 order as specified on the command line.
 .Pp
 This option implies
-.Fl -batch .
-.It Fl f , -file Ar file
+.Fl \-batch .
+.It Fl f , \-file Ar file
 Read commands from
 .Ar file
 instead of standard input.  If both
-.Fl -execute
+.Fl \-execute
 and
-.Fl -file
+.Fl \-file
 are specified, any
-.Fl -file
+.Fl \-file
 option is ignored.
 .Pp
 This option implies
-.Fl -batch .
-.It Fl V , -version
+.Fl \-batch .
+.It Fl V , \-version
 Print a version message and exit.
-.It Fl H , -help
+.It Fl H , \-help
 Print a help message and exit.
 .El
 .Sh COMMANDS
@@ -206,7 +206,7 @@ Thus, f is interpreted as a function which takes an int and returns an int.
 .Sh AUTHORS
 Nick Bowler <nbowler@draconx.ca>
 .Sh COPYRIGHT
-Copyright \(co 2011, 2021 Nick Bowler
+Copyright \(co 2011, 2021, 2023 Nick Bowler
 .Pp
 Permission is granted to copy, distribute and/or modify this manual under the
 terms of the GNU General Public License as published by the Free Software

diff --git a/doc/libcdecl.3 b/doc/libcdecl.3
index 0d17d2b739f368cb964b05c0dca2780ab3d74f3e..022795acb173e5342cb2ed0d2ebbc9ca79e9e09e 100644 (file)
--- a/doc/libcdecl.3
+++ b/doc/libcdecl.3
@@ -1,6 +1,6 @@
-.Dd July 27, 2023
-.Os cdecl99
+.Dd November 18, 2023
 .Dt LIBCDECL \&3 "Cdecl99 Developer's Manual"
+.Os cdecl99
 .Sh NAME
 .Nm libcdecl
 .Nd C library for making sense of C declarations