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

Groups > gnu.bash.bug > #15407 > unrolled thread

Re: Wrong command option in the manual examples

Back to article view | Back to gnu.bash.bug

This discussion starts older than the indexed window; earlier articles aren't shown. The article labeled Started by below is the oldest one visible, not the original post.

Contents

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

#15407 — Re: Wrong command option in the manual examples

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

[toc] | [standalone]

Back to top | Article view | gnu.bash.bug

csiph-web