Autodia.pm - The configuration and Utility perl module for AutoDia.

AutoDia takes source files as input and using a handler parses them to create documentation through templates. The handlers allow AutoDia to parse any language by providing a handler and registering in in autodia.pm. The templates allow the output to be heavily customised from Dia XML to simple HTML and seperates the logic of the application from the presentation of the results.

AutoDia is written in perl and defaults to the perl handler and file extension matching unless a language is specified using the -l switch.

AutoDia requires Template Toolkit and Perl 5. Some handlers and templates may require additional software, for example the Java SDK for the java handler.

Helpful information, links and news can be found at the autodia website - http://droogs.org/autodia/

To add handlers or languages edit this file.

To add a handler/parser

Add the language or name of the parser and the name of the module to the CW%handlers hash in the get_handlers function.

for example :

perl => 'HandlerPerl',

Documentation on writing yoru own handler can be found in the HandlerPerl and Handler perl modules

To add a new language or file extension or file matching patter

Add the name of the pattern and a hashreference to its properties to CW%patterns in the get_patterns function.

for example :

perl => \%perl,

Create a hash of its properties that will be pointed to by the above hashref

for example :

my CW%perl = ( regex => '\w+\.p[ml]$', wildcards => [ pl, pm, ], );

use the autodia.pl script to run autodia.

autodia.pl ([-i filename [-p path] ] or [-d directory [-r] ]) [options]

autodia.pl -i filename : use filename as input

autodia.pl -i 'filea fileb filec' : use filea, fileb and filec as input

autodia.pl -i filename -p .. : use ../filename as input file

autodia.pl -d directoryname : use *.pl/pm in directoryname as input files

autodia.pl -d 'foo bar quz' : use *pl/pm in directories foo, bar and quz as input files

autodia.pl -d directory -r : use *pl/pm in directory and its subdirectories as input files

autodia.pl -o outfile.xml : use outfile.xml as output file (otherwise uses autodial.out.xml)

autodia.pl -m [file|directory] : use multiple output files split by file or directory (creates an autodia-files directory containing files)

autodia.pl -O : output to stdout

autodia.pl -l language : parse source as language (ie: C) and look for appropriate filename extensions if also -d

autodia.pl -t templatefile : use templatefile as template (otherwise uses template.xml)

autodia.pl -S : silent mode, no output to stdout except with -O

autodia.pl -h : display this help message