config.sqh

 Copyright (C) 2003-2004 Ray Ontko & Company



  This include file handles a set of name-value pairs.  They can easily
 be saved and restored using a text file.

- begin-procedure config_find($name, :$value, :#index)
   Returns the value associated with $name.  #index will be -1
      if the key, $name, is not found.

- begin-procedure config_set($set_name, $set_value)
     Sets the value associated with $set_name to $set_value.

- begin-procedure config_unset($unset_name)
     Removes the values associated with $unset_name

- begin-procedure config_set_default($set_name, $set_value)
     Will create a new value for $set_name, but will not overwrite
     an existing one.

- begin-procedure config_set_number($set_name, #set_value)
     This procedure is just a shorthand way of setting a number value.

- begin-procedure config_set_default_number($set_name, #set_value)
     This procedure is just a shorthand way of setting a number value.

- begin-procedure config_find_number($name, :#value, :#index)
     This procedure is just a shorthand way of recalling a number value.

- begin-procedure config_load local
     Loads configuration from the file.

- begin-procedure config_save($comment)
     Saves configuration to the file.

