Skip to content

arnuga/Perl--DocGenerator

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

35 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

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

No packages published

Languages