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-updateDESCRIPTION
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-emailto 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/masteras 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.