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