NAME

VERSION

DESCRIPTION

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.

Helpful information, links and news can be found at the autodia website - http://www.aarontrevena.co.uk/opensource/autodia/

METHODS

getHandlers =item getPattern =item setConfig

Configuring AutoDia via Autodia.pm

To add a handler/parser

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

for example :

"perl" => 'HandlerPerl',

Documentation on writing your 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 %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 %perl = ( regex => '\w+\.p[ml]$', wildcards => [ "pl", "pm", ], );

USAGE

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

AUTHOR

COPYRIGHT AND LICENSE

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.1 or, at your option, any later version of Perl 5 you may have available.