1Git::CPAN::Patch(3) User Contributed Perl Documentation Git::CPAN::Patch(3)
2
3
4
6 Git::CPAN::Patch - Patch CPAN modules using Git
7
9 version 2.5.0
10
12 # import a module:
13
14 % git-cpan clone Foo::Bar
15 % cd Foo-Bar
16
17 # hack and submit to RT
18
19 # it's probably best to work in a branch
20 % git checkout -b blah
21
22 ... hack lib/Foo/Bar.pm ...
23
24 % git commit -am "blah"
25 % git-cpan send-patch
26
27 # update the module
28 # this automatically rebases the current branch
29 % git-cpan update
30
32 Git::CPAN::Patch provides a suite of git commands aimed at making
33 trivially easy the process of grabbing any distribution off CPAN,
34 stuffing it in a local git repository and, once gleeful hacking has
35 been perpetrated, sending back patches to its maintainer.
36
37 NOTE: This module is supported in Linux, BSD, and the like. This module
38 is not supported in Microsoft Windows (Cygwin, Strawberry Perl). See
39 CPAN Testers Matrix <http://matrix.cpantesters.org/?dist=Git-CPAN-
40 Patch> for currently supported operating systems.
41
43 clone
44 Clone a CPAN module's history into a new git repository
45
46 import
47 Import a module into a git repository.
48
49 send-email
50 Use "git-send-email" to submit patches to CPAN RT
51
52 send-patch
53 Create patch files and submit then to RT
54
55 update
56 Import the latest version of a module and rebase the current branch
57
58 format-patch
59 Format patches using "cpan/master" as the origin reference
60
61 squash
62 Combine multiple commits into one patch
63
64 which
65 Report upon the managed module
66
68 Yanick Champoux "<yanick@cpan.org>"
69
70 Yuval Kogman "<nothingmuch@woobling.org>"
71
73 Articles
74 The set of scripts that would eventually become Git::CPAN::Patch were
75 first presented in the article CPAN Patching with Git, published in
76 issue 5.1 of The Perl Review <http://theperlreview.com>.
77
79 Yanick Champoux <yanick@cpan.org>
80
82 This software is copyright (c) 2022, 2021, 2018, 2017, 2016, 2015,
83 2014, 2013, 2012, 2011, 2010, 2009 by Yanick Champoux.
84
85 This is free software; you can redistribute it and/or modify it under
86 the same terms as the Perl 5 programming language system itself.
87
88
89
90perl v5.38.0 2023-07-20 Git::CPAN::Patch(3)