I've recently come across the JAVADOC utility which seems to allow self-extraction from Java source of the documentation concerning how a class interface is implemented.
We have a number of tools that we write, and although developers generally maintain the Word document that describes the command interface, I 'm unhappy that we have to rely on human memory to remember. I'd much rather that there was some sort of automated method of generating the printed document.
What I'd like to do is define a template that goes into the Command Processing Program (CLLE) and is marked with special character start and end comments to identify the template for extraction by another program when the source is moved through our Change Management system.
Having extracted the comments, I know realize I'm not quite sure what I should do with them! Currently, each tool we have has it's own word document in a standard template format, and the manual of tools is managed by a word master document of some sort.
In essence, how do I create a file to the IFS in a basic WORD (.doc) format?
Any manuals/redbooks I can refer to? Do I just put it out as a simple text file and then run some other convertor over it?
Any tips would be greatly appreciated.