NAME

git-cpan-import - Import a module into a git repository

VERSION

version 0.4.6

SYNOPSIS

# takes any string CPANPLUS handles:

% git cpan-import Foo::Bar
% git cpan-import A/AU/AUTHORID/Foo-Bar-0.03.tar.gz
% git cpan-import http://backpan.cpan.org/authors/id/A/AU/AUTHORID/Foo-Bar-0.03.tar.gz



# If the repository is already initialized, can be run with no arguments to
# import the latest version
git cpan-import

DESCRIPTION

This command is used internally by git-cpan-init, git-cpan-update and git-backpan-init.

This command takes a tarball, extracts it, and imports it into the repository.

It is only possible to update to a newer version of a module.

The module history is tracked in refs/remotes/cpan/master.

Tags are created for each version of the module.

This command does not touch the working directory, and is safe to run even if you have pending work.

OPTIONS

--backpan

Enables Backpan index fetching (to get the author and release date).

--gitpan

Imports the distribution's gitpan repository under the remote branch gitpan. Subsequent calls with this option are equivalent to a simple git fetch gitpan.

--checkversion, --nocheckversion

Explicitly enables/disables version checking. If version checking is enabled, which is the default, git-cpan-import will refuse to import a version of the package that has a smaller version number than the HEAD of the branch cpan/master.

--force

Force an import into an existing repository. This can be used to import a renamed distribution e.g.

$ git cpan-import --backpan Old::Name
$ git cpan-import --force --backpan New::Name

--parent

Allows adding extra parents when importing, so that when a patch has been incorporated into an upstream version the generated commit is like a merge commit, incorporating both the CPAN history and the user's local history.

For example, this will set the current HEAD of the master branch as a parent of the imported CPAN package:

$ git checkout master
$ git cpan-import --parent HEAD My-Module

More than one '--parent' can be specified.

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

Yuval Kogman <nothingmuch@woobling.org>

Yanick Champoux <yanick@cpan.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

The gitpan GitHub account at http://github.com/gitpan.