Palm-SMS version 0.01 ===================== This is Palm::SMS, a Perl module for reading, manipulating, and writing the .pdb files used by Handspring SMS application on PalmOS devices such as Handspring Treo 270. Palm::SMS module is the result of a reverse engineering attempt of trasforming a Handspring Treo 270 SMS PDB file into a plain text file. The PDB test file was produced by Handspring's application SMS v. 3.5H. Due to lack of knowledge about how PDB files work and what format SMS database files conform to, at present this module is not suitable for from-scratch SMS generation. Conversely, you may find it extremely useful if you intend to extract SMS messages from merged PDB files and convert them to a human readable form. I heard rumors that SMS format changes with GSM network providers. Please, contact me if this module cannot correctly handle your messages, hopefully attaching a patch which corrects the shortcoming. INSTALLATION To install this module type the following: perl Makefile.PL make make test make install DEPENDENCIES This module requires that at least Palm::Raw is installed on your system. To be productive, you'll surely want to have Palm::PDB as well. Both modules are provided by Andrew Arensburger's p5-Palm library. The utility smsdump requires the following modules: Getopt::Long Pod::Usage File::Basename Date::Format Text::Wrap which should all be available in a standard Perl installation. DOCUMENTATION All documentation is in the form of PODs embedded in the module files themselves. Use pod2text lib/Palm/SMS.pm pod2text bin/smsdump NOTEWORTHY CHANGES This is a list of user visible changes between each module release. If you need detailed W5(tm) (What, When, Where, Who, and Why ;-) change log, please, consult the ChangeLog file. 0.02 Fri Jan 28 09:48:18 CET 2005 Enanched and cleaned documentation via podchecker. 0.02 smsdump * Added three new switches: --date-format: specify how message timestamps should be formatted --text-format: customize txt output --filter: allow to selectively include messages to print 0.01 Sun Jan 2 10:08:13 CET 2005 0.01 Palm::SMS * First module release which provides the basic methods required by underlying Palm::Raw for reading and writing SMS PDB files. 0.01 smsdump * First draft of smsdump utility: it is possible to convert a single PDB file to a plain text or a bunch of raw data. FEEDBACK If you have any comments, suggestions, bug reports, patches, etc., please send mail to the maintainer, Lorenzo Cappelletti, at . AUTHORS AND CONTRIBUTORS Lorenzo Cappelletti principal perpetrator COPYRIGHT AND LICENCE Copyright (C) 2005 by Lorenzo Cappelletti This program is Copyright 2004 by Lorenzo Cappelletti. This program is free software; you can redistribute it and/or modify it under the terms of the Perl Artistic License or the GNU General Public License as pub- lished by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111, USA. $Id: README,v 1.4 2005/01/28 20:57:42 lolo Exp $