From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-pl1-f170.google.com (mail-pl1-f170.google.com [209.85.214.170]) by fantadrom.bsd.lv (OpenSMTPD) with ESMTP id d40153c0 for ; Sun, 21 Apr 2019 11:32:37 -0500 (EST) Received: by mail-pl1-f170.google.com with SMTP id t16so4727160plo.0 for ; Sun, 21 Apr 2019 09:32:37 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=cathet-us.20150623.gappssmtp.com; s=20150623; h=sender:from:to:cc:subject:in-reply-to:references:comments :mime-version:content-id:date:message-id; bh=9+rQ3SHhug7gUO+MRcF0xwHyytuALiikG/QlJG8UDpw=; b=gxtvthptBE1JpjBLIRzuftovkHIemdLaUHy4kkeABX9WRxzd2591Eakbu8t2U20GRp VaYECzNV6b0VYNExbzdvS3o6PFKJndvVmc5u1Lu2bAvawxF1JD+gL2wcbP2e3eEu9ASi QA36O8OreQ+Co/5XEFxuFg/+ELstx7Yi6/hSXzmViFW/boBAOr+/nAQ2lK7cI5CI3PSD Iuarpf2jw5GV/yWwmAGkiUYujXDihOCUteQeFHTB2N4tvIeM3OnvkH+i64d+T9o/TPdc hx/bh6FQkm38AA21e55lxH6EMGshEh4Bslgy1voEo19w2WrQNiF6qIJulmBaNKnL6PNh GgZQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:sender:from:to:cc:subject:in-reply-to:references :comments:mime-version:content-id:date:message-id; bh=9+rQ3SHhug7gUO+MRcF0xwHyytuALiikG/QlJG8UDpw=; b=i0gY6qA/O1ikuR/Yb6QvXyVvZS/fsw5eihTsxllG4v5TubVic7+oNdBWK3LYJThZyT fpsCin1QMJupvxgwkOGtCHAgda/KXWrhZpZef84vVUBDVjYZ8u/DH0S2Ahe2Emi3EYEe vGjusIKV0xmAx1m/gXM4cJVdnFhAy+75PK24iSAiEiKiv5pVcyGa0x/ct5pxSncaL01K jwYF7BN90hRE+MhyROTMWiCfEywcPIPh/pVyxe12AvitY+MjPeyrpUl8oidxGHYDaTiV ReEPl40/ulLUMzo/kWojXvz/v0DBCJ3VLu4tgYo/8uP9rwEWxBbpeIRBKWX9tvX/uR1i yVyQ== X-Gm-Message-State: APjAAAWqeO44X+17bi00Wx8Me5qhCTb3nO18RXDoJZaCjYH6IuV5rMBZ kfaHQJm9vdotw5wvHhZVcecD7g== X-Google-Smtp-Source: APXvYqweGmDDkZBtkNlGENElkfUpJELhLyDx6mmV4ZG3k+LKp3nCVk8ToJZ11S2WPWAnK4EWzlyu8g== X-Received: by 2002:a17:902:e281:: with SMTP id cf1mr15677589plb.13.1555864355572; Sun, 21 Apr 2019 09:32:35 -0700 (PDT) Received: from desktop.ajb.soy (67-0-35-139.albq.qwest.net. [67.0.35.139]) by smtp.gmail.com with ESMTPSA id a9sm13705745pfo.17.2019.04.21.09.32.34 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Sun, 21 Apr 2019 09:32:34 -0700 (PDT) Sender: "Anthony J. Bentley" Received: from desktop.ajb.soy (localhost [127.0.0.1]) by desktop.ajb.soy (OpenSMTPD) with ESMTP id 5f5ae6dd; Sun, 21 Apr 2019 10:32:33 -0600 (MDT) From: "Anthony J. Bentley" To: Ingo Schwarze cc: Jan Stary , discuss@mandoc.bsd.lv Subject: Re: hyphen-minus, was: docbook2mdoc-1.0.0 released In-reply-to: <20190421123257.GA31325@athene.usta.de> References: <20190417192435.GA10272@athene.usta.de> <20190420190331.GA36463@www.stare.cz> <74092.1555800985@desktop.ajb.soy> <20190421123257.GA31325@athene.usta.de> Comments: In-reply-to Ingo Schwarze message dated "Sun, 21 Apr 2019 14:32:57 +0200." X-Mailinglist: mandoc-discuss Reply-To: discuss@mandoc.bsd.lv MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-ID: <32419.1555864352.1@desktop.ajb.soy> Date: Sun, 21 Apr 2019 10:32:32 -0600 Message-ID: <7061.1555864352@desktop.ajb.soy> Hi Ingo, Ingo Schwarze writes: > 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. I remember that conclusion, but I simply don't agree with the prescriptivism in this particular case. > 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). "Fl abcd" could mean an option called "abcd" as in xterm(1) or "-a -b -c -d" as in normal getopt usage. I don't see how "Fl Fl may be considered to collapse into a single option" is inherently worse than that, especially as the pattern is seen in real-world manpages. > > 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... I am quite sure I've mentioned this before in our voluminous discussion on this subject... hopefully we can avoid re-litigating it, since I hate the topic as much as you do! > > 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 > $ Try "man openrsync", then ":tversion". That's what I was referring to. -- Anthony J. Bentley -- To unsubscribe send an email to discuss+unsubscribe@mandoc.bsd.lv