The OODoc module is designed to create manual pages independent from the source of the information and the type of output. The documentation may be extracted from the source code with a parser (like the Markov parser, which extends the syntax of POD with logical markup) and the output may be plain POD or HTML. OODoc can be extended with new input parsers and output formatters in an Object Oriented way. OODoc supports features to improve the documentation of Object Oriented modules.
Examples of OODocThis website is a demonstration of the output of the OODoc::Format::Html formatter, which uses templates to describe the pages. A much simpler example of OODoc is demonstrated by the html of the MIME::Types module. Both set-ups are included in the module's distribution as example, and other will follow in the future. WarningThe module is still quite young and therefore due for rapid change. The common structure will stand, but the capabilities will grow fast. This may mean that you want to adapt to each next release of the module, which will cost you some time for each release. I will do my best to be backwards compatible. Mark Overmeer. Documentation of OODoc version , produced with OODoc on . |