NAME
    CPAN::Patches - patch CPAN distributions

SYNOPSIS
        cd Some-Distribution
        cpan-patches list
        cpan-patches patch
        cpan-patches --patch-set $HOME/cpan-patches-set list
        cpan-patches --patch-set $HOME/cpan-patches-set patch

DESCRIPTION
    This module allows to apply custom patches to the CPAN distributions.

    See the patch and update_debian entries elsewhere in this document for a
    detail description how.

    See http://github.com/jozef/CPAN-Patches-Example-Set for example
    generated Debian patches set folder.

PROPERTIES
  patch_set_locations
    An array ref of folders where are the distribution patches located.
    Default is Sys::Path->sharedstatedir/cpan-patches/set which is
    /var/lib/cpan-patches/set on Linux.

  verbose
    Turns on/off some verbose output. By default it is on.

METHODS
  new()
    Object constructor.

  BUILD
    All plugins (Moose roles) from `CPAN::Patches::Plugin::*' will be
    loaded.

  patch
    Apply all patches that are listed in .../module-name/patches/series.

cpan-patch commands
  cmd_list
    Print out list of all patches files.

  cmd_patch
    Apply all patches to the current CPAN distribution.

INTERNAL METHODS
  get_patch_series($module_name)
    Return an array of patches filenames for given `$module_name'.

  get_module_folder($module_name)
    Returns a folder that exists in one of the `patch_set_locations' for a
    given `$module_name'.

  clean_meta_name($name)
    Returns lowercased :: by - substituted and trimmed module name.

  read_meta([$path])
    Reads a META.yml or META.json from `$path'. If `$path' is not provided
    than tries to read from current folder.

  read_meta_intrusive
    Generates and reads the META.yml using Build.PL or Makefile.PL.

AUTHOR
    jozef@kutej.net, `<jkutej at cpan.org>'

BUGS
    Please report any bugs or feature requests to `bug-cpan-patches at
    rt.cpan.org', or through the web interface at
    http://rt.cpan.org/NoAuth/ReportBug.html?Queue=CPAN-Patches. I will be
    notified, and then you'll automatically be notified of progress on your
    bug as I make changes.

SUPPORT
    You can find documentation for this module with the perldoc command.

        perldoc CPAN::Patches

    You can also look for information at:

    * RT: CPAN's request tracker
        http://rt.cpan.org/NoAuth/Bugs.html?Dist=CPAN-Patches

    * AnnoCPAN: Annotated CPAN documentation
        http://annocpan.org/dist/CPAN-Patches

    * CPAN Ratings
        http://cpanratings.perl.org/d/CPAN-Patches

    * Search CPAN
        http://search.cpan.org/dist/CPAN-Patches/

ACKNOWLEDGEMENTS
LICENSE AND COPYRIGHT
    This program is free software; you can redistribute it and/or modify it
    under the terms of either: the GNU General Public License as published
    by the Free Software Foundation; or the Artistic License.

    See http://dev.perl.org/licenses/ for more information.