Debian Codegraph @

INSTALL

raw
1
2 ------------------------------------
3 Installation of XBase and DBD::XBase
4 ------------------------------------
5
6 To use the XBase.pm module, perl version 5.004 is required. To use
7 the DBD::XBase driver, you need a DBI module version 1.0 or higher.
8
9 Installation is the same as for any Perl module, so if you have some
10 obscure platform, check instructions that came with perl for that
11 platform -- I won't be able to help you because I probably do not use
12 your platform.
13
14 The generic way is: download the DBD-XBase-x.xxx.tar.gz, unpack it,
15 change to the DBD-XBase-x.xxx directory. Then do
16
17 perl Makefile.PL
18 make
19 make test
20 make install
21
22 You can also use the CPAN.pm module to do these steps for you
23
24 $ perl -MCPAN -e shell
25 cpan> install DBD::XBase
26
27 If you do not have root access on that machine and/or cannot install
28 into standard Perl library directories, you can specify alternate
29 location with
30
31 $ perl Makefile.PL LIB=/your/directory \
32 INSTALLMAN1DIR=/path/for/man1 \
33 INSTALLMAN3DIR=/path/for/man3
34
35 instead of just perl Makefile.PL, and in your scripts do
36
37 use lib '/your/directory';
38 use XBase;
39 or
40 use lib '/your/directory';
41 use DBI;
42
43 If you do not have make or you cannot run it (do you really want to
44 use Perl on that machine?), just copy the content of the
45 DBD-XBase-x.xxx/lib directory to wherever you want to have it. That
46 should work, even if it won't give you man pages and dbfdump/indexdump
47 scripts.
48
49 If you use a platform supported by ActiveState and run ActiveState
50 perl, you can use ppm to install the module. Please note that I have
51 no way of influencing what version of XBase.pm/DBD::XBase ActiveState
52 offers on their site -- contact them if you need newer version which
53 is only on CPAN. Cygwin does a good job of providing make on Windows
54 platform, so you can always install any needed version using the
55 generic approach described above.
56
57 If you have case insensitive filesystem, make sure you do not have an
58 old module named Xbase.pm installed -- remove it prior to using
59 XBase.pm, otherwise bad things will happen.
60
61
62 ------------------------------------
63 Problems and bug reporting for XBase
64 ------------------------------------
65
66 If anything goes wrong when installing/make test, please send me
67 output of your installation messages and of
68
69 $ make test TEST_VERBOSE=1
70
71 Each version of the module is tested on multiple systems and multiple
72 versions of perl before releasing but surely there might be situation
73 where something is corrupted on other platforms. So please, send me
74 reasonable output and it is a bug of XBase.pm/DBD::XBase, I'll try to
75 get it fixed.
76
77 If there are errors when actually using the module on your data,
78 please check first that it's really a XBase/DBD::XBase problem (for
79 example, did you FTP your files using binary mode?). If so, please
80 send me example of your script, the errstr messages you get and (if
81 possible) your data files that cause the problems and description
82 of what output you expected. If there is problem with writing the
83 data, send me the file before and after the action and also describe
84 what you expect and what you got. Add info about your OS, version of
85 Perl and other modules that might be relevant. You can of course
86 also send patches to actual bugs. I may respond with requests for
87 particular tests and actions to try on your machine.
88
89 Mention the word "XBase" in the Subject line, otherwise your post
90 will probably just slip through my xxx MB daily email load without
91 even being read. Please note that I'm _very_ busy, so try to help me
92 to help you by using the latest version of the module, minimalizing
93 the script code that causes you problems, providing me with tiny
94 sample datafile, anything that might be related. Detailed description
95 and small examples are the best.
96
97 For general Perl issues, use the comp.lang.perl.* newsgroups, for DBI
98 issues, look at http://dbi.perl.org/ or use [email protected].
99
100 Available:
101 http://www.adelton.com/perl/DBD-XBase/ and from your favorite
102 CPAN site in the authors/id/JANPAZ/ directory.
103
104 Copyright: (c) 1997--2011 Jan Pazdziora.
105 All rights reserved. This package is free software; you can
106 redistribute it and/or modify it under the same terms as Perl
107 itself.
108
109