pdf documents won't build

pdf documents won't build

[Ross Boylan]

I got the tarball for guile-1.6.8 and ran configure at the top level.  I
did this solely to get the documentation.

When I do make pdf from the top, I get (excerpt)
make[1]: Entering directory `/usr/local/src/tools/guile-1.6.8/doc'
Making pdf in ref
make[2]: Entering directory `/usr/local/src/tools/guile-1.6.8/doc/ref'
GUILE="/usr/local/src/tools/guile-1.6.8/pre-inst-guile" ../../scripts/snarf-guile-m4-docs ../../guile-config/guile.m4 autoconf-macros.texi
/usr/local/src/tools/guile-1.6.8/pre-inst-guile: line
83: /usr/local/src/tools/guile-1.6.8/libguile/guile: No such file or
directory
/usr/local/src/tools/guile-1.6.8/pre-inst-guile: line 83:
exec: /usr/local/src/tools/guile-1.6.8/libguile/guile: cannot execute:
No such file or directory
make[2]: *** [autoconf-macros.texi] Error 126
make[2]: Leaving directory `/usr/local/src/tools/guile-1.6.8/doc/ref'

It looks as if maybe some other stuff needs to be built first, and the
Makefile isn't picking up on it.


I'm on a Debian GNU/Linux system; it is unlikely I currently have all
packages installed that would be needed for a full build.  The tarball
is the original one, with no Debian modifications.

I posted this to guile-user a few days ago.  Someone sent me prebuilt
docs (for 1.8 actually, which isn't the one I'm using), along with the
information that they built their docs on MS-Windows and could not build
them under Linux.  That's been the only response, so I figured this
might be a real bug and am filing this report.

I'm a bit surprised you don't have people enter bugs in the bug tracker;
the BUGS file said to send an email like this.
-- 
Ross Boylan                                      wk:  (415) 514-8146
185 Berry St #5700                               ross@biostat.ucsf.edu
Dept of Epidemiology and Biostatistics           fax: (415) 514-8150
University of California, San Francisco
San Francisco, CA 94107-1739                     hm:  (415) 550-1062



_______________________________________________
Bug-guile mailing list
Bug-guile@gnu.org
http://lists.gnu.org/mailman/listinfo/bug-guile

Re: pdf documents won't build

[Neil Jerram]

Ross Boylan <ross@biostat.ucsf.edu> writes:

> I got the tarball for guile-1.6.8 and ran configure at the top level.  I
> did this solely to get the documentation.
>
> When I do make pdf from the top, I get (excerpt)
> make[1]: Entering directory `/usr/local/src/tools/guile-1.6.8/doc'
> Making pdf in ref
> make[2]: Entering directory `/usr/local/src/tools/guile-1.6.8/doc/ref'
> GUILE="/usr/local/src/tools/guile-1.6.8/pre-inst-guile" ../../scripts/snarf-guile-m4-docs ../../guile-config/guile.m4 autoconf-macros.texi
> /usr/local/src/tools/guile-1.6.8/pre-inst-guile: line
> 83: /usr/local/src/tools/guile-1.6.8/libguile/guile: No such file or
> directory
> /usr/local/src/tools/guile-1.6.8/pre-inst-guile: line 83:
> exec: /usr/local/src/tools/guile-1.6.8/libguile/guile: cannot execute:
> No such file or directory
> make[2]: *** [autoconf-macros.texi] Error 126
> make[2]: Leaving directory `/usr/local/src/tools/guile-1.6.8/doc/ref'
>
> It looks as if maybe some other stuff needs to be built first, and the
> Makefile isn't picking up on it.

That's correct.  It's currently the case that you need to run a plain
"make" first.  Are you in a position to do that?

> I posted this to guile-user a few days ago.  Someone sent me prebuilt
> docs (for 1.8 actually, which isn't the one I'm using), along with the
> information that they built their docs on MS-Windows and could not build
> them under Linux.  That's been the only response, so I figured this
> might be a real bug and am filing this report.

Thanks; we appreciate your report.  Given that there is an easy
workaround, though, how important is this for you?

> I'm a bit surprised you don't have people enter bugs in the bug tracker;
> the BUGS file said to send an email like this.

I agree that it is unusual not to use a tracker these days, but
bug-guile@gnu.org is still for now our primary mechanism for reporting
and dealing with bug reports.

Regards,
     Neil



_______________________________________________
Bug-guile mailing list
Bug-guile@gnu.org
http://lists.gnu.org/mailman/listinfo/bug-guile

Re: pdf documents won't build

[Ross Boylan]

On Thu, 2006-11-02 at 21:22 +0000, Neil Jerram wrote:
> Ross Boylan <ross@biostat.ucsf.edu> writes:
> 
> > I got the tarball for guile-1.6.8 and ran configure at the top level.  I
> > did this solely to get the documentation.
> >
> > When I do make pdf from the top, I get (excerpt)
> > make[1]: Entering directory `/usr/local/src/tools/guile-1.6.8/doc'
> > Making pdf in ref
> > make[2]: Entering directory `/usr/local/src/tools/guile-1.6.8/doc/ref'
> > GUILE="/usr/local/src/tools/guile-1.6.8/pre-inst-guile" ../../scripts/snarf-guile-m4-docs ../../guile-config/guile.m4 autoconf-macros.texi
> > /usr/local/src/tools/guile-1.6.8/pre-inst-guile: line
> > 83: /usr/local/src/tools/guile-1.6.8/libguile/guile: No such file or
> > directory
> > /usr/local/src/tools/guile-1.6.8/pre-inst-guile: line 83:
> > exec: /usr/local/src/tools/guile-1.6.8/libguile/guile: cannot execute:
> > No such file or directory
> > make[2]: *** [autoconf-macros.texi] Error 126
> > make[2]: Leaving directory `/usr/local/src/tools/guile-1.6.8/doc/ref'
> >
> > It looks as if maybe some other stuff needs to be built first, and the
> > Makefile isn't picking up on it.
> 
> That's correct.  It's currently the case that you need to run a plain
> "make" first.  Are you in a position to do that?
I'm not sure how much software needs to be present for a regular make. I
tried it, and it seemed to run OK.  Unfortunately, in make pdf this
seems to have advanced me to other issues:

1. The main ref manual was a no-op.  There was already a pdf file there
from my earlier attempts.  I later changed to that directory and did
make clean; make pdf.  No problems.

2. In the doc/tutorial, I got these errors, even on the 2nd run of
pdftex:
Chapter 4 [11]
l.945: Undefined cross reference `Scheme data representation-snt'.
l.945: Undefined cross reference `Scheme data representation-snt'.
l.945: Undefined cross reference `Scheme data representation-pg'. [12]
[13]
[14] [15] [16] Chapter 5 Chapter 6 Chapter 7 (Concept Index)
(./guile-tut.cps)

(I later changed to doc/tutorial and did make clean pdf.  The results
were unchanged.)

