--- texttool-architecture/soft-cgi.tex	2004/01/15 09:03:23	1.12
+++ texttool-architecture/soft-cgi.tex	2004/04/03 17:19:33	1.17
@@ -23,8 +23,7 @@ submitted metadata file.
 
 The input metadata file must have the following form
 
-\paragraph
-
+\begin{verbatim}
 <resource>
     ...
     <meta>
@@ -35,11 +34,12 @@ The input metadata file must have the fo
 <author>anon</author>
 <year>1580</year>
         <texttool><display>yes</display>
-	<image>pageimgtif</image>
-	<text>/mpiwg/online/experimental/echo_DRQEdit_test/anon_Mainz_1580/fulltextDW/mainzugo02_utf8.xml</text>
-	<pagebreak>pb</pagebreak><presentation>01-presentation/info.xml</presentation></texttool></meta>
+        <image>pageimgtif</image>
+        <text>/mpiwg/online/experimental/echo_DRQEdit_test/anon_Mainz_1580/fulltextDW/mainzugo02_utf8.xml</text>
+        <pagebreak>pb</pagebreak><presentation>01-presentation/info.xml</presentation></texttool></meta>
 
     </meta>
+\end{verbatim}
 
 \paragraph{archimedes object registration}
 
@@ -48,11 +48,12 @@ The input metadata file must have the fo
 
 \paragraph{plan of this section }
 
-\begin{enumeration}
+\begin{enumerate}
 \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}
+\item The TOC Perl modules
+\end{enumerate}
 
 \paragraph{Overview of toc.cgi architecture}
 
@@ -87,56 +88,72 @@ xml format at all.
 
 \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 }
+\url{ 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 }
+\url{ 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 }
+\url{ 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 }
+\url{ 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 }
+\url{ 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 }
+\url{ 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 }
+\url{ 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 }
+\url{ 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 }
+\url{ 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 
 
 
-
+\paragraph{TOC Perl Modules}
+\subparagraph{general}The documentation for the Toc Perl Modules is
+located in the modules themselves in POD format. The POD is the
+definitive documentation for the modules. 
+
+The modules are available to archimedes staff from cvs on the archimedes server at
+141.14.236.86:/perseus/cvsroot in the module
+/perseus/cvsroot/mpitexts/perl/perllib. To get them, log on to the
+archimedes server and use the commandline command: 
+\begin{verbatim}
+        cvs -d /perseus/cvsroot co /perseus/cvsroot/mpitexts/perl/perllib
+\end{verbatim}
+
+or from a remote location
+
+\begin{verbatim}
+      bash; export CVS_RSH=ssh; cvs -d :ext:myusername@141.14.236.86:/perseus/cvsroot co /perseus/cvsroot/mpitexts/perl/perllib
+\end{verbatim}
 
 \subsubsection{Indexing}
 \label{sec:indexing}
@@ -146,18 +163,18 @@ Currently indexing is not implemented on
 
 \paragraph{Plan ECHO}
 
-\begin{enumeration}
+\begin{enumerate}
 \item construct remote (141.14.236.86) index for each file at
   per-change or daily intervals
 \item store indices locally in
-archimedes/data/db/PROJECT_NAME/CORPUS_NAME/WORK
-\item 2 progs on server 1. cgi: indexer 2. backend da_remote
-\item 2 progs on client 1. cgi: sendindex 2. backend getindex
+\url{archimedes/data/db/PROJECT_NAME/CORPUS_NAME/WORK}
+\item 2 progs on server 1. cgi: \url{indexer} 2. backend \url{da_remote}
+\item 2 progs on client 1. cgi: \url{sendindex} 2. backend \url{getindex}
 \item indexing transaction handled by two cgi scripts, one on the
   server the other on the client [this is the 1st implementation bcs
   its easiest and there are no port issues, but probably it'd be
   better to have a separate port]. 
-\item client cgi: indexinput -- sends 1.  list of files to index
+\item client cgi: getindex -- sends 1.  list of files to index
   2. uri to which xml notification of completion is to be sent. Upon
   notification, activates backend prog that fetches and installs the
   indices.  
@@ -168,7 +185,7 @@ archimedes/data/db/PROJECT_NAME/CORPUS_N
 \item single script provides backend access to indices 
 \item leave front-end issues like display, collection and navigation
   to web-design programmers. Do only a  sample for now. 
-\end{enumeration}
+\end{enumerate}
 
 \subsubsection{Morphology}
 \label{sec:morphology}
@@ -202,6 +219,32 @@ Parameters
 No parameter--update all lemmatization indices
 [latin | ital | greek | en | nl | de]--  update this language
 
+\subsubsection{summary of differences btwn the archimedes toc.cgi
+  implementation and the echo toc.cgi impelementation (toc.x.cgi)}
+
+\paragraph{missing in archimedes}
+\begin{enumerate}
+
+\item html templates (coded but phased out of cvs branch)
+\end{enumerate}
+
+\paragraph{missing in echo}
+\begin{enumerate}
+
+\item word-coloring?
+\item remote text method may work differently
+
+
+
+\end{enumerate}
+\paragraph{differences}
+\begin{enumerate}
+\item structure of info.xml
+\item resource-discovery algorithm for info.xml
+\end{enumerate}
+
+
+
 %%% Local Variables: 
 %%% mode: latex
 %%% TeX-master: "texttools"