git-backpan-init(1)

1GIT-BACKPAN-INIT(1)   User Contributed Perl Documentation  GIT-BACKPAN-INIT(1)
2
3
4

NAME

6       git-backpan-init - Initialize a repository for a CPAN module with full
7       history from the backpan.
8

SYNOPSIS

10           git backpan-init [ --help | --man ] [ --mkdir <directory> ] [ --force ] Foo::Bar
11

DESCRIPTION

13       This command is like "cpan-init" except it imports all the historical
14       versions of a module as well, allowing you to run "git bisect" or to
15       browse history.
16
17       The name of the module can be written with double-colons or dashes
18       (i.e., Foo::Bar or Foo-Bar).
19
20       Unless the -force option is used, the command will abort if a git
21       repository is found to be already present in the directory.
22

OPTIONS

24       --mkdir directory
25           Creates a sub-directory and create the git repository there instead
26           than in the current directory.  If no directory name is given,
27           figures one out based on the name of the module.
28
29       --force, -f
30           Forces the imports, even if a git repository was already present in
31           the directory.
32
33       --help, -h
34           Prints the synopsis and valid options and exits.
35
36       --man
37           Prints the man page and exits.
38

EXAMPLES

40       Most of the time, you want to use git backpan-init like this:
41
42           % cd ~/work/
43           % git backpan-init -mkdir Foo::Bar
44

VERSION

46       This document describes git-backpan-init version 0.2.1
47

BUGS AND LIMITATIONS

49       When importing a package history with git-backpan-init, version
50       checking will be automatically turned off.  This is to circumvent the
51       cases where, e.g., version 0.38.1 (morphed into 0.038001 by the module
52       version) follows version 0.38.  We are making the (hopefully
53       reasonable) assumption that the chronological order reported by the
54       Backpan trumps all.
55
56       If a version of the package can't be extracted, git-backpan-init will
57       issue a warning and skip to the next version.
58
59       Please report any bugs or feature requests to
60       "bug-git-cpan-patch@rt.cpan.org", or through the web interface at
61       <http://rt.cpan.org>.
62

AUTHORS

64       Yanick Champoux "<yanick@cpan.org>"
65
66       Yuval Kogman "<nothingmuch@woobling.org>"
67

LICENCE

69       This module is free software; you can redistribute it and/or modify it
70       under the same terms as Perl itself. See perlartistic.
71