> >- the GNAT doc source would be in rest format (.rst files) instead > > of texinfo (.texi files) > > What about the preprocessor for the VMS specifics? Will it go away?
Yes, we are about to baseline VMS maintenance, and the VMS specific doc will go away in any case. > >- we would still provide .texi files, generated automatically by the > > sphinx toolset (via 'make texinfo') and committed in the repository > > (similarly to configure vs configure.in/aclocal.m4), so end users > > would not have any extra dependency, and generation of documentation > > would still be possible from the .texi files directly > > How stable is the output from Sphinx across versions? Will this > potentially cause a lot of update churn? I do not know, that can be investigated, although it's no different from e.g. using different versions of autoconf (or requiring a specific version). Arno
