Re: Build warnings for documentation

[Daniel J Sebald]

On 08/24/2012 06:55 PM, Daniel J Sebald wrote:

> The only thing that I can think of (and which the others don't
> have) is this dependency definition:
>
> INFO_DEPS = $(srcdir)/octave.info
>
> If one builds in a separate directory, then the destination for
> octave.info is no longer in the source tree. I thought the answer was to
> change "srcdir" to "DESTDIR", but that doesn't compile.

The octave.info files are built, but placed in the wrong directory. 
Here's the contents in stages of build for the $(source)/doc/interpreter 
directory (notice I said "source"):

hg clone http://www.octave.org/hg/octave
<whatever is in the repository>

[sourcedir]# ./autogen.sh
(additional files)
Makefile.in
images.mk

[builddir]# ../octave/configure --disable-gui
(additional files)

[builddir]# make
(additional files)
octave.info
octave.info-1
octave.info-2
octave.info-3
octave.info-4
octave.info-5
octave.info-6
octave.info-7
stamp-vti
version.texi

I take it that the last group of 10 files should be in the build tree, 
not the source tree.

I've attached a diff file of changes I made to the build directory 
Makefile (notice I didn't call this a patch file) in order to make the 
doc files compile correctly.  Perhaps you could translate that to the 
appropriate automagic changes.  But (emphasis!) don't take complete 
faith in what I've done, as there might be smarter ways of making the 
change with redefining what $(srcdir) or $(DESTDIR) is.  AND, I also 
noticed that even though I made the mentioned changes it wasn't until I 
went to the <source>/doc/interpreter directory and deleted "stamp-vti" 
and "version.texi" that make rebuilt those two files and put them in the 
correct location of the build tree.  That tells me I missed something 
and make was still looking for "stamp-vti" and "version.texi" in the 
source tree somehow.

Anyway, that leaves me wondering about this following directive:

# The full path to the default info file.
infofile = $(infodir)/octave.info

Is this the system wide installing directory?

Dan

PS: Perhaps you could go through the $(srcdir)/doc/interpreter/TODO file 
to check what still rings true in there.

octave-octaveinfo_2012aug24.diff
Description: Text document