| 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 |
|