Has anyone considered converting the docs to Forrest? Forrest is XML based and uses Ant for its process control. Possibly coupling Forrest with AntDoclet will yield both the web site and the PDF that is desired. Of course, this does not preclude the important step that Daniel mentioned "You have to add meaningful information into your sources first", but, it may help some.
I just started using Forrest for some of my web site work. You do not have to convert all files to XML in the first pass. Forrest takes existing HTML files for content as well as XML files. It will also pull in files from whatever source you specify (I think, I have not tried this). I do link to JavaDoc generated files from the XML files and that works. Forrest relies on a sitemap file that maps virtual file names to real file names. Each page in the documentation can have a PDF button on it that links to the PDF version of the page. An example of a site generated with Forrest is http://g11ntoolkit.sourceforge.net. One thing I am not excited about is how long it has been taking the site to come up in my browser. I don't know the cause of the slow down yet but it started happening when I switched to Forrest. I am sure it is something that can be solved with just a SMOP. Documentation for Forrest is located at http://forrest.apache.org/docs_0_70. Bill -----Original Message----- From: Daniel Lindner [mailto:[EMAIL PROTECTED] Sent: Friday, March 03, 2006 7:25 AM To: Ant Users List Subject: Re: Generating PDF documentation . Steve Loughran wrote: > [EMAIL PROTECTED] wrote: > >> Hi , >> Would like to know , how to generate the PDF documentation >> similar to what is found in ANT docs (appendix_e.pdf) . The second step in this process, extracting information from the task sources, can be done with the AntDoclet tool: http://antdoclet.neuroning.com/ You have to add meaningful information into your sources first, though. The AntDoclet comes with XSL-Skripts to convert to HTML. Perhaps its possible to add another conversion step from HTML to PDF or convert directly into PDF. I'm very happy with my generated HTML-Taskdoc. Consider asking Fernando (the AntDoclet author) for the most current version. :) Sincerely, Daniel --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED] --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
