[dbdoclet] Re: Problems with dbdoclet 1.6.205 (Java 1.6)

Hello Udo,

your problem should be solved with new version 1.7 of dbdoclet.

Regards
Michael

Hempel, Udo schrieb:
>
> 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: