  % -*- Mode:TeX -*-

\appendix
\chapter{Files of the Dataflow Compiler Substrate}
\label{files}

\begin{aside}
{\bf Note:} The files described in this section correspond to the state of
the DFCS system as on the date of release of this document. This section
MUST be updated whenever there is an addition or deletion of files to the
DFCS system. (Hopefully this would not be very often.)
\end{aside}

Figure~\ref{dfcs-files} describes the files currently present in the DFCS
system. Those marked with an asterisk ($\ast$) are ususally loaded as part
of the definition of the {\tt dfcs} program. Others are present as aids and
tools. The references at the end point to the chapters or sections of this
document or other documents which describe most (or relevent) parts of that
file. 

\begin{systemfiles}{Dataflow Compiler Substrate System}{dfcs}{dfcs-files}
\fileentry{ciobl}{Implements CIOBL.}{$\ast$}{Chapter~\ref{ciobl}}
\fileentry{common}{Implements common utilities for DFCS; {\em sxhash-tables}, clause validation, and miscellaneous functions.}{$\ast$}{Section~\ref{misc-fns}}
\fileentry{dataflow-graph}{Dataflow Graph Abstraction.}{$\ast$}{Section~\ref{dfg}}
\fileentry{defcompiler}{Utilities for defining and running Compilers.}{$\ast$}{Chapter~\ref{defcompiler}}
\fileentry{external-symbols}{Implements External Symbols Abstraction.}{$\ast$}{Chapter~\ref{exsym-tables}}
\fileentry{file}{CIOBL read/write functions for Dataflow Graphs.}{$\ast$}{}
\fileentry{frame}{Implements Frames (except for wiring functions).}{$\ast$}{Section~\ref{FrameSubSection}}
\fileentry{parse-tree}{Implements Lexical Tokens and Parse Tree manipulations.}{$\ast$}{Section~\ref{parsetrees}}
\fileentry{performance-meters}{Implements Performance Metering.}{}{Section~\ref{perf-meters}}
\fileentry{storage}{Implements explicit management of adjustable vectors with fill pointers.}{$\ast$}{}
\fileentry{syntax-directed}{Implements Grammars and Parse Tree Attribute management.}{$\ast$}{\parbox[t]{1in}{\centering Section~\ref{grammars} \\ and \\ Section~\ref{ptnode-attr}}}
\fileentry{test}{Some random test functions for DFCS.}{}{}
\fileentry{wiring}{Implements wiring functions to and from Instruction/Frame Sinks and Sources.}{$\ast$}{Section~\ref{dfg}}
\fileentry{write-verbose-dataflow-graph}{A utility to view a dataflow graph in a tabular form.}{}{Section~\ref{misc-fns}}
\end{systemfiles}

