-
Notifications
You must be signed in to change notification settings - Fork 0
arnuga/Perl--DocGenerator
Folders and files
Name | Name | Last commit message | Last commit date | |
---|---|---|---|---|
Repository files navigation
Perl-DocGenerator This module is my attempt to auto-generate searchable and indexable documentation for a work project that spans over 2 million lines of perl code. Frankly I got tired of new hires over the years asking about docs and having to shrug my shoulders. I didn't really want to write the docs myself so I decided that perl might be able to help with documenting my perl code. This module does it's (my) best at providing documentation about the .pm files you have, what they include, inherit from, etc. It should capture functions, inheritted functions, class methods, packages, package level scalars, arrays, hashes, etc. I'm sure it's missing a lot but it's a start, if you have something better then I'm guessing you wouldn't be reading this. I'm very open to patches, comments, suggestions, etc. Please direct all complaints to /dev/null. Side note; I don't do moose so no, this is not a moose/mouse/mice/whatever class. I haven't looked at how moose works from an inheritance POV so it may not work for you if you're into that sorta thing. Besides isn't moose supposed to be the kitchen sink of "modern perl"? Shouldn't it do this already? INSTALLATION The following CPAN libraries are required for this module to install: Devel::Symdump enum File::Find File::Spec HTML::Template Module::Info Module::Load Pod::POM To install this module, run the following commands: perl Build.PL ./Build ./Build test ./Build install SUPPORT AND DOCUMENTATION After installing, you can find documentation for this module with the perldoc command. perldoc Perl::DocGenerator You can also look for information at: RT, CPAN's request tracker (report bugs here) http://rt.cpan.org/NoAuth/Bugs.html?Dist=Perl-DocGenerator AnnoCPAN, Annotated CPAN documentation http://annocpan.org/dist/Perl-DocGenerator CPAN Ratings http://cpanratings.perl.org/d/Perl-DocGenerator Search CPAN http://search.cpan.org/dist/Perl-DocGenerator/ LICENSE AND COPYRIGHT Copyright (C) 2012 David Shultz 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.
About
Auto-generate documentation from perl code
Resources
Stars
Watchers
Forks
Releases
No releases published
Packages 0
No packages published