AmeriSoft BBS SoftWare v.9.5b
-- o --
 --> StartUp Documentation v1.0
-- o --

    AmBBS is not the hardest thing to setup, infact, I find it rather easy.
To install, just untar the ambbs[version].tar file, which you all ready have
done. Make a "bbs" group in /etc/group  and make a "bbsadmin" user in
/etc/passwd with the group of bbs. You now can unzip the ambbs-data.tar.gz
file, *FROM THE /bbs DIR*. And it should be all set for you to use. 

Chapter 1 ---------------------
-----------> Setting up Menus

    The AmBBS menu system isn't that hard to master, here is the basic
format of one menu option:

{
Key or Keys to Hit
Either "RUN", "PRO", "BBS", "MENU", "DISP", "MSG", or "FILE". Depending on the function
The info for the above function. If RUN, the file name, others, the __ __ command. (See the __codes.txt file)
Security Level
}
    So, let's say you wanted to run "/usr/bin/tin", with a secuirty level of
100, and the text to type "tin". (Note that: the FUNCTION, and KEY OR KEYS
must be in UPPERCASE)

{
TIN
RUN
/usr/bin/tin
100
}
    You should be able to save the file, and when you enter the BBS, be able
to run "tin" from the menu that you saved it too. That's about it for the
RUN command, let's look at a BBS command example...

{
G
BBS
__GOODBYE__
10
}

   In the menu spefic to that entry, whenever "g" would be pressed in it, it
would log you off. Only people with the security level of 10> could use that
function. (See __codes.txt for a complete list of __ codes) Next onto the
MENU option.
    The MENU option lets your speicfy that command to go to another MENU.
The MENU command also has another purpose, to "Exit" a menu. But we'll talk
about that in a sec.. Here is a sample MENU option:

{
B
MENU
bul.menu
10
}

   Now, when "B" is pressed, it calls the menu bul.menu. The BBS will
default to the main BBS menu dir (check src/bbs.h, SEE CHANGING DEFAULTS 
BELOW!) and load bul.menu and speficyed. Only sec level 10> can access this
menu.
   The other usage of MENU is to "Exit" a menu. It's exactly the same as
another ussage of MENU, but, just has the label of 'Exit'.. Here's an example:

{
E
MENU
main.menu
10
}

   Let's say that was in the bul.menu file . When the use presses "E" it
goes to the main.menu  .. Which, was the menu before it. I know this might
be a pain, but it also can be an advantage. I've tried a BBS/__EXIT__
command once, but I coulnd't get it to work so I trashed it, bear with me..
    
    -> PUTTING IT TOGETHER, END OF CHAPTER 1.
  
   Now, since we know the basic rules of MENU files, (Which include message
menu's, file menu's, etc) We can make a sample menu file. Note: This menu is
not included the distribution, it's just made in this doc.. 

--CUT HERE--
{
W
RUN
/usr/bin/w
100
}
{
A
BBS
__ANSITOG__
0
}
{
I
DISP
/bbs/system/textfiles/important-info.txt
0
}
{
E
MENU
main.menu
0
}
{
G
BBS
__GOODBYE__
0
}
--CUT HERE--
    
    And there we have it.
    
Chapter 2
-----------> 

