-- file: readme.txt
-- written by: Vincent Howell
-- date: 11/12/05
-----------------------------

NOTICE
******

This dynamic/conditional include system only works with interpreted Euphoria
applications and libraries. This library requires Euphoria v2.3 or newer to
run.


READ ME
*******

This library allows for dynamic & conditional including of files into programs
and/or libraries either directly or indirectly via nesting.

Dynamic_include() and clear_includes() can be used anywhere in a source file:
top-level, loops, conditional statements, and routines. There is no limit on
how many calls that can be made with either routine. To use the library, you
must first 'include' both "dynamic.e" and "includes.e" at the top of your code
files. Using dynamic_include() should be self-explanatory, check the example
programs included in the package for help. Place a call to clear_includes() at
the bottom of the main program to clear the main including file, "includes.e".
It is often necessary to issue calls to clear_includes() in routines that have
calls to dynamic_include() placed within them, in order to clear "includes.e".

Feel free to make any modifications and/or additions to the library to help it
suit your needs better, but remember I'm NOT liable for any problems associated
with the use or misuse of this library in any case whatsoever!

Please see: disclaimer.txt

-------------------------------------------------------------------------------
