Re: Modernizing Documentation format?

[Bart Schaefer <schaefer@xxxxxxxxxxxxxxxx>]

On Fri, Aug 22, 2025 at 1:01 AM Marc Chantreux <mc@xxxxxxxxxx> wrote:
>
> Well … if textinfo is important, then why not just write in textinfo
> which is also a rich documentation format?

That could be an option, but requires extra software to generate man
pages, and a large part of the reason for using yodl was to structure
the man pages somewhat differently than the info pages.  I have not
tried any of the info to man formatting tools.

> * lot of people just don't use info
>   * most just don't know it exists
>   * the ergonomy of the info command is terrible
> * info is pleasant just for people who installed emacs or vim plugins.

Subjective opinions.  Info and DocBook are still the standard formats
for GNU software.  Although zsh is not GNU, it's typically packaged
with GNU-based systems.