
             Gopherus v1.1 Copyright (C) 2013-2019 Mateusz Viste
                       http://gopherus.sourceforge.net


Gopherus is a free, multiplatform, console-mode gopher client available for
DOS, Linux and Windows. It provides a classic text interface to the
gopherspace. Altough primarily targeted for DOS, ports to Windows and Linux
are also available. These may use SDL to emulate a pseudo terminal.
This program is released under the terms of the '2-clause' BSD license.


 *** Key bindings ***

 Gopherus is a console-mode gopher client. It's entirely keyboard-driven, thus
 knowing its key bindings is mandatory for comfortable gopher browsing.

 Key bindings:
   TAB       - Switch to/from URL bar edition
   ESC       - Quit Gopherus (requires a confirmation)
   UP/DOWN   - Scroll the screen's content up/down by one line
   PGUP/PGDW - Scroll the screen's content up/down by one page
   HOME/END  - Go to the begin/end of the document
   BACKSPC   - Go back to the previous location
   F1        - Show help (this manual)
   F5        - Refresh current location
   F9        - Download location on disk


 *** Customizing the color scheme ***

 The Gopherus color scheme can be customized, should the default one not suit
 you. To customize the color scheme used by Gopherus, you will have to set an
 environnment variable 'GOPHERUSCOLOR' prior to Gopherus launching. This
 variable have to contain exacty 6 color attributes. Each attribute describes
 the foreground/background color for a given element of the Gopherus user
 interface. An attribute is composed from two hexadecimal digits: XY, where X
 is the background color, and Y is the foreground color. Colors are indexed as
 in the classic CGA palette, that is:

 Index - Color
   0   -  black
   1   -  low blue
   2   -  low green
   3   -  low cyan
   4   -  low red
   5   -  low magenta
   6   -  low brown
   7   -  light gray
   8   -  dark gray
   9   -  high blue
   A   -  high green
   B   -  high cyan
   C   -  high red
   D   -  high magenta
   E   -  yellow
   F   -  high intensity white

 SET GOPHERUSCOLOR=aabbccddeeffgghhii
                    | | | | | | | | |
                    | | | | | | | | |
                    | | | | | | | | +- Selected item in menu
                    | | | | | | | |
                    | | | | | | | +--- Selectable items in menu
                    | | | | | | |
                    | | | | | | +----- Error item in menu
                    | | | | | |
                    | | | | | +------- Itemtype column in menus
                    | | | | |
                    | | | | +--------- URL bar side decorations
                    | | | |
                    | | | +----------- URL bar
                    | | |
                    | | +------------- Status bar (warning)
                    | |
                    | +--------------- Status bar (information)
                    |
                    +----------------- Normal text (text files or 'i' items)

 Examples:
  The default palette used by Gopherus is.......: "177047707818141220"
  For a black & white mode, use.................: "077070707808070770"
  Missing those green 1980-like phosphor CRTs?..: "022020202002020220"


 *** Requirements ***

 Gopherus has been designed with hardware sparseness in mind, hence it doesn't
 need much to run. But still, the 16-bit DOS version requires at least:
  - a CGA card
  - some kind of CPU
  - 400K of available RAM
  - an ethernet card with a working packet driver


 *** License ***

Copyright 2019 Mateusz Viste

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.

2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.


 *** Final notes ***

 Gopherus has been written with care to behave nicely and follow standards.
 It conforms closely to following guidelines:
   RFC 1436: The Internet Gopher Protocol
   RFC 4266: The gopher URI Scheme
