David Cantrell > Palm-ProjectGutenberg > pg2pdb

Download:
Palm-ProjectGutenberg-1.02.tar.gz

Annotate this POD

View/Report Bugs
Source  

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.

syntax highlighting: