Skip site navigation (1)Skip section navigation (2)
Date:      Fri, 24 Jan 2020 19:31:32 +0100
From:      Steffen Nurpmeso <steffen@sdaoden.eu>
To:        Yuri Pankov <yp@xvoid.org>
Cc:        freebsd-hackers@freebsd.org, Ingo Schwarze <schwarze@usta.de>
Subject:   Re: Long (-- style) options (.Fl) with mdoc(7)
Message-ID:  <20200124183132.-nDI2%steffen@sdaoden.eu>
In-Reply-To: <d07ec64e-5ad1-0960-d14b-a446077ee25b@xvoid.org>
References:  <20200124144829.49360%steffen@sdaoden.eu> <d07ec64e-5ad1-0960-d14b-a446077ee25b@xvoid.org>

next in thread | previous in thread | raw e-mail | index | archive | help
Yuri Pankov wrote in <d07ec64e-5ad1-0960-d14b-a446077ee25b@xvoid.org>:
 |Steffen Nurpmeso wrote:
 |> The very moment i have seen a showmount(8) change fly by, and
 |> wanted to make you aware of the persuading approach that NetBSD's
 |> wizd(8) uses, namely ".Fl Fl long-option".  Different to ".Fl
 |> -long-option" this produces visually appealing results on all
 |> output devices.
 |
 |mandoc style guide advises differently:
 |
 |https://mandoc.bsd.lv/mdoc/style/options.html
 |
 |It's not authoritative, of course, but I'm not aware of any other mdoc 
 |style guide.  May be you could take it up to style guide/mandoc authors?

I can Cc: him.  That is _he_, who is totally opposed against long-
options, isn't he?
Whatever this guide says, if you do Postscript/PDF output (with
groff) then Fl becomes a nice dash, whereas the other thing is
a hyphen-minus.  I am using Fl Fl ever since i saw wizd(8)'s
comment, tried it, and was satisfied by the results.  Despite that
Fl Fl is ugly but logically deducable, too.

 --End of <d07ec64e-5ad1-0960-d14b-a446077ee25b@xvoid.org>

--steffen
|
|Der Kragenbaer,                The moon bear,
|der holt sich munter           he cheerfully and one by one
|einen nach dem anderen runter  wa.ks himself off
|(By Robert Gernhardt)



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20200124183132.-nDI2%steffen>