[dbdoclet] Re: [ANNOUNCE] dbdoclet 0.55.0

On Today at 4:15pm, MF=>Michael Fuchs <MichaelFuchs@xxxxxxxxxxx> wrote:

MF> Hello,
MF> 
MF> dbdoclet 0.55.0 has been released
MF> 

Hi Michael,

I decided to go from dbdoclet version 0.53.1 to 0.55 and encountered a few 
problems resulting in unsuccessful PDF file creation.

The actual doclet creation is successful, as I see:

     [echo] Creating docbook
  [javadoc] Generating Javadoc
  [javadoc] Javadoc execution
....snip....
  [javadoc] Constructing Javadoc information...
  [javadoc] Running dbdoclet...
  [javadoc] Copyright (C) 2001-2004 Michael Fuchs
  [javadoc] Release 0.55.0 200403091440
  [javadoc] Setting options...
  [javadoc] Constructing DocBook...
....snip....
  [javadoc] Constructing statistics...
  [javadoc] Collecting statistical data...
  [javadoc] Creating totals diagram...

Its the FOP process that's tripping me up.

I get some warnings:

     [echo] Converting to PDF
     [java] [INFO] Using org.apache.crimson.parser.XMLReaderImpl as SAX2 
Parser
     [java] [INFO] FOP 0.20.5
     [java] [INFO] Using org.apache.crimson.parser.XMLReaderImpl as SAX2 
Parser
     [java] http://www.oasis-open.org/docbook/xml/4.2/ent/iso-lat2.ent; 
Line #49; Column #-1; Parser warning: Using original entity definition for 
"&inodot;".
     [java] http://www.oasis-open.org/docbook/xml/4.2/ent/iso-num.ent; 
Line #19; Column #-1; Parser warning: Using original entity definition for 
"&lt;".
     [java] http://www.oasis-open.org/docbook/xml/4.2/ent/iso-num.ent; 
Line #21; Column #-1; Parser warning: Using original entity definition for 
"&gt;".
     [java] http://www.oasis-open.org/docbook/xml/4.2/ent/iso-num.ent; 
Line #31; Column #-1; Parser warning: Using original entity definition for 
"&amp;".
     [java] http://www.oasis-open.org/docbook/xml/4.2/ent/iso-num.ent; 
Line #61; Column #-1; Parser warning: Using original entity definition for 
"&quot;".
     [java] http://www.oasis-open.org/docbook/xml/4.2/ent/iso-num.ent; 
Line #62; Column #-1; Parser warning: Using original entity definition for 
"&apos;".
     [java] 
file:/home/haroon/dbdoclet-0.55/share/dbdoclet/docbook/xsl/fo/docbook.xsl; 
Line #197; Column #-1; Making portrait pages on USletter paper 
(8.5inx11in)
     [java] [INFO] building formatting object tree
     [java] [INFO] setting up fonts
     [java] [INFO] [1]
     [java] [INFO] [2]
....snip....

Now this is really odd. This is actually a .png file that's inside a 
doc-files directory, but somehow its looking for a .jpg file instead.

     [java] [ERROR] Error while creating area : Error while recovering 
Image Informations 
(file:/home/haroon/tomcat/sis/dist/docs/api/figures/ca/utoronto/sis/action/StudentWebServiceRequestProcessorFlowChart.jpg)
 
: 
/home/haroon/tomcat/sis/dist/docs/api/figures/ca/utoronto/sis/action/StudentWebServiceRequestProcessorFlowChart.jpg
 
(No such file or directory)
     [java] [INFO] [11]
     [java] [INFO] [12]
     [java] [INFO] [13]
     [java] [INFO] [14]
....snip....

Finally, it blows up at:

     [java] [INFO] [71]
     [java] [INFO] [71]
     [java] [ERROR] org.apache.fop.apps.FOPException: internal-destination 
or external-destination must be specified in basic-link

and I get an ant BUILD FAILED message.

Any ideas what's going on here? This used to work fine in 0.53.1 (except 
for a few warnings). Can I send you my docbook file? Don't know what else 
to try here.

I have another issue that I want to investigate as well. If I was to untar 
the dbdoclet binary distribution on a clean system in a user's home 
directory, what is the possibility of getting runexamples.sh to run 
properly without depending on dbdoclet being installed in 
/usr/share/dbdoclet. As it is, if I have nothing in /usr/share/dbdoclet 
the runexample.sh task fails. Even if I install something in 
/usr/share/dbdoclet, Running example #1 fails with

javadoc: invalid flag: -pdf

Cheers,
--
Haroon Rafique
<haroon.rafique@xxxxxxxxxxx>

Other related posts: