[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Document that find -maxdepth is a GNU extension

From: Bernhard Voelker
Subject: Re: Document that find -maxdepth is a GNU extension
Date: Fri, 26 Apr 2019 08:09:40 +0200
User-agent: Mozilla/5.0 (X11; Linux x86_64; rv:60.0) Gecko/20100101 Thunderbird/60.6.1

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 -> 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:

Have a nice day,

reply via email to

[Prev in Thread] Current Thread [Next in Thread]