Long (-- style) options (.Fl) with mdoc(7)
Yuri Pankov
yp at xvoid.org
Fri Jan 24 18:56:09 UTC 2020
Steffen Nurpmeso wrote:
> 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.
Note that I don't disagree on using Fl Fl, and quite some of our man
pages already do it, I just want it documented at least somewhere so
it's possible to link to it if there's a question how something should
be done.
More information about the freebsd-hackers
mailing list