Re: [bug #43122] texi2dvi does not compile enough times to get toc

[Gavin Smith]

On 9 September 2015 at 06:52, Vincent Belaïche
<address@hidden> wrote:
> Well, I agree with you that tweaking just for performance when it is not
> worth it is just another source of problem. However :
>
> 1) I think that it is worth it, that openout test is noticeable
>    processing-time-wise : there is a file created and a tex run. Anyway,
>    you can also argue that when one really needs performance because
>    he/she writes a document and wants WYSIWYGing it, he/she won't run
>    texi2dvi but rather run manually individual tools.

What about all the other auxiliary files that are copied to backup
directories, surely creating one extra file doesn't make much of a
difference?

>
> 2) I think that it is anyway needed for debug and testing, whichn, yes,
>    the plain user does not need to know, until, as Karl suggested,
>    he/she meets another bug.
>
>> Once again, I'd be happy enough to put it in the manual if others see
>> a need for it.
>
> That is fine to me to do that, provided that there is some "see manual
> info node texi2dvi gory details for expert options/envars" in the help
> message, and we create that info node about the gory details. In the
> nodes about envvar & options we just put a link to this node also for
> the TEXI2DVI_USER_RECORDER envvar and -u / --use-recorder option.
>
> I think that this way we would make the information available to the
> user, but at the same time the manual and help message reading would be
> smoother as the bulk of it is in a separate "gory details" node.
>

I've added the documentation to the manual and a reference to it in
the help message.