--- texttool-architecture/soft-cgi.tex	2003/12/19 13:05:35	1.1
+++ texttool-architecture/soft-cgi.tex	2004/01/06 21:34:05	1.4
@@ -1,10 +1,83 @@
 \subsubsection{rec.cgi (register text)}
 \label{sec:rec.cgi}
 
+\paragraph
+On the ECHO server, new texts are registered by means of reg.cgi (
+archimedes/web/cgi-bin/toc/admin/reg.cgi ). reg.cgi retrieves a
+metadata file from the entered uri (currently only local paths are
+supported ) and constructs from this file a toc.cgi object file (see
+below) , which it writes to toc.cgi's data section. [corpus???]
+
+\paragraph
+reg.cgi takes two parameters, path and show.  Path should give the
+local path to the metadata file for the text that is being
+registered. If ``show'' is set to 1, reg.cgi will return for
+inspection the toc.cgi object file that it has built out of the
+submitted metadata file. 
+
 
 \subsubsection{toc.cgi (display text)}
 \label{sec:toc.cgi}
 
+\paragraph{plan of this section }
+
+\begin{enumeration}
+\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{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 }
+\newline
+\newline
+get a listing of corpora
+
+
+\htmladdnormallink{ http://archimedes.mpiwg-berlin.mpg.de/cgi-bin/toc/toc.cgi?step=xmlcorpusmanifest }{ http://archimedes.mpiwg-berlin.mpg.de/cgi-bin/toc/toc.cgi?step=xmlcorpusmanifest }
+\newline
+\newline
+get an xml listing of corpora 
+
+
+\htmladdnormallink{ http://archimedes.mpiwg-berlin.mpg.de/cgi-bin/toc/toc.cgi }{ http://archimedes.mpiwg-berlin.mpg.de/cgi-bin/toc/toc.cgi }
+\newline
+\newline
+get a listing of works in default corpus
+
+\htmladdnormallink{ http://archimedes.mpiwg-berlin.mpg.de/cgi-bin/toc/toc.cgi?corpus=1 }{ http://archimedes.mpiwg-berlin.mpg.de/cgi-bin/toc/toc.cgi?corpus=1 }
+\newline
+\newline
+get a listing of works in corpus 1 [default corpus = 0]
+
+\htmladdnormallink{ http://archimedes.mpiwg-berlin.mpg.de/cgi-bin/toc/toc.cgi?step=xmlcorpuslist }{ http://archimedes.mpiwg-berlin.mpg.de/cgi-bin/toc/toc.cgi?step=xmlcorpuslist }
+\newline
+\newline
+get an xml listing of works in default corpus 
+
+\htmladdnormallink{ http://archimedes.mpiwg-berlin.mpg.de/cgi-bin/toc/toc.cgi?step=xmlcorpuslist;corpus=1 }{ http://archimedes.mpiwg-berlin.mpg.de/cgi-bin/toc/toc.cgi?step=xmlcorpuslist;corpus=1 }
+\newline
+\newline
+get an xml listing of works in corpus 1
+
+\htmladdnormallink{ http://archimedes.mpiwg-berlin.mpg.de/cgi-bin/toc/toc.cgi?dir=baifl_renav_006_la_1537;step=thumb }{ http://archimedes.mpiwg-berlin.mpg.de/cgi-bin/toc/toc.cgi?dir=baifl_renav_006_la_1537;step=thumb }
+\newline
+\newline
+get a work from default corpus with thumbnail navbar displayed left
+
+
+\htmladdnormallink{ http://archimedes.mpiwg-berlin.mpg.de/cgi-bin/toc/toc.cgi?dir=jorda_ponde_050_la_1533;step=thumb;ftype=thumbright }{ http://archimedes.mpiwg-berlin.mpg.de/cgi-bin/toc/toc.cgi?dir=jorda_ponde_050_la_1533;step=thumb;ftype=thumbright }
+\newline
+\newline
+get a work from default corpus with thumbnail navbar displayed right
+
+\htmladdnormallink{ http://archimedes.mpiwg-berlin.mpg.de/cgi-bin/toc/toc.cgi?dir=jorda_ponde_050_la_1533;step=textonly;corpus=;page=22 }{ http://archimedes.mpiwg-berlin.mpg.de/cgi-bin/toc/toc.cgi?dir=jorda_ponde_050_la_1533;step=textonly;corpus=;page=22 }
+\newline
+\newline
+get a page of text from a work from default corpus 
+
+
+
 
 \subsubsection{Indexing}
 \label{sec:indexing}