[dbdoclet] Overview.html & the docbook.chapter.overview.title property

Hi,

First of all, I wish to express my compliments on
dbdoclet! It's a powerful tool and by far the best PDF
creation tool I've used. 

I had a question on the overview ability. I read the
section describing supplying a custom overview, §4.1
in the dbdoclet manual. It says that if the first tag
following <body> is <h1> then that heading (and any
subsequent <h1>s) is used as chapters in the .pdf. I
created a simple overview.html containing 3 <h1>s, one
of which immediately follows <body>. I do get all the
<h1> headings as chapter headings, but they occur
after Chapter 1, i.e. they become chapters 2, 3, and 4
instead of 1, 2, and 3 as I expected. The value of
chapter 1 appears to be dependent on the
"docbook.chapter.overview.title" property in
dbdoclet.properties. When I set this property to "",
the chapter still exists, though it doesn't have a
title (i.e. it shows up as "Chapter 1."). If I comment
out that property, the chapter shows up as "Chapter 1.
Overview". 

Does anyone have any tips on getting the <h1>s
supplied in overview.html to show up starting with
chapter 1 instead of chapter 2?

For some background configuration info:

I run the following Ant javadoc target:
<javadoc access="protected"
  destdir="${output.dbdoclet.dir}"
  docencoding="UTF-8" 
  encoding="ISO-8859-15" 
  failonerror="yes" 
  maxmemory="512m"
  overview="${dbdoclet.overview.file}"
  packagenames="${packages}"
>

<sourcepath refid="dbdoclet.sourcepath"/>
<classpath refid="dbdoclet.classpath"/>

<doclet 
    name="org.dbdoclet.doclet.docbook.DocBookDoclet" 
    path="${lib.dbdoclet.dir}/dbdoclet.jar">
  <param name="-properties" 
    value="${lib.dbdoclet.dir}/dbdoclet.properties"/>
  <param name="-nostatistics" />
  <param name="-f" value="${output.filename}.xml" />
</doclet>
</javadoc>

dbdoclet version: 0.55.3
javadoc version: 1.4.2_04-b05

Thanks,

Paul


__________________________________
Do you Yahoo!?
Yahoo! Small Business $15K Web Design Giveaway 
http://promotions.yahoo.com/design_giveaway/

Other related posts: