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

