view release on metacpan or  search on metacpan

scripts/mmkrpbp  view on Meta::CPAN

#ExtUtils::ModuleMaker::PBP version: $ExtUtils::ModuleMaker::PBP::VERSION
#ENDOFUSAGE
#
#    return ($message);
#}
##'

################### DOCUMENTATION ################### 

=head1 NAME

mmkrpbp - interactive interface to ExtUtils::ModuleMaker::PBP

=head1 VERSION

This document references version 0.09 of mmkrpbp, released
to CPAN on April 5, 2006.

=head1 DESCRIPTION

F<mmkrpbp> replaces the most typical use of the F<h2xs> utility distributed
with F<perl>:

    h2xs -AXn [module_name]

It creates a directory and file structure suitable for installation with
F<make> and uploading to CPAN.  The directory and file structure so created
reflects the recommendations made by Damian Conway in his book I<Perl 
Best Practices> (O'Reilly, 2005) L<http://www.oreilly.com/catalog/perlbp/>.

<mmkrpbp> is closely patterned after F<modulemaker>, the command-line utility
associated with F<ExtUtils::ModuleMaker>.

=head1 USAGE::Simple

=head2 Easy

At the command-prompt, simply call:

    % mmkrpbp

... and answer each question.

=head2 Not So Easy, But More Geeky

At the command-prompt, call C<mmkrpbp> with as many options as you can type correctly:

    mmkrpbp [-CIPVchqs] [-v version] [-n module_name] [-a abstract]
        [-u author_name] [-p author_CPAN_ID] [-o organization]
        [-w author_website] [-e author_e-mail]
        [-l license_name] [-b build_system]

=head2 Mix and Match

You can specify some of the arguments on the command-line and then -- assuming
you don't include the C<-I> option -- F<mmkrpbp> will then switch to
interactive mode so that you can finish entering arguments at the prompts.

=head1 USAGE::More

=head2 Menus

F<mmkrpbp> is, for all practical purposes, a clone of F<modulemaker>, the
command-line utility associated with F<ExtUtils::ModuleMaker>.  For
description of F<mmkrpbp> menus and features currently supported by
command-line options, please see the documentation for F<modulemaker>.

=head1 AUTHOR

James E. Keenan (jkeenan [at] cpan [dot]
org), adapting the F<modulemaker> utility originally written in 2001-02 by R.
Geoffrey Avery and F<Module::Starter::PBP> written in 2005 by Damian Conway.

=head1 COPYRIGHT

Copyright (c) 2005 James E. Keenan.  All rights reserved.
This program is free software; you can redistribute
it and/or modify it under the same terms as Perl itself.

The full text of the license can be found in the
LICENSE file included with this module.

=head1 SEE ALSO

F<modulemaker>, F<ExtUtils::ModuleMaker::PBP>,
F<ExtUtils::ModuleMaker::PBP::Interactive>, F<h2xs>.

=cut