[dbdoclet] Case in xml:id values
- From: "Lillian Sullam" <lsullam@xxxxxxxxxxx>
- To: dbdoclet@xxxxxxxxxxxxx
- Date: Tue, 6 Jan 2009 17:51:25 -0800
When dbdoclet creates an xml:id value for cross-references, it appears to
lower-case class names and method names, for example, the method
"digitalQuery" generates an xml:id of "method...digitalquery". Java is
case-sensitive, so method "digitalQuery" is different from the method
"DigitalQuery". Should the xml:id values preserve case? I notice that
dbdoclet goes to the trouble of including the parameter signature in the
xml:id values, which is very nice. It would be nice to preserve the class
and method case as well.
I would like the xml:id values to preserve Java case, so we can perform
global transformations on the DocBook output that rely on matching all
occurrences of specific method names, even if those names occur inside an
"xml:id". I am using dbdoclet and javadoc to document a Java interface and a
corresponding C++ interface using DocBook. There are some global changes
between the interfaces, for example, Java 'boolean' becomes C++ 'bool'.
These changes are easy to make. I also have to change some method names, and
I want to change both the method names and the corresponding xml:id values,
so the Java dbdoclet DocBook output and the transformed C++ DocBook files
can be incorporated into one DocBook document.
Other related posts: