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
<lorenzo.cappelletti@email.it>.
AUTHORS AND CONTRIBUTORS
Lorenzo Cappelletti <lorenzo.cappelletti@email.it>
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 $