=================================================================== RCS file: /home/cvs/OpenXM/doc/issac2000/openxm-clients.tex,v retrieving revision 1.7 retrieving revision 1.10 diff -u -p -r1.7 -r1.10 --- OpenXM/doc/issac2000/openxm-clients.tex 2000/01/16 06:39:39 1.7 +++ OpenXM/doc/issac2000/openxm-clients.tex 2000/01/17 01:24:27 1.10 @@ -1,4 +1,4 @@ -% $OpenXM: OpenXM/doc/issac2000/openxm-clients.tex,v 1.6 2000/01/16 03:15:49 noro Exp $ +% $OpenXM: OpenXM/doc/issac2000/openxm-clients.tex,v 1.9 2000/01/17 00:48:06 takayama Exp $ \section{OpenXM Clients} @@ -28,9 +28,9 @@ are provided to execute these primitive operations: {\tt ox\_push\_cmd()} for sending an {\tt SM} command to a server and {\tt ox\_get()} for receiving data from a stream. -Some operations including the reset operation are realized by +Some operations including the reset operation are implemented by combining these primitives. Among them, frequently used ones are -provided as built-in functions. We show several ones. +provided as built-in functions. We show some of them. \begin{itemize} \item {\tt ox\_pop\_cmo()} @@ -49,8 +49,8 @@ the function. It does not wait the termination of the After sending {\tt SM\_control\_reset\_connection} to a control server, it completes the operations stated in Section \ref{control}. \end{itemize} -Furthermore {\tt ox\_select()} is provided to detect streams ready for -reading. It is realized by the {\tt select()} system call and is used +Furthermore {\tt ox\_select()} is provided to detect if streams are ready for +reading. It is implemented by the {\tt select()} system call and is used to avoid blocking on read operations. \subsection{Mathematica} @@ -61,7 +61,7 @@ The module {\tt math2ox} communicates with Mathematica with any OpenXM server by the OpenXM protocol. By using the module {\tt math2ox}, we can call OpenXM servers from Mathematica; -here is an example of a computation of the de Rham cohomology groups +here is a demonstration of a computation of the de Rham cohomology groups of ${\bf C}^2 \setminus V(x^3-y^2)$ from Mathematica. {\footnotesize \begin{verbatim} @@ -74,8 +74,6 @@ Out[4]= [ 1 , 1 , 0 ] (* The dimension of \end{verbatim} } -\subsubsection{Functions} - The {\tt math2ox} adds the following functions to Mathematica. \begin{quote} {\tt OxStart[s\_String]} \\ @@ -95,7 +93,9 @@ as {\tt ox\_pop\_cmo()} in Risa/Asir; it pops data from the server stack. The {\tt OxGet[]} receives an OX data message and returns its translation to an local object. -By using the {\tt OxParse[]} function, one can send OX messages, +The function {\tt OxParse[]} helps debugging to connect Mathematica +and ox servers. +By using the function, one can send OX messages, written by the OX expression, to a server. OX expressions are Lisp-like expressions for OX messages and are defined in~\cite{noro-takayama}.