Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]


Groups > gnu.bash.bug > #15407

Re: Wrong command option in the manual examples

Path csiph.com!3.us.feeder.erje.net!feeder.erje.net!news.linkpendium.com!news.linkpendium.com!panix!usenet.stanford.edu!not-for-mail
From Ilkka Virta <itvirta@iki.fi>
Newsgroups gnu.bash.bug
Subject Re: Wrong command option in the manual examples
Date Mon, 23 Sep 2019 12:29:18 +0300
Lines 31
Approved bug-bash@gnu.org
Message-ID <mailman.844.1569230968.2190.bug-bash@gnu.org> (permalink)
References <CAD0rTC6EHd5w5A6kuD850mLzu+V_EJXQyoZ=amQcF9TktTSEJA@mail.gmail.com> <38052651-6d67-6107-660c-707ca39ee00c@case.edu> <59cf49b0-1292-b752-4fe8-8928fd558ebf@iki.fi>
NNTP-Posting-Host lists.gnu.org
Mime-Version 1.0
Content-Type text/plain; charset=utf-8; format=flowed
Content-Transfer-Encoding 7bit
X-Trace usenet.stanford.edu 1569230969 17139 209.51.188.17 (23 Sep 2019 09:29:29 GMT)
X-Complaints-To action@cs.stanford.edu
To chet.ramey@case.edu, hk <hkadeveloper@gmail.com>, bug-bash@gnu.org
Envelope-to bug-bash@gnu.org
User-Agent Mozilla/5.0 (Macintosh; Intel Mac OS X 10.11; rv:60.0) Gecko/20100101 Thunderbird/60.9.0
In-Reply-To <38052651-6d67-6107-660c-707ca39ee00c@case.edu>
Content-Language en-US
X-SASI-RCODE 200
DKIM-Signature v=1; a=rsa-sha256; c=relaxed/relaxed; d=iki.fi; h=subject:to:references:from:message-id:date:mime-version:in-reply-to:content-type:content-transfer-encoding; s=smtp; bh=pe5sgZse100/6iMGWUQBzsSQi6lla/knmwqnmCBOZS8=; b=Pi9bNeGg9Gs/9wwQnpSFt0kzkHtpW0XJjPtxf7jksSYGJMfT0KV2VeF7NB7VCJTI0h3Y08VmbkRSqU7qWyMYgvnInFZNlIih/nqrh6sxSqum38NhoYABD3DduDMmTtCsq7/wa8pkfp6s+XII6RkX02ghvxMQQIG6/57nGc13sKta61xp+gpXXxWdJhJ3HhmGSEonTAOzLOXXANjvSZvJEoQ0wYLv5/oYx179G1EZHnlyrAmcUNXjaXWJvhQ2X7mJvynwa1Te9WrE0ZVSTBOB1wnDuMuCG0QQiV2szCWRhmbw7+62MgI6e6JpFD8DmfWfTIo52b9yglcVN/GVckbZsQ==
X-detected-operating-system by eggs.gnu.org: FreeBSD 8.x
X-Received-From 157.24.2.213
X-BeenThere bug-bash@gnu.org
X-Mailman-Version 2.1.23
Precedence list
List-Id Bug reports for the GNU Bourne Again SHell <bug-bash.gnu.org>
List-Unsubscribe <https://lists.gnu.org/mailman/options/bug-bash>, <mailto:bug-bash-request@gnu.org?subject=unsubscribe>
List-Archive <https://lists.gnu.org/archive/html/bug-bash>
List-Post <mailto:bug-bash@gnu.org>
List-Help <mailto:bug-bash-request@gnu.org?subject=help>
List-Subscribe <https://lists.gnu.org/mailman/listinfo/bug-bash>, <mailto:bug-bash-request@gnu.org?subject=subscribe>
X-Mailman-Original-Message-ID <59cf49b0-1292-b752-4fe8-8928fd558ebf@iki.fi>
X-Mailman-Original-References <CAD0rTC6EHd5w5A6kuD850mLzu+V_EJXQyoZ=amQcF9TktTSEJA@mail.gmail.com> <38052651-6d67-6107-660c-707ca39ee00c@case.edu>
Xref csiph.com gnu.bash.bug:15407

Show key headers only | View raw


On 22.9. 21:15, Chet Ramey wrote:
> On 9/20/19 10:24 PM, hk wrote:
> 
>> Bash Version: 5.0
>> Patch Level: 0
>> Release Status: release
>>
>> Description:
>>          On the section 3.2.6(GNU Parallel, page 16 in the pdf) of Bash
>> Reference Manual. The manual uses `find' command to illustrate
>> possible use cases of `parallel' as examples. but the option `-depth'
>> does not accept any argument, I think it means `-maxdepth` option
>> instead.
> 
> -depth n
>        True if the depth of the file relative to the starting point of
>        the traversal is n.
> 
> It's not in POSIX, and maybe GNU find doesn't implement it.

That seems to raise a question.

Isn't Bash a GNU project? Would it be prudent to use other GNU tools in 
examples, if standard POSIX features aren't sufficient? I can see that 
FreeBSD find has '-depth n' (as well the standard '-depth', somewhat 
confusingly) but should the reader of the manual be assumed to know the 
options supported by BSD utilities?

-- 
Ilkka Virta / itvirta@iki.fi

Back to gnu.bash.bug | Previous | Next | Find similar | Unroll thread


Thread

Re: Wrong command option in the manual examples Ilkka Virta <itvirta@iki.fi> - 2019-09-23 12:29 +0300

csiph-web