Yo Emacs, pleased to be in -*- text -*- mode, thanks!

# Gutenbook README
# http://www.gutenbook.org/
# Copyright (C) 2000  Lee "Lefty" Burgess
#
# This program is free software; you can redistribute it and/or
# modify it under the terms of the GNU General Public License
# as published 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-1307, USA.

This is an advanced Phase 1 design prototype of Gutenbook.

Gutenbook is written in Perl/GTK+ and uses the following Perl modules:

Gtk 
Gtk::Keysyms
Data::Dumper
Date::Calc
FileHandle
File::Basename
URI::URL
LWP::UserAgent
HTTP::Request
HTTP::Response
Storable

Perl can be found at:

http://www.perl.com/pub/language/info/software.html

If you need to get and build the modules from CPAN,
(http://www.perl.com/CPAN-local/modules/index.html) here is what you
need:

Gtk-Perl-x.xxxx.tar.gz  (Gtk is available at ftp://ftp.gimp.org/pub/gtk/)
Date-Calc-x.x.tar.gz
libwww-perl-x.xx.tar.gz (which recommends the following)
	URI-x.xx.tar.gz
	MIME-Base64-x.xx.tar.gz
	HTML-Parser-x.xx.tar.gz
	libnet-x.xxxx.tar.gz
	Digest-MD5-x.xx.tar.gz (not required for Gutenbook)
Storable-x.x.x.tar.gz

Note: Life will be *much* easier for you if you use the CPAN module to
automate the installation of these modules.

Configure or run CPAN in interactive mode like so:

$ perl -MCPAN -e shell

You may then install any CPAN module by invoking something like this:

cpan> install Storable

If you are using Debian Linux, it will suffice to point your
sources.list file to look at potato (which is currently frozen) and
"apt-get install" the following packages:

perl-5.005 (which you should have by default)
libdate-calc-perl
libgtk-perl
libwww-perl (which recommends the following)
	libhtml-parser-perl (if not already required by libwww-perl)
	libdigest-md5-perl (not required for Gutenbook)
libstorable-perl

These custom modules are distributed with Gutenbook:

PGB
PGB::Index
PGB::Etext
PGB::Network
PGB::File
PBG::PropList

I wanted to use Compress::Zlib to deal with zip'd Etexts, but that
module is only for gzip compression.  Any help or code along these
lines would be greatly appreciated.  Right now, Gutenbook just does a
call to /usr/bin/(un)zip.  It's crappy and I don't like it, but it
works.  So make sure you have zip/unzip on your system.

I use Data::Dumper for debugging, and for writing out the user
properties in a human readable and easily parsable manner.

The Storable module is used for caching the Gutenberg index and local
file information.

This program is being developed on a Debian Linux box, but it should
work on just about any unix type platform with Perl, unzip and the
required modules installed correctly.

See the INSTALL file to install Gutenbook.

Please send comments and feedback to lefty@red-bean.com.

Have fun!

Copyright 1999 Lee P.W. Burgess

The software this README accompanies is protected under the GNU 
General Public License included as the file COPYLEFT.

For a copy of the current GPL, you may also point your favorite web
browser to:

http://www.gnu.org/copyleft/gpl.html

Or write:

Free Software Foundation
59 Temple Plase - Suite 330
Boston, MA 02111-1307, USA

Or email:

gnu@gnu.org

