BTRIEVE::SAVE (Dump file support for Pervasive's BTRIEVE and sql.2000 file formats.) VERSION=0.35, 10 February 2000 This is a cross-platform module. All of the files except README.txt are LF-only terminations. You will need a better editor than Notepad to read them on Win32. README.txt is README with CRLF. DESCRIPTION: BTRIEVE::SAVE can read and write Pervasive's dump files. It does not provide direct access to the Btrieve api. Users will probably want to have at least the equivalent of Pervasive's butil -save -stat and -load available to make much use of it, although these are not required. FILES: Changes - for history lovers Makefile.PL - the "starting point" for traditional reasons MANIFEST - file list README - this file for CPAN README.txt - this file for DOS SAVE.pm - the reason you're reading this t - test directory t/test1.t - basic test of simple read-write. A bunch of reference files. t/f1ref.rdb - rdb file t/f1ref.sav - save equivalent t/f1ref.std - config file t/f1rdbref.err - error file in rdb format t/f2ref.rdb - another rdb file t/f2ref.sav - save equivalent t/f2ref.std - config file t/f2savref.err - error file in rdb format eg - example directory eg/README - more details of make_save.pl eg/loctitle.dat - save file eg/loctitle.std - config file eg/make_save.pl - script to add a new index (used for fancy sorting). INSTALL and TEST: On linux and Unix, this distribution uses Makefile.PL and the "standard" install sequence for CPAN modules: perl Makefile.PL make make test make install On Win32, Makefile.PL creates equivalent scripts for the "make-deprived" and follows a similar sequence. perl Makefile.PL perl test.pl perl install.pl Both sequences create install files and directories. The test uses a small sample input file and creates outputs in various formats. You can specify an optional PAUSE (0..5 seconds) between pages of output. The 'perl t/test1.pl PAUSE' form works on all OS types. The test will indicate if any unexpected errors occur (not ok). Once you have installed, you can check if Perl can find it. Change to some other directory and execute from the command line: perl -e "use BTRIEVE::SAVE" No response that means everything is OK! If you get an error like * Can't locate method "use" via package BTRIEVE::SAVE *, then Perl is not able to find SAVE.pm--double check that the file copied it into the right place during the install. NOTES: Please let us know if you run into any difficulties using BTRIEVE::SAVE -- We'd be happy to try to help. Also, please contact us if you notice any bugs, or if you would like to suggest an improvement/enhancement. Email addresses are listed at the bottom of this page. Lane is the most interested in making this work: he might be your best initial bet. We have not tested this on Win32 yet, let us know if there are problems on installation or use. The module is provided in standard CPAN distribution format. Additional documentation is created during the installation (html and man formats). Download the latest version from CPAN at http://www.cpan.org/modules/by-module/BTRIEVE or at your local CPAN ftp mirror. The home page is at http://btrieve.sourceforge.net/ AUTHORS: Chuck Bearden cbearden@rice.edu Bill Birthisel wcbirthisel@alum.mit.edu Derek Lane dereklane@pobox.com Charles McFadden chuck@vims.edu Ed Summers esummers@odu.edu COPYRIGHT Copyright (C) 2000, Bearden, Birthisel, Lane, McFadden, and Summers. All rights reserved. This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself. Portions Copyright (C) 1999,2000, Duke University, Lane.