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

From Ilkka Virta <itvirta@iki.fi>
Newsgroups gnu.bash.bug
Subject Re: Wrong command option in the manual examples
Date 2019-09-23 12:29 +0300
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>

Show all headers | 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