This is a list of possible errors reported by sources in the
directory miro/src/lib/extract. All errors are reported by making
calls to one of the error routines in miro/src/lib/parse/error.c. The
errors are broken down by the source file they are reported from.

N.B. The "Programmer Errors" below are only tested for if the source
files are compiled with the macro DEBUG defined.

============================= Semantic Errors ==========================

EXTRACT.C

"value associated with property name 'foo' should be a list"
   Certain types of property names (e.g. "children") only takes lists
   as values. This error is reported if some such property named "foo"
   is being assigned a non-list in the input file.

"this 'foo' is missing the required property named 'bar'"
   Each entry type has a certain set of required property names. If
   the required property name "bar" of entry "foo" is not included,
   this error message is reported.

============================= Programmer Errors ==========================

"extact.c: list size of XX too small"
   The maximum list size for PNameDesignators passed to InitPNameList()
   was exceeded by some list in the input file. The size is set in the
   file miro/src/include/parser.h by the value of the macro
   MaxNumPNames. The value XX is the current value for this macro.
   N.B.: there is *no* limit on the sizes of lists in the input file;
   this is a different kind of list (for extracting values); see the
   documentation in extract.c for details.

"convert.c: prop_val_type should be IntValType instead of 0xXX"
   The ConvertInt() and routine assumes its first argument is a
   pointer to a PropVal with PropValTypeOf IntPValType; if it isn't,
   this error is reported; XX is the hex representation of the
   encountered PropValType.

"convert.c: prop_val_type should be IdValType instead of 0xXX"
   The ConvertId() and ConvertString() routines assume their first
   arguments are pointers to PropVal's with PropValTypeOf IdPValType;
   if they aren't, this error is reported; XX is the hex
   representation of the encountered PropValType.
