----------------------------------------
 INI DATABASE DOCUMENTATION AND HISTORY
----------------------------------------
  Version: 0.4.2
  Date: 12-16-1999
----------------------------------------


SECTIONS
  History
  Documentation
   - General info
   - ini_read
   - ini_write
   - ini_remove
  Future plans
  Contact info


HISTORY
  VERSION   UPDATES
    0.4.2 - First public release


DOCUMENTATION

 General Info:
   INI Database is made for TCL scripters. It is intended to be used with
   Eggdrop bots, but you may try to use it for other purposes (not tested).
   This script has been tested on Eggdrop v1.4.0 and should work on all
   releases of Eggdrop bots as long as your TCL version is fairly new.

   This script could be used to easily store and access categorized settings.
   So TCL scripters can use an INI file for storing settings that will be
   there when the bots restarts.

 ini_read <ini file> <section> <item>
   -- Reads the item's value from the specified section. All the arguments
      are needed for this proc to work.
   -- Returns: the value of the item if successful; semi-colon ';' otherwise
       (semi-colon because any other characters could be used as the value,
       so use "\;" when comparing ini_read's return value)
 
 ini_write <ini file> <section> <item> [value]
   -- Sets the value of the specified item in the section. The value does not
      have to be specified (just use "" in it's place)
   -- Returns: TRUE (1) if successful; FALSE (0) otherwise
 
 ini_remove <ini file> <section> [item]
   -- Removes the item or section. The item does not have to be specified (just
      use "" in it's place). If there are no items left in the section after the
      item has been removed the section will be removed. If there are no sections
      left in the ini file after the section has been removed then the ini file
      will be removed.
   -- Returns: TRUE (1) if successful; FALSE (0) otherwise


FUTURE PLANS
  Even though the script works fine now there are some things I would like to
  add in future versions. Here are a few things:
    1. Comment Support (; comment)
    2. Faster procs
    3. Smaller procs


CONTACT INFO
  If you have any suggestions, questions, or bug reports contact me by:
    E-mail: mamakin@mailandnews.com
    IRC: mamaKIN on EFnet
