GIT-CPAN-IMPORT(1) User Contributed Perl Documentation GIT-CPAN-IMPORT(1)NAMEgit-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>.
perl v5.14.2 2012-01-14 GIT-CPAN-IMPORT(1)
