[PyX-devel] Problems building manual.pdf

[Andrea R. <ari...@pi...>]

Hi all,
I was trying to build the PyX release 0.8.1 when I noticed that the  
manual.pdf file didn't build correctly. It turned out that the  
problem was twofold. First the manual/Makefile has got an error and  
here it is the patch:

> *** /Users/andrea/Installs/Python/PyX-0.8.1/manual/Makefile.orig    
> Tue Sep  6 16:43:38 2005
> --- /Users/andrea/Installs/Python/PyX-0.8.1/manual/Makefile     Tue  
> Sep  6 16:46:43 2005
> ***************
> *** 22,28 ****   
> pdf:manual.pdf                                                         
>                                         html:manual/manual.html
> ! manual.pdf: $(src)
>         #for index-with-own-hyperrefs debugging, anybody interested?
>         #./mkhowto --a4 --pdf --keep manual.tex
>         ./mkhowto --a4 --pdf manual.tex
> --- 22,28 ----
>   pdf:manual.pdf
>   html:manual/manual.html
>
> ! manual.pdf: $(src)  
> eps                                                                    
>                            #for index-with-own-hyperrefs debugging,  
> anybody  
> interested?                                                  #./ 
> mkhowto --a4 --pdf --keep  
> manual.tex                                                             
>            ./mkhowto --a4 --pdf manual.tex

The second problem is more subtle and I haven't understood it  
completely. After patching the Makefile as show above, the  
compilation of the manual fails while processing graph.tex with the  
following error message:

> ! Undefined control sequence.
> \filenq #1->{\py@smallsize \textsf {\let \e
>                                             =\textbackslash #1}}
> l.44 ... for the data from file \file{graph.dat}.}
>
> ?
> ! Emergency stop.
> \filenq #1->{\py@smallsize \textsf {\let \e
>                                             =\textbackslash #1}}
> l.44 ... for the data from file \file{graph.dat}.}

Removing the \file{} macro from the caption on line 44 solved the  
problem, and the compilation of the manual completes successfully.  
However, not having found where the definition for the  \file{} macro  
is located, I wasn't be able to understand the real reason of this  
failure. Could you help me?

For sake of completeness here they are the specifications of my teTeX  
distro:

> Totila:~ andrea$ latex --version
> pdfeTeX 3.141592-1.20a-2.2 (Web2C 7.5.3)
> kpathsea version 3.5.3
> Copyright (C) 1997-2004 Peter Breitenlohner (eTeX)/Han The Thanh  
> (pdfTeX).
> Kpathsea is copyright (C) 1997-2004 Free Software Foundation, Inc.
> There is NO warranty.  Redistribution of this software is
> covered by the terms of both the pdfeTeX copyright and
> the GNU General Public License.
> For more information about these matters, see the files
> named COPYING and the pdfeTeX source.
> Primary author of pdfeTeX: Peter Breitenlohner (eTeX)/Han The Thanh  
> (pdfTeX).
> Kpathsea written by Karl Berry and others.

Thanks,
  Andrea.