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

Groups > gnu.bash.bug > #15410

Re: Wrong command option in the manual examples

Show all headers | View raw

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/

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

Thread

Re: Wrong command option in the manual examples Chet Ramey <chet.ramey@case.edu> - 2019-09-23 09:34 -0400

csiph-web