1CPANDEPS-DIFF(1)      User Contributed Perl Documentation     CPANDEPS-DIFF(1)
2
3
4

NAME

6       cpandeps-diff - generate reports when modules' dependencies get new
7       releases
8

SYNOPSIS

10           cpandeps-diff add Some::Module --perl 5.30.3 --mirror file:///home/me/cpanmirror
11
12           cpandeps-diff list
13
14           cpandeps-diff report Some::Module
15

COMMANDS

17       cpandeps-diff takes at most one of several different commands, some of
18       which in turn take more arguments:
19
20   add $module [@args]
21       Add the named module to the list of modules we care about
22
23   remove $module [@args]
24       Stop reporting on this module
25
26       (aliases: delete; rm)
27
28   list
29       Show which modules we're going to report on
30
31   report $module [@args]
32       Generate a report for just this one module
33
34   [@args]
35       If you don't provide a command then it will generate a report about all
36       known modules.
37
38   help
39       Can you guess what this does?
40

ARGUMENTS

42   perl $version
43       Use this version of perl for figuring out what's in core. Any
44       dependencies that are in core will not be reported on unless a newer
45       version is required.
46
47       If not specified it defaults to 5.005.
48
49       Note that adding, removing and reporting on modules always depends on
50       the version of perl, so as well as being used to figure out what's in
51       core you can also have different lists of modules for different
52       versions of perl.
53
54   mirror $mirror
55       Use this CPAN mirror to fetch dependency information from (see
56       CPAN::FindDependencies documentation for details). You may provide this
57       argument as many times as you want.
58

FILES

60       Data is stored in a directory called .cpandeps-diff, which by default
61       is under your home directory. If you want to put it somewhere else (you
62       probably don't) then set CPANDEPS_DIFF_DIR in your environment. That
63       data includes a cache of data fetched from the CPAN which will be
64       automatically cleared out after 23 hours. This cache helps to generate
65       reports for multiple modules more quickly, and also to prevent you from
66       being rate-limited or even kicked off CPAN mirrors.
67

WARNINGS, BUGS and FEEDBACK

69       This script has not been thoroughly tested.
70
71       I welcome feedback about my code, including constructive criticism.
72       Bug reports should be made on Github or by email.
73

75       Copyright 2007 - 2020 David Cantrell <david@cantrell.org.uk>
76
77       This software is free-as-in-speech software, and may be used,
78       distributed, and modified under the terms of either the GNU General
79       Public Licence version 2 or the Artistic Licence. It's up to you which
80       one you use. The full text of the licences can be found in the files
81       GPL2.txt and ARTISTIC.txt, respectively.
82

CONSPIRACY

84       This software is also free-as-in-mason.
85
86
87
88perl v5.36.0                      2022-07-22                  CPANDEPS-DIFF(1)
Impressum