GNU bug report logs - #34475
doc: test: expand on -a/-o usage

Please note: This is a static page, with minimal formatting, updated once a day.
Click here to see this page with the latest information and nicer formatting.

Package: coreutils; Severity: wishlist; Reported by: 積丹尼 Dan Jacobson <jidanni@HIDDEN>; dated Thu, 14 Feb 2019 03:38:02 UTC; Maintainer for coreutils is bug-coreutils@HIDDEN.
Changed bug title to 'doc: test: expand on -a/-o usage' from 'Mention even more worries for test -a' Request was from Assaf Gordon <assafgordon@HIDDEN> to control <at> debbugs.gnu.org. Full text available.
Severity set to 'wishlist' from 'normal' Request was from Assaf Gordon <assafgordon@HIDDEN> to control <at> debbugs.gnu.org. Full text available.

Message received at 34475 <at> debbugs.gnu.org:


Received: (at 34475) by debbugs.gnu.org; 15 Feb 2019 14:57:10 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Fri Feb 15 09:57:10 2019
Received: from localhost ([127.0.0.1]:49675 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1guevN-0000Pb-MG
	for submit <at> debbugs.gnu.org; Fri, 15 Feb 2019 09:57:09 -0500
Received: from mail-pf1-f178.google.com ([209.85.210.178]:37869)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <assafgordon@HIDDEN>)
 id 1guevL-0000PH-VY; Fri, 15 Feb 2019 09:57:08 -0500
Received: by mail-pf1-f178.google.com with SMTP id s22so4955454pfh.4;
 Fri, 15 Feb 2019 06:57:07 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025;
 h=subject:to:references:from:message-id:date:user-agent:mime-version
 :in-reply-to:content-language:content-transfer-encoding;
 bh=hz9qmqSQEqOHJzDSLZqkh3inHErYYOrm22btYSvaqqQ=;
 b=OccMrJFm5wJ5tHVIbxOgmWydNNz/+n+uhXl97vMG1RA7xAEZubqlVbtvHkdHcGrr/R
 BxKJt+0Bkg246tgmsTMpRh2CMGG4RMMVPVhErn9MRWJbVqm2NuE98i4ZgDQZUOML+ns7
 TYct6z8Q87gkv4i2kZZuEWSqFoGxoLf4rxhu751FmirxYrcZzThkq/NzfNhbwP/FuorI
 9ZQQYp6WaGJquZ6RlR8HGyoqgC0kMlnsUS/B+VknvgJ4aKrvjSSL6mJbG6J3Hwa58zEz
 TfNTnWX6dNXB/2DToeKU0mVDU8gBgWbDGGnjmnpxhNN+DSIcpjtYBLsRA0Ud0+VojnsU
 LXyA==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
 d=1e100.net; s=20161025;
 h=x-gm-message-state:subject:to:references:from:message-id:date
 :user-agent:mime-version:in-reply-to:content-language
 :content-transfer-encoding;
 bh=hz9qmqSQEqOHJzDSLZqkh3inHErYYOrm22btYSvaqqQ=;
 b=hOOXb6jXO7YnvXJ3utngSCn1CxI7nQWk+FIRP5VStt4sFnlcW+c+Ryvx7EVqI6h6vs
 oNJK/TUxkff9NMcTeuotuHg9HAldGxTTjg9D1QliJOqvN8nkT1SccPqXRhWs3xF7pgQX
 +R/XRlK7mBOpWfoc+v4zZDKIiwY0pwv0rzHnuKZaifP+zsXh9Iac54HP6zqgEvPpFH/2
 70j4RPauwUBFUcBVVQ/ByxGF/GNalhug3cIW/uGu4pfKWHBLBfK6u/TIMahydwep7OVV
 R6grsYUrXX3J0NJdQo+DB2k6aYn+EH4oKn794wWv7wmS7N5XNQd65AywcM+JHXeMhDdo
 2Nbg==
X-Gm-Message-State: AHQUAubXalrvz0rZ7zNXS8t12WSW1a/q+3b7F0YQ12K2AfNgk1NDqn6e
 FoEn5AZ6hh4zqPklDVOMkWd0Olxa
X-Google-Smtp-Source: AHgI3Ib1J+/FuMWy5ze11JhhJ4kxmZlUqIcFWXCfLiMRgYbLK0CAtmVP79N18TUpEg6uSlLaaTR2JA==
X-Received: by 2002:a62:9f1a:: with SMTP id g26mr10350003pfe.123.1550242621744; 
 Fri, 15 Feb 2019 06:57:01 -0800 (PST)
Received: from tomato.housegordon.com (moose.housegordon.com. [184.68.105.38])
 by smtp.googlemail.com with ESMTPSA id
 v26sm7962675pfg.62.2019.02.15.06.57.00
 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128);
 Fri, 15 Feb 2019 06:57:00 -0800 (PST)
Subject: Re: bug#34475: Mention even more worries for test -a
To: =?UTF-8?B?56mN5Li55bC8IERhbiBKYWNvYnNvbg==?= <jidanni@HIDDEN>,
 34475 <at> debbugs.gnu.org
References: <87wom34222.fsf@HIDDEN>
From: Assaf Gordon <assafgordon@HIDDEN>
Message-ID: <01a260d8-cf51-4b75-abdb-cf152471122c@HIDDEN>
Date: Fri, 15 Feb 2019 07:56:57 -0700
User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:60.0) Gecko/20100101
 Thunderbird/60.4.0
MIME-Version: 1.0
In-Reply-To: <87wom34222.fsf@HIDDEN>
Content-Type: text/plain; charset=utf-8; format=flowed
Content-Language: en-US
Content-Transfer-Encoding: 8bit
X-Spam-Score: 0.0 (/)
X-Debbugs-Envelope-To: 34475
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -1.0 (-)

severity 34475 wishlist
retitle 34475 doc: test: expand on -a/-o usage
stop

Hello,

On 2019-02-13 6:00 p.m., 積丹尼 Dan Jacobson wrote:
> First, on the test(1) man page, at
[...]> Say instead
[...]

I'm marking this as "wishlist" item, patches always welcomed.

-assaf





Information forwarded to bug-coreutils@HIDDEN:
bug#34475; Package coreutils. Full text available.

Message received at submit <at> debbugs.gnu.org:


Received: (at submit) by debbugs.gnu.org; 14 Feb 2019 03:37:08 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Wed Feb 13 22:37:08 2019
Received: from localhost ([127.0.0.1]:47558 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1gu7pk-0007XP-4Z
	for submit <at> debbugs.gnu.org; Wed, 13 Feb 2019 22:37:08 -0500
Received: from eggs.gnu.org ([209.51.188.92]:42658)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <jidanni@HIDDEN>) id 1gu7ph-0007Wl-RM
 for submit <at> debbugs.gnu.org; Wed, 13 Feb 2019 22:37:06 -0500
Received: from lists.gnu.org ([209.51.188.17]:49811)
 by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32)
 (Exim 4.71) (envelope-from <jidanni@HIDDEN>) id 1gu7pc-0002Fo-LZ
 for submit <at> debbugs.gnu.org; Wed, 13 Feb 2019 22:37:00 -0500
Received: from eggs.gnu.org ([209.51.188.92]:56712)
 by lists.gnu.org with esmtp (Exim 4.71)
 (envelope-from <jidanni@HIDDEN>) id 1gu7pb-0008C3-C3
 for bug-coreutils@HIDDEN; Wed, 13 Feb 2019 22:37:00 -0500
X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org
X-Spam-Level: *
X-Spam-Status: No, score=1.8 required=5.0 tests=BAYES_50,FROM_EXCESS_BASE64,
 RCVD_IN_DNSWL_NONE,URIBL_BLOCKED autolearn=disabled version=3.3.2
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
 (envelope-from <jidanni@HIDDEN>) id 1gu7b6-0005GE-MO
 for bug-coreutils@HIDDEN; Wed, 13 Feb 2019 22:22:02 -0500
Received: from bonobo.maple.relay.mailchannels.net ([23.83.214.22]:7735)
 by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32)
 (Exim 4.71) (envelope-from <jidanni@HIDDEN>) id 1gu7ay-0005AK-DR
 for bug-coreutils@HIDDEN; Wed, 13 Feb 2019 22:21:56 -0500
X-Sender-Id: dreamhost|x-authsender|jidanni@HIDDEN
Received: from relay.mailchannels.net (localhost [127.0.0.1])
 by relay.mailchannels.net (Postfix) with ESMTP id 180A1281857
 for <bug-coreutils@HIDDEN>; Thu, 14 Feb 2019 03:21:45 +0000 (UTC)
Received: from pdx1-sub0-mail-a6.g.dreamhost.com (unknown [100.96.26.166])
 (Authenticated sender: dreamhost)
 by relay.mailchannels.net (Postfix) with ESMTPA id D36E0282886
 for <bug-coreutils@HIDDEN>; Thu, 14 Feb 2019 03:21:44 +0000 (UTC)
X-Sender-Id: dreamhost|x-authsender|jidanni@HIDDEN
Received: from pdx1-sub0-mail-a6.g.dreamhost.com (pop.dreamhost.com
 [64.90.62.162]) (using TLSv1.2 with cipher DHE-RSA-AES256-GCM-SHA384)
 by 0.0.0.0:2500 (trex/5.16.2); Thu, 14 Feb 2019 03:21:45 +0000
