Overview
--------

PGopher is a simple Gopher client written in Perl.


Installation
------------

First of all, you will need a recent version of Perl (5.8.1 and up for
proper UTF-8 support).  Put the `pgopher' (or `pgopher-utf8', see
below) script somewhere in your path, and copy the `PgopherLib'
directory to a place where Perl looks for library files.  Finally,
copy `sample.pgopherrc' to your home directory as `.pgopherrc' and
edit the settings if necessary.


Command Line Syntax
-------------------

    pgopher [host[:port][/type[selector]]]


Internal Commands
-----------------

Type `h' in the program for command help.


If you have a UTF-8 capable terminal
------------------------------------

There's a version of PGopher named `pgopher-utf8' included for those
who have a terminal capable of UTF-8 input/output.  The configuration
and bookmark files will be read/written in UTF-8 as well.
When viewing text files (not downloading), automatic conversion from
8-bit source encoding to UTF-8 is performed, with the source encoding
determined by the `$TEXTENC' variable in .pgopherrc.  If using `less'
as the text pager, the LESSCHARSET environment variable will be set to
`utf-8'.  Rename `pgopher-utf8' to `pgopher' if desired.


Mats Peterson  <matsp888@yahoo.com>
