[dbdoclet] Re: [ANNOUNCE] dbdoclet 0.63.0

Hi Michael,

I finally tried 0.64.0 [sic], but I didn't get far, as I get a =
DocletException when I try to use the new reference style:

  [javadoc] org.dbdoclet.doclet.DocletException: [DocletException]
  [javadoc]     at =
org.dbdoclet.doclet.docbook.RefentryManager.writeClass(RefentryManager.ja=
va:602)
  [javadoc]     at =
org.dbdoclet.doclet.docbook.RefentryManager.process(RefentryManager.java:=
205)
  [javadoc]     at =
org.dbdoclet.doclet.docbook.DocBookDoclet.writeContents(DocBookDoclet.jav=
a:166)
  [javadoc]     at =
org.dbdoclet.doclet.docbook.DocBookDoclet.start(DocBookDoclet.java:103)
  [javadoc]     at sun.reflect.NativeMethodAccessorImpl.invoke0(Native =
Method)
  [javadoc]     at =
sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java=
:39)
  [javadoc]     at =
sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorI=
mpl.java:25)
  [javadoc]     at java.lang.reflect.Method.invoke(Method.java:324)
  [javadoc]     at =
com.sun.tools.javadoc.DocletInvoker.invoke(DocletInvoker.java:193)
  [javadoc]     at =
com.sun.tools.javadoc.DocletInvoker.start(DocletInvoker.java:92)
  [javadoc]     at =
com.sun.tools.javadoc.Start.parseAndExecute(Start.java:311)
  [javadoc]     at com.sun.tools.javadoc.Start.begin(Start.java:121)
  [javadoc]     at com.sun.tools.javadoc.Main.execute(Main.java:41)
  [javadoc]     at com.sun.tools.javadoc.Main.main(Main.java:31)

The only things I changed in my 'dbdoclet.properties' since 0.63.0 are =
related to the new/renamed 0.64.0 parameters. It looks like this:

docbook.copyright.holder=3DSome Corporation
docbook.copyright.year=3D2005
docbook.corporation=3DSome Corporation
docbook.part=3Dtrue
doclet.noprolog=3Dtrue
doclet.nodeprecated=3Dtrue
doclet.nosince=3Dtrue
doclet.nostatistics=3Dtrue
doclet.noindex=3Dtrue
docbook.author.email=3Dnobody@xxxxxxxxxxx
docbook.author.surname=3DNobody
docbook.book.title=3DReference
encoding.destination=3DUTF-8
docbook.table.frame=3Dall
doclet.style.type=3Dstrict
doclet.book.type=3Dreference
doclet.use.appendix=3Dtrue

I removed the last two lines but still get a DocletException, however =
now the stack trace is slightly different:

  [javadoc] org.dbdoclet.doclet.DocletException: [DocletException]
  [javadoc]     at =
org.dbdoclet.doclet.docbook.BookManager.writeClass(BookManager.java:567)
  [javadoc]     at =
org.dbdoclet.doclet.docbook.BookManager.process(BookManager.java:194)
  [javadoc]     at =
org.dbdoclet.doclet.docbook.DocBookDoclet.writeContents(DocBookDoclet.jav=
a:171)
(and so on, I only copied the lines that are different.)

I was going to look at the source for some clues, but I couldn't =
download the source package, the link to 'dbdoclet-0.64.0-src.tar.gz' =
was dead. I hope you can deduce something from the stack information =
above.

A few related remarks:
- The parameter 'docbook.part' is not documented.
- The parameter 'docbook.nodeprecated' is documented, but not supported.
- The renamed parameter 'doclet.style.type' is still called =
'doclet.style.flavour' in the documentation.

--Jere

> -----Original Message-----
> From: dbdoclet-bounce@xxxxxxxxxxxxx
> [mailto:dbdoclet-bounce@xxxxxxxxxxxxx]On Behalf Of ext Michael Fuchs
> Sent: Wednesday, April 13, 2005 10:53 PM
> To: dbdoclet@xxxxxxxxxxxxx
> Subject: [dbdoclet] [ANNOUNCE] dbdoclet 0.63.0
>=20
>=20
> *** PGP SIGNATURE VERIFICATION ***
> *** Status:   Unknown Signature
> *** Signer:   Unknown Key (0xBF0198C6)
> *** Signed:   13.4.2005 22:53:07
> *** Verified: 15.4.2005 14:57:07
> *** BEGIN PGP VERIFIED MESSAGE ***
>=20
> Hello,
>=20
> dbdoclet 0.64.0 has been released
>=20
> About:
>=20
> The DocBook Doclet creates DocBook XML from Java source
> documentation or HTML files.
>=20
> Changes:
>=20
> * The new property doclet.book.type controls which type of book
>   should be created. Two type of books are supported: book and
>   reference.  The first creates a book, chapters structure and the
>   second a reference, refentry one.
>=20
> * Renamed the property doclet.style.flavour to doclet.style.type
>   (--style-type).
> =09
> * The new property doclet.use-appendix (--use-appendix) controls
>   whether appendix components should be used or not. The default is
>   to use only chapters. When this flag is set, certain parts of the
>   document will be created as appendix.
>=20
> * If constant field values are of type java.lang.String, they are
>   surrounded by double quotes now.
>=20
> * Fixed spurious whitespace in para and xref tags.
>=20
> * Fixed missing id in table tag.
>=20
> * Fixed erroneous entity handling in constant values section.
>   dbdoclet can be obtained at www.dbdoclet.org
>=20
> Regards
> Michael
>=20
>=20
>=20
>=20
> *** END PGP VERIFIED MESSAGE ***
>=20
>=20

Other related posts: