[prev in list] [next in list] [prev in thread] [next in thread] 

List:       bash-bug
Subject:    Re: Man Page: Confusing wording
From:       Tadeus Prastowo <tadeus.prastowo () unitn ! it>
Date:       2018-04-10 8:27:10
Message-ID: CAN-HRFbWmS8oPZU6PtHa5QqhfieyoFE6=+AsRAqwcmbR9537dg () mail ! gmail ! com
[Download RAW message or body]

On Tue, Apr 10, 2018 at 1:32 AM, L A Walsh <bash@tlinx.org> wrote:
>
> How about the below, suggested wording replacing these 2 paragraphs:
>
>    A  list  is a sequence of one or more pipelines separated by one of the
>    operators ;, &, &&, or ||, and optionally terminated by one of ;, &, or
>    <newline>.
>
>    Of these list operators, && and || have equal precedence, followed by ;
>    and &, which have equal precedence.
>
> Suggest:
>
>    A  list  is a sequence of one or more pipelines separated by one of the
>    operators ;, &, &&, or ||, and terminated by ;, &, or <newline>.
>
>    Precedence of these operators, in decreasing order by line is:
>
>    && and ||
>     ; and &

IMO, the current wording is already good.  Some months ago I decided
to get initiated into Bash, and so I hit the Bash reference manual.
The part under debate was not confusing for me.

As Chet said in the other e-mail, it would be best for the OP to first
point out which words got them wrong the first time they read it
before we even try to fix the wording.

--
Best regards,
Tadeus


[prev in list] [next in list] [prev in thread] [next in thread]