Debian Codegraph @

INSTALL

raw
1 Installation Instructions
2
3 The instructions are basically as per any Perl module.
4
5
6 INSTALLING AUTOMATICALLY
7 ------------------------
8
9 The easiest way to install is via CPAN, CPANPLUS or cpanminus:
10
11 CPAN:
12
13 % perl -MCPAN -e shell [as root]
14 > install Test::CPAN::Meta::YAML
15 > quit
16
17 CPANPLUS:
18
19 % cpanp
20 > i Test::CPAN::Meta::YAML
21 > q
22
23 cpanminus:
24
25 % cpanm Test::CPAN::Meta::YAML
26
27 See your local documentation ('perldoc CPAN', 'perldoc CPANPLUS' or
28 'perldoc cpanm') for further instructions on setting up and configuring your
29 chosen installer.
30
31
32 OBTAINING THE MODULE
33 --------------------
34
35 The latest release version of Test-CPAN-Meta-YAML can be downloaded
36 from any CPAN site:
37
38 http://www.cpan.org/modules/by-authors/id/B/BA/BARBIE/
39 http://search.cpan.org/dist/Test-CPAN-Meta-YAML/
40
41 Phrasebook is distributed as a gzipped tar archive file:
42
43 Test-CPAN-Meta-YAML-<version>.tar.gz
44
45 where <version> represents the current version number, e.g. 0.17.
46
47 To install the module, unpack the distribution archive to
48 create an installation directory. Something like this:
49
50 tar zxf Test-CPAN-Meta-YAML-0.17.tar.gz
51 or
52 gunzip Test-CPAN-Meta-YAML-0.17.tar.gz
53 tar xf Test-CPAN-Meta-YAML-0.17.tar
54
55 You can then 'cd' into the directory created,
56
57 cd Test-CPAN-Meta-YAML-0.17
58
59
60 INSTALLING MANUALLY
61 -------------------
62
63 The 'make install' (done later) will install the modules and scripts on
64 your system. You may need administrator privileges to perform this task.
65 Alternately you can install the module to a local directory (see
66 ExtUtils::MakeMaker for full details), e.g.
67
68 % perl Makefile.PL PREFIX=/home/me/
69
70 Don't forget to update your PERL5LIB environment variable if you do
71 this, or add a line to your script to tell Perl where to find the files,
72 e.g.
73
74 use lib qw( /home/me/lib/perl5/site_perl/5.6.0 );
75
76 If you're not after a custom location, just do:
77
78 % perl Makefile.PL
79
80 If you are lacking any of the prerequisite modules, running that
81 program will tell you. All prerequisites are available from CPAN.
82
83 When you have them all:
84
85 % make && make test
86
87 If there are any failures, it's best if you contact me. It may help
88 other people who have the same problem. I don't tend to read the Perl
89 newsgroups or PerlMonks, so it's no use posting there.
90
91 When you report your trouble, be sure to send me the following
92 information;
93 + result of `perl -V'
94 + output from 'make test' - ideally do 'make test TEST_VERBOSE=1 >& errs'
95
96 Send those to [email protected] and I'll get back to you as
97 soon as I'm able.
98
99 If it worked, then become root and type:
100
101 # make install
102
103 Congratulations. You've just installed Test::CPAN::Meta::YAML.
104
105 If you have a copy of cpantest installed, type:
106
107 % cpantest -g pass -nc -p `basename \`pwd\`` -auto
108
109 Or:
110 % cpantest -g pass -nc -p Test-CPAN-Meta-YAML-0.17 -auto
111
112 That will tell both me and other potential users that the module
113 built correctly on your machine.
114
115 Cheers,
116 Barbie.
117 http://www.missbarbell.co.uk/
118