NAME

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

VERSION

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

DESCRIPTION

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

    h2xs -AXn [module_name]

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

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

USAGE::Simple

Easy

At the command-prompt, simply call:

    % mmkrpbp

... and answer each question.

Not So Easy, But More Geeky

At the command-prompt, call 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]

Mix and Match

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

USAGE::More

Menus

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

AUTHOR

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

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.

SEE ALSO

modulemaker, ExtUtils::ModuleMaker::PBP, ExtUtils::ModuleMaker::PBP::Interactive, h2xs.