%++++++++
%.IDENTIFICATION cdscat.tex
%.PURPOSE        Man pages related to CDS Catalogue
%.AUTHOR         Francois Ochsenbein
%.VERSION   1.0  17-May-1995
%----------
% The normal sequence of a man page is
%\begin{manpage} {sec_num}{Name}{Short Title}{Version}{Keywords}
%\syntax{ how to call }
%\mansec{ Description }
%\mansec{ Options }
%\mansec{ Returned status }
%\mansec{ Environment Variables }
%\mansec{ Restrictions }
%\seealso { Other topics }
%\end{manpage}
\begin{manpage}{3}{cdscat}{CDS Catalogues Subroutines}{17-May-1995}{CDS Catalogues ReadMe}
\def\pt{{\tt*}}
\syntax{}
\#include <readmef.h>
\begin{itemize}
\item	Interpretation of ReadMe File: \\
    READMEF {\pt\em readmef} = {\tt rmf\_new}(char \pt{\em ReadMe\_File}); \\
    FILINFO {\pt\em filinfo} = {\tt rmf\_findfile}(READMEF \pt{\em readmef},
		char \pt{\em filename}); \\
    FILINFO {\pt\em filinfo} = {\tt rmf\_addfile}(READMEF \pt{\em readmef},
		char \pt{\em filename}); \\
    TABFORM {\pt\em tabform} = {\tt rmf\_findformat}(READMEF \pt{\em readmef},
		char \pt{\em filename}); \\
    FORMAT {\pt\em format} = {\tt tbf\_findlabel}(TABFORM {\pt\em tabform},
		char \pt{\em LABEL}); \\
    TABMAP {\pt\em tabmap} = {\tt tbm\_new}(TABFORM {\pt\em tabform},
		char \pt{\em instructions}, char \pt{\em prefix}); \\
\item   Unit manipulation: \\
    char \pt{\em developped\_unit} = {\tt unitex}( char \pt{\em symbol}, 
		int {\em option}); \\

\mansec{Description}
    This set of functions, stored in the libraries 

    \noindent {\tt /usr/local/lib/libsk.a} for the client routines, and in

    \noindent {\tt /usr/local/lib/libskserv.a} (server routines),

   \noindent allow to deal with {\tt ReadMe} file 
	(see CDS Standard Documentation)

\mansec{Include Files}
Function declarations are gathered in the two files:
\begin{itemize}
\item {\tt /usr/local/include/readmef.h} for client routines
\end{itemize}


\mansec{Example of a Server}
The following shows the basic writing of a server which creates a child
via {\bf fork}(2) who has to deal with the client. The server
is assumed to receive the name of a file and to send its contents 
to the Client.

\seealso{anafile(1) tofits(1) }
\end{manpage}
