The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

pg2pdb - convert PG text files to Palm Doc format

DESCRIPTION

This is a very simple wrapper around the Palm::Doc module that re-formats files from Project Gutenberg so that they look better on a small screen. It does this by removing line breaks apart from at paragraph breaks.

USAGE

pg2pdb "King Solomon's Mines" 2166.txt king-solomons-mines.pdb

All three parameters are compulsory and are, in order:

title

The title of the book

input file

The name of a file containing the plain-text of the book. This should not contains HTML markup. It works best if you choose a plain ASCII file instead of ISO 8859-1, as PalmOS doesn't handle weird character sets very well.

output file

The name of a file to write the encoded version of the text to. You should then hotsync this to your PalmOS device in the usual way.

LIMITATIONS, BUGS and FEEDBACK

This is subject to the limitations of Palm::Doc - eg that all documents produced are compressed.

I welcome feedback about my code, including constructive criticism. Bug reports should be made using http://rt.cpan.org/ or by email, and should include the a brief description of the bug and a small text file that provokes it and which I can freely distribute with the code as part of its automated test suite in the future.

SEE ALSO

Palm::ProjectGutenberg

Palm::Doc

http://gutenberg.org

AUTHOR, COPYRIGHT and LICENCE

David Cantrell <david@cantrell.org.uk>

Copyright 2009 David Cantrell <david@cantrell.org.uk>

This software is free-as-in-speech software, and may be used, distributed, and modified under the terms of either the GNU General Public Licence version 2 or the Artistic Licence. It's up to you which one you use. The full text of the licences can be found in the files GPL2.txt and ARTISTIC.txt, respectively.

CONSPIRACY

This module is also free-as-in-mason software.