The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

git-backpan-init - Initialize a repository for a CPAN module with full history from the backpan.

SYNOPSIS

    git backpan-init [ --help | --man ] [ --mkdir <directory> ] [ --force ] Foo::Bar

DESCRIPTION

This command is like cpan-init except it imports all the historical versions of a module as well, allowing you to run git bisect or to browse history.

The name of the module can be written with double-colons or dashes (i.e., Foo::Bar or Foo-Bar).

Unless the -force option is used, the command will abort if a git repository is found to be already present in the directory.

OPTIONS

--mkdir directory

Creates a sub-directory and create the git repository there instead than in the current directory. If no directory name is given, figures one out based on the name of the module.

--force, -f

Forces the imports, even if a git repository was already present in the directory.

--help, -h

Prints the synopsis and valid options and exits.

--man

Prints the man page and exits.

EXAMPLES

Most of the time, you want to use git backpan-init like this:

    % cd ~/work/
    % git backpan-init -mkdir Foo::Bar

VERSION

This document describes git-backpan-init version 0.1.5

BUGS AND LIMITATIONS

Please report any bugs or feature requests to bug-git-cpan-patch@rt.cpan.org, or through the web interface at http://rt.cpan.org.

AUTHORS

Yanick Champoux <yanick@cpan.org>

Yuval Kogman <nothingmuch@woobling.org>

LICENCE

This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See perlartistic.

SEE ALSO

Git::CPAN::Patch