\documentstyle[11pt]{article}               % Without Bibliography, in English

% ----------------------------------------------------------------------------
%
% Setting  LaTeX Standard Format
%

% Page Format
\topmargin=0.5cm
\textheight=21.5cm
\footskip=1.5cm
\oddsidemargin=0.75cm
\evensidemargin=0.75cm
\textwidth=14.5cm
\headsep=1cm

% Paragraphs
\parskip=\medskipamount
\parindent=0pt

% Footnote Rule
\renewcommand{\footnoterule} {\kern-3pt \hrule width \textwidth \kern 2.6pt}

% ----------------------------------------------------------------------------

\title{Structure of the ACPC Manual}            % Insert the name of the group here

\author{
  H. W. Loidl, RISC-Linz
}

\begin{document}

\maketitle

The following document should sketch the hierarchical structure of the
ACPC Manual. It also describes which parts should be put in separate
files.


\section{Logical Structure of the manual}

The headline in the following picture describes the level of the
corresponding part in the LaTex file. A node marked with * is the
beginning of a new file, that has to be included into the main part.

\begin{verbatim}

    report       chapter  section subsection  subsubsection

  ACPC-Manual * 
      |
      |
      |--- Introduction
      |
      |
      |
      |--- Hardware Connections
      |
      |
      |
      |--- The Groups in the ACPC
      |            |
      |            |---
      |            |   .
      |            |   . <\input of one file for each group>
      |            |   .
      |            |---
      |
      |--- Facilities in the Network
      |            |
      |            |
      |            |---  <group> *   
      |            |        |   
      |            |        |
      |            |        |--- <machine_1>
      |            |        |        |
      |            |        |        |---  <HW-form> * 
      |            |        |        |
      |            |        |        |---  <SW-form_1> * 
      |            |        |        |   .
      |            |        |        |   .
      |            |        |        |   .
      |            |        |        |---  <SW-form_{n_1}> *
      |            |        |
      |            |        |   .
      |            |        |   .
      |            |        |   .
      |            |        |
      |            |        |--- <machine_m>
      |            |        |        |
      |            |        |        |---  <HW-form> *
      |            |        |        |
      |            |        |        |---  <SW-form_1> *
      |            |        |        |   .
      |            |        |        |   .
      |            |        |        |   .
      |            |        |        |---  <SW-form_{n_m}> *
      |            |---
      |            |    .
      |            |    .
      |            |    .
      |            |---
      |
      |
      |--- Future Plans                   


\end{verbatim}

\section{Physical Structure of the manual}

To make the changes of each group independent of each other the following
parts should be put in a separate file:

\begin{itemize}
 \item A {\it group-description\/} for each ACPC-group.
       Such a {\it group-description\/} should contain a description of 
       each machine of this group, consisting of a filled in 
       {\it HW-form\/} (separate file!) and a filled in 
       {\it SW-form\/} (separate file!). So, the body of a group-description
       file should look like this:

        \begin{verbatim}

            \input{hw-1}     % filled in HW-form of first machine

            \input{sw-1-1}   % filled in SW-form
	    ...
            \input{sw-1-n1}  % filled in SW-form

            ...

            \input{hw-m}     % filled in HW-form of last machine

            \input{sw-m-1}   % filled in SW-form
	    ...
            \input{sw-m-nm}  % filled in SW-form

        \end{verbatim}


 \item A filled in {\it HW-form\/}  which is taken from the template file
       {\tt hw-form.tex}.
 \item A filled in {\it SW-form\/}  which is taken from the template file
       {\tt sw-form.tex}.
\end{itemize}
 
By this structure it should never be necessary to change the top level file
after having added the inputs for each group. And the only thing one has to 
do in the group-description file is to make an `input' with the new
files describing the HW and SW of a new machine.

\end{document}
