% ----------------------------------------------------------------------------
%
%                                  Hans Wolfgang Loidl, RISC-Linz,  10.3.1992 
%
%
% Changes:    <By whom>, <When>, <What changes> 
%
% H.W.  Loidl, 7.11.1991, Title in \bf style, contents of
%                         `Functions' in \tt style
%
%  SW-form for registering the software products that are installed
%  on a machine in the ACPC network. 
%  NOTE: This is no independent LaTex file. It has to be included in the 
%        file that describes the corresponding ACPC group
%        or in a `frame' LaTex file (see `sw-frame.tex') where
%        formating information etc is given.
%        All SW-forms should be included into the group description file
%        after the included HW-form.
%
% ----------------------------------------------------------------------------


\subsubsection*{\bf ParaScope Debugger}

\begin{itemize}
 \item {\bf Name:} ParaScope Transputer Network Debugger for Logical Systems C.  
                   % Full name and version of the software product (sw-p).

 \item {\bf Location:} 
                   /usr0/lsc/dos/cdbug

                   % Full path of the sw-p (references to other
                   % important directories might be included here).

 \item {\bf Type:} Debugger for parallel programs.
 
                   % What sort of sw-p is this?
                   % Possible entries are: (Parallelizing) Compiler, Debugger,
                   % Editor, Computer Algebra System etc.

 \item {\bf Characterization:} 
                  This debugger works with Logical Systems C on a network
                  of Transputers. It is a `postmortem' debugger. In several
                  windows the source code, the memory contents and other information
                  is shown.

                  % A short description of what the sw-p
                           % does (no longer than 50 words).

 \item {\bf Functions:}     % Description of the main features of the 
                        % sw-p.
                        % This should include the following subtopics:
       \begin{itemize}
        \item {Invocation:}  {\tt cdbug} \{ {\it options} \}% How to start the sw-p.
        \item {Termination:} {\tt <CTRL> C} for terminating the program that has to
                             be debugged and to enter the debugger with the above command.

                             Go with the mouse to the {\it Process Register Window\/}.
                             Press center mouse button and choose ``exit'' from the
                             menu that pops up.
        \item {Help:}         % How to get help.
        \item {Example:}     {\tt cdbug} 

                             Debug a program that has just crashed on the
                             transputer (network) or that has been stopped
                             with {\tt <CTRL> C}. In the program that has to be
                             debugged the function {\tt debug()} has to be 
                             called at the beginning of main and for each 
                             that will be linked into the main program a 
                             symbol table must be generated by calling the
                             program {\tt symtab.exe}.
        \item {Other important functions:}  Pressing the center mouse button
                           in different windows causes different menus to pop up.
       \end{itemize}

 \item {\bf Installation:}  % Which environment vars have to be set, etc.
         \verb+SET CDPATH=Z:\USR0\LSC\DOS\CDBUG+ (directory for the debugger).

 \item {\bf Manuals:}  ``ParaScope Transputer Network Debugger for Logical
                         Systems C'', by Computer Systems Architects (CSA),
                         1990.
                       
 
\end{itemize}


