From owner-freebsd-hackers@freebsd.org Tue Jun 9 06:48:30 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 C48ED34B41E for ; Tue, 9 Jun 2020 06:48:30 +0000 (UTC) (envelope-from yuripv@yuripv.dev) Received: from out3-smtp.messagingengine.com (out3-smtp.messagingengine.com [66.111.4.27]) (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 49h10s6mGJz3YFF for ; Tue, 9 Jun 2020 06:48:29 +0000 (UTC) (envelope-from yuripv@yuripv.dev) Received: from compute2.internal (compute2.nyi.internal [10.202.2.42]) by mailout.nyi.internal (Postfix) with ESMTP id 479395C00C6 for ; Tue, 9 Jun 2020 02:48:29 -0400 (EDT) Received: from mailfrontend1 ([10.202.2.162]) by compute2.internal (MEProxy); Tue, 09 Jun 2020 02:48:29 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yuripv.dev; h= subject:to:references:from:message-id:date:mime-version :in-reply-to:content-type:content-transfer-encoding; s=fm1; bh=I 5fRr0HuXlu4Z/xGhRdA1JYOxgwoLf37e6ndttRSp2Q=; b=CkdvklMHPLhdEqmgQ 5UpEf9MqVYT8N3eDZKOqwyIyTZ0auIt0jPT+6s/oR3s6SkxqmWaQiYEE2ATxvNIC W3Xt5qC7JoF0xQHIktwi48aRyGA1/JCG9ziLr8ryWrjxWhl+A/ivmsdq/fgk3ssZ gsN9x/F4jihJjQMAzJ63wvGV2bxnpxAMF+J9pmAt88Jz0xoE3+afkvf0J03cuhrx UXac0BjpZ4VEndxhdeYXWJYhxUh84TR5a+7knJxTy2x1V4Mh2YYJD/IEflE4yoYS NAuG6Tu/jP10cNwQuuPr4JAPAZ6qPMpzaefCLtCrri1dCqSNoFNeuhESTcGrlt/c MNZqw== 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=fm3; bh=I5fRr0HuXlu4Z/xGhRdA1JYOxgwoLf37e6ndttRSp 2Q=; b=fUh4pdtg4XHBJdjtDLlCZXtR2RZitl5Bui9vxbfJjTJ+ozKGzc0uaLWWw 7OffnSnxHUuZBkTvdeqkI1JxfgJfM9vICwwQKRA3KkmS2bTSCE+qWyFKxPzxs/w2 zp0l9Lut4m1GQ7HhApGTP/tkJrBTQgQ9bJLKOt9skSxUxSNvjV1dfceikOn/c6jJ UmGGwSC2YcGJBj1edG3IgDdZxPKFe+fAcI2DEdykz9SM0/huUaSgH0hmlD6TxLx3 AfOIXRlp0MtwLIkFyS/I3naH1OLWQQZtZZVUj7RhiRViyAT2Gc0VopqjPEEtoWjy bQuPONamW7mrl8kA/fC+0XFt94/NQ== X-ME-Sender: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgeduhedrudehfedgudduhecutefuodetggdotefrod ftvfcurfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfgh necuuegrihhlohhuthemuceftddtnecunecujfgurhepuffvfhfhkffffgggjggtgfesth ejredttdefjeenucfhrhhomhepjghurhhiucfrrghnkhhovhcuoeihuhhrihhpvheshihu rhhiphhvrdguvghvqeenucggtffrrghtthgvrhhnpeeikeetfedtfedtkefhffeuleejfe ffgfffffeuhfehgfehjedvgeefheeivedugfenucffohhmrghinhepfhhrvggvsghsugdr ohhrghenucfkphepledurddvgedtrdduvdegrddufeeknecuvehluhhsthgvrhfuihiivg eptdenucfrrghrrghmpehmrghilhhfrhhomhephihurhhiphhvseihuhhrihhpvhdruggv vh X-ME-Proxy: Received: from [192.168.1.6] (unknown [91.240.124.138]) by mail.messagingengine.com (Postfix) with ESMTPA id BF2913280065 for ; Tue, 9 Jun 2020 02:48:28 -0400 (EDT) Subject: Re: svn commit: r361940 - head/usr.bin/mkimg To: freebsd-hackers@freebsd.org References: <202006082111.058LBYfj075205@repo.freebsd.org> <20200608211940.qrR5l%steffen@sdaoden.eu> From: Yuri Pankov Message-ID: Date: Tue, 9 Jun 2020 09:48:26 +0300 User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:68.0) Gecko/20100101 Thunderbird/68.9.0 MIME-Version: 1.0 In-Reply-To: <20200608211940.qrR5l%steffen@sdaoden.eu> Content-Type: text/plain; charset=utf-8; format=flowed Content-Language: en-US Content-Transfer-Encoding: 7bit X-Rspamd-Queue-Id: 49h10s6mGJz3YFF X-Spamd-Bar: +++ Authentication-Results: mx1.freebsd.org; dkim=pass header.d=yuripv.dev header.s=fm1 header.b=CkdvklMH; dkim=pass header.d=messagingengine.com header.s=fm3 header.b=fUh4pdtg; dmarc=none; spf=pass (mx1.freebsd.org: domain of yuripv@yuripv.dev designates 66.111.4.27 as permitted sender) smtp.mailfrom=yuripv@yuripv.dev X-Spamd-Result: default: False [3.25 / 15.00]; RCVD_VIA_SMTP_AUTH(0.00)[]; ARC_NA(0.00)[]; R_DKIM_ALLOW(0.00)[yuripv.dev:s=fm1,messagingengine.com:s=fm3]; FROM_HAS_DN(0.00)[]; SEM_URIBL_FRESH15(3.00)[yuripv.dev:dkim]; TO_MATCH_ENVRCPT_ALL(0.00)[]; R_SPF_ALLOW(0.00)[+ip4:66.111.4.27]; MIME_GOOD(-0.10)[text/plain]; TO_DN_NONE(0.00)[]; PREVIOUSLY_DELIVERED(0.00)[freebsd-hackers@freebsd.org]; NEURAL_SPAM_MEDIUM(0.25)[0.246]; RCPT_COUNT_ONE(0.00)[1]; BAD_REP_POLICIES(0.10)[]; RCVD_COUNT_THREE(0.00)[4]; DMARC_NA(0.00)[yuripv.dev]; DKIM_TRACE(0.00)[yuripv.dev:+,messagingengine.com:+]; NEURAL_SPAM_LONG(0.54)[0.543]; NEURAL_HAM_SHORT(-0.44)[-0.444]; FROM_EQ_ENVFROM(0.00)[]; MIME_TRACE(0.00)[0:+]; RCVD_TLS_LAST(0.00)[]; ASN(0.00)[asn:11403, ipnet:66.111.4.0/24, country:US]; MID_RHS_MATCH_FROM(0.00)[]; RWL_MAILSPIKE_VERYGOOD(0.00)[66.111.4.27:from]; RCVD_IN_DNSWL_LOW(-0.10)[66.111.4.27:from] X-BeenThere: freebsd-hackers@freebsd.org X-Mailman-Version: 2.1.33 Precedence: list List-Id: Technical Discussions relating to FreeBSD List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 09 Jun 2020 06:48:30 -0000 Steffen Nurpmeso wrote: > Hi. > > Mateusz Piotrowski wrote in > <202006082111.058LBYfj075205@repo.freebsd.org>: > |Author: 0mp (doc,ports committer) > |Date: Mon Jun 8 21:11:34 2020 > |New Revision: 361940 > |URL: https://svnweb.freebsd.org/changeset/base/361940 > | > |Log: > | Use Fl instead of Ar for long flags > ... > |-.Ar --formats | --schemes | --version > |+.Fl -formats | Fl -schemes | Fl -version > > Ingo Schwarze of mandoc has in the meanwhile committed support for > ".Fl Fl", which is the term that seems to be most widely used for > long options, for example > > .Fl Fl formats > > It also works just fine for groff, the real roff macros that is. This requires quoting the actual commit message: While we do not recommend the idiom ".Fl Fl long" for long options because it is an abuse of semantic macros for device-specific presentational effects, this idiom is so widespread that it makes sense to convert it to the recommended ".Fl \-long" during the validation phase. For example, this improves HTML formatting in pages where authors have used the dubious .Fl Fl. So, FWIW, while the support for ".Fl Fl" was added, using it is not recommended.