From owner-freebsd-hackers@freebsd.org Tue Jun 9 18:28:27 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 5D3B33388F2 for ; Tue, 9 Jun 2020 18:28:27 +0000 (UTC) (envelope-from ian@freebsd.org) Received: from outbound2k.ore.mailhop.org (outbound2k.ore.mailhop.org [54.148.219.64]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 49hJXV6KSbz4Kbf for ; Tue, 9 Jun 2020 18:28:26 +0000 (UTC) (envelope-from ian@freebsd.org) ARC-Seal: i=1; a=rsa-sha256; t=1591727305; cv=none; d=outbound.mailhop.org; s=arc-outbound20181012; b=PZmuwgABkVxnPm+9P378Onk1ybfqLgOPVyaXREeQL/4BZzOLiwKJbpY9MfEbOsBc2gykvwzGqrv10 TrWyjbmdPPuloU3KDNAIva2PV6F43WcicoAglQbuUPBvQzLwMCTS6buKFGUTNDRJP/Gy9eIFnIHImR RYUG9z+OvLblBCLuSSG3hDiUqTCa7a5GbABKOo9l8Rx34j5XVpAIf37Z2WA1+Gb8OaBJUtPgMgV2u3 EC/283Qt74fg45L0NF6a0GSfZQqgqJogKV+AizXKRsIpR74pq/LJzcklHbMgS0FhT0UIjoKnEpDgB8 BGtU82rVgH4pHsrB2JS7UWxBac/3Gnw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=outbound.mailhop.org; s=arc-outbound20181012; h=content-transfer-encoding:mime-version:content-type:references:in-reply-to: date:cc:to:from:subject:message-id:dkim-signature:from; bh=U0LLJqk/68Ub/l6WZNDSf7fikAC95LLr5WwbGr2h9ds=; b=snXs2efOmoR6exf0Ys/7bRwTrCetXq9/1wnruGodwvBit8z0HkYd9aibmqfUTaaU9Y5dDVA52RI8b mOXjgS0tWdCaGUHp36J/K5j2Reb7cOWOsXMlGeNKGy+gqlUzigovlmiMpL9gh0IHDyauDPjyuKckac AwimM6YTmo61rrvfmZW1LDgST8/FPZqFNnJyIOaCgJaPsBIhRloWYWyZsl84c77ICE08xA4sEGozBe m5uHFQUrpn6uWQlNx+fKI4KwrTxIYiwT2hCgBLvKabuXSof3Wfkt3Y8bxyMld877dHtzJ3xx8pVD2D cLZsHLMj6gcZ6g4KqvYoLJGTX+HK3KA== ARC-Authentication-Results: i=1; outbound4.ore.mailhop.org; spf=softfail smtp.mailfrom=freebsd.org smtp.remote-ip=67.177.211.60; dmarc=none header.from=freebsd.org; arc=none header.oldest-pass=0; DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=outbound.mailhop.org; s=dkim-high; h=content-transfer-encoding:mime-version:content-type:references:in-reply-to: date:cc:to:from:subject:message-id:from; bh=U0LLJqk/68Ub/l6WZNDSf7fikAC95LLr5WwbGr2h9ds=; b=LKxPpgNEIW5d6Na/f3C6bCo8QBmSoupGX7GPDk5XVRzkHdJNorBM2LHWgeMRz+Xq2NSfj4BKGyQiC 6eSR4/Vhyyfcw1VT1Jk0FZF9YTKgmNCQPbtUIFlfm4IqWpeGk9YVvBxhSrz9u34TMoUL64tFp1jcc/ iSqjiZ5b3LeyLiCqF+XZaFcQTxdOSJkMh4s1VaNKmYRMTbAGz8+seJlpa6vyfa1EKzWOATu9yLzoNB SbC8hFCooEJNFRAdkwIdSPqlCsCdOlYOgp4R8WqZkE69EafOCKk4+BAI8kX1TXLOfWuDOvPIxpguPZ OZEl1ylw2qBDDViTsWkIyJ0QUHvdHOw== X-MHO-RoutePath: aGlwcGll X-MHO-User: ffcf2bde-aa7e-11ea-a067-6d02e42e573a X-Report-Abuse-To: https://support.duocircle.com/support/solutions/articles/5000540958-duocircle-standard-smtp-abuse-information X-Originating-IP: 67.177.211.60 X-Mail-Handler: DuoCircle Outbound SMTP Received: from ilsoft.org (c-67-177-211-60.hsd1.co.comcast.net [67.177.211.60]) by outbound4.ore.mailhop.org (Halon) with ESMTPSA id ffcf2bde-aa7e-11ea-a067-6d02e42e573a; Tue, 09 Jun 2020 18:28:24 +0000 (UTC) Received: from rev (rev [172.22.42.240]) by ilsoft.org (8.15.2/8.15.2) with ESMTP id 059ISLwd095919; Tue, 9 Jun 2020 12:28:21 -0600 (MDT) (envelope-from ian@freebsd.org) Message-ID: <1743df590639dc61b2b4216c81677851d2ee1312.camel@freebsd.org> Subject: Re: svn commit: r361940 - head/usr.bin/mkimg From: Ian Lepore To: Steffen Nurpmeso , Yuri Pankov Cc: freebsd-hackers@freebsd.org Date: Tue, 09 Jun 2020 12:28:21 -0600 In-Reply-To: <20200609141319.u7QUq%steffen@sdaoden.eu> References: <202006082111.058LBYfj075205@repo.freebsd.org> <20200608211940.qrR5l%steffen@sdaoden.eu> <20200609141319.u7QUq%steffen@sdaoden.eu> Content-Type: text/plain; charset="ASCII" X-Mailer: Evolution 3.28.5 FreeBSD GNOME Team Mime-Version: 1.0 Content-Transfer-Encoding: 7bit X-Rspamd-Queue-Id: 49hJXV6KSbz4Kbf X-Spamd-Bar: / Authentication-Results: mx1.freebsd.org; none X-Spamd-Result: default: False [0.00 / 15.00]; ASN(0.00)[asn:16509, ipnet:54.148.0.0/15, country:US]; local_wl_from(0.00)[freebsd.org] 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 18:28:27 -0000 On Tue, 2020-06-09 at 16:13 +0200, Steffen Nurpmeso wrote: > I for one think Fl Fl is absolutely valid, where is the problem? > If you go that route that Ingo (it is Ingo) brings into the world > here (which counteracts many, many real-life manuals), then just > reach into the macros and check how many characters the argument > to Fl has, after all Fl is meant to document getopt-style things. > If it is one, it is a short option, if it has more, it is a long > one. Short options have one dash, long have two, that is the > convention. It may be a convention, but it is not a standard that is universally followed, as "man clang" or "man gcc" will show you. -- Ian