ConfigReader
by
avalon2260
version 20160524

Requires:

OBSE v20+ http://www.nexusmods.com/oblivion/mods/37952
ConScribe http://www.nexusmods.com/oblivion/mods/26510

Description
===========

This is a set of functions to read custom config files via ConScribe. It does
nothing by itself of course. The calling mod needs to define callback
functions to handle each line of input. There are also a couple of string
twiddling functions (strip whitespace etc.).

Installation
============

Load order is irrelevant, this is entirely scripted and self-contained. It is
a single stand-alone esp, so installation should be easy enough.

I don't use mod managers, and don't know anything about them. There is a BAIN
version for Wrye Bash, but I have not tested this, it should work though.

For the manual version, copy (or symlink) the esp to your Oblivion Data
directory, or create your own package for your mod manager of choice.

Upgrading
=========

This is backwards compatible. Just install over the old version, if any. There
is no need to clean save as it contains only scripts and doesn't store any
data itself.

Bugs etc.
=========

Possibly. None known currently, but not all code paths have been fully tested
yet, especially error handling, etc.

There were several memory leaks (strings), which should now all be fixed. Keep
an eye on your co-save.

Credits
=======

The OBSE team. Without OBSE, I would have wandered away from Oblivion years
ago.

shadeMe for ConScribe.

Legal etc.
==========

The scripts in this mod are in the Public Domain and can be freely used for any purpose.

Changelog
=========

2016-05-24

* Changed cmddata setup to initialize at parser creation time rather
than when the relevant functions are called.

* New functions: ParserAddExprText, ParserCreateFull,
ParserExprFile{Read,Tag}, ParserFilelist{Add,Have}{Filename,Tag},
GetCmddataExecExpr, GetCmddataIf, MkCmddata, MkFilelist.

* ParseFile now records the filename in an array.

* Added filetag command.

* Added check to include command to avoid including files multiple times.

2016-05-06 (unreleased)

* Fixed a couple of bugs.

2016-01-06 (unreleased)

* Remove filename prefix from syntax command.

2016-01-01

* Added an "info" parser command for debugging purposes etc.

2015-12-31

* Added syntax command. Config files can specify the function(s) to call
to define their commands. This allows the syntax to be extended by 3rd
party mods at runtime.

* Fixed bug in parse_line_args that didn't check if acmd was defined.

* Added debug variable to quest script to control debug verbosity, but
most functions have not been updated to use it yet.

* No longer use meaningless version numbers. Version will now be the
release/build date.

2015-12 (0.5)

* First release

2015-04

* Begin