Sign In/My Account | View Cart  

advertisement

AddThis Social Bookmark Button

Article:
  Creating an Online Help System with JavaHelp and DocBook
Subject:   JavaDoc?
Date:   2003-10-16 12:25:03
From:   anonymous2
Great article!


I would like to be able to integrate automatically generated Javadoc with text and illustrations. From the elaborate text parts I would like to have links/references to class documentation in Javadoc (used as a reference section).


There is a tool that makes Docbook XML from Javadoc, (Docbook Doclet) but I find it hard to integrate other material into the resulting document.


Imagine an ant task that creates Javadoc and merges that with more elaborate texts/illustration/UML diagrams into JavaHelp, PDF, HTML etc. Updated documentation every day.


Any thoughts on this?
Full Threads Oldest First

Showing messages 1 through 1 of 1.

  • JavaDoc?
    2003-10-16 19:49:21  anonymous2 [View]

    Maybe you could generate the Javadoc into docbook using the doclet and combine it with the generated help docbook file by using an XQuery script to merge the two. I haven't used XQuery with docbook but since it can be in XML format then it should be possible.

    There are severl XQuery engines availalbe - I have had some success with Kawa.

    Anyway my 2 cents.