You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@subversion.apache.org by kf...@collab.net on 2003/08/12 18:17:21 UTC

Documentation build broken with latest doc tools?

In the process of rolling the 0.27.0 distribution, I've encountered
what appears to be brokenness in the Book build.  (The release is not
held up, I'll just use some prebuilt docs Ben has.)

Here's what I did.  First, I installed the latest versions of all the
tools as described in doc/book/README:

   - docbook-xsl-1.61.3.tar.gz
   - libxml2-2.5.9.tar.gz
   - libxslt-1.0.32.tar.gz
   - fop-0.20.5-bin.tar.gz (installed into doc/book/tools/fop/)
   - jimi1_0.tar.Z (cp Jimi/examples/AppletDemo/JimiProClasses.jar fop/lib/)

Then I ran 

   $ autogen.sh
   $ ./configure --enable-maintainer-mode
   $ ./dist.sh 0.27.0 6715

Below is the output of dist.sh.  (Don't worry about the "WARNING"
regarding the docs/ directory, I expected that and it doesn't indicate
any actual version skew.)

   Distribution will be named: subversion-0.27.0
        constructed from path: /branches/release-0.27.0
   * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
   *                                                             *
   * WARNING:  The docs/ directory in your working copy does not *
   *           appear  to  have the same revision number  as the *
   *           distribution revision you requested.  Since these *
   *           documents will be the ones included in your final *
   *           tarball, please  be  sure they reflect the proper *
   *           state.                                            *
   *                                                             *
   * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
   Cleaning old docs in docs/ ...
   for d in doc/programmer/design doc/book/book doc/book/misc-docs ;                               \
           do                                                  \
               (cd $d;                                        \
                rm -f *.info *.info-[1-9]                      \
                      *.aux *.cp *.fn *.ky *.log *.pg *.toc    \
                      *.tp *.vr                                \
                      *.dvi *.txt *.html *.ps *.pdf *.fo);     \
           done
   Building new docs in docs/ ...
   /usr/local/bin/makeinfo -I `dirname doc/programmer/design/svn-design.texi` -o doc/programmer/design/svn-design.info doc/programmer/design/svn-design.texi 
   /usr/local/bin/makeinfo -I `dirname doc/programmer/design/svn-design.texi` --no-split --html -o doc/programmer/design/svn-design.html doc/programmer/design/svn-design.texi
   /usr/local/bin/makeinfo -I `dirname doc/programmer/design/svn-design.texi` --no-headers -o doc/programmer/design/svn-design.txt doc/programmer/design/svn-design.texi
   cd doc/book && make book-html
   make[1]: Entering directory `/home/kfogel/src/release-0.27/doc/book'
   6712
   xsltproc --stringparam html.stylesheet styles.css \
              --output ./book/book.html ./tools/xsl/html/docbook.xsl ./book/book.xml
   make[1]: Leaving directory `/home/kfogel/src/release-0.27/doc/book'
   cd doc/book && make book-pdf
   make[1]: Entering directory `/home/kfogel/src/release-0.27/doc/book'
   xsltproc  \
      --output ./book/book.fo ./tools/fo-stylesheet.xsl ./book/book.xml
   Making portrait pages on USletter paper (8.5inx11in)
   ./tools/bin/run-fop.sh . -fo ./book/book.fo -pdf ./book/book.pdf
   (Using './tools/fop/fop.sh' for FOP)
   [INFO] Using org.apache.xerces.parsers.SAXParser as SAX2 Parser
   [INFO] FOP 0.20.5
   [INFO] Using org.apache.xerces.parsers.SAXParser as SAX2 Parser
   [INFO] building formatting object tree
   [INFO] setting up fonts
   [INFO] [1]
   [INFO] [2]
   [INFO] [3]
   [INFO] [4]
   [INFO] [5]
   [INFO] [6]
   [INFO] [7]
   [INFO] [8]
   [INFO] [9]
   [INFO] [10]
   [INFO] [11]
   [INFO] [12] (blank)
   [INFO] [1]
   [INFO] [2]
   [INFO] [3]
   [INFO] [4]
   [INFO] JAI support was not installed (read: not present at build time). Trying to use Jimi instead
   [INFO] [5]
   [INFO] [6]
   [INFO] [7]
   [INFO] [8]
   [INFO] [9]
   [INFO] [10]
   [INFO] [11]
   [INFO] [12]
   [WARNING] table-layout=auto is not supported, using fixed!
   [INFO] [13]
   [INFO] [14]
   [INFO] [15]
   [INFO] [16]
   [INFO] [17]
   [INFO] [18]
   [INFO] [19]
   [INFO] [20]
   [INFO] [21]
   [INFO] [22]
   [INFO] [23]
   [INFO] [24]
   [INFO] [25]
   [INFO] [26]
   [INFO] [27]
   [INFO] [28]
   [INFO] [29]
   [INFO] [30]
   [INFO] [31]
   [INFO] [32]
   [INFO] [33]
   [INFO] [34]
   [INFO] [35]
   [INFO] [36]
   [INFO] [37]
   [INFO] [38]
   [INFO] [39]
   [INFO] [40]
   [INFO] [41]
   [INFO] [42]
   [INFO] [43]
   [INFO] [44]
   [INFO] [45]
   [INFO] [46]
   [INFO] [47]
   [INFO] [48]
   [INFO] [49]
   [INFO] [50]
   [INFO] [51]
   [INFO] [52]
   [INFO] [53]
   [INFO] [54]
   [INFO] [55]
   [INFO] [56]
   [INFO] [57]
   [INFO] [58]
   [INFO] [59]
   [INFO] [60]
   [INFO] [61]
   [INFO] [62]
   [INFO] [63]
   [INFO] [64]
   [INFO] [65]
   [INFO] [66]
   [INFO] [67]
   [INFO] [68]
   [INFO] [69]
   [INFO] [70]
   [INFO] [71]
   [INFO] [72]
   [INFO] [73]
   [INFO] [74]
   [INFO] [75]
   [INFO] [76]
   [INFO] [77]
   [INFO] [78]
   [INFO] [79]
   [INFO] [80]
   [INFO] [81]
   [INFO] [82]
   [INFO] [83]
   [INFO] [84]
   [INFO] [85]
   [INFO] [86]
   [INFO] area contents overflows area in line 
   [INFO] [87]
   [INFO] [88]
   [INFO] [89]
   [INFO] area contents overflows area in line 
   [INFO] [90]
   [INFO] [91]
   [INFO] [92]
   [INFO] [93]
   [INFO] [94]
   [INFO] [95]
   [INFO] [96]
   [INFO] [97]
   [INFO] [98]
   [INFO] [99]
   [INFO] [100]
   [INFO] [101]
   [INFO] [102]
   [INFO] [103]
   [INFO] [104]
   [WARNING] table-layout=auto is not supported, using fixed!
   [INFO] [105]
   [INFO] [106]
   [INFO] [107]
   [INFO] [108]
   [INFO] [109]
   [INFO] [110]
   [INFO] [111]
   [INFO] [112]
   [INFO] [113]
   [INFO] [114]
   [INFO] [115]
   [INFO] [116]
   [INFO] [117]
   [INFO] [118]
   [INFO] [119]
   [INFO] [120]
   [INFO] [121]
   [INFO] [122]
   [INFO] [123]
   [INFO] [124]
   [INFO] [125]
   [INFO] [126]
   [INFO] [127]
   [INFO] [128]
   [INFO] [129]
   [INFO] [130]
   [INFO] [131]
   [INFO] [132]
   [INFO] [133]
   [INFO] [134]
   [INFO] [135]
   [INFO] [136]
   [INFO] [137]
   [INFO] [138]
   [INFO] [139]
   [INFO] [140]
   [INFO] [141]
   [INFO] [142]
   [INFO] [143]
   [INFO] [144]
   [INFO] [145]
   [INFO] [146]
   [INFO] [147]
   [INFO] [148]
   [INFO] [149]
   [INFO] [150]
   [INFO] [151]
   [INFO] [152]
   [INFO] [153]
   [INFO] [154]
   [INFO] [155]
   [INFO] [156]
   [INFO] [157]
   [INFO] [158]
   [INFO] [159]
   [INFO] [160]
   [INFO] [161]
   [INFO] [162]
   [INFO] [163]
   [INFO] [164]
   [INFO] [165]
   [INFO] [166]
   [INFO] [167]
   [INFO] [168]
   [INFO] [169]
   [INFO] [170]
   [INFO] [171]
   [INFO] [172]
   [INFO] [173]
   [INFO] [174]
   [INFO] [175]
   [INFO] area contents overflows area in line 
   [INFO] area contents overflows area in line 
   [INFO] [176]
   [INFO] [177]
   [INFO] [178]
   [INFO] [179]
   [INFO] [180]
   [INFO] area contents overflows area in line 
   [INFO] area contents overflows area in line 
   [INFO] area contents overflows area in line 
   
And then that last line repeats... for about 50,000 more lines (!),
until I gave up and hit ^C:

   make[1]: *** Deleting file `book/book.pdf'
   make[1]: *** [book/book.pdf] Error 130
   make: *** [doc-book-pdf] Interrupt

If this is not an infinite loop, it sure looks like one.

Any ideas, People of the Book?

-Karl

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org

Re: Documentation build broken with latest doc tools?

Posted by kf...@collab.net.
David Summers <da...@summersoft.fay.ar.us> writes:
> I just built the 0.27.0 candidate on RedHat 9 and noticed no problems 
> generating the book documentation.  Maybe I should try on Redhat 7.3?

Try making the release, or just the book documentation?  I'm hoping
the former -- that would be huge.  The branch is already done, the
CHANGES file is done.  I was at step 4 in releases.txt:

   $ svn co http://svn.collab.net/repos/svn/branches/release-0.27.0 rel-0.27
   $ cd rel-0.27
   $ ./dist.sh 0.27.0 6715

...when I got stopped by an unbelievable libtool compatibility problem
that is so intricate, and yet stupid, that I don't want to go into it,
except to say that building the release appears to be cursed for me
today.  And that the libtool-1.4.3 and 1.5 sources have been removed
from the GNU site and its mirrors for "authentication" (whatever that
means -- I'm just echoing what they said in the placeholder READMEs
they left behind).

If you could finish off the release, I'd be eternally(*) grateful.

-K

(*) Use of the word "eternally" does not guarantee the existence of an
    immortal soul; void where prohibited by law.

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org

Re: Documentation build broken with latest doc tools?

Posted by David Summers <da...@summersoft.fay.ar.us>.
I just built the 0.27.0 candidate on RedHat 9 and noticed no problems 
generating the book documentation.  Maybe I should try on Redhat 7.3?

   - David

On Tue, 12 Aug 2003 kfogel@collab.net wrote:
> In the process of rolling the 0.27.0 distribution, I've encountered
> what appears to be brokenness in the Book build.  (The release is not
> held up, I'll just use some prebuilt docs Ben has.)
> 
> Here's what I did.  First, I installed the latest versions of all the
> tools as described in doc/book/README:
> 
>    - docbook-xsl-1.61.3.tar.gz
>    - libxml2-2.5.9.tar.gz
>    - libxslt-1.0.32.tar.gz
>    - fop-0.20.5-bin.tar.gz (installed into doc/book/tools/fop/)
>    - jimi1_0.tar.Z (cp Jimi/examples/AppletDemo/JimiProClasses.jar fop/lib/)
> 
> Then I ran 
> 
>    $ autogen.sh
>    $ ./configure --enable-maintainer-mode
>    $ ./dist.sh 0.27.0 6715
> 
> Below is the output of dist.sh.  (Don't worry about the "WARNING"
> regarding the docs/ directory, I expected that and it doesn't indicate
> any actual version skew.)
> 
>    Distribution will be named: subversion-0.27.0
>         constructed from path: /branches/release-0.27.0
>    * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
>    *                                                             *
>    * WARNING:  The docs/ directory in your working copy does not *
>    *           appear  to  have the same revision number  as the *
>    *           distribution revision you requested.  Since these *
>    *           documents will be the ones included in your final *
>    *           tarball, please  be  sure they reflect the proper *
>    *           state.                                            *
>    *                                                             *
>    * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
>    Cleaning old docs in docs/ ...
>    for d in doc/programmer/design doc/book/book doc/book/misc-docs ;                               \
>            do                                                  \
>                (cd $d;                                        \
>                 rm -f *.info *.info-[1-9]                      \
>                       *.aux *.cp *.fn *.ky *.log *.pg *.toc    \
>                       *.tp *.vr                                \
>                       *.dvi *.txt *.html *.ps *.pdf *.fo);     \
>            done
>    Building new docs in docs/ ...
>    /usr/local/bin/makeinfo -I `dirname doc/programmer/design/svn-design.texi` -o doc/programmer/design/svn-design.info doc/programmer/design/svn-design.texi 
>    /usr/local/bin/makeinfo -I `dirname doc/programmer/design/svn-design.texi` --no-split --html -o doc/programmer/design/svn-design.html doc/programmer/design/svn-design.texi
>    /usr/local/bin/makeinfo -I `dirname doc/programmer/design/svn-design.texi` --no-headers -o doc/programmer/design/svn-design.txt doc/programmer/design/svn-design.texi
>    cd doc/book && make book-html
>    make[1]: Entering directory `/home/kfogel/src/release-0.27/doc/book'
>    6712
>    xsltproc --stringparam html.stylesheet styles.css \
>               --output ./book/book.html ./tools/xsl/html/docbook.xsl ./book/book.xml
>    make[1]: Leaving directory `/home/kfogel/src/release-0.27/doc/book'
>    cd doc/book && make book-pdf
>    make[1]: Entering directory `/home/kfogel/src/release-0.27/doc/book'
>    xsltproc  \
>       --output ./book/book.fo ./tools/fo-stylesheet.xsl ./book/book.xml
>    Making portrait pages on USletter paper (8.5inx11in)
>    ./tools/bin/run-fop.sh . -fo ./book/book.fo -pdf ./book/book.pdf
>    (Using './tools/fop/fop.sh' for FOP)
>    [INFO] Using org.apache.xerces.parsers.SAXParser as SAX2 Parser
>    [INFO] FOP 0.20.5
>    [INFO] Using org.apache.xerces.parsers.SAXParser as SAX2 Parser
>    [INFO] building formatting object tree
>    [INFO] setting up fonts
>    [INFO] [1]
>    [INFO] [2]
>    [INFO] [3]
>    [INFO] [4]
>    [INFO] [5]
>    [INFO] [6]
>    [INFO] [7]
>    [INFO] [8]
>    [INFO] [9]
>    [INFO] [10]
>    [INFO] [11]
>    [INFO] [12] (blank)
>    [INFO] [1]
>    [INFO] [2]
>    [INFO] [3]
>    [INFO] [4]
>    [INFO] JAI support was not installed (read: not present at build time). Trying to use Jimi instead
>    [INFO] [5]
>    [INFO] [6]
>    [INFO] [7]
>    [INFO] [8]
>    [INFO] [9]
>    [INFO] [10]
>    [INFO] [11]
>    [INFO] [12]
>    [WARNING] table-layout=auto is not supported, using fixed!
>    [INFO] [13]
>    [INFO] [14]
>    [INFO] [15]
>    [INFO] [16]
>    [INFO] [17]
>    [INFO] [18]
>    [INFO] [19]
>    [INFO] [20]
>    [INFO] [21]
>    [INFO] [22]
>    [INFO] [23]
>    [INFO] [24]
>    [INFO] [25]
>    [INFO] [26]
>    [INFO] [27]
>    [INFO] [28]
>    [INFO] [29]
>    [INFO] [30]
>    [INFO] [31]
>    [INFO] [32]
>    [INFO] [33]
>    [INFO] [34]
>    [INFO] [35]
>    [INFO] [36]
>    [INFO] [37]
>    [INFO] [38]
>    [INFO] [39]
>    [INFO] [40]
>    [INFO] [41]
>    [INFO] [42]
>    [INFO] [43]
>    [INFO] [44]
>    [INFO] [45]
>    [INFO] [46]
>    [INFO] [47]
>    [INFO] [48]
>    [INFO] [49]
>    [INFO] [50]
>    [INFO] [51]
>    [INFO] [52]
>    [INFO] [53]
>    [INFO] [54]
>    [INFO] [55]
>    [INFO] [56]
>    [INFO] [57]
>    [INFO] [58]
>    [INFO] [59]
>    [INFO] [60]
>    [INFO] [61]
>    [INFO] [62]
>    [INFO] [63]
>    [INFO] [64]
>    [INFO] [65]
>    [INFO] [66]
>    [INFO] [67]
>    [INFO] [68]
>    [INFO] [69]
>    [INFO] [70]
>    [INFO] [71]
>    [INFO] [72]
>    [INFO] [73]
>    [INFO] [74]
>    [INFO] [75]
>    [INFO] [76]
>    [INFO] [77]
>    [INFO] [78]
>    [INFO] [79]
>    [INFO] [80]
>    [INFO] [81]
>    [INFO] [82]
>    [INFO] [83]
>    [INFO] [84]
>    [INFO] [85]
>    [INFO] [86]
>    [INFO] area contents overflows area in line 
>    [INFO] [87]
>    [INFO] [88]
>    [INFO] [89]
>    [INFO] area contents overflows area in line 
>    [INFO] [90]
>    [INFO] [91]
>    [INFO] [92]
>    [INFO] [93]
>    [INFO] [94]
>    [INFO] [95]
>    [INFO] [96]
>    [INFO] [97]
>    [INFO] [98]
>    [INFO] [99]
>    [INFO] [100]
>    [INFO] [101]
>    [INFO] [102]
>    [INFO] [103]
>    [INFO] [104]
>    [WARNING] table-layout=auto is not supported, using fixed!
>    [INFO] [105]
>    [INFO] [106]
>    [INFO] [107]
>    [INFO] [108]
>    [INFO] [109]
>    [INFO] [110]
>    [INFO] [111]
>    [INFO] [112]
>    [INFO] [113]
>    [INFO] [114]
>    [INFO] [115]
>    [INFO] [116]
>    [INFO] [117]
>    [INFO] [118]
>    [INFO] [119]
>    [INFO] [120]
>    [INFO] [121]
>    [INFO] [122]
>    [INFO] [123]
>    [INFO] [124]
>    [INFO] [125]
>    [INFO] [126]
>    [INFO] [127]
>    [INFO] [128]
>    [INFO] [129]
>    [INFO] [130]
>    [INFO] [131]
>    [INFO] [132]
>    [INFO] [133]
>    [INFO] [134]
>    [INFO] [135]
>    [INFO] [136]
>    [INFO] [137]
>    [INFO] [138]
>    [INFO] [139]
>    [INFO] [140]
>    [INFO] [141]
>    [INFO] [142]
>    [INFO] [143]
>    [INFO] [144]
>    [INFO] [145]
>    [INFO] [146]
>    [INFO] [147]
>    [INFO] [148]
>    [INFO] [149]
>    [INFO] [150]
>    [INFO] [151]
>    [INFO] [152]
>    [INFO] [153]
>    [INFO] [154]
>    [INFO] [155]
>    [INFO] [156]
>    [INFO] [157]
>    [INFO] [158]
>    [INFO] [159]
>    [INFO] [160]
>    [INFO] [161]
>    [INFO] [162]
>    [INFO] [163]
>    [INFO] [164]
>    [INFO] [165]
>    [INFO] [166]
>    [INFO] [167]
>    [INFO] [168]
>    [INFO] [169]
>    [INFO] [170]
>    [INFO] [171]
>    [INFO] [172]
>    [INFO] [173]
>    [INFO] [174]
>    [INFO] [175]
>    [INFO] area contents overflows area in line 
>    [INFO] area contents overflows area in line 
>    [INFO] [176]
>    [INFO] [177]
>    [INFO] [178]
>    [INFO] [179]
>    [INFO] [180]
>    [INFO] area contents overflows area in line 
>    [INFO] area contents overflows area in line 
>    [INFO] area contents overflows area in line 
>    
> And then that last line repeats... for about 50,000 more lines (!),
> until I gave up and hit ^C:
> 
>    make[1]: *** Deleting file `book/book.pdf'
>    make[1]: *** [book/book.pdf] Error 130
>    make: *** [doc-book-pdf] Interrupt
> 

-- 
David Wayne Summers          "Linux: Because reboots are for hardware upgrades!"
david@summersoft.fay.ar.us   PGP Key: http://summersoft.fay.ar.us/~david/pgp.txt
PGP Key fingerprint =  C0 E0 4F 50 DD A9 B6 2B  60 A1 31 7E D2 28 6D A8 


---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org