[dbdoclet] Re: Package overviews in reference style

Hello Jere,

thank you for your bug report. I will fix this as soon as poosible.

Regards
Michael

Jere.Kapyaho@xxxxxxxxx wrote:
>Hello Michael,
>
>I returned to dbdoclet after a short pause and tried the reference style with 
>0.64.2. Seems there is a slight problem with package overview files with the 
>reference style, or it could be just my ignorance...
>
>If I put a package.html file in the root directory of some package in the 
>normal JavaDoc way and then generate DocBook XML, the contents of the file are 
>included, but not as DocBook XML markup. That is, given a package.html file 
>with this content:
>
><body>
><p>This is the package overview for the second package.</p>
><h2>Subheading</h2>
><p>Some explanation of the second package contents goes here.</p>
></body>
>
>The result is the following markup in docs/Reference.xml:
>
><reference id="PACKAGE-1" xreflabel="com.acme.something.package1">
>  <title>Package com.acme.something.package1</title>
>This is the package overview for the first package.<emphasis 
>remap="h2" role="bold">Subheading</emphasis>SubheadingSome explanation of the 
>package contents goes here.
>  <refentry id="CLASS-1" xreflabel="com.acme.something.package1.Inspectable">
>
>(and so on)
>
>Maybe the p tag should be replaced with para, and the h2 maybe with 
>'bridgehead renderas="sect2"' or similar? Or is there another way to get the 
>package.html contents in there neatly? Maybe you haven't had trouble with this 
>because you don't seem to use package descriptions in the dbdoclet source code.
>
>--Jere
>
>  


-- 
-------------------------------------
Dipl.-Ing. (FH) Michael Fuchs
Phone: 0 81 61/ 14 41 66
Fax: 0 81 61/ 14 05 21
E-Mail: michael.fuchs@xxxxxxxxxxxxxxx
Homepage: http://www.dbdoclet.org


begin:vcard
fn:Michael Fuchs
n:Fuchs;Michael
adr;quoted-printable:;;Thalhauser Fu=C3=9Fweg 
9b;Freising;Bayern;85354;Deutschland
email;internet:michael.fuchs@xxxxxxxxxxxxxxx
tel;work:+49 (0) 81 61 14 41 66
tel;fax:+49 (0) 81 61 14 05 21
tel;cell:+ 49 (0) 16 07 84 53 84
url:http://www.dbdoclet.org
version:2.1
end:vcard

Other related posts: