NAME

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

VERSION

version 2.5.0

SYNOPSIS

# import a module:

% git-cpan clone Foo::Bar
% cd 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 send-patch

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

NOTE: This module is supported in Linux, BSD, and the like. This module is not supported in Microsoft Windows (Cygwin, Strawberry Perl). See CPAN Testers Matrix for currently supported operating systems.

GIT-CPAN COMMANDS

• clone

  Clone a CPAN module's history into a new git repository

• import

  Import a module into a git repository.

• send-email

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

• send-patch

  Create patch files and submit then to RT

• update

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

• format-patch

  Format patches using cpan/master as the origin reference

• squash

  Combine multiple commits into one patch

• which

  Report upon the managed module

AUTHORS

Yanick Champoux <[email protected]>

Yuval Kogman <[email protected]>

SEE ALSO

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.

AUTHOR

Yanick Champoux [email protected]

COPYRIGHT AND LICENSE

This software is copyright (c) 2022, 2021, 2018, 2017, 2016, 2015, 2014, 2013, 2012, 2011, 2010, 2009 by Yanick Champoux.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.