git-cpan-import (1) - Linux Man Pages

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

NAME

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

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).
--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.
--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.

VERSION

This document describes git-cpan-import version 0.2.1

BUGS AND LIMITATIONS

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

AUTHORS

Yuval Kogman "<nothingmuch [at] woobling.org>"

Yanick Champoux "<yanick [at] 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