Re: Modernizing Documentation format?

[Jun T <takimoto-j@xxxxxxxxxxxxxxxxx>]

> 2025/08/20 5:25, dana <dana@xxxxxxx> wrote:
> 
> grep for 'ifn?zman' etc. also, i haven't looked closely at the changes,
> but jun-ichi recently did some work on related macros 

The main problem is that the man pages are divided into several
files (zshmisc, zshoptions, etc.) and it is highly desirable that
a reference from a file to a section in another file is accompanied
with the file name of the referent; otherwise it would not be easy
for readers to find which file they should look into.
(Providing only a single file (zshall) would solve the problem but...)

I've never used Sphinx and don't know it's easy or not to achieve this.

If Sphinx can't do this, one possibility is to add our own preprocessor
that generates two rst files for man page and other output formats,
but of course we want avoid such a complication as far as possible.

--
Jun