===========================================================================
   "SugBox" v1.2: Suggestion Box Program. READ_ME! by: Dotoran, 12/16/92
===========================================================================

What is it?
~~~~~~~~~~~
    SugBox is an easy to use Public Suggestion Box that the users of your
BBS can use to write Suggestions, Comments, and/or Criticisms they may have
concerning your BBS.

    This allows the SysOp(s) a way of evaluating how well their meeting the
needs of their users, and may even help you to make your BBS more easy and
entertaining to use.

How does it work?
~~~~~~~~~~~~~~~~~
    SugBox is written in Arexx using the new PROMPT command for it's editor.
Your users can write a Suggestion that is a maximum of eight 60-character
lines long. Errors can be corrected line by line, or they can start over
completely if they feel the message contains too many errors.

    Upon completion of their Suggestion, they will be asked if they wish to
make their Suggestion PRIVATE. By creating a PRIVATE Suggestion, the user
can be assured their suggestion will only be viewed by those ID Numbers that
have Maintenance Access.

    Before a user enters a Suggestion, they may wish to view the Suggestions
that are already IN the box. They will be allowed to view any Suggestion as
long as it has not been tagged as PRIVATE.

    Users that are given Maintenance Access will be able to selectivly KILL
any Suggestion, or toggle the PRIVATE status of any Suggestion.

    The SugBox program will create a data file in your PFILES: directory
called "Suggestions". This file contains ALL Suggestions created as well as
the PRIVATE status and LENGTH status for each Suggestion.

    A third file operation will occur in your RAM: disk whenever a new
Suggestion is written. This is only a TEMPORARY file that is created, so
that the PERSONAL MAIL to ID # 1 function will work. This TEMPORARY file
will always be deleted after the PERSONAL MAIL has been sent.

How do I set it up?
~~~~~~~~~~~~~~~~~~~
   To get SugBox working on your system, follow these steps:

1: In the beginning of the SugBox program are two variables you will want
   to edit to contain the appropriate information:

   bbsname : The name of YOUR bbs. This name should NOT exceed 17 characters
             in length, and SHOULD be enclosed in single or double quotes.

   maintID : This contains any ID Numbers you wish to be able to use the
             extended KILL and PRIVATE commands. If you will be including
             more than one ID Number, make sure each is SEPARATED with at
             LEAST ONE SPACE, and that the ENTIRE string is enclosed using
             either single or double quotation marks.

2: You should place the SugBox program in your Root PFILES: directory.

3: You now need to allow your users to access the SugBox. Here are four ways
   to include it in your system. I suggest including it in ALL FOUR PLACES,
   because the easier it is to FIND, the more beneficial it will be:

   A: In your "sys.welcome" menu. Use the command:   \#0pfiles:SugBox\
      to start the program running from your menu.

   B: Add it directly to your PFILES: Main Menu. It is an Arexx File that
      can be used by Multiple Ports.

   C: You can add the "SB" command to your 'bbsmenu' file. Somewhere in the
      From ANYWHERE menu, add this line:

      SB, Suggestion Box    |   \#0pfiles:SugBox\   `1-23

      NOTE_1: Be sure to include the SPACE between the word Suggestion and
              the word Box in the beginning of the line.

      NOTE_2: The  `1-23  at the END of the line determines the Access
              Groups that will be allowed to use the SugBox Program.

   D: You can add SugBox to your SYS.END file. I've included a copy of MY
      SYS.END file in this Archive so you can see how I've created the line
      that REQUESTS whether they wish to leave a Suggestion or not.

Is there anything else?
~~~~~~~~~~~~~~~~~~~~~~~
    Nope! That's it. If you added the "SB" command, you will have to REBOOT
your CNet to get the new command operative, but other than that, you're all
set to use it!

    One further note concerning the Personal Mail option. Whenever a new
Suggestion is written, it will also be sent to ID # 1, NOT ALL the ID's
you specified in the MaintID variable.  Also, ID # 1 will ALWAYS be given
Maintenance Access, REGARDLESS of whether or not you include ID Number 1 in
the MaintID variable. This is a double safeguard built in for the SysOp's
Protection.

    There are still a couple things I would like to add, but this version
should be stable enough to hold it's own until I get around to adding the
other options.

    If you think the SugBox needs something else, please don't hesitate to
give me some feedback on FutureWorld, or better yet, why not call me direct:

            F R O N T I E R S     B U L L E T I N     B O A R D

                (  7  1  6  )  /  8  2  3  -  9  8  9  2  !

                    Any baud from 300 through 14,400!

===========================================================================
                  THIS IS THE END OF THIS READ_ME! FILE!
===========================================================================