Re: [PATCH 3/5] New cache variable index in the manual.

[Ralf Wildenhues]

an addendum:

* Eric Blake wrote on Wed, Sep 16, 2009 at 06:16:15AM CEST:
> According to Ralf Wildenhues on 9/13/2009 2:33 AM:
> > * doc/autoconf.texi: Define new index `CA' for cache variables.
> > (caindex): New macro.
> > (Cache Variable Index): New appendix node.
> > (Top, Indices): Adjust menus.
> > (Cache Variable Names, Site Defaults): Adjust text.
> > * doc/Makefile.am (CLEANFILES): Add files generated for CA index.
> 
> Yes, I think our use of _cv_ variables in many of the existing autoconf
> macros is unlikely to change without causing major headaches (for example,
> gnulib inspects ac_cv_func_NAME all over the place to see what happened
> with AC_CHECK_FUNCS_ONCE), so documenting stable cache variables is a good
> step.

FWIW, I agree with Paolo that taking gnulib as only or just major
reference point is vastly underestimating the problem domain here.

> I take it you've inspected dvi and/or pdf output, to make sure the
> new index looks reasonable?

Yes, it looks good.  However, there is an empty page inserted before the
new index, which makes me wonder about some texinfo.tex setting being
too strict.  I'll try to reproduce with a smaller example and report to
bug-texinfo.

Cheers,
Ralf