git-cpan-import(1)

1GIT-CPAN-IMPORT(1)    User Contributed Perl Documentation   GIT-CPAN-IMPORT(1)
2
3
4

NAME

6       git-cpan-import - Import a module into a git repository
7

SYNOPSIS

9           # takes any string CPANPLUS handles:
10
11           % git cpan-import Foo::Bar
12           % git cpan-import A/AU/AUTHORID/Foo-Bar-0.03.tar.gz
13           % git cpan-import http://backpan.cpan.org/authors/id/A/AU/AUTHORID/Foo-Bar-0.03.tar.gz
14
15
16
17           # If the repository is already initialized, can be run with no arguments to
18           # import the latest version
19           git cpan-import
20

DESCRIPTION

22       This command is used internally by "git-cpan-init", "git-cpan-update"
23       and "git-backpan-init".
24
25       This command takes a tarball, extracts it, and imports it into the
26       repository.
27
28       It is only possible to update to a newer version of a module.
29
30       The module history is tracked in "refs/remotes/cpan/master".
31
32       Tags are created for each version of the module.
33
34       This command does not touch the working directory, and is safe to run
35       even if you have pending work.
36

OPTIONS

38       --backpan
39           Enables Backpan index fetching (to get the author and release
40           date).
41
42       --checkversion, --nocheckversion
43           Explicitly enables/disables version checking.  If version checking
44           is enabled, which is the default, git-cpan-import will refuse to
45           import a version of the package that has a smaller version number
46           than the HEAD of the branch cpan/master.
47
48       --parent
49           Allows adding extra parents when importing, so that when a patch
50           has been incorporated into an upstream version the generated commit
51           is like a merge commit, incorporating both the CPAN history and the
52           user's local history.
53
54           For example, this will set the current HEAD of the master branch as
55           a parent of the imported CPAN package:
56
57                   $ git checkout master
58                   $ git cpan-import --parent HEAD My-Module
59
60           More than one '--parent' can be specified.
61

VERSION

63       This document describes git-cpan-import version 0.2.1
64

BUGS AND LIMITATIONS

66       Please report any bugs or feature requests to
67       "bug-git-cpan-patch@rt.cpan.org", or through the web interface at
68       <http://rt.cpan.org>.
69

AUTHORS

71       Yuval Kogman "<nothingmuch@woobling.org>"
72
73       Yanick Champoux "<yanick@cpan.org>"
74

LICENCE

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