Date: Fri, 24 Jan 2020 21:56:03 +0300 From: Yuri Pankov <yp@xvoid.org> To: freebsd-hackers@freebsd.org, Ingo Schwarze <schwarze@usta.de> Subject: Re: Long (-- style) options (.Fl) with mdoc(7) Message-ID: <6ab0ed49-0fa4-8028-8f31-a4f4daa5e538@xvoid.org> In-Reply-To: <20200124183132.-nDI2%steffen@sdaoden.eu> References: <20200124144829.49360%steffen@sdaoden.eu> <d07ec64e-5ad1-0960-d14b-a446077ee25b@xvoid.org> <20200124183132.-nDI2%steffen@sdaoden.eu>
next in thread | previous in thread | raw e-mail | index | archive | help
Steffen Nurpmeso wrote: > 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. 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.
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?6ab0ed49-0fa4-8028-8f31-a4f4daa5e538>