THE FORG
Written by David Allen <s2mdalle@titan.vcu.edu>
http://opop.nols.com/

Released under the terms of the GNU General Public License.  Please
see the file COPYING or visit http://www.gnu.org/ for more details.
One of the things that the file is going to tell you is that I am not
responsible for anything that may happen as a result of running this
program.  About the worst that's ever happened to me running this
program was that I had to hand-kill a few processes, but just to be
sure, I want to you know that if this program pens filthy novels
in Russian and then sends them to your friends, I am in no way
responsible. 

Please read the section "IN ORDER TO RUN THE FORG" below on how to get
this running.  (Hint:  python, Tkinter, and Pmw, and you're there)

FORG is a gopher client.  Right now it's pretty primitive, but it does
work.  To run the program, run:

./forg host

as an example, host can be "gopher.ptloma.edu",
"gopher.heatdeath.org", or "gopher.quux.org", which are all 3 valid
gopher sites.

---=== Features ===---

Everything listed here actually does work, well at least most of the
time.  Please see the BUGS file to find out about what doesn't work.

- Ability to load other programs with different file formats.
  I.e. this program does not interpret HTML, so you may want to
  associate .html files with mozilla, so it will be launched upon
  saving a .html file.
- Full caching of directories and files
- Searching supported.  (Tested against gopher.floodgap.com's
  Veronica, but of course)
- Bookmark support.  (Currently there is no support for subfolders of
  bookmarks though)
- Directories are searchable by name.
- Statistics on size of cache, number of files in the cache, and
  number of documents in the queue.
- Ability to save files and directories.  (Note: when directories are
  saved, the protocol information that the server sent is what is
  saved to disk...for now)
- Right click context menus on all items providing all available
  information on a resource.  (If the server supports Gopher+)
- Between 0 and 100% complete implementation of Gopher *AND*
  Gopher+!!! :)
- Managerspeak.  This program leverages automatic internet data retrieval
  and storaging technologies for quasi-reliable interlocked handshake
  protocol interaction, allowing open-ended failsafe solutions to be
  developed in the realm of...oh whatever.

Please email me with information on anything that the program does
that you don't think it should do.  (Like penning filthy Russian
novels, provoking arab/israeli hostilities, breaking your toaster, or
causing a MIDI rendition of "Yankee Doodle" to be played backwards
through your speakers)

---=== IN ORDER TO RUN THE FORG ===---

You will need 3 things.  Python, Tkinter, and Pmw.  If you have an up
to date linux system, chances are good that you have python and
Tkinter already.  If you don't, you can download them from
http://www.python.org/.  The version of python required is 1.5.2, and
the version of Tkinter required is the latest.

To obtain Pmw, do one of several things:

Download the package from
ftp://ftp.dscpl.com.au/pub/pmw/Pmw.0.8.4.tar.gz
This is the latest version that was used for development.  You could
possibly skate by with an earlier version (I haven't tried it) but
why?

If you're using debian, you can just type "apt-get install python-pmw"
and let the package management system do all of the dirty work for
you. 

To install Pmw, just unzip it into your python's library directory.
For most people, this will be something like
/usr/lib/python1.5/site-packages/ or something similar.

Theoretically, this program should run under windows.  I haven't tried
it, so don't be suprised if it dies horribly.  But do email me.