RE: Re: Modernizing Documentation format?

[zeurkous@xxxxxxxxxxxxxxx]

On Sat, 30 Aug 2025 07:33:12 +0100, Stephane Chazelas <stephane@xxxxxxxxxxxx> wrote:
> I never could understand what issues people had with "info".

The simple explanation, then--

 info has a captive design.
 UNIX folk tend to prefer non-captive designs.

> I
> can only explain it by them not having spent the time
> understanding how to use it.

The same could be said about mdoc(7).

> The killer feature is definitely the index (i), with completion
> and searchable (I) and available on command line (like in "info
> zsh typeset"; and with (perfectible as discussed not so long ago
> here) completion in zsh). The day I discovered that, there was
> no turning back.

This is only because for some strange hysterical reason, shells are not
allotted their own manual sections. Perhaps zsh should set an example
by claiming such a section, to enable break-up of the huge manual pages
into more readily-accessible per-feature ones?

> Compared to HTML:

That's not fair, HTML always loses, even against texinfo ;)

        --zeurkous.

-- 
Friggin' Machines!