Zsh Mailing List Archive
Messages sorted by: Reverse Date, Date, Thread, Author

Re: Modernizing Documentation format?



hello,

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

to be tested: https://mandoc.bsd.lv/texi2mdoc/

> 
> > * 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.

based on 20+ of teaching, mentoring and community support.

> Although zsh is not GNU, it's typically packaged with GNU-based systems.

no reason to use the whole GNU thing. info is just another way to read
the doc (obviously confortable for emacs users).

-- 
Marc Chantreux
Pôle CESAR (Calcul et services avancés à la recherche)
Université de Strasbourg
14 rue René Descartes,
BP 80010, 67084 STRASBOURG CEDEX
03.68.85.60.79

Attachment: signature.asc
Description: PGP signature



Messages sorted by: Reverse Date, Date, Thread, Author