Tcl Extension for Windows
RCS Version $Revision: 1.2 $
RCS Last Change Date: $Date: 2002/10/07 18:00:38 $
Original Author: Michael I. Schwartz, mschwart@nyx.net

{LICENSE}

THIS SOFTWARE IS PROVIDED BY THE AUTHOR WITH PERMISSION TO USE, COPY, MODIFY, AND
DISTRIBUTE IT FOR ANY PURPOSE WITH THE FOLLOWING CONDITIONS:
1) IN SOURCE FORM, THIS HEADER MUST BE PRESERVED AND THESE CONDITIONS PROPOGATED
2) IN BINARY FORM, THE ORIGINAL AUTHOR MUST BE ACKNOWLEDGED IN DOCUMENTATION AND
   CREDITS SCREEN (IF ANY)
3) FOR ANY COMMERCIAL SALE, THE AUTHOR MUST BE NOTIFIED OF THE USE OF THIS CODE
   IN A PARTICULAR PRODUCT; THE ORIGINAL AUTHOR MAY CITE 
   THE COMMERCIAL SELLER AS A BENEFICIARY OF THE CODE.


IN NO EVENT SHALL THE AUTHOR BE LIABLE TO ANY PARTY FOR DIRECT,
INDIRECT, SPECIAL, INCIDENTAL,  OR CONSEQUENTIAL DAMAGES ARISING OUT OF
THE USE OF THIS SOFTWARE, ITS DOCUMENTATION,  OR ANY DERIVATIVES
THEREOF, EVEN IF THE AUTHORS HAVE BEEN ADVISED OF THE POSSIBILITY OF
SUCH DAMAGE.

THE AUTHORS AND DISTRIBUTORS SPECIFICALLY DISCLAIM ANY WARRANTIES,
INCLUDING, BUT NOT LIMITED TO,  THE IMPLIED WARRANTIES OF
MERCHANTABILITY,FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT. 
THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS, AND THE AUTHORS AND
DISTRIBUTORS HAVE NO OBLIGATION  TO PROVIDE MAINTENANCE, SUPPORT,
UPDATES, ENHANCEMENTS, OR MODIFICATIONS.

{SYNOPSIS}

This file contains commands to extend TK for Windows 3.11, Windows 95,
and Windows NT 4.0 features

The commands are:

ini

The details of each command's options follow:

{PROFILE}

ini [get|set|delete] ...
ini get [-section sectname] [-private filename] \
                    [-default defstring] [-key string] [-max maxsize]
 DESCRIPTION:
   Used to get information from Win3.1 .INI files.
   These are supported by Win95 and WinNT as well, but the registry is strongly 
   preferred by these systems.
 OPTIONS:
   -private 
     filename points to a particular .INI file. Default is WIN.INI (or equivalent).
   -section 
     sectname points to the proper section of the .INI file. 
     If omitted, a list ofall sections will be returned.
   -default 
     defstring is a string to return if the key is not found 
     The default is an empty string ("")
   -key 
     string is the value to search for. 
     If omitted, a list of keys in the section is returned
   -max maxsize is the biggest return value expected (default 1024).
     for example, the call ini get -section fonts would normally 
     require a bigger -max.
 LIMITATIONS:
   Under Win32s (Win3.11), failure to provide a section will NOT list all sections.

ini set [-section sectname] [-private filename] -key keyname -value valuename
 DESCRIPTION:
   Similarly, sets values in the .INI files.

ini delete -section sectname -private filename [-key keyname]
 DESCRIPTION:
   Similarly, deletes either the value for the key or the entire section 
   (if no key is provided)

ini version
   Returns the version of this package