[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: Wrong command option in the manual examples
From: |
Chet Ramey |
Subject: |
Re: Wrong command option in the manual examples |
Date: |
Mon, 23 Sep 2019 09:34:29 -0400 |
User-agent: |
Mozilla/5.0 (Macintosh; Intel Mac OS X 10.14; rv:60.0) Gecko/20100101 Thunderbird/60.9.0 |
On 9/23/19 5:29 AM, Ilkka Virta wrote:
> 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?
That's a good question. It's complicated by the fact that parallel is not
part of bash, and I included the parallel manual verbatim upon request. I
don't know what the author's intent was with the example, or if -maxdepth
would work. Let's see if we can loop Ole Tange, the parallel author, into
this discussion.
Chet
--
``The lyf so short, the craft so long to lerne.'' - Chaucer
``Ars longa, vita brevis'' - Hippocrates
Chet Ramey, UTech, CWRU chet@case.edu http://tiswww.cwru.edu/~chet/
- Re: Wrong command option in the manual examples,
Chet Ramey <=