
Welcome to Eagles BBS 3.01

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2, or (at your option)
any later version. See the COPYING file for further information.

Eagles BBS 3 is a standalone, screen-oriented bulletin board package. 
It is the successor to Eagles BBS version 2, which was built upon Ed Luke's
Pirates BBS package. The user interface from those programs has been kept
intact for the most part, and some code has been reused. For the most part
this is a complete rewrite though, to correct some basic limitations and
inefficiencies present in Pirates and Eagles 2.x. 

This software has a fairly full-featured message posting and private mail
system, its own IRC-like chat system, and private talk facility. It has
configurable menus allowing custom arrangement of the builtin functions 
and any external programs you care to hook in.

One thing Eagles BBS is not suited for is as a fancy shell. All BBS users
run as a single user, so things like shell access and external mail and
news do not integrate very well. You should probably look elsewhere if
BBS users are to be anything more than guests on your system.

One improvement over Pirates and old Eagles is much greater runtime
configuration. A lot of stuff you used to have to recompile to change is
now in config files read in at runtime. All of these files are ASCII so
they may be patched with an editor if needed. The stock config files are
in the config directory and reside in ~bbs/etc at runtime.

If you are already using an earlier version of EBBS 3, be SURE to read the
ReleaseNotes and ChangeLog to see what has changed before continuing.

All documentation has been moved into the EBBS-Guide. Please consult it
for installation and configuration instructions, examples, and technical
information. 

The Linux binary distribution, ebbs-3.01-Linux.tar.gz, was built with 
gcc 2.5.8. You should have Linux 1.0 or later, the GNU shared C library 
version 4.5.19 or later, and the dynamic loader ld.so. Earlier versions 
of the kernel and shared C library may or may not work.

The source distribution, ebbs-3.01.tar.gz, should build under recent versions
of Linux, SunOS, Solaris, AIX, OSF/1, NextStep, A/UX, Unixware, and Ultrix. 
You should go through the Makefile and osdeps.h to set up the conditional 
defines for your operating system -- see EBBS-Guide under "Building the Source"
for details. 

If you have an operational EBBS 2.x that you want to convert to version 3,
you'll need the source distribution and the conversion package, cvtpkg.tar.gz.
It should be available at //ftp:/seabass.st.usm.edu/pub/EaglesBBS or
other sites. Get it and see the enclosed README for the scoop on getting 
your existing BBS converted to version 3.01.
   
Add-on packages (useful scripts, safe editors, etc.) are under development.
Check the EaglesBBS directory on seabass mentioned above to see what's there.


The TODO list
-------------

These features aren't done yet, but might be one day:

-- Post expire program that can be run from cron.
-- Mail clean program.
-- Ability to receive/send Internet mail from the BBS Mail Menu.
   (Update: this is tentatively slated for version 3.1)
-- Tagging of messages in mail, for deleting or forwarding.
-- Reading lists that allow each user to specify the order to scan the
   boards during a new message scan.
-- Configurable read-menus (read menu, mail read menu, download menu).
-- The big TODO: A split into client and server, with which the client 
   can run on a different machine and do things like editing, menu movements,
   shell escapes, job control, etc. locally.
   (Update: This is progressing nicely, an alpha may be available soon)


Known Bugs
----------

-- On the File Menu, the "Current Board" is shown is not the currently
   selected File board. It is correct on the Download read-menu.
   (The fix isn't worth the trouble)
-- On Solaris, lbbs processes have a habit of hanging around as zombies
   after they exit. It is unclear whether Solaris or the bbs is at fault.
-- The file-based user table is reported to have some problems. This is
   only an issue if you do not have a shared memory facility.


Credits
-------

Thanks to these people for helping code, test, debug, and port EBBS 3!
Ed Luke
Ray Seyfarth
Bill Schwartz
Xabier Vazquez Gallardo
John Salmi
Paul Snow
Mark Roe
Andre Schmidt
Jon Stevens
Thanh Ma
Alex Schubert
Jiri Randus
Everyone at the Eagle's Nest and Auggie BBS

Additional tip of the hat for assistance with previous versions of EBBS:
Guy Vega, Dominic Tynes, Randy Austin, Jim Morton, Carey Chou

------------------------------------------------------------------------------

Good luck, and happy BBSing!

TheRock
In real life:  Ray Rocker
On the air:    WQ5L
Internet:      rock@seabass.st.usm.edu
CompuServe:    72673,2105 
Delphi:        RRROCKER



