--- texttool-architecture/soft-cgi.tex	2004/01/13 10:56:52	1.7
+++ texttool-architecture/soft-cgi.tex	2004/01/13 11:26:11	1.9
@@ -49,18 +49,42 @@ The input metadata file must have the fo
 \paragraph{plan of this section }
 
 \begin{enumeration}
+\item An overview of toc.cgi architecture
 \item A walk-through of typical cgi queries for toc.cgi
 \item An index of cgi parameters and values with short descriptions of function
 \end{enumeration}
 
-\paragraph{}
+\paragraph{Overview of toc.cgi architecture}
+
+\subparagraph{}
 toc.cgi is a perl script for displaying collections of xml texts and 
 linking them to related resources such as page-images, morphological
 analysis, commentaries, dictionaries, etc. It implements generic methods
 for resource-linking provided by a series of perl modules which are in
-turn based mainly on generic tools for xml manipulation and networking
+turn based mainly on generic open-source tools for xml manipulation and networking
 written in C. 
 
+\subparagraph{toc.cgi collections--Network transparency}
+Each of the collections in toc.cgi is a ``virtual'' collection, that
+is, a collection of links or uri's to resources that reside somewhere on an accessible
+network, local or remote.  
+
+\subparagraph{toc.cgi collections--remote resources}
+
+What is at the other end of the link is of no concern to toc.cgi, as
+long as the resource referenced by the link meets minimal toc.cgi
+requirements--how the resource is actually implemented and exposed is
+a matter for the resource provider. The link may, for instance, point
+directly to an xml text or it may point to a container which exposes a
+particular xml view of an underlying resource that is perhaps not in
+xml format at all. 
+
+
+\subparagraph{resource registry}
+
+
+
+
 \paragraph{cgi parameters -- standard queries}
 
 \htmladdnormallink{ http://archimedes.mpiwg-berlin.mpg.de/cgi-bin/toc/toc.cgi?step=corpus }{ http://archimedes.mpiwg-berlin.mpg.de/cgi-bin/toc/toc.cgi?step=corpus }
@@ -131,17 +155,19 @@ get a page of text from a work from defa
 \paragraph{addarch.pl ARCHIMEDES} 
 
 Automatically registers new texts as toc.cgi objects when they appear in
-cvs. Automatically updates relevant morphological indices (slow!).
+cvs. Automatically updates relevant morphological indices (slow!) each
+time a cvs update occurs. This program is called by a hook in the cvs
+``loginfo'' configuration file. 
 
 
-\paragraph{makelemma.pl}
+\paragraph{makelemma.pl ARCHIMEDES}
 
 Updates lemmatization indices. 
 Parameters: 
 No parameter--update all lemmatization indices
 [latin | ital | greek | en | nl | de]--  update this language
 
-\paragraph{makefast.pl} 
+\paragraph{makefast.pl ARCHIMEDES} 
 
 Updates the toc.cgi morphology indices
 Parameters