Hes, > I have a template that transforms this to xdoc format as expected. It > works quite well already!
Sounds great. > It's a bit tedious to copy the original xdocs file back to the xdoclet > template, but it may be worth the trouble. I think it would be worth it. I haven't got any experience of xdoclet, apart from watching it in action, but I think this is the way to go. My plan for docs is that 1/ we have the website as a seperate "component" managed independantly 2/ the release manager is responsible for also building docs for the release version (no need for this to involve more than an extra commit of the generated docs) 3/ docs will be published under version label directories so that we can have multiple doc sets live at once, say "stable" and "head" 4/ historic docs would still be available in downloads or split downloads into src, bin , & doc This means that xdoclet would be a great way of documenting mailets & matchers, but also means that we would separate website from product docs so that we could move towards a "manual" style rather than a web-site style, for the product docs. I think Ant is a good example of what I'm thinking. We might even find it worthwhile using xdoclet for documenting more components which implement public interfaces, such as processor, mail repository, and protocol handler. WDYT? d. (p.s. it might be better to move this discussion to [EMAIL PROTECTED]) *************************************************************************** The information in this e-mail is confidential and for use by the addressee(s) only. If you are not the intended recipient (or responsible for delivery of the message to the intended recipient) please notify us immediately on 0141 306 2050 and delete the message from your computer. You may not copy or forward it or use or disclose its contents to any other person. As Internet communications are capable of data corruption Student Loans Company Limited does not accept any responsibility for changes made to this message after it was sent. For this reason it may be inappropriate to rely on advice or opinions contained in an e-mail without obtaining written confirmation of it. Neither Student Loans Company Limited or the sender accepts any liability or responsibility for viruses as it is your responsibility to scan attachments (if any). Opinions and views expressed in this e-mail are those of the sender and may not reflect the opinions and views of The Student Loans Company Limited. This footnote also confirms that this email message has been swept for the presence of computer viruses. ************************************************************************** --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
