From owner-freebsd-hackers@freebsd.org Fri Jan 24 18:56:09 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 BCC331F8DB5 for ; Fri, 24 Jan 2020 18:56:09 +0000 (UTC) (envelope-from yp@xvoid.org) Received: from wnew1-smtp.messagingengine.com (wnew1-smtp.messagingengine.com [64.147.123.26]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 4847dh639Fz4PQl for ; Fri, 24 Jan 2020 18:56:08 +0000 (UTC) (envelope-from yp@xvoid.org) Received: from compute2.internal (compute2.nyi.internal [10.202.2.42]) by mailnew.west.internal (Postfix) with ESMTP id C83AC583; Fri, 24 Jan 2020 13:56:06 -0500 (EST) Received: from mailfrontend2 ([10.202.2.163]) by compute2.internal (MEProxy); Fri, 24 Jan 2020 13:56:06 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=xvoid.org; h= subject:to:references:from:message-id:date:mime-version :in-reply-to:content-type:content-transfer-encoding; s=fm1; bh=0 d31A0935S+GsMzqBlykbV+zMyRcXaZUG+dD8AWb7vw=; b=G4zTP81MXtqDQKiSz gJOXNICEUgv7GU4KU+cejmOOW/gExqja+XRX9yQgbBZ9S1BN9f4qz3E/d+wJPkKG xMXktUfq7Y7TtY9iNwj9ofRdB0rCpvC5uRevtsLEa4I7Losu6dzVf1h9uN38cZSE 04vFaBbweqrf6wXTe5tiqWTpZxTLQmvLbg/nHDZci0IoXuq2DJGTSD21CykFK+T9 hZRbHC+y5O76Z1TDX8SybOT53aZUoCMRTBlZsL1Vl6k4ZAAcbNfezEkCKwZaVGqb pnYKQQoIRehIBAvOmITR/TYlKewBpYEgHTmQk5FDp1BbYSPprKNrdVXLYN4Puh1f oKtPQ== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=content-transfer-encoding:content-type :date:from:in-reply-to:message-id:mime-version:references :subject:to:x-me-proxy:x-me-proxy:x-me-sender:x-me-sender :x-sasl-enc; s=fm1; bh=0d31A0935S+GsMzqBlykbV+zMyRcXaZUG+dD8AWb7 vw=; b=jsHVnFapc1uNtiUiGAuhr8mhtfI6V1j5cVflZeqd+ORqLpZ9rsySWP39W gFXPW5S/bAhL+xlmGIAbClnqgIumXWJ/oxr3awhzkxtf6fJ/v9qbQ06MXUiPF98z Pg3XUjtHi+Zt3LO7l1ye971iTsxkbR9MHH2ck3BhkVvHGtFqM9o/tz3GbYG2gxfM lSoVi6XrPddQ2i3AAVk4CIw0beR90On2IfgTrnkZjV6QIpZnDqgaNjAXz2Il7KM1 2ZwwuwhHQLIpgiV0dS1+v2vaBp0TQxMWD/aETDxWlAmW8ARAKUZDYp4ZOISO+yCs pkiofkBFCyNgRb8xdGzjNZ8HUzETg== X-ME-Sender: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedugedrvdeggdduudejucetufdoteggodetrfdotf fvucfrrhhofhhilhgvmecuhfgrshhtofgrihhlpdfqfgfvpdfurfetoffkrfgpnffqhgen uceurghilhhouhhtmecufedttdenucesvcftvggtihhpihgvnhhtshculddquddttddmne cujfgurhepuffvfhfhkffffgggjggtgfesthejredttdefjeenucfhrhhomhepjghurhhi ucfrrghnkhhovhcuoeihphesgihvohhiugdrohhrgheqnecuffhomhgrihhnpegsshgurd hlvhenucfkphepudejkedrudehhedrgedrkeelnecuvehluhhsthgvrhfuihiivgeptden ucfrrghrrghmpehmrghilhhfrhhomhephihpseigvhhoihgurdhorhhg X-ME-Proxy: Received: from earth.xvoid.org (unknown [178.155.4.89]) by mail.messagingengine.com (Postfix) with ESMTPA id 12EC530617E6; Fri, 24 Jan 2020 13:56:04 -0500 (EST) Subject: Re: Long (-- style) options (.Fl) with mdoc(7) To: freebsd-hackers@freebsd.org, Ingo Schwarze References: <20200124144829.49360%steffen@sdaoden.eu> <20200124183132.-nDI2%steffen@sdaoden.eu> From: Yuri Pankov Message-ID: <6ab0ed49-0fa4-8028-8f31-a4f4daa5e538@xvoid.org> Date: Fri, 24 Jan 2020 21:56:03 +0300 User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:68.0) Gecko/20100101 Thunderbird/68.4.1 MIME-Version: 1.0 In-Reply-To: <20200124183132.-nDI2%steffen@sdaoden.eu> Content-Type: text/plain; charset=utf-8; format=flowed Content-Language: en-US Content-Transfer-Encoding: 7bit X-Rspamd-Queue-Id: 4847dh639Fz4PQl X-Spamd-Bar: ++++ Authentication-Results: mx1.freebsd.org; dkim=pass header.d=xvoid.org header.s=fm1 header.b=G4zTP81M; dkim=pass header.d=messagingengine.com header.s=fm1 header.b=jsHVnFap; dmarc=none; spf=pass (mx1.freebsd.org: domain of yp@xvoid.org designates 64.147.123.26 as permitted sender) smtp.mailfrom=yp@xvoid.org X-Spamd-Result: default: False [4.38 / 15.00]; ARC_NA(0.00)[]; RCVD_VIA_SMTP_AUTH(0.00)[]; R_DKIM_ALLOW(0.00)[xvoid.org:s=fm1,messagingengine.com:s=fm1]; FROM_HAS_DN(0.00)[]; TO_DN_SOME(0.00)[]; R_SPF_ALLOW(0.00)[+ip4:64.147.123.26:c]; RECEIVED_SPAMHAUS_XBL(5.00)[89.4.155.178.khpj7ygk5idzvmvt5x4ziurxhy.zen.dq.spamhaus.net : 127.0.0.4]; MIME_GOOD(-0.10)[text/plain]; RCVD_TLS_LAST(0.00)[]; DMARC_NA(0.00)[xvoid.org]; NEURAL_SPAM_MEDIUM(0.18)[0.177,0]; BAD_REP_POLICIES(0.10)[]; RCVD_COUNT_THREE(0.00)[4]; TO_MATCH_ENVRCPT_SOME(0.00)[]; DKIM_TRACE(0.00)[xvoid.org:+,messagingengine.com:+]; RCPT_COUNT_TWO(0.00)[2]; NEURAL_SPAM_LONG(0.83)[0.831,0]; IP_SCORE(-1.53)[ipnet: 64.147.123.0/24(-4.92), asn: 11403(-2.68), country: US(-0.05)]; RCVD_IN_DNSWL_LOW(-0.10)[26.123.147.64.list.dnswl.org : 127.0.5.1]; FROM_EQ_ENVFROM(0.00)[]; MIME_TRACE(0.00)[0:+]; ASN(0.00)[asn:11403, ipnet:64.147.123.0/24, country:US]; MID_RHS_MATCH_FROM(0.00)[]; RECEIVED_SPAMHAUS_PBL(0.00)[89.4.155.178.khpj7ygk5idzvmvt5x4ziurxhy.zen.dq.spamhaus.net : 127.0.0.11] 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:56:09 -0000 Steffen Nurpmeso wrote: > 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. 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.