Re: docs not building

[Michael Godfrey]

On 07/08/2015 02:57 AM, John W. Eaton wrote:

On 07/07/2015 09:23 PM, Rik wrote:

On 07/07/2015 05:05 PM, address@hidden wrote:

Subject:
Re: Eliminating more recursive make invocations
From:
Michael Godfrey <address@hidden>
Date:
07/07/2015 05:05 PM

To:
"John W. Eaton" <address@hidden>, address@hidden

List-Post:
<mailto:address@hidden>
Precedence:
list
MIME-Version:
1.0
References:
<address@hidden> <address@hidden>
<address@hidden>
In-Reply-To:
<address@hidden>
Message-ID:
<address@hidden>
Content-Type:
multipart/alternative; boundary="------------010000050800080908020607"
Message:
6




On 07/07/2015 11:51 PM, John W. Eaton wrote:

On 07/07/2015 04:37 PM, Michael Godfrey wrote:

On 07/07/2015 05:34 PM, John W. Eaton wrote:

I checked in a series of changes that eliminates calling make
recursively for the doc, etc/icons, and test directory trees.

You may need to clean up your build tree and run the bootstrap script
followed by configure to eliminate now obsolete Makefiles.

In doing this I once again enabled building the documentation and
images for the documentation in parallel.  It seems to work for me,
but if you notice problems, please report them.

I'm considering doing the same for the liboctave, libinterp, libgui,
src, and scripts directory.  At that point, the only directory that
will be handled by a recursive make invocation will be libgnu.

jwe

This all went smoothly for me until:

  GEN      doc/interpreter/octave.html/mesh.png
   GEN      doc/interpreter/plot3.png
   GEN      doc/interpreter/octave.html/plot3.png
   GEN      doc/interpreter/extended.png
   GEN      doc/interpreter/octave.html/extended.png
   TEX      doc/refcard/refcard-a4.dvi
^C^C^C^C^CMakefile:4332: recipe for target 'doc/refcard/refcard-a4.dvi'
failed

Does a full build work for you? It appears to me that something is out
of order
in the build in doc/interpreter/

A clean build does seem to work for me.

Are you doing a parallel build?  How many jobs?

Can you use

  make V=1 ...

to see the details of this failure and post the info here?

Thanks,

jwe

Here is the result of V=1
cd doc/refcard && \
TEXINPUTS="./doc/refcard::./doc/interpreter::./doc/interpreter::./doc/interpreter::./doc/interpreter::./doc/interpreter::./doc/interpreter:/home/godfrey/tex/macros::/home/godfrey/tex/inputs::::"
\
tex doc/refcard/refcard-a4.tex
This is TeX, Version 3.14159265 (TeX Live 2015) (preloaded format=tex)
! I can't find file `doc/refcard/refcard-a4.tex'.
<*> doc/refcard/refcard-a4.tex

(Press Enter to retry, or Control-D to exit)
Please type another input file name:

I have the same issue.  The problem is that the make rule changes
directory into doc/refcard, but then tries to execute 'tex
doc/refcard/refcard-a4.tex' rather than just 'tex refcard-a4.tex'.

I'm not sure why it succeeded for me.  I think the attached change should fix the problem.

jwe

This did fix the doc/refcard problem, but the same construct fails for make check.
I get:
make  check-local
make[3]: Entering directory '/home/godfrey/d/src/octave/hg/octave'
./doc/interpreter/config-images.sh .
./doc/interpreter/images.mk is unchanged
cd test && ../run-octave  --norc --silent --no-history ./test/fntests.m ./test
error: no such file, '/home/godfrey/d/src/octave/hg/octave/test/test/fntests.m'
error: source: error sourcing file '/home/godfrey/d/src/octave/hg/octave/test/test/fntests.m'
Makefile:4649: recipe for target 'check-local' failed
make[3]: *** [check-local] Error 1
make[3]: Leaving directory '/home/godfrey/d/src/octave/hg/octave'
Makefile:3420: recipe for target 'check-am' failed
make[2]: *** [check-am] Error 2
make[2]: Leaving directory '/home/godfrey/d/src/octave/hg/octave'
Makefile:3129: recipe for target 'check-recursive' failed
make[1]: *** [check-recursive] Error 1
make[1]: Leaving directory '/home/godfrey/d/src/octave/hg/octave'
Makefile:3422: recipe for target 'check' failed
make: *** [check] Error 2
===============================
As I mentioned before, removing the cd test && . fixes this.  It does appear that there
is a difference in how make is handling cd commands. This has always (for me) been
a bit obscure. I have to reread the make doc whenever I use cd in a makefile.

Are you using a make different from GNU Make 4.0?

By the way, your changes have made one improvement (at least): before
make clean
make
did not rebuild the doc/ files. Now it does.

Michael