
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) main script file somewhere in your path, and copy the
`PGopherLib' directory and its contents 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 [-d] [host[:port][/type[selector]]]

Options
-------

-d   Run in "dumb" mode; no VT100 control sequences will be used.


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

Type `h' in the program for command help.


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

There's a version of the PGopher main script file 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 the file to `pgopher' if desired.


Mats Peterson  <matsp888@yahoo.com>
