From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from scc-mailout-kit-02.scc.kit.edu (scc-mailout-kit-02.scc.kit.edu [129.13.231.82]) by fantadrom.bsd.lv (OpenSMTPD) with ESMTP id f867348c for ; Sun, 21 Apr 2019 07:33:00 -0500 (EST) Received: from asta-nat.asta.uni-karlsruhe.de ([172.22.63.82] helo=hekate.usta.de) by scc-mailout-kit-02.scc.kit.edu with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (envelope-from ) id 1hIBeU-0003hK-RW; Sun, 21 Apr 2019 14:32:59 +0200 Received: from donnerwolke.usta.de ([172.24.96.3]) by hekate.usta.de with esmtp (Exim 4.77) (envelope-from ) id 1hIBeT-0007Wl-OC; Sun, 21 Apr 2019 14:32:57 +0200 Received: from athene.usta.de ([172.24.96.10]) by donnerwolke.usta.de with esmtp (Exim 4.84_2) (envelope-from ) id 1hIBeT-0002CA-KA; Sun, 21 Apr 2019 14:32:57 +0200 Received: from localhost (athene.usta.de [local]) by athene.usta.de (OpenSMTPD) with ESMTPA id b0734e04; Sun, 21 Apr 2019 14:32:57 +0200 (CEST) Date: Sun, 21 Apr 2019 14:32:57 +0200 From: Ingo Schwarze To: "Anthony J. Bentley" , Jan Stary Cc: discuss@mandoc.bsd.lv Subject: hyphen-minus, was: docbook2mdoc-1.0.0 released Message-ID: <20190421123257.GA31325@athene.usta.de> References: <20190417192435.GA10272@athene.usta.de> <20190420190331.GA36463@www.stare.cz> <74092.1555800985@desktop.ajb.soy> X-Mailinglist: mandoc-discuss Reply-To: discuss@mandoc.bsd.lv MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <74092.1555800985@desktop.ajb.soy> User-Agent: Mutt/1.8.0 (2017-02-23) Hi Jan & Anthony, Anthony J. Bentley wrote on Sat, Apr 20, 2019 at 04:56:25PM -0600: > Jan Stary writes: >> BTW, is "Fl -option" the preferred way to handle --long-options? Yes. > I've seen "Fl -option" and "Fl Fl option" about equally. > Personally I prefer Fl Fl, We did that for some time, but generally stopped doing so because even though the printed output looks correct, it is logically misleading. There is only a single option here, not two, and .Fl without an argument means the special option "-", as it occurs for example in lprm(1) and tset(1). http://mandoc.bsd.lv/mdoc/style/options.html (note that already recommends .Fl -option even though it was last updated more than two years ago) > because in some groff outputs "Fl -option" prints > the first and second - as visibly different characters. Oh wow. All the discussion we recently had about whether to recommend "\-" or "-" as input for desired HYPHEN-MINUS output was based on the assumption that groff contained, for the man(7) and mdoc(7) macros, a mapping of '-' to \N'45'. It does indeed for UTF-8. But for PostScript and HTML, '-' actually comes out as a hyphen from groff, even for manual pages... How could we possibly miss that after years of delimberation? I'm so tired of this matter... > Fl Fl also means that mandoc's tagging support lets me search > for "option" instead of "-option", and that feels more natural to me. That works either way: $ grep version `man -w openrsync` .Op Fl -version .It Fl -version Print version and exit. protocol version is older than the local protocol version. is compatible with rsync protocol version 27 $ man -k Fl=version | grep rsync openrsync(1) - synchronise local and remote files $ man -k Fl~version | grep rsync openrsync(1) - synchronise local and remote files You would have to go out of your way to not make it work: $ man -k Fl~^version | grep rsync $ Yours, Ingo -- To unsubscribe send an email to discuss+unsubscribe@mandoc.bsd.lv