"map.conf" API ============== The "map.conf" config file defines the structure of a map area data file's fields. Every line in the "map.conf" file is either part of a LIST description, is a SELECT description line or is a comment. Each non comment line is made up of elements. Each element is separated from the other elements in the line by white space. Some elements may have white space imbedded in them but these elements specifically noted as begining and ending with "s. Each line of the "map.conf" is one of the following: A comment line LIST start line A LIST END line A nickname description line A SELECT description line A comment line is a line which starts a "#" or a white space. A LIST start line has one element a LIST nickname. The following line(s) which are not "A LIST end line" describe a LIST nickname. A LIST end line has one element, "END". This will stop the description of one LIST nickname. A nickname description line has this FORMAT: NICKNAME "Full Description" TYPE SINGLE/MULTI The NICKNAME is a unique internal discription for the field. You can not have more then one field with the same NICKNAME "Full description" is surrounded by "s. It can consist on any printable character except a ". TYPE is either OPEN, SELECT or LIST. If the TYPE is OPEN it is considered open ended. When a person enters a value for this field through the web interface they may type in anything. If the type is SELECT then a "SELECT description line" must follow outside a LIST description. When a person enters a value for this field through the web interface they will select from a list of values. If the TYPE is LIST then a LIST description must exist somewhere in the "map.conf" that is outside any other LIST descriptions. A person will actually enter many values for the multiple fields that make of the LIST description. The last element of a NICKNAME description line is either SINGLE or MULTI. If SINGLE is here then each data file will only have a SINGLE value. If MULTI is here then each data file can have any number of values. A SELECT description line starts with the nickname and then is followed by any number of " surrounded values. Each value may consist of any printable character other then ". This is an example: OS "Windows 9x" "Windows NT" "MacOS" The data file must have at least one LIST description. The mandatory LIST description must be named MAIN. No nickname may be called END.