changeset 20452:095e42d7a0bb

build: Avoid building pdf and ps outputs simultaneously * doc/module.mk: Add new dependency rules to protect against running the dvips and texi2pdf commands simultaneously, document the potential race condition.
author Mike Miller <mtmiller@octave.org>
date Sun, 02 Aug 2015 11:01:05 -0400
parents 44a1281e6e76
children 9e9e67845bbe
files doc/module.mk
diffstat 1 files changed, 9 insertions(+), 4 deletions(-) [+]
line wrap: on
line diff
--- a/doc/module.mk	Sun Aug 02 09:50:43 2015 -0400
+++ b/doc/module.mk	Sun Aug 02 11:01:05 2015 -0400
@@ -371,6 +371,11 @@
   $(BUILT_OCTAVE_TEXI_SRC) \
   doc/interpreter/doc-cache
 
+## The TeX software suite is used to create both PDF and PS output formats.
+## In order to avoid race conditions between simultaneous TeX commands, the
+## PDF and PS builds are forced to run serially through the following rule.
+doc/interpreter/octave.pdf: doc/interpreter/octave.ps
+
 DIRSTAMP_FILES += doc/interpreter/$(octave_dirstamp)
 
 liboctave_TEXINFOS = \
@@ -433,10 +438,10 @@
   doc/liboctave/liboctave.pdf \
   doc/liboctave/liboctave.html
 
-## The texi2dvi script (used to create both PDF and DVI output formats)
-## uses some fixed temporary file names.  In order to avoid a race condition
-## the DVI and PDF builds are forced to run serially through a Makefile rule.
-#doc/liboctave/liboctave.pdf: doc/liboctave/liboctave.dvi
+## The TeX software suite is used to create both PDF and PS output formats.
+## In order to avoid race conditions between simultaneous TeX commands, the
+## PDF and PS builds are forced to run serially through the following rule.
+doc/liboctave/liboctave.pdf: doc/liboctave/liboctave.ps
 
 DIRSTAMP_FILES += doc/liboctave/$(octave_dirstamp)