Re: Race condition in doc build

[Mike Miller]

On Fri, Jul 31, 2015 at 14:14:43 -0700, rik wrote:
> On 07/31/2015 10:53 AM, John W. Eaton wrote:
> > On 07/31/2015 12:30 PM, Rik wrote:
> >
> >> This may need to be amended to depend on octave.ps as well.
> >> Theoretically, that should be enough since octave.ps is created through
> >> dvips which will require building octave.dvi first.  But maybe it is
> >> safer to have octave.pdf depend on BOTH octave.dvi and octave.ps.
> >
> > Doesn't octave.ps already depend on octave.dvi?
> 
> I believe indirectly through a %.ps : %.dvi rule which is why I don't think
> it's necessary in the dependency list, but sometimes its easier to be
> redundant than to formally prove there isn't an issue with depending on
> octave.ps alone.

I don't think there is a race condition between pdf and dvi anymore, now
that we use separate build directories for each. So I don't know that we
need to reintroduce that dependency (one was deleted, one was commented
out on default).

I've pushed a couple changes to address this, let me know if things
break for you. One change to enforce the PS -> PDF ordering for both
liboctave.pdf and octave.pdf. The other change to use a temporary
directory (doc/.texmf-var) for any cache files created by TeX while
building the docs (I want to avoid assuming that the user can safely
write to $HOME or /tmp during the build if possible).

-- 
mike