spadgos / sublime-jsdocs

Simplifies writing DocBlock comments in Javascript, PHP, CoffeeScript, Actionscript, C & C++
MIT License
3.11k stars 278 forks source link

Perl Support #457

Open davmillar opened 6 years ago

davmillar commented 6 years ago

Support for Perl would be nice. POD, as those Perl folks refer to it. A little weird how they put it all at the end of the file, but what do I know?

Example of it:

# ABSTRACT: Foo bar my foo and my bar
# PODNAME: Foo:Bar

=head1 SYNOPSIS

    use Modern::Perl;
    use Foo::Bar;

=head1 DESCRIPTION

The foo instance is a singleton that does foo and bar.

=head1 ATTRIBUTES

=head2 config( HashRef )

This accessor is for foo bar use only.

=head1 METHODS

=head2 BUILD (don't invoke this method directly)

Does whatever is necessary to load.

=head2 do_foo(Int $foo_id, Int $user_id)

Does fooey foo to the barry bar.