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 ci -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

VERSION

This document describes Git::CPAN::Patch version 0.1.0.

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.

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