Re: Document that find -maxdepth is a GNU extension

[Bernhard Voelker]

On 4/16/19 6:41 AM, Andreas Metzler wrote:
> As a find user I would rather see the info manual dropped than the
> manpage. For *me* the latter is not only better accessible. man with
> less a pager simply is quicker than any of the info readers or a
> web-browser, but apart from that especially for find the man page is
> better readable. There is less chaff. It is leaner since it only
> documents find and not e.g. updatedb, too.

I'm personally using 'pinfo' instead of plain 'info' as reader,
because I find the navigation there more natural.

> Also I simply do not like fine-grained the node structure with deep
> hierarchy. It is fine in theory, but if I am looking for e.g. printf
> specifiers I am going to search for /printf/ instead of jumping through
> TOC -> 3 Actions -> 3.2 Print File Information -> 3.2.2 Format
> Directives -> 3.2.2.1 Name Directives.

I agree, the structure of the whole document is looking quite odd
to me as well.  But this is not a deficiency of the Tex language.
It could be easily moved around a bit.

> I do know that GNU standards say differently, but I respectfully
> disagree.

I'm not an expert for either format, but I think the Texinfo format
is more powerful, and especially the converted formats - HTML as one
page, HTML with a page per node, and finally PDF - are really nice.

Ideally, we could generate the man page from the Texinfo manual,
or the other way round, to avoid the double maintenance.  We've
had quite some reports in the past couple of years that something
is missing in either documentation.

The problem is: whatever we decide (iff we ever come to a conclusion),
we have to avoid to create much effort for our friends at:
  https://translationproject.org/domain/findutils.html

Have a nice day,
Berny