----------------------------------------------------------------------------
BBGopher/amiga 1.0 (20.4.95)
Copyright (c) 1995 Jason M. Weber

Ported from BBGopher 1.6 for UNIX systems.
Information regarding BBGopher 1.6 resides in the original README file
which I included in the distribution.
----------------------------------------------------------------------------
BBGopher/amiga was ported to be used as a CNet/AmiTCP client.  This program
is fully compatible with CNet and should be run as a DOS program.

I was asked by David Cook of Terminal Edge BBS to port this for him.  I hope
everyone else will find as much use for it as he has so far.

Instructions for setting up and configuring are included in the README from
the original BBGopher 1.6 (UNIX version).  I have included the README in the
distribution as well.  There is nothing new, except for the fact that it now
runs on the Amiga as well!  :)

I also editied the supplied 'bbgopher.config' file to be a bit more
compatible from scratch with most AmiTCP and CNet systems.  Be sure to check
through it though before you use it on your setup.

BBGopher accepts two commandline arguments, these two arguments aren't even
documented in the original README.  They are as follows:

   first argument is the gopher site
   second argument is the port number

   eg.: bbgopher mheadbbs.com 70

Any bugs and/or suggestions should be directed to me at:

   jmw@tedgebbs.is.net

This is David Cook's BBS, which is connected to the internet and also uses
my bbgopher port. :)  I call here quite a bit, so you should get a reply
relatively quickly.
----------------------------------------------------------------------------
Setting up - Installing

   Copy 'bbgopher' into a path somewhere.  Most likely your AMITCP:bin/
   directory.

   Copy 'bbgopher.conf' (the config file) into your AMITCP:db/ directory.
   Edit the config file to suit your systems needs and your personal taste.

   Copy 'bbgopher.help' (the help file) into your AMITCP:db/ directory.
   You can put this one anywhere you want, IF, you change the setting for
   it in the config file.

   If you add this as a CNet BBS command, I recommend you add the
   'gopher.rexx' file as the command.  'gopher.rexx' is a rexx script I
   wrote up that allows you to parse commandline arguments to BBGopher
   through CNet.  This will allow you and your users to specify the
   site they wish to gopher to.

   Below is how you would add this command to your CNet BBS:

      Edit your 'cnet:bbsmenu' file and add the following to the end of
      Menu 2; Available Everywhere. ('{' is a CTRL-Q)

      GOPHER | {#0 PFiles:gopher.rexx}

      Save the 'cnet:bbsmenu' file and reload your BBSTEXT/MENU.

   Now GOPHER is the command users can use to run the gopher utility!

Thats it!  Enjoy!
----------------------------------------------------------------------------
Noteworthy Features for the Amiga port:

   Does include CTRL-C break handling.  This is essential for CNet BBS
   operators, it will keep your port from locking up if the user drops
   carrier or loses carrier for some reason.

   Fully tested for 'hits' using Enforcer and Mungwall on my system.
   I don't have a TRUE connection, I just use available AmiTCP ports to
   test the features, etc.  If you do encounter any Enforcer or Mungwall
   'hits', be sure to send a full report on them to me.

   Has been in beta-testing for a while before the release.  I don't want
   to release a buggy program, but it is possible that some bugs do exist.
   If so, we haven't found them yet and it is your duty to report them so
   I can fix them.

   Rexx script for lauching BBGopher with CNet.  This rexx script allows
   you to parse the site you wish to connect to.  Even allows you to
   parse the port number, although if not given it will default to the
   configs port number.  If no arguments are passed, it will default
   to the config defaults.

   The 'Save' feature either saves to the user's HOME directory (UNIX) or
   if used with CNet, it will save to the user's CNet mail directory.
   Be sure to read the note in the config file for the WORKDIR variable.
   It is currently setup to default to the user's CNet mail directory.

   An alternate 68030 compiled executable is also included.

   Much thanks to David Cook for suggesting features and taking list of
   the bugs during development.

   Freeware, but if you'd like to send me something to show your
   appreciation, don't hesitate.  Home address is:

      Jason Weber
      533 Ansley Street
      Perry, Georgia 31069

   Postcards from different states, countries, continents, planets, etc,
   would be cool.  I can add them to my mess on the wall!  \8^P

   Or even $3 bucks is enough to buy me a FEAST at Taco Bell!  =\8^P
----------------------------------------------------------------------------