Long (-- style) options (.Fl) with mdoc(7)
Steffen Nurpmeso
steffen at sdaoden.eu
Fri Jan 24 18:31:35 UTC 2020
Yuri Pankov wrote in <d07ec64e-5ad1-0960-d14b-a446077ee25b at 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 at 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)
More information about the freebsd-hackers
mailing list