From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp2 ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms11 with LMTPS id uDepLzqwsV4xEwAA0tVLHw (envelope-from ) for ; Tue, 05 May 2020 18:28:10 +0000 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp2 with LMTPS id cN9PEEawsV71AgAAB5/wlQ (envelope-from ) for ; Tue, 05 May 2020 18:28:22 +0000 Received: from arlo.cworth.org (arlo.cworth.org [50.126.95.6]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) server-signature RSA-PSS (4096 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id BAFA8940C73 for ; Tue, 5 May 2020 18:28:18 +0000 (UTC) Received: from localhost (localhost [127.0.0.1]) by arlo.cworth.org (Postfix) with ESMTP id A029A6DE1395; Tue, 5 May 2020 11:28:16 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=cworth.org; s=mail; t=1588703296; bh=se48cqp+Qx0Sz3gRY9JFedRVPT0EBRHNmgIrFjrp/jQ=; h=To:Subject:In-Reply-To:References:From:Date:List-Id: List-Unsubscribe:List-Archive:List-Post:List-Help:List-Subscribe: Cc:From; b=P271vMlc9kQUr7faBSAuSfncg9ebCH7a+s/YwYaOpz7GZ04dJtUyAFTbA+6XsS92p l6j8hYDqdzt7wRPVLJ/dY4AU2wF5GxEeawUC/S7N/HP4TQNC6ieGTKVevv95l56p9x FIQ0xMuufJd6q29m5a+5CfpakEbaYaDdiur794FVBSBACKajOo9XLY354iCysD3u3o cQTQKaUbMhUqKd5ZBDgfABl3LPAWIyKcTmdKNIqOzhhVJNCZMKqsOa3TM3vk95cqQT zwcfr/xIefeMnU7VIP0rFD1e6hG85MLOyLv0rv06C+QnNb2RWK5THm0Ny/4DNDkQ7Z CCMACLzpAjT/A== X-Virus-Scanned: Debian amavisd-new at cworth.org Received: from arlo.cworth.org ([127.0.0.1]) by localhost (arlo.cworth.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id HJLQb3x9QnId; Tue, 5 May 2020 11:28:15 -0700 (PDT) Received: from arlo.cworth.org (localhost [IPv6:::1]) by arlo.cworth.org (Postfix) with ESMTP id E54186DE1386; Tue, 5 May 2020 11:28:14 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=cworth.org; s=mail; t=1588703294; bh=se48cqp+Qx0Sz3gRY9JFedRVPT0EBRHNmgIrFjrp/jQ=; h=To:Subject:In-Reply-To:References:From:Date:List-Id: List-Unsubscribe:List-Archive:List-Post:List-Help:List-Subscribe: Cc:From; b=EuOUzO0OnEYmaDg9q5zmM3PCg/cCA8dQ8abfVS+cVkSmYoQioUHc+CSKWIjmqeb4l hoJBmb8Y5aDVv7XG9kT8gSO+xrYY3Mctz7fQbQFOuFTagW6uc6isosteEc2/qM2JfS ROZm+NfFZXonJ78Wjub2cR0AXu6clmlWd4H7tGHdjofAP4ERvDJGqoJyS7wkMibg1t wdsuuabMt+WS79TIhBjdZxXjRIhE4HLT/IL047u06aeTKs+LpEM5Z//nC8BMw0XZCO /EjZVtp3Jz5ZpE/JDWgOWQ0klR1lYA+RKVU6DriWOGo0jrFd+TfXfBAOfLAm+QKeGJ IiJE4rGtq3gZg== Received: from localhost (localhost [127.0.0.1]) by arlo.cworth.org (Postfix) with ESMTP id 7124D6DE1386 for ; Tue, 5 May 2020 11:28:13 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=cworth.org; s=mail; t=1588703293; bh=/V/8/6qLWnD3+YigYsnHgHVkrD3kiAlCVEzaoTr9k24=; h=To:Cc:Subject:In-Reply-To:References:From:Date:From; b=AG12IfNd9hTuyMHJ7wjBROP5pLnXMPH68KChLnmmu7DAvBVwjq345fvLM/kgL6TT/ zO0Bwr4ozrjH6utre7y024OKRp89eooxqfX2MOGS/o0gOGhQhVw5WaSZWhaYVIPJeO gFkHHPNMQfyUG6z67g5f8BTgWCiBympjGK9GIzUWRoRqT1HsDde79qmGR+o1ZP1aPw DrMkSHf/oEyEoVg7zvkuEz13TkVZv8hpGPc3bXEeJfQRkQhP3EJEi8RzF21FiLX3Mv +VvQboK/ZrhNOBMKzRXgHm+g8ay7xCTf6/2SwokuWB9+rw6KfOHThTbDBc/eBrRagr 3PfYXg0D7ejcQ== X-Virus-Scanned: Debian amavisd-new at cworth.org Received: from arlo.cworth.org ([127.0.0.1]) by localhost (arlo.cworth.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id HZf7YBPe_2ET; Tue, 5 May 2020 11:28:12 -0700 (PDT) Received: from wondoo.home.cworth.org (unknown [10.0.0.11]) (Authenticated sender: cworth) by arlo.cworth.org (Postfix) with ESMTPSA id AB5796DE10E7; Tue, 5 May 2020 11:28:12 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=cworth.org; s=mail; t=1588703292; bh=/V/8/6qLWnD3+YigYsnHgHVkrD3kiAlCVEzaoTr9k24=; h=To:Cc:Subject:In-Reply-To:References:From:Date:From; b=jQ6+lwjXrauXWN38PRAG2halbjpRXfWNmqj4M9sC/X8lNj0JTbDf+Nxilx7DnCTPV oJs3XLUbAsxDX8xYMmp279SG8WWtRA0aPmAP5dr191hCeBfYr7V6nO7xC1KGEWhn9P NTL1WI09JHZCsaZe5wIupsYT2qGa9pCW61ZJUtqlX4KN2We6WKa64wdYGiHZywZfY0 h6MW50ObLzjsT1a+SZQ3/tWVzCCiK+HKGu7Pu08MngDJhXKwfwzTCp8l4aT0Spk6EX d86i8qaneCqRURBQb7Z5oLr5TzY1mb3kbtGTxs+SXHBdLIG5MG4NsRz92p6g/EZNoS DIzLhLoibMfzQ== Received: from wondoo (localhost [IPv6:::1]) by wondoo.home.cworth.org (Postfix) with ESMTPS id 89DB11FE15E9; Tue, 5 May 2020 11:28:12 -0700 (PDT) To: Jameson Graef Rollins , David Bremner , Daniel Kahn Gillmor , Jani Nikula Subject: Re: Inconsistencies in handling command flags: `--flag=value` different than `--flag value` In-Reply-To: <87y2qemh27.fsf@caltech.edu> References: <87imhk95oc.fsf@tethera.net> <87k120x0wh.fsf@fifthhorseman.net> <87blnbvxx4.fsf@fifthhorseman.net> <87pnbql2sg.fsf@tethera.net> <87y2qemh27.fsf@caltech.edu> From: Carl Worth Date: Tue, 05 May 2020 11:28:07 -0700 Message-ID: <87o8r2tex4.fsf@wondoo.home.cworth.org> MIME-Version: 1.0 X-BeenThere: notmuch@notmuchmail.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "Use and development of the notmuch mail system." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: notmuch@notmuchmail.org Content-Type: multipart/mixed; boundary="===============3798610655678520811==" Errors-To: notmuch-bounces@notmuchmail.org Sender: "notmuch" X-Scanner: scn0 X-Spam-Score: 1.49 Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=cworth.org header.s=mail header.b=P271vMlc; dkim=pass header.d=cworth.org header.s=mail header.b=EuOUzO0O; dkim=fail (body hash did not verify) header.d=cworth.org header.s=mail header.b=AG12IfNd; dkim=fail (body hash did not verify) header.d=cworth.org header.s=mail header.b=jQ6+lwjX; dmarc=none; spf=pass (aspmx1.migadu.com: domain of notmuch-bounces@notmuchmail.org designates 50.126.95.6 as permitted sender) smtp.mailfrom=notmuch-bounces@notmuchmail.org X-Scan-Result: default: False [1.49 / 13.00]; RCVD_VIA_SMTP_AUTH(0.00)[]; GENERIC_REPUTATION(0.00)[-0.46653779614648]; TO_DN_SOME(0.00)[]; IP_REPUTATION_HAM(0.00)[asn: 27017(-0.18), country: US(-0.00), ip: 50.126.95.6(-0.47)]; R_DKIM_REJECT(0.00)[cworth.org:s=mail]; DWL_DNSWL_BLOCKED(0.00)[cworth.org:dkim,50.126.95.6:from]; R_SPF_ALLOW(0.00)[+a]; DKIM_MIXED(0.00)[]; RCPT_COUNT_FIVE(0.00)[5]; MX_GOOD(-0.50)[cached: notmuchmail.org]; DKIM_TRACE(0.00)[cworth.org:+,cworth.org:-]; MAILLIST(-0.20)[mailman]; SIGNED_PGP(-2.00)[]; RCVD_IN_DNSWL_FAIL(0.00)[50.126.95.6:server fail]; MIME_TRACE(0.00)[0:+,1:+,2:+,3:~,4:+]; RCVD_TLS_LAST(0.00)[]; ASN(0.00)[asn:27017, ipnet:50.126.64.0/18, country:US]; FROM_NEQ_ENVFROM(0.00)[cworth@cworth.org,notmuch-bounces@notmuchmail.org]; RSPAMD_URIBL(4.50)[cworth.org:dkim]; ARC_NA(0.00)[]; R_DKIM_ALLOW(-0.20)[cworth.org:s=mail]; URIBL_BLOCKED(0.00)[notmuchmail.org:email,cworth.org:dkim]; FROM_HAS_DN(0.00)[]; SPF_REPUTATION_HAM(0.00)[-0.44271048689312]; MIME_GOOD(-0.20)[multipart/mixed,multipart/signed,text/plain]; PREVIOUSLY_DELIVERED(0.00)[notmuch@notmuchmail.org]; DMARC_NA(0.00)[cworth.org]; HAS_LIST_UNSUB(-0.01)[]; BAD_REP_POLICIES(0.10)[]; RCVD_COUNT_SEVEN(0.00)[8]; FORGED_SENDER_MAILLIST(0.00)[] X-TUID: 1InC9INadWhD Content-Transfer-Encoding: 7bit --===============3798610655678520811== Content-Type: multipart/signed; boundary="=-=-="; micalg=pgp-sha512; protocol="application/pgp-signature" --=-=-= Content-Type: text/plain On Wed, Apr 29 2020, Jameson Graef Rollins wrote: > I dare say there are few people that have muscle memory for the notmuch > command line (especially for notmuch show), and fewer that aren't > themselves developers... Here, the concern isn't just "muscle memory" (forcing users to learn how to retype commands at the command line) but also that users can have developed scripts that call notmuch, and we would need to have an extremely significant reason to break those. And the notmuch CLI, from the beginning, was intentionally designed to be comfortable for users to use directly (by typing at an interactive shell), and for users to also incorporate into various scripts. And even if they _are_ developers, they don't deserve to have their environments broken either. That said, it is unfortunate that some confusion has crept into the API. I have to admit that I do not understand what this sentence of the documentation means: For the cases where it's not ambiguous (in particular excluding boolean options), a space can also be used. What are the possible cases where it could be ambiguous? I'm personally opposed to adding any new option like --strict that changes how command-line options are parsed. I'm also opposed to renaming any of our existing command-line options. It seems clear we could at least fix the wording of the above documentation to make it clear that a space separator cannot be used for Boolean options. The only further change that could possibly make sense (to improve consistency) would be to back out support for using a space separator for _any_ options. But that introduces all the opportunities to break users' environments, so it's probably a non-starter as well. -Carl --=-=-= Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQIzBAEBCgAdFiEEzvjdyAGcpm1OMJTzYAIzup5U3GEFAl6xsDcACgkQYAIzup5U 3GGF/xAAvV7IZmzPvxry2JUDKqmOyF5vuBTnVTgNiZI3m6eNFLobUYgLgkY1+Vgg ELfZDa+oy4jg4GSTEKhmCa2pzi+EFMtw1hvR3jgqrBY7Q0FZlM9LsGtBzsJ0miRx np0Xm/6vqkh6bg0+6cBRuiMjdrKWiBVpF//KsjUj/rA2rB1QPpR/5JnLa0DfROPa ijUDXGEgfC7Rrz7NlkbASIN/Id7NOG34zwcFqkAtOHhoyxo/VksgkkHyqA0pC3sc UEG04o5HFPJXpoEVkhPUW43UflO5QXuT8gF2/UUNF4afPQ3q6fLukwIuS1X4TQ6b 5SlITR8Iy8zMXA2p5B1LSZ4SDk1LPCBaxalvzd+UfpBZcUq6DhQrOyZMF1KMsCIT cINz4bPJ8FUlFfGI353M98ZtohRHGW7RXcUgS0F1dB+/e1uTaiRq2eTipFvB8De0 HobwKfeOFMmyyM564MkHEIcMWnvdod4BC2IisbUyjiJHI6GF8i4xKBfOl9Uco2lK hTfm3u5EY4fbpCui27dRshZyiOuUYtLQbAkKQkLznfli0clvIdLR1gjyPh8sG3hF UhJwrIlIUnGhdUopS9NtpAGr99r3RCwk4DKoqQiP+s+nUPbBZFP0gaERcCf/sjro NQU03DCAU8Wx5LslKvl6KzFCOnfIHIHu2GzmxZieRozMioS3rHM= =Gjar -----END PGP SIGNATURE----- --=-=-=-- --===============3798610655678520811== Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Content-Disposition: inline --===============3798610655678520811==--