X-MC-Relay: Neutral
X-MailChannels-SenderId: dreamhost|x-authsender|jidanni@HIDDEN
X-MailChannels-Auth-Id: dreamhost
X-Towering-Whimsical: 23b0e6727e152744_1550114504940_3571083071
X-MC-Loop-Signature: 1550114504940:1832561278
X-MC-Ingress-Time: 1550114504940
Received: from pdx1-sub0-mail-a6.g.dreamhost.com (localhost [127.0.0.1])
 by pdx1-sub0-mail-a6.g.dreamhost.com (Postfix) with ESMTP id 94CED80B9B
 for <bug-coreutils@HIDDEN>; Wed, 13 Feb 2019 19:21:44 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha1; c=relaxed; d=jidanni.org; h=from:to
 :subject:date:message-id:mime-version:content-type; s=
 jidanni.org; bh=PKrLQpAU87SEax3clfCuUHFSVWE=; b=ZMc2001gCJ4iopX/
 orASwrXA+A8F6af83cOuNDvTFiGGprAUDeV4eIO45OoK44Pu8gZFvHyANSfGAJPG
 f5o+i71ZQrK07UGhWqKwskjzk1zgnQxN3Ayy2Q+ZmV1txgjzKaWMmlX3sbJfgObo
 c7GfaH6XLZMjYy7mwGjUCRcQtwQ=
Received: from jidanni.org (36-234-96-203.dynamic-ip.hinet.net [36.234.96.203])
 (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))
 (No client certificate requested)
 (Authenticated sender: jidanni@HIDDEN)
 by pdx1-sub0-mail-a6.g.dreamhost.com (Postfix) with ESMTPSA id 07BB480BA1
 for <bug-coreutils@HIDDEN>; Wed, 13 Feb 2019 19:21:43 -0800 (PST)
X-DH-BACKEND: pdx1-sub0-mail-a6
From: =?utf-8?B?56mN5Li55bC8?= Dan Jacobson <jidanni@HIDDEN>
To: bug-coreutils@HIDDEN
Subject: Mention even more worries for test -a
Date: Thu, 14 Feb 2019 09:00:05 +0800
Message-ID: <87wom34222.fsf@HIDDEN>
MIME-Version: 1.0
Content-Type: text/plain
X-VR-OUT-STATUS: OK
X-VR-OUT-SCORE: 0
X-VR-OUT-SPAMCAUSE: gggruggvucftvghtrhhoucdtuddrgedtledruddtgedgheejucetufdoteggodetrfdotffvucfrrhhofhhilhgvmecuggftfghnshhusghstghrihgsvgdpffftgfetoffjqffuvfenuceurghilhhouhhtmecufedttdenucenucfjughrpefhvffufffkgggtsehttdertddttdejnecuhfhrohhmpejnnjjnucffrghnucflrggtohgsshhonhcuoehjihgurghnnhhisehjihgurghnnhhirdhorhhgqeenucfkphepfeeirddvfeegrdeliedrvddtfeenucfrrghrrghmpehmohguvgepshhmthhppdhhvghlohepjhhiuggrnhhnihdrohhrghdpihhnvghtpeefiedrvdefgedrleeirddvtdefpdhrvghtuhhrnhdqphgrthhhpeeprehuthhfqdekreeureehiehmpfehnfhiheehsgevkeerpecuffgrnhculfgrtghosghsohhnuceojhhiuggrnhhnihesjhhiuggrnhhnihdrohhrgheqpdhmrghilhhfrhhomhepjhhiuggrnhhnihesjhhiuggrnhhnihdrohhrghdpnhhrtghpthhtohepsghughdqtghorhgvuhhtihhlshesghhnuhdrohhrghenucevlhhushhtvghrufhiiigvpedv
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 23.83.214.22
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x
X-Spam-Score: 1.0 (+)
X-Debbugs-Envelope-To: submit
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: 0.0 (/)

First, on the test(1) man page, at


       EXPRESSION1 -a EXPRESSION2
              both EXPRESSION1 and EXPRESSION2 are true

       EXPRESSION1 -o EXPRESSION2
              either EXPRESSION1 or EXPRESSION2 is true


Say instead

       EXPRESSION1 -a EXPRESSION2
              both EXPRESSION1 and EXPRESSION2 are true (See warning NOTE below.)

       EXPRESSION1 -o EXPRESSION2
              either EXPRESSION1 or EXPRESSION2 is true (See warning NOTE below.)

else users who never make it down to the "fine print at bottom" will
blithefully use them a lifetime without ever an inkling of the dangers!

(Indeed on (info "(coreutils) Connectives for test")
you discuss the dangers first, before even letting the users eyeballs
touch the syntax!)

Also on both man and info pages you need to warn of portability worries,
e.g., in bash we see -a and -o do even more things.

$ help test|egrep -- ' -(a|o) '
      -a FILE        True if file exists.
      -o OPTION      True if the shell option OPTION is enabled.
      EXPR1 -a EXPR2 True if both expr1 AND expr2 are true.
      EXPR1 -o EXPR2 True if either expr1 OR expr2 is true.




Acknowledgement sent to 積丹尼 Dan Jacobson <jidanni@HIDDEN>:
New bug report received and forwarded. Copy sent to bug-coreutils@HIDDEN. Full text available.
Report forwarded to bug-coreutils@HIDDEN:
bug#34475; Package coreutils. Full text available.
Please note: This is a static page, with minimal formatting, updated once a day.
Click here to see this page with the latest information and nicer formatting.
Last modified: Fri, 15 Feb 2019 15:00:02 UTC

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997 nCipher Corporation Ltd, 1994-97 Ian Jackson.