Name Dictionary

The name dictionary is a simple ASCII file, with at most one name entry per line. Curly brackets {} will be used to indicate the beginning and end of a set of names of sub-fragments. Each definition line will contain the following:

index / tag value in hex

fragment name (ASCII)

fragment title (ASCII)

The index value for a bank must be in the range 0000 to FFFF and for a segment it must be in the range 00 to FF. The fragment name must contain only alphanumeric characters, and names are case insensitive. The title may contain any printable character. The three fields are delimited by any amount of white space (space or tab), and the title starts at the first non-space character after the name and continues to the end of line or to a matching close curly bracket. Comments may be embedded anywhere in the file (including the middle of titles) using C style delimiters:

 /*comment */

If the first non-comment, non-white space character on a line is the left curly bracket, all following definitions up to the close curly bracket are for substructures of the previous name. For example:

 /* This is a sample name dictionary */ 
 1   name   now is the time /* I hope */ for all 
 2   another 
   {1  abc   good men 
    2  def   to come to 
   } 
 3  lastname (sic) 
   {99 abc "handle"}

Defines the outermost names $<name>$, another, and lastname, where the fragment another has 2 defined sub-fragments named abc and def, and lastname has one defined sub-fragment named abc. By convention, sub-fragments may be uniquely referred to by giving all parent names in order separated by periods. In this example, another.abc is a fragment with a title of good men, and lastname.abc has a title of "handle".