NAME
    Sub::Spec::To::Pod - Generate POD documentation from sub spec

VERSION
    version 0.21

SYNOPSIS
     % perl -MSub::Spec::To::Pod=gen_module_subs_pod \
         -e'print gen_module_subs_pod(module=>"MyModule")'

DESCRIPTION
    NOTICE: This module and the Sub::Spec standard is deprecated as of Jan
    2012. Rinci is the new specification to replace Sub::Spec, it is about
    95% compatible with Sub::Spec, but corrects a few issues and is more
    generic. Rias is the Perl implementation for Rinci and many of its
    modules can handle existing Sub::Spec sub specs. Rias::Sub::To::POD is
    the replacement for Sub::Spec::To::Pod.

    This module generates API POD documentation from sub specs in a
    specified module. Example specification:

     our %SPEC;

     $SPEC{sub1} = {
         summary     => 'Summary of sub1.',
         description => "Description of sub1 ...",
         args        => {
             arg1 => ['int*' => {
                 summary => 'Blah ...',
                 default => 0,
             }],
             arg2 => [str => {
                 summary => 'Blah blah ...',
                 ...
             }
         },
     }
     sub sub1 { ... }

     $SPEC{sub2} = { ... };
     sub sub2 { ... }

    Example output:

     =head2 sub1(%args) -> [STATUS_CODE, ERR_MSG, RESULT]

     Summary of sub1.

     Description of sub1...

     Arguments (* denotes required arguments):

     =over 4

     =item * arg1* => INT (default 0)

     Blah ...

     =item * arg2 => STR (default none)

     Blah blah ...

     =back

     =head2 sub2(%args) -> [STATUS_CODE, ERR_MSG, RESULT]

     ...

    This module uses Log::Any logging framework.

FUNCTIONS
    None of the functions are exported by default, but they are exportable.

  gen_module_subs_pod(%args) -> RESULT
    Arguments ("*" denotes required arguments):

    *   load => *bool* (default 1)

        Whether to load module using "require".

    *   module* => *str*

    *   path => *str*

        Specify exact path to load module (instead of relying on @INC).

    *   specs => *hash*

  spec_to_pod(%args) -> RESULT
    Generate POD documentation from sub spec.

    Arguments ("*" denotes required arguments):

    *   spec* => *hash*

SEE ALSO
    Sub::Spec

    Sub::Spec::To::HTML

    Sub::Spec::To::Org

    Sub::Spec::To::Text

AUTHOR
    Steven Haryanto <stevenharyanto@gmail.com>

COPYRIGHT AND LICENSE
    This software is copyright (c) 2012 by Steven Haryanto.

    This is free software; you can redistribute it and/or modify it under
    the same terms as the Perl 5 programming language system itself.

