A concise tree giving the structure of the source code follows.  A section
name is given brackets when it has already been given on a previous line: so
"(inform.c)" is intended to be read as "now back to inform.c again". A name
written as a function, like "compile()", is indeed a function, whose
arguments are omitted here.  Text in square brackets indicates the presence
of interesting tables of static data.  Finally, note that this structure
is not absolutely rigorous: the error-reporting routines in "errors.c", for
example, are called from all over Inform, not just from the lexical analyser.


    inform.c  ICL parser: switches, filename translation, path variables

    memory.c  ICL memory command parser: sets memory settings.

    (inform.c)   compile(): polling all sections to manage variables,
                 allocate and free arrays

    syntax.c       syntax analyser, top level
    
    lexer.c          lexical analyser: converts source text to a stream of
                     tokens
                     [Tables of all Inform keywords]

    chars.c            performs character set translations
    
    files.c            reads source code files into buffers for the lexer;
                       performs miscellaneous file I/O

    symbols.c          keeps table of symbol names found in the source;
                       recognises from and adds to this table
    
    errors.c           issues error, fatal error and warning messages
    
    (syntax.c)     parse_program(): top level routine in syntax analyser

                     parse_directive()

    directs.c          parse_given_directive(): parses and obeys the easier
                       directives; manages conditional compilation; delegates
                       directive parsing down to other sections for harder
                       cases:

    text.c               make_abbreviation(): Abbreviate

    arrays.c             make_global(): Array, Global

    objects.c            make_attribute(): Attribute
                         make_property(): Property
                         make_class(): Class
                         make_object(): Object

    verbs.c              make_fake_action(): Fake_Action
                         make_verb(): Verb
                         extend_verb(): Extend

    linker.c             link_module(): Link

    (symbols.c)            assign_symbol(): giving value and type to symbols

    (syntax.c)         parse_routine()

                         parse_code_block()

    states.c               parse_statement(): assigns ".Label" labels, parses
                           and generates code for statements

                             parse_action(): handles <Action ...> statements

                             parse_print(): handles print and print_ret

    asm.c                    parse_assembly(): handles assembly language
                             source code (preceded by "@")

    expressp.c                 parse_expression(): parses all expressions
                               (including constants), conditions and
                               assignments.

    expressc.c                 [Table of operators]
                               code_generate(): generates code from parse
                               trees previously found by parse_expression()

    (asm.c)                      assemble_2_to() (and many other similarly
                                 named routines)

                                   [Database of all Z-machine opcodes]
                                   assemble_instruction(): assembles a single
                                   Z-code instruction

                                   assemble_label_no(): puts label N here

                                   assemble_routine_end(): finishes routine,
                                   backpatches and optimises branches

    (text.c)                     compile_string(): translates ASCII text
                                 to Z-encoded text

                                 the dictionary manager

                                 the abbreviations optimiser

    (chars.c)                      performs character set translations

    veneer.c       compile_veneer(): compiles in any whole routines
                   needed by the rest of the compiled code
                   [Table of Inform source code for veneer routines]

    tables.c       construct_storyfile(): glues together all the
                   code, dictionary, object tree, etc. into a story file

    bpatch.c       backpatch the code in the light of recent knowledge