|
NAMEToader::AutoDoc - Automatically build documentation from specified directories.VERSIONVersion 0.2.0METHODSnewThis initiates the object.One argument is required and it is a Toader object. my $foo = Toader::AutoDoc->new( $toader ); if ( $foo->error ){ warn('error:'.$foo->error.': '.$foo->errorString); } dirGetThis gets Toader directory this entry is associated with.This will only error if a permanent error is set. This will return undef if no directory has been set. my $dir=$foo->dirGet; if($foo->error){ warn('Error:'.$foo->error.': '.$foo->errorString); } dirSetThis sets Toader directory this entry is associated with.One argument is taken and it is the Toader directory to set it to. my $dir=$foo->dirSet($toaderDirectory); if($foo->error){ warn('Error:'.$foo->error.': '.$foo->errorString); } findDocsFinds documentation under the specified paths.pathAddThis adds a new path.pathRemoveRemove a specified path.pathsGetThis gets the list of what is to by handled.No arguments are taken. The returned value is a list. Each item in the list is a path to recursively search. my @paths=$foo->pathsGet; pathsSetThis sets the AutoDoc paths for a directory.One argument is required and that is a array ref of relative paths. $foo->pathsSet( \@paths ); validPathThis verifies that a path is valid.It makes sure it defined and does not match any thing below. ^..\/ \/..\/ \/..$ REQUIRED RENDERING METHODSfilesDirThis returns the file directory for the object.This is not a full path, but a partial path that should be appended the directory current directory being outputted to. locationIDThis returns the location ID.This one requires the object to be initialized. renderDirThis is the directory that it will be rendered to.The base directory that will be used for rendering. renderUsingThis returns the module to use for rendering.my $module=$foo->renderUsing; toaderRenderableThis method returns true and marks it as being Toader renderable.toDirThis returns the relative path to the object.This is not a full path, but a partial path that should be appended the directory current directory being outputted to. ERROR CODES1, noDirSpecifiedNo directory specified.2, notAtoaderDirThe directory is not a Toader directory.3, pathsFileOpenFailedFailed to open the paths file.4, noDirSetNo directory set.5, noPathSpecifiedNo path specified.6, invalidPathInvalid path.7, dirCreationFailedThe AutoDoc configuration directory could not be created.8, notAtoaderObjThe specified object is not a Toader object.9, getVCSerroredToader::VCS->getVCS errored.10, VCSusableFailedErroredToader::VCS->VCSusable errored.11, underVCSerroredToader::VCS->underVCS errored.12, VCSaddErroredToader::VCS->add errored.13, noToaderObjAUTHORZane C. Bowers-Hadley, "<vvelox at vvelox.net>"BUGSPlease report any bugs or feature requests to "bug-toader at rt.cpan.org", or through the web interface at <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Toader>. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.SUPPORTYou can find documentation for this module with the perldoc command.perldoc Toader::AutoDoc You can also look for information at:
ACKNOWLEDGEMENTSLICENSE AND COPYRIGHTCopyright 2013 Zane C. Bowers-Hadley.This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License. See http://dev.perl.org/licenses/ for more information.
Visit the GSP FreeBSD Man Page Interface. |