3. In doc/goops I got
[26] [27] [28] [29] [30] [31] Chapter 3 [32] [33] [34] [35] Chapter 4
[36]
(./goops-tutorial.texi [37]
Error: pdfetex (file hierarchy.pdf): cannot find image file
 ==> Fatal error occurred, the output PDF file is not finished!

(Same when I changed to the directory and did make clean pdf.)

Of course, all these problems might be the result of my missing some
software the build system needs (I didn't study the docs on that before
my build attempts), or having software in the wrong version.

[snip]
> 
> Thanks; we appreciate your report.  Given that there is an easy
> workaround, though, how important is this for you?
Given that I now have the 1.8 docs, which are pretty close (?), and that
these are now available in various forms on the web, not so important.

Still, it would be nice if it worked.  I suspect the problems I'm seeing
now are separate issues from the original one.

If regular make needs to be run first, perhaps the default target (or
something appropriate) should be in the prerequisites of the doc
targets.

There are a few reasons it would be good to make this work:
* the 1.6 docs are not readily available, and if you're working with 1.6
(as I guess I and other Debian users are) it's good to have the exact
documenation. 
* If possible, it would be good to be able to build the documentation
without having everything on hand that is needed to build the full
package.  Since I appear to have succeeded with the vanilla make, that
may already be the case.  But I have a lot of development tools on my
machine already. 
* If this is supposed to just work, maybe it indicates an automake
problem that would be good to report.
> 
> > I'm a bit surprised you don't have people enter bugs in the bug tracker;
> > the BUGS file said to send an email like this.
> 
> I agree that it is unusual not to use a tracker these days, but
> bug-guile@gnu.org is still for now our primary mechanism for reporting
> and dealing with bug reports.
You might add to the instructions that fact that you need to subscribe
to the list in order to post there smoothly; I found out the hard way. 

Thanks.
Ross




_______________________________________________
Bug-guile mailing list
Bug-guile@gnu.org
http://lists.gnu.org/mailman/listinfo/bug-guile

Re: pdf documents won't build

[Neil Jerram]

Ross Boylan <ross@biostat.ucsf.edu> writes:

> 2. In the doc/tutorial, I got these errors, even on the 2nd run of
> pdftex:
> Chapter 4 [11]
> l.945: Undefined cross reference `Scheme data representation-snt'.
> l.945: Undefined cross reference `Scheme data representation-snt'.
> l.945: Undefined cross reference `Scheme data representation-pg'. [12]
> [13]
> [14] [15] [16] Chapter 5 Chapter 6 Chapter 7 (Concept Index)
> (./guile-tut.cps)
>
> (I later changed to doc/tutorial and did make clean pdf.  The results
> were unchanged.)

This has now been fixed in our CVS (before the 1.8.1 release); thanks
for reporting it though.

> 3. In doc/goops I got
> [26] [27] [28] [29] [30] [31] Chapter 3 [32] [33] [34] [35] Chapter 4
> [36]
> (./goops-tutorial.texi [37]
> Error: pdfetex (file hierarchy.pdf): cannot find image file
>  ==> Fatal error occurred, the output PDF file is not finished!

Similarly.

>> Thanks; we appreciate your report.  Given that there is an easy
>> workaround, though, how important is this for you?
> Given that I now have the 1.8 docs, which are pretty close (?), and that
> these are now available in various forms on the web, not so important.
>
> Still, it would be nice if it worked.  I suspect the problems I'm seeing
> now are separate issues from the original one.
>
> If regular make needs to be run first, perhaps the default target (or
> something appropriate) should be in the prerequisites of the doc
> targets.

Ideally yes, but I don't think there's an easy way to do this.  It's
an example of the problems that Peter Miller's essay "Recursive Make
Considered Harmful"
(http://www.pcug.org.au/~millerp/rmch/recu-make-cons-harm.html).

> There are a few reasons it would be good to make this work:
> * the 1.6 docs are not readily available, and if you're working with 1.6
> (as I guess I and other Debian users are) it's good to have the exact
> documenation. 
> * If possible, it would be good to be able to build the documentation
> without having everything on hand that is needed to build the full
> package.  Since I appear to have succeeded with the vanilla make, that
> may already be the case.  But I have a lot of development tools on my
> machine already. 
> * If this is supposed to just work, maybe it indicates an automake
> problem that would be good to report.

I think we should review whether it's a good idea to have parts of the
manual auto-generated during make.  My feeling is that this could
better be a developer-side activity inside, like autogen.sh.  Then the
.texis as shipped would be ready for feeding to texinfo etc.

>> > I'm a bit surprised you don't have people enter bugs in the bug tracker;
>> > the BUGS file said to send an email like this.
>> 
>> I agree that it is unusual not to use a tracker these days, but
>> bug-guile@gnu.org is still for now our primary mechanism for reporting
>> and dealing with bug reports.

I should have added here that it does also work to use the savannah
tracker; an email to bug-guile@gnu.org is generated automatically.

> You might add to the instructions that fact that you need to subscribe
> to the list in order to post there smoothly; I found out the hard way. 

Thanks; I've updated lots of places now to say this.

Regards,
     Neil



_______________________________________________
Bug-guile mailing list
Bug-guile@gnu.org
http://lists.gnu.org/mailman/listinfo/bug-guile

Re: pdf documents won't build

[Ross Boylan]

On Fri, Nov 17, 2006 at 03:45:39PM +0000, Neil Jerram wrote:
> Ross Boylan <ross@biostat.ucsf.edu> writes:
> 
> > 2. In the doc/tutorial, I got these errors, even on the 2nd run of
> > pdftex:
> > Chapter 4 [11]
> > l.945: Undefined cross reference `Scheme data representation-snt'.
> > l.945: Undefined cross reference `Scheme data representation-snt'.
> > l.945: Undefined cross reference `Scheme data representation-pg'. [12]
> > [13]
> > [14] [15] [16] Chapter 5 Chapter 6 Chapter 7 (Concept Index)
> > (./guile-tut.cps)
> >
> > (I later changed to doc/tutorial and did make clean pdf.  The results
> > were unchanged.)
> 
> This has now been fixed in our CVS (before the 1.8.1 release); thanks
> for reporting it though.

Thanks for fixing it!

Any chance of backporting this to 1.6, since that's still in use at
least on Debian (cf the thread about problems with some module in 1.8
that's preventing the move to 1.8)?

Ross


_______________________________________________
Bug-guile mailing list
Bug-guile@gnu.org
http://lists.gnu.org/mailman/listinfo/bug-guile

Re: pdf documents won't build

[Neil Jerram]

Ross Boylan <ross@biostat.ucsf.edu> writes:

> Thanks for fixing it!
>
> Any chance of backporting this to 1.6, since that's still in use at
> least on Debian (cf the thread about problems with some module in 1.8
> that's preventing the move to 1.8)?

Yes, I've done that.  I can't say exactly when the next 1.6 release
will be though.

Regards,
     Neil



_______________________________________________
Bug-guile mailing list
Bug-guile@gnu.org
http://lists.gnu.org/mailman/listinfo/bug-guile