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

Re: Modernizing Documentation format?



On Thu, Aug 21, 2025 at 08:08:51PM +0100, Stephane Chazelas wrote:
> 2025-08-21 09:00:26 -0500, Bart Schaefer:
> > As long as I can type
> >   make info; info -f Doc/zsh.info
> > what happens before that is not hugely important.

> Same here, anything that can't produce info and, at least as

Well … if textinfo is important, then why not just write in textinfo
which is also a rich documentation format?

> importantly, with the same (or better touch that would be hard)
> quality of table of contents and index as we curently have with
> yodl would be a non-starter for me.

Both mandoc and texinfo are capable here. Maybe texinfo can be
interesting because man pages becomes sections of a whole
"zsh documentation" entity so there will be no more zshall.

I really love the way perl and zsh handle things (the main man is
the index of more thematic mans) and AFAIS(aw)

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

> > I'm not a great fan of Python, but, like Thanos, it is inevitable.

unlike Thanos:

* it's here for bad reasons (mostly active lobbying at the time when
  the unix culture was mostly ignored)
* it can be defeated.

regards

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