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>
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

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