NAME

Git::CPAN::Patch - Patch CPAN modules using Git

SYNOPSIS

# import a module:

        % mkdir Foo-Bar
        % cd Foo-Bar
        % git cpan-init Foo::Bar

        # hack and submit to RT

        # it's probably best to work in a branch
        % git checkout -b blah

        hack lib/Foo/Bar.pm

        % git commit -am "blah"
        % git cpan-sendpatch --compose

        # update the module
        # this automatically rebases the current branch
        % git cpan-update

DESCRIPTION

Git::CPAN::Patch provides a suite of git commands aimed at making trivially easy the process of grabbing any distribution off CPAN, stuffing it in a local git repository and, once gleeful hacking has been perpetrated, sending back patches to its maintainer.

GIT COMMANDS

git-cpan-init

Create a git repository for a CPAN module

git-backpan-init

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

git-cpan-import

Import a module into a git repository.

git-cpan-last-version

Report the last imported version

git-cpan-send-email

Use "git-send-email" to submit patches to CPAN RT

git-cpan-sendpatch

Create patch files and submit then to RT

git-cpan-update

Import the latest version of a module and rebase the current branch

git-cpan-format-patch

Format patches using "cpan/master" as the origin reference

git-cpan-squash

Combine multiple commits into one patch

git-cpan-which

Report the managed module

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-backpan-init
git-cpan-import
git-cpan-last-version
git-cpan-sendpatch
git-cpan-update
git-cpan-format-patch
git-cpan-init
git-cpan-send-email
git-cpan-squash
git-cpan-which

Articles
The set of scripts that would eventually become Git::CPAN::Patch were first presented in the article CPAN Patching with Git, published in issue 5.1 of The Perl Review <http://theperlreview.com>.

Git::CPAN::Patch on the Net
On CPAN

http://search.cpan.org/dist/Git-CPAN-Patch

Bug tracker

http://rt.cpan.org/Public/Dist/Display.html?Name=Git-CPAN-Patch

Github git repository

web interface: http://github.com/yanick/git-cpan-patch

to clone:

$ git clone git://github.com/yanick/git-cpan-patch.git