GIT-BACKPAN-INIT(1) User Contributed Perl Documentation GIT-BACKPAN-INIT(1)NAMEVERSION
version 0.4.6 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 ] [ --backpan <url> ] Module::Name
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.
--backpan url
URL to BackPAN. If none is given <http://backpan.perl.org/> will
be used.
--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 Foo::Bar
BUGS AND LIMITATIONS
When importing a package history with git-backpan-init, version
checking will be automatically turned off. This is to circumvent the
cases where, e.g., version 0.38.1 (morphed into 0.038001 by the module
version) follows version 0.38. We are making the (hopefully
reasonable) assumption that the chronological order reported by the
Backpan trumps all.
If a version of the package can't be extracted, git-backpan-init will
issue a warning and skip to the next version.
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
perl v5.14.2 2012-01-14 GIT-BACKPAN-INIT(1)
