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 <yanick@cpan.org>

Yuval Kogman <nothingmuch@woobling.org>

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 <yanick@cpan.org>

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.