From owner-freebsd-hackers@freebsd.org Fri Jan 24 18:31:35 2020 Return-Path: Delivered-To: freebsd-hackers@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id 8CC5C1F7ED9 for ; Fri, 24 Jan 2020 18:31:35 +0000 (UTC) (envelope-from steffen@sdaoden.eu) Received: from sdaoden.eu (sdaoden.eu [217.144.132.164]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) server-signature RSA-PSS (4096 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 48475L1rw2z4NBK for ; Fri, 24 Jan 2020 18:31:34 +0000 (UTC) (envelope-from steffen@sdaoden.eu) Received: by sdaoden.eu (Postfix, from userid 1000) id 82B7816054; Fri, 24 Jan 2020 19:31:32 +0100 (CET) Date: Fri, 24 Jan 2020 19:31:32 +0100 From: Steffen Nurpmeso To: Yuri Pankov Cc: freebsd-hackers@freebsd.org, Ingo Schwarze Subject: Re: Long (-- style) options (.Fl) with mdoc(7) Message-ID: <20200124183132.-nDI2%steffen@sdaoden.eu> In-Reply-To: References: <20200124144829.49360%steffen@sdaoden.eu> Mail-Followup-To: Yuri Pankov , freebsd-hackers@freebsd.org, Ingo Schwarze User-Agent: s-nail v14.9.16-79-g49f65d86-dirty OpenPGP: id=EE19E1C1F2F7054F8D3954D8308964B51883A0DD; url=https://ftp.sdaoden.eu/steffen.asc; preference=signencrypt BlahBlahBlah: Any stupid boy can crush a beetle. But all the professors in the world can make no bugs. X-Rspamd-Queue-Id: 48475L1rw2z4NBK X-Spamd-Bar: / Authentication-Results: mx1.freebsd.org; dkim=none; dmarc=none; spf=pass (mx1.freebsd.org: domain of steffen@sdaoden.eu designates 217.144.132.164 as permitted sender) smtp.mailfrom=steffen@sdaoden.eu X-Spamd-Result: default: False [0.18 / 15.00]; ARC_NA(0.00)[]; NEURAL_HAM_MEDIUM(-0.63)[-0.626,0]; FROM_HAS_DN(0.00)[]; RCPT_COUNT_THREE(0.00)[3]; R_SPF_ALLOW(-0.20)[+a]; NEURAL_HAM_LONG(-0.20)[-0.201,0]; MIME_GOOD(-0.10)[text/plain]; DMARC_NA(0.00)[sdaoden.eu]; TO_DN_SOME(0.00)[]; TO_MATCH_ENVRCPT_SOME(0.00)[]; MID_CONTAINS_FROM(1.00)[]; RCVD_COUNT_ZERO(0.00)[0]; FROM_EQ_ENVFROM(0.00)[]; R_DKIM_NA(0.00)[]; MIME_TRACE(0.00)[0:+]; ASN(0.00)[asn:15987, ipnet:217.144.132.0/24, country:DE]; IP_SCORE(0.30)[asn: 15987(1.53), country: DE(-0.02)] X-BeenThere: freebsd-hackers@freebsd.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Technical Discussions relating to FreeBSD List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 24 Jan 2020 18:31:35 -0000 Yuri Pankov wrote in : |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 --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)