 ###################################################################
 #  libReadINI - Reads your configs files easily
 #  o David Colmenero AKA D_Skywalk <dantoine@gmail.com>
 #
 #  Version 0.8f - 15 Enero de 2006
 #		by D_Skywalk


----------------
(I) Introduction
----------------

LibReadINI is a library to read INI files, developed in C code,
Now you can use this on your GP32 proyects!! :D

Dont have any external dependencies (SDL, libxml, etc...)
Little -6kb- and quick code, but if you can make a better code, share your changes ;)

 
-----------------------
(II) Installing the lib
-----------------------

See the "INSTALL.txt" file.



-------------------
(III) Documentation
-------------------

-  int cfgOpen ( const char * Filename, const int Style )

  Open the configuration file. 
  Styles supported: "MS_STYLE" and "NOT_MS_STYLE".
  
  Example of MS_STYLE config file:
     [section]
         version = 2.4
     [foo]
         bar=hello
         foobar=world

  Example of NOT_MS_STYLE config file:
     [section]
             2.4
     [foo]
             hello
             world


-  int cfgSelectSection ( const char * SectionName );

  Selects (& reads) current open config file
  Note: This function use a Case Sensitive string comparison...


-  int cfgReadInt ( const char * VariableName, const int Default );
   char * cfgReadText ( const char * VariableName, const char * Default );
   bool cfgReadBool ( const char * VariableName, const bool Default );

  Returns an: int, text or bool variable from opened config file
  if not is found returns default
  Note: These functions use a NO Case Sensitive string comparison...
 
-  void cfgClose( void );

  Close the config file and free the mallocs!! ;)

-----------------------
(III) An Example [...]
-----------------------

See the "test.c" code :P


---------------
(V) Final notes
---------------

- The code changes are welcomed :D
- If you use libReadINI in your project, please email me to public you project name on my website.

--------------------
(VI) Make a Donation
--------------------

I do make my game, programs and libs in my spare time. Donating you will help me to 
keep coding, upgrading the current projects and creating new stuff. It is also 
a nice way to give a big THANK YOU if my program is useful for you. 

Some of my projects: Pituka (GP32/GP2x?), 
                     ScummVM (GP2X), 
                     Developer SDK & Environment for GP32/GP2X, 
                     Abalon RPG Enigne (GP32/GP2x).

More info at:
http://david.dantoine.org/english/


-----------------------------------
David Skywalker (D_Skywalk) dantoine@gmail.com
http://david.dantoine.org

Ps: Soorry for my terrible english ;)
