From a2143aa79fb92571c6073e955cd28b18cc62ec89 Mon Sep 17 00:00:00 2001 From: Nick Bowler Date: Sat, 18 Nov 2023 23:01:41 -0500 Subject: [PATCH] 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. --- doc/cdecl99.1 | 32 ++++++++++++++++---------------- doc/libcdecl.3 | 4 ++-- 2 files changed, 18 insertions(+), 18 deletions(-) diff --git a/doc/cdecl99.1 b/doc/cdecl99.1 index d458380..f93aded 100644 --- 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 .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 0d17d2b..022795a 100644 --- 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 -- 2.43.2