[dbdoclet] Problems with dbdoclet 1.6.205 (Java 1.6)

Hi everybody,

I've some problems with dbdoclet, maybe someone can help

1) If I specify an overview.html file in the JavaDoc params I get the following:

  [javadoc] Constructing Javadoc information...
  [javadoc] Starte dbdoclet...
  [javadoc] Copyright (c) 2001-2007 Michael Fuchs
  [javadoc] Version 1.6 Build 10 (jdk 1.6)
  [javadoc] Analyse der Referenzen...
  [javadoc] Analyse der javadoc tags...
  [javadoc] ##################################################################
  [javadoc] # DEBUG START DocletException
  [javadoc] ##################################################################
  [javadoc] org.dbdoclet.doclet.DocletException
  [javadoc] org.dbdoclet.doclet.DocletException: java.lang.ClassCastException: o
rg.dbdoclet.tag.docbook.DocBookDocument cannot be cast to org.dbdoclet.tag.docbo
ok.DocBookElement
  [javadoc]     at org.dbdoclet.doclet.docbook.BookManager.process(BookManager.j
ava:275)
  [javadoc]     at org.dbdoclet.doclet.docbook.DocBookDoclet.writeContents(DocBo
okDoclet.java:168)
  [javadoc]     at org.dbdoclet.doclet.docbook.DocBookDoclet.start(DocBookDoclet
.java:93)
  [javadoc]     at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
  [javadoc]     at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAcces
sorImpl.java:39)
  [javadoc]     at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMet
hodAccessorImpl.java:25)
  [javadoc]     at java.lang.reflect.Method.invoke(Method.java:597)
  [javadoc]     at com.sun.tools.javadoc.DocletInvoker.invoke(DocletInvoker.java
:215)
  [javadoc]     at com.sun.tools.javadoc.DocletInvoker.start(DocletInvoker.java:
91)
  [javadoc]     at com.sun.tools.javadoc.Start.parseAndExecute(Start.java:340)
  [javadoc]     at com.sun.tools.javadoc.Start.begin(Start.java:128)
  [javadoc]     at com.sun.tools.javadoc.Main.execute(Main.java:41)
  [javadoc]     at com.sun.tools.javadoc.Main.main(Main.java:31)
  [javadoc] Caused by: java.lang.ClassCastException: org.dbdoclet.tag.docbook.Do
cBookDocument cannot be cast to org.dbdoclet.tag.docbook.DocBookElement
  [javadoc]     at org.dbdoclet.transform.html.docbook.editor.HeaderBaseEditor.e
dit(HeaderBaseEditor.java:225)
  [javadoc]     at org.dbdoclet.transform.html.DocBookTransformer.edit(DocBookTr
ansformer.java:521)
  [javadoc]     at org.dbdoclet.transform.html.DocBookTransformer.transform(DocB
ookTransformer.java:274)
  [javadoc]     at org.dbdoclet.doclet.docbook.DbdTransformer.transform(DbdTrans
former.java:264)
  [javadoc]     at org.dbdoclet.doclet.docbook.DbdTransformer.transform(DbdTrans
former.java:186)
  [javadoc]     at org.dbdoclet.doclet.docbook.DbdTransformer.transform(DbdTrans
former.java:155)
  [javadoc]     at org.dbdoclet.doclet.docbook.DbdTransformer.transform(DbdTrans
former.java:116)
  [javadoc]     at org.dbdoclet.doclet.docbook.MediaManager.writeOverview(MediaM
anager.java:164)
  [javadoc]     at org.dbdoclet.doclet.docbook.BookManager.process(BookManager.j
ava:193)
  [javadoc]     ... 12 more
  [javadoc] ================================================================
  [javadoc] CAUSE #0: org.dbdoclet.doclet.docbook.BookManager
  [javadoc] org.dbdoclet.doclet.docbook.BookManager.process(BookManager.java:275
)
  [javadoc] ================================================================
  [javadoc] CAUSE #1: org.dbdoclet.doclet.docbook.DocBookDoclet
  [javadoc] org.dbdoclet.doclet.docbook.DocBookDoclet.writeContents(DocBookDocle
t.java:168)
  [javadoc] ================================================================
  [javadoc] CAUSE #2: org.dbdoclet.doclet.docbook.DocBookDoclet
  [javadoc] org.dbdoclet.doclet.docbook.DocBookDoclet.start(DocBookDoclet.java:9
3)
  [javadoc] ================================================================
  [javadoc] CAUSE #3: sun.reflect.NativeMethodAccessorImpl
  [javadoc] sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
  [javadoc] ================================================================
  [javadoc] CAUSE #4: sun.reflect.NativeMethodAccessorImpl
  [javadoc] sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl
.java:39)
  [javadoc] ================================================================
  [javadoc] CAUSE #5: sun.reflect.DelegatingMethodAccessorImpl
  [javadoc] sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAcce
ssorImpl.java:25)
  [javadoc] ================================================================
  [javadoc] CAUSE #6: java.lang.reflect.Method
  [javadoc] java.lang.reflect.Method.invoke(Method.java:597)
  [javadoc] ================================================================
  [javadoc] CAUSE #7: com.sun.tools.javadoc.DocletInvoker
  [javadoc] com.sun.tools.javadoc.DocletInvoker.invoke(DocletInvoker.java:215)
  [javadoc] ================================================================
  [javadoc] CAUSE #8: com.sun.tools.javadoc.DocletInvoker
  [javadoc] com.sun.tools.javadoc.DocletInvoker.start(DocletInvoker.java:91)
  [javadoc] ================================================================
  [javadoc] CAUSE #9: com.sun.tools.javadoc.Start
  [javadoc] com.sun.tools.javadoc.Start.parseAndExecute(Start.java:340)
  [javadoc] ================================================================
  [javadoc] CAUSE #10: com.sun.tools.javadoc.Start
  [javadoc] com.sun.tools.javadoc.Start.begin(Start.java:128)
  [javadoc] ================================================================
  [javadoc] CAUSE #11: com.sun.tools.javadoc.Main
  [javadoc] com.sun.tools.javadoc.Main.execute(Main.java:41)
  [javadoc] ================================================================
  [javadoc] CAUSE #12: com.sun.tools.javadoc.Main
  [javadoc] com.sun.tools.javadoc.Main.main(Main.java:31)
  [javadoc] ##################################################################
  [javadoc] # DEBUG END DocletException
  [javadoc] ##################################################################

BUILD FAILED

This seems to be independant from the contents of the overview file. I've tried 
a very short HTML file "<HTML><BODY></BODY></HTML>",
a file with a <P> tag as first tag after <body> as well as a file with a <H1> 
tag as first tag. Always the same result.
If I don't specify an overview page in the JavaDoc params the error doesn't 
occur.

2).The fo.xsl file generated with the "tidbits" application contains invalid 
path specifications for "admon.graphics.path" and "callout.graphics.path".
The template in "xslt/fo/dbdoclet.xsl" contains placeholders like 
"@dbdoclet_home@/docbook/xsl/images/". It seems that the variable dbdoclet_home 
ends in a "/" so that the contructed path looks like 
"<some_path>//docbook/xsl/images".
Since I'm an absolute beginner on DocBook and dbdoclet, I can't tell the 
consequences. It's easy to fix this manually, anyway.

3) Without the overview page I've managed to build a PDF from our JavaDocs. 
Unfortunately there are immediate follow-up questions:
a) If the page title text is too long it is split in 2 text lines. The 
graph-line below the page title then goes through the first line of the page 
body.
So, how can I increase the maximum width for the page title text? 
b) How can I automagically scale JPG or SVG graphics to fit on a page?

I hope my english is at least in parts understandable. Sorry, if not. Any help 
highly appreciated.

Regards,
Udo Hempel
------------------------------------------------------
WINCOR NIXDORF International GmbH
Sitz der Gesellschaft: Paderborn
Registergericht Paderborn HRB 3507
Geschäftsführer: Eckard Heidloff (Vorsitzender), Stefan Auerbach, Jürgen Wilde, 
Dr. Jürgen Wunram
Vorsitzender des Aufsichtsrats: Karl-Heinz Stiller 
Steuernummer: 339/5884/0031
Ust-ID Nr.: DE812927716
WEEE-Reg.-Nr. DE44477193

Other related posts: