From 55fd1228fb8e2a8864468ba7c68f827d5cfb36a8 Mon Sep 17 00:00:00 2001 From: kn Date: Sun, 4 Jul 2021 15:58:51 +0000 Subject: [PATCH] .Fl marks up options not arguments POSIX says `-v' is an option, not an argument; options may take arguments, as documented in getopt(3). Programs may take arguments as well, e.g. "prog -v -- arg ...", but these are usually marked up with `.Cm'. Change "The arguments are as follows:" to "The options are as follows:" in `.Fl's DESCRIPTION example to match what most of our base manuals say. OK schwarze jmc --- share/man/man7/mdoc.7 | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/share/man/man7/mdoc.7 b/share/man/man7/mdoc.7 index 8e123bee00a..fcf8271b3f7 100644 --- a/share/man/man7/mdoc.7 +++ b/share/man/man7/mdoc.7 @@ -1,4 +1,4 @@ -.\" $OpenBSD: mdoc.7,v 1.176 2021/05/12 10:59:43 jmc Exp $ +.\" $OpenBSD: mdoc.7,v 1.177 2021/07/04 15:58:51 kn Exp $ .\" .\" Copyright (c) 2009, 2010, 2011 Kristaps Dzonsons .\" Copyright (c) 2010, 2011, 2013-2020 Ingo Schwarze @@ -15,7 +15,7 @@ .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. .\" -.Dd $Mdocdate: May 12 2021 $ +.Dd $Mdocdate: July 4 2021 $ .Dt MDOC 7 .Os .Sh NAME @@ -297,7 +297,7 @@ utility does this, that, and the other. It usually follows with a breakdown of the options (if documenting a command), such as: .Bd -literal -offset indent -The arguments are as follows: +The options are as follows: \&.Bl \-tag \-width Ds \&.It Fl v Print verbose information. -- 2.20.1