[RFC] HTML documentation with texi2any

[Jonas Hahnfeld]

Hi all,

after some more work, I think I have resolved most details for
generating LilyPond's HTML documentation with texi2any. The only minor
detail I would like to call out (for transparency) is that we will
again have "see section" when building with Texinfo 6.7, essentially
reverting https://gitlab.com/lilypond/lilypond/-/merge_requests/1109
It is (in my opinion) a very minor cosmetic change and, as you can read
up in that merge request, it already hit some objections when it was
introduced one and a half years ago. With texi2any, we do not have the
same customization hook and would have to format all references
ourselves. Additionally, "see section" will again disappear with
Texinfo 6.8 because of upstream changes, so I propose we just live with
that for now.

There will certainly be other (hopefully smaller) problems, but I
believe there aren't major blockers anymore. I would therefore like to
propose that we switch to texi2any reasonably soon. Please note that
the only really critical part is the website because it's generated
from master, and that one should be in fairly good shape. Minor
problems in the other manuals "only" affect the unstable releases and
can probably be dealt with as they are discovered.

For a possible timeline, we could wait for the release of LilyPond
2.25.8 (probably September 16/17 because I'm travelling next weekend,
unless Jean wants to do it again) and then merge the changes right
after. This would still allow us to maybe shake out some first problems
and also clean up some workarounds remaining from texi2html.

What do you think?

Jonas

signature.asc
Description: This is a digitally signed message part