Re: Texinfo reputation

[Max Nikulin]

On 04/12/2024 01:51, Dr. Arne Babenhauserheide wrote:
> Max Nikulin writes:
> I used to be annoyed by the standalone reader, but with
>
> info --usage <package>
>
> it’s actually pretty good.

Certainly it is more convenient, but a more universal link is still

    or available locally via: info '(coreutils) ls invocation'

> It nowadays also gives a useful answer when
> looking for a non-existing manual:
>
>      info NOTEXISTING
>      info: No menu item 'NOTEXISTING' in node '(dir)Top'

I prefer this behavior as well. It reminds me another recent thread 
however. "info git" renders the man page in my case. In the absence of 
apparent banner, it requires some cognitive efforts to recognize that 
the rendered document is not an info page. Citations in the following 
message gives a fair summary of that discussion
<https://lists.debian.org/msgid-search/Z0dZjysfE3HE2nJZ@tuxteam.de>
debian-user. Re: help, man, etc. (was Re: Using terminal commands - 
corner cases) Wed, 27 Nov 2024 18:40:31 +0100

> You even get very fast full-text search through the manuals.

I do not mind, but the real annoyance for new users is that key bindings 
do not match e.g. "less" ones for next match. Mouse support in tkinfo 
makes its usage significantly more intuitive.

> And: info --usage git does not give the invocation page — because that
> node is missing in the manual. That’s not a problem of texinfo, but an
> indication that something may be missing:
>
> Is there a linter for texinfo that remarks such problems?

Perhaps it is possible to write TeX code that spits a warning/error at 
the end of the document when the "invocation" node is missed.