% LAY_e2.TEX - Anhang von LAYOUT.TEX (PA 1988)
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\clearpage

\section*{Appendix}
\addcontentsline{toc}{section}{Appendix}

\appendix

\section{The page structure in \LaTeX}

This appendix describes how the actual page is build from it's 
components and how they are influenced by \TeX s parameters 
(\seealso{Fig.\,\ref{bild}}.  Figure~\ref{bild} has been created by 
Nelson Beebe at the University of Utah.

\begin{description}

\item[text area]
	The normal text area (``Body'') contains the running text 
	including footnotes, tables and figures.  The headings, footer 
	and margin notes do \emph{not} belong to the text area.
        
	The text area has the width \texttt{\textbackslash textwidth} 
	and the height \texttt{\textbackslash text\-height}.
        
	In a twocolumn layout the text area is split into two 
	columns, with the width \texttt{\textbackslash columnwidth} 
	each and a space of \texttt{\textbackslash columnsep} between 
	them.  Thus the \texttt{\textbackslash columnwidth} is a 
	little bit smaller than half the \texttt{\textbackslash 
	textwidth}.
	
	\texttt{\textbackslash textwidth} and \texttt{\textbackslash 
	columnwidth} should be a multiple of the width of one 
	character in the \texttt{tt} font.
	
        \texttt{\textbackslash textheight} should be multiple of the 
        line height \texttt{\textbackslash baselineskip}, increased by 
        the constant value of \texttt{\textbackslash topskip}.
	
	Indentations inside the text area are defined with 
	\texttt{\textbackslash leftskip} and \texttt{\textbackslash 
	rightskip}.  These parameters should not be changed explicit 
	by the user but rather implicit through environments.
	
\item[left margin]
	The left margin is either \texttt{\textbackslash odd-} or 
	\texttt{\textbackslash evensidemargin} increased by 1~inch.  
	Both parameters have the same value, unless the 
	\texttt{twoside} option is given.

\item[top margin]
	The top margin is the sum of \texttt{\textbackslash 
	topmargin}, \texttt{\textbackslash headheight} and 
	\texttt{\textbackslash headsep} increased by 1~inch.

\item[right margin]
	The right margin is the paper width minus the left margin and 
	the text area.

\item[bottom margin]
	The bottom margin is the paper height minus the top margin and 
	the text area.
       
\item[heading]\index{headings}
	The heading is inside the top margin with a space of 
	\texttt{\textbackslash headsep} between the lower border of 
	the header and the upper border of the text area.  Above the 
	header is a free space of \texttt{\textbackslash topmargin} 
	increased by 1~inch.
      
\item[footing]\index{footings}
	The footer is inside the bottom margin with a space of 
	\texttt{\textbackslash footskip} between the lower border of the text 
	area and the lower border of the footer.
	
\item[margin notes]\index{margin notes}
	Margin notes are inside the left or right margin.  They have a 
	width of \texttt{\textbackslash marginparwidth} and a space of 
	\texttt{\textbackslash marginparsep} between the margin note 
	and the text area.  The vertical space between two margin 
	notes is \texttt{\textbackslash marginparpush}.
		    
\end{description}

The paperheight consists of the following elements (from top to 
bottom):
\begin{verse}
\rmfamily 1 Inch \\*[2pt]
\ttfamily \textbackslash topmargin \\*[2pt]
\textbackslash headheight \\*[2pt]
\textbackslash headsep \\*[2pt]
\textbackslash textheight \\*[2pt]
\textbackslash footskip \\*[2pt]
\rmfamily remaining page.
\end{verse}

On pages with margin notes in the right margin the paperwidth consists 
of the following elements:
\begin{verse}
\rmfamily 1 Inch \\*[2pt]
\ttfamily \textbackslash oddsidemargin
\rmfamily\ \ or\ \ 
\ttfamily \textbackslash evensidemargin \\*[2pt]
\textbackslash textwidth \\*[2pt]
\textbackslash marginparsep \\*[2pt]
\textbackslash marginparwidth \\*[2pt]
\rm remaining page
\end{verse}
With the option \texttt{twoside} the left pages change to
\begin{verse}
\rmfamily 1 Inch \\*[2pt]
\ttfamily \textbackslash evensidemargin \\*[2pt]
\textbackslash textwidth \\*[2pt]
\rmfamily remaining page
\end{verse}

\marginlabel{Comments:} The parameters \texttt{\textbackslash 
topmargin}, \texttt{\textbackslash oddsidemargin} and 
\texttt{\textbackslash evensidemargin} may be negative.  In this case 
the margin will be smaller than 1~inch.  The same is true for 
\texttt{\textbackslash leftskip} and \texttt{\textbackslash 
rightskip} which leads to text that is wider than the text area.

Extensive treatment and figures to this subject may be found in the
\textsc{TUGboat} Vol.9, No.1 (April 1988).

The parameter \texttt{\textbackslash footheight} is no longer defined 
in \LaTeXe\ since no-one used it.


%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\begin{fullpage}
%%%%%%%%%%%%%%%%


% Bild von Nelson Beebe, mit geringen "Anderungen von PA:
\newcommand{\X}[1]{{#1}\index{{#1}}}
% NB: For computed dimension parameters, we cannot use
% \newcommand{}, because this expands to a TeX \def which does
% not evaluate the definition before assigning it to the control
% sequence name; we use \xdef directly to force evaluation
\newcount\T      % temporary counter for arithmetic calculations
\T=0

% **********************************************************************
% WARNING: Do not insert ANY aditional whitespace in these
% macros--otherwise it ends up in the TeX boxes and ruins the
% positioning, sigh....
% **********************************************************************

% NAMEBOX{x}{y}{dx}{dy}{width}{height}{pos}{label} -- framed label with
% box lower-left corner at (x+dx,y+dy)
\newcommand{\NAMEBOX}[8]{\put(#1,#2){\begin{picture}(0,0)(-#3,-#4)\ignorespaces
    \framebox(#5,#6)[#7]{#8}\end{picture}}}

% HARROW{x}{y}{dx}{dy}{length}{side}{pos}{label} -- horizontal
% labeled arrow with left point at (x+dx,y+dy), label on bottom
% (side=b) or top (side=t) of arrow, in makebox[pos]
\newcommand{\HARROW}[8]{\put(#1,#2){\begin{picture}(0,0)(-#3,-#4)\ignorespaces
    \put(0,0){\vector(1,0){#5}}\ignorespaces
    \put(#5,0){\vector(-1,0){#5}}\ignorespaces
    \ifthenelse{\equal{#6}{b}}{\ignorespaces
      \put(0,-\TAD){\makebox(#5,0)[#7]{#8}}
    }{\ignorespaces
    \ifthenelse{\equal{#6}{t}}{}{\ignorespaces
      \typeout{Side #6 must be ``b'' or ``t''--``t'' assumed}}\ignorespaces
      \put(0,\TAD){\makebox(#5,0)[#7]{#8}}
    }
    \end{picture}}}

% VARROW{x}{y}{dx}{dy}{length}{side}{pos}{label} -- vertical
% labeled arrow with left point at (x+dx,y+dy), label on left
% (side=l) or right (side=r) of arrow, in makebox[pos]
\newcommand{\VARROW}[8]{\put(#1,#2){\begin{picture}(0,0)(-#3,-#4)\ignorespaces
    \put(0,0){\vector(0,1){#5}}\ignorespaces
    \put(0,#5){\vector(0,-1){#5}}\ignorespaces
    \ifthenelse{\equal{#6}{l}}{\ignorespaces
      \put(-\TAD,0){\makebox(0,#5)[#7]{#8}}
    }{\ignorespaces
      \ifthenelse{\equal{#6}{r}}{}{\ignorespaces
        \typeout{Side #6 must be ``r'' or ``l''--``r'' assumed}}\ignorespaces
        \put(\TAD,0){\makebox(0,#5)[#7]{#8}}
    }
    \end{picture}}}

% VRULE{x}{y}{dx}{dy}{length}{side}{pos}{label} -- vertical
% rule with left point at (x+dx,y+dy), label on left
% (side=l) or right (side=r) of rule, in makebox[pos]
\newcommand{\VRULE}[8]{\put(#1,#2){\begin{picture}(0,0)(-#3,-#4)\ignorespaces
    \put(0,0){\line(0,1){#5}}\ignorespaces
    \ifthenelse{\equal{#6}{l}}{\ignorespaces
      \put(0,0){\makebox(0,#5)[#7]{$\rightarrow${}#8}}
    }{\ignorespaces
      \ifthenelse{\equal{#6}{r}}{}{\ignorespaces
        \typeout{Side #6 must be ``r'' or ``l''--``r'' assumed}}\ignorespaces
        \put(0,0){\makebox(0,#5)[#7]{$\leftarrow${}#8}}
    }
  \end{picture}}}
% **********************************************************************
% If you wish to change any of these values:
%       * definitions are mostly in alphabetical order
%       * remember units are in centipoints for accurate
%         positioning
%       * most parameters are taken directly from values in
%         BK11.STY, but in order to improve the appearance of the
%         figure, a few have been increased to avoid overlap of
%         labels and/or boxes, or to loosen up the figure
%       * ALL parameters which depend on others are defined by
%         computation and \xdef's below; they must NEVER be
%         changed
%
%- For 11pt BOOK style, \textwidth / \pagewidth(8.5in) = 0.5294
%- Anything larger than this will generate an overfull box.  We
%- choose 0.50 since that makes scaling trivial for the reader
%- \newcommand{\UNITLENGTH}{0.005pt}
%- \newcommand{\SCALEFACTOR}{50\%}
%
%-----> We use a larger picture with 0.70 on our DIN-A4 paper:
\newcommand{\UNITLENGTH}{0.007pt}
\newcommand{\SCALEFACTOR}{70\%}
% <------------------------------
%
% US papersize...
%
\newcommand{\PAGEHEIGHT}{79497}         % 11in in centipoints
\newcommand{\PAGEWIDTH}{61430}          % 8.5in in centipoints
%
% Typical dimensions from BK10.DOC
%
\newcommand{\BASELINESKIP}{2000}        % really 1000, but this is
                                        % too tight for the figure
\newcommand{\COLUMNSEP}{1000}
\newcommand{\COLUMNSEPRULE}{0}

% DVI drivers put top left corner at (1in,1in) from physical page
% left corner
\newcommand{\DVIXOFFSET}{7227}
\newcommand{\DVIYOFFSET}{7227}

\newcommand{\EVENSIDEMARGIN}{10841}

\newcommand{\FOOTHEIGHT}{2400} % really 1200, but too tight
\newcommand{\FOOTNOTESEP}{665}
\newcommand{\FOOTSKIP}{4207}    % really 2529, but too tight; for symmetry,
                                % make FOOTSKIP=HEADSEP+FOOTHEIGHT
\newcommand{\HEAdHEIGHT}{2400}  % really 1200, but too tight
\newcommand{\HEADSEP}{1807}

\newcommand{\MARGINPARPUSH}{2000}       % really 500, but too tight
\newcommand{\MARGINPARSEP}{2800}        % really 700, but too tight
\newcommand{\MARGINPARWIDTH}{7227}
\newcommand{\MARGINNOTEHEIGHT}{4444}    % arbitrary value (holds
                                        % ``Margin Note A'' on
                                        % 2 lines)

\newcommand{\ODDSIDEMARGIN}{3613}
%
% Upper left page corner (0,0) is at (1in,1in) on physical page
% for DVI drivers.  Position the LOWER left corner at
% (\PAGEXORIGIN,\PAGEYORIGIN), where \PAGEYORIGIN is computed
% below
\newcommand{\PAGEXORIGIN}{\DVIXOFFSET}

\newcommand{\TAD}{800}     % how far to move labels from their arrows
\newcommand{\TEXTHEIGHT}{50400}
\newcommand{\TEXTWIDTH}{32522}
\newcommand{\TOPMARGIN}{5420}

% **********************************************************************
% DO NOT CHANGE any of these computed parameters
%

%
\T=\TEXTWIDTH
\advance\T by -\COLUMNSEP
\divide\T by 2
\xdef\COLUMNWIDTH{\the\T}

\T=\TEXTWIDTH
\divide\T by 2
\advance\T by \ODDSIDEMARGIN
\xdef\COLUMNXMIDDLE{\the\T}     % 0.5*TEXTWIDTH+ODDSIDEMARGIN

\T=\COLUMNWIDTH
\advance\T by \ODDSIDEMARGIN
\advance\T by \COLUMNSEP
\xdef\COLUMNTWOX{\the\T}        % COLUMNWIDTH+COLUMNSEP+ODDSIDEMARGIN

\T=\FOOTSKIP
\advance\T by \TEXTHEIGHT
\advance\T by \HEADSEP
\xdef\HEADYORIGIN{\the\T}           % FOOTSKIP+TEXTHEIGHT+HEADSEP
%
% Inner TeX page dimensions are (\INNERWIDTH,\INNERHEIGHT).  All TeX
% coordinates are relative to (0,0) at upper-left corner of this
% page, although for the figures, we put (0,0) at lower-left
% corner.
%
\T=\TOPMARGIN
\advance\T by \HEAdHEIGHT
\advance\T by \HEADSEP
\advance\T by \TEXTHEIGHT
\advance\T by \FOOTSKIP
% INNERHEIGHT=TOPMARGIN+HEAdHEIGHT+HEADSEP+TEXTHEIGHT+FOOTSKIP
\xdef\INNERHEIGHT{\the\T}

\T=\ODDSIDEMARGIN
\advance\T by \TEXTWIDTH
\advance\T by \EVENSIDEMARGIN
\xdef\INNERWIDTH{\the\T}  % ODDSIDEMARGIN+TEXTWIDTH+EVENSIDEMARGIN

\T=\ODDSIDEMARGIN
\advance\T by \TEXTWIDTH
\advance\T by \MARGINPARSEP
\xdef\MARGINNOTEXORIGIN{\the\T} % ODDSIDEMARGIN+TEXTWIDTH+MARGINPARSEP

\T=\TEXTHEIGHT
\multiply\T by 75
\divide\T by 100
\advance\T by \FOOTSKIP
\xdef\MARGINNOTEYA{\the\T}      % .75*TEXTHEIGHT+FOOTSKIP

\T=\MARGINNOTEYA
\advance\T by -\MARGINNOTEHEIGHT
\advance\T by -\MARGINPARPUSH
\xdef\MARGINNOTEYB{\the\T}      % MARGINNOTEYA-MARGINNOTEHEIGHT-MARGINPARPUSH

\T=\MARGINNOTEYA
\advance\T by \MARGINNOTEHEIGHT
\xdef\MARGINNOTEYC{\the\T}      % MARGINNOTEYA+MARGINNOTEHEIGHT

\T=\PAGEHEIGHT
\advance\T by -\DVIYOFFSET
\xdef\PAGEYTOP{\the\T}          % PAGEHEIGHT-DVIYOFFSET

\T=\PAGEYTOP
\advance\T by -\INNERHEIGHT
\xdef\PAGEYORIGIN{\the\T}       % PAGEYTOP-INNERHEIGHT

\T=\ODDSIDEMARGIN
\advance\T by \TEXTWIDTH
\xdef\RIGHTEDGE{\the\T}         % ODDSIDEMARGIN+TEXTWIDTH

\T=\TEXTHEIGHT
\multiply\T by 4
\divide\T by 10
\xdef\TEXTY{\the\T}             % TEXTY = 0.4*TEXTHEIGHT (we put
                                % sample text here)

\T=\TEXTHEIGHT
\divide\T by 3
\xdef\TEXTWIDTHY{\the\T}        % TEXTWIDTHY = TEXTHEIGHT/3 (we
                                % put \textwidth label here)
  \begin{figure}
  %%%%%%%%%%%%%%

 \caption{Page layout}
 \label{bild}

    \begin{center}
      \begin{small}       % make text somewhat smaller
      \setlength{\unitlength}{\UNITLENGTH}
        \begin{picture}(\PAGEWIDTH,\PAGEHEIGHT)   % sizes in centipoints

%
          \NAMEBOX{0}{0}{0}{0}{\PAGEWIDTH}{\PAGEHEIGHT}{}{}
%
          \HARROW{0}{\PAGEYTOP}{0}{0}{\PAGEXORIGIN}{b}{}{1in}
%
          \VARROW{\PAGEXORIGIN}{\PAGEYTOP}{0}{0}{\DVIYOFFSET}{r}{l}{1in}
%
          \put(\PAGEXORIGIN,\PAGEYORIGIN){
          \begin{picture}(\INNERWIDTH,\INNERHEIGHT)
            % Draw 3-sided inner page frame--no bottom side
            % because it is not significant for dimensioning
            \put(0,0){\line(0,1){\INNERHEIGHT}}
            \put(0,\INNERHEIGHT){\line(1,0){\INNERWIDTH}}
            \put(\INNERWIDTH,0){\line(0,1){\INNERHEIGHT}}
%
            \NAMEBOX{\ODDSIDEMARGIN}{\TEXTY}{0}{0}{\TEXTWIDTH}{
                \BASELINESKIP}{l}{A line of text\ldots}
            \NAMEBOX{\ODDSIDEMARGIN}{\TEXTY}{0}{-\BASELINESKIP}{
                \TEXTWIDTH}{\BASELINESKIP}{l}{Next line\ldots}
%
            \VARROW{\COLUMNXMIDDLE}{\TEXTY}{0}{-\BASELINESKIP}{
              \BASELINESKIP}{r}{l}{\tt\string\baselinestretch
              $\times$\string\baselineskip}
%
            \HARROW{0}{\TEXTHEIGHT}{0}{0}{\ODDSIDEMARGIN}{t}{}{
              \tt\string\oddsidemargin}
            \HARROW{0}{\TEXTHEIGHT}{0}{0}{\ODDSIDEMARGIN}{b}{}{
              \tt\string\evensidemargin}
            %
            % Page text label
            \NAMEBOX{\ODDSIDEMARGIN}{\FOOTSKIP}{0}{0}{\TEXTWIDTH}{
              \TEXTHEIGHT}{}{Page Text}
            % Page footer box, arrow, and label
            \NAMEBOX{\ODDSIDEMARGIN}{0}{0}{0}{\TEXTWIDTH}{
              \FOOTHEIGHT}{}{Page Footer}
            %
            \VARROW{\ODDSIDEMARGIN}{0}{-\TAD}{0}{\FOOTHEIGHT}{l}{r}{
              \tt\string\footheight}
            %
            % Footskip arrow and label
            \VARROW{\RIGHTEDGE}{0}{\TAD}{0}{\FOOTSKIP}{r}{l}{
              \tt\string\footskip}
            %
            \HARROW{\ODDSIDEMARGIN}{\TEXTWIDTHY}{0}{0}{\TEXTWIDTH}{b}{}{
              \tt\string\textwidth}
            %
            \VARROW{\ODDSIDEMARGIN}{\FOOTSKIP}{-\TAD}{0}{
              \TEXTHEIGHT}{l}{r}{\tt\string\textheight$\rightarrow$}
            %
            \VARROW{\ODDSIDEMARGIN}{\HEADYORIGIN}{-\TAD}{0}{
              \HEAdHEIGHT}{l}{r}{\tt\string\headheight}
            %
            \VARROW{\RIGHTEDGE}{\HEADYORIGIN}{\TAD}{-\HEADSEP}{
              \HEADSEP}{r}{l}{\tt\string\headsep}
            %
            \VARROW{\RIGHTEDGE}{\INNERHEIGHT}{\TAD}{-\TOPMARGIN}{
              \TOPMARGIN}{r}{l}{\tt\string\topmargin}
            %
            \NAMEBOX{\ODDSIDEMARGIN}{\HEADYORIGIN}{0}{0}{\TEXTWIDTH}{
              \HEAdHEIGHT}{}{Page Header}
            %
            \NAMEBOX{\MARGINNOTEXORIGIN}{\MARGINNOTEYA}{0}{0}{
              \MARGINPARWIDTH}{\MARGINNOTEHEIGHT}{}{\shortstack{
              Margin\\note A}}
            %
            \VARROW{\MARGINNOTEXORIGIN}{\MARGINNOTEYA}{-\TAD}{
              -\MARGINPARPUSH}{\MARGINPARPUSH}{l}{r}{
            \tt\string\marginparpush}
            %
            \NAMEBOX{\MARGINNOTEXORIGIN}{\MARGINNOTEYB}{0}{0}{
              \MARGINPARWIDTH}{\MARGINNOTEHEIGHT}{}{\shortstack{Margin\\note B}}
            %
            \HARROW{\MARGINNOTEXORIGIN}{\MARGINNOTEYB}{0}{-\TAD}{
              \MARGINPARWIDTH}{b}{}{\tt\string\marginparwidth}
            %
            \HARROW{\MARGINNOTEXORIGIN}{\MARGINNOTEYC}{
              -\MARGINPARSEP}{\TAD}{\MARGINPARSEP}{t}{}{
              \tt\string\marginparsep}
            %
          \end{picture}}
        \end{picture}
      \end{small}
    \end{center}
  \end{figure}
  %%%%%%%%%%%%

  \clearpage
  %%%%%%%%%%

\end{fullpage}
%%%%%%%%%%%%%%

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\section{Description of the refman-class family}
\label{refman}

The \texttt{refman.sty} was defined at the EDV-Zentrum (computing 
center) of the TU Wien. This layout is suitable for reference 
manuals, technical descriptions and similar applications. It is based 
on the ideas shown in previous sections: The layout has a wide left 
margin for headings and margin notes and smaller margins on the right 
side, the top and the bottom.

In 1994 this layout was re-implemented as a class for the new \LaTeXe. 
This made it possible to include some minor improvements, like the 
support of different paper sizes. The \texttt{refman.sty} was split 
into two classes
\texttt{refrep}\index{refrep.cls} similar to \texttt{report} and 
\texttt{refart}\index{refart.cls} similar to \texttt{article}.
These classes differ in the layout of the header and footer. The 
\texttt{refart} does not support the \texttt{\textbackslash chapter} 
command.

The current version of this class is described in this document. If 
serves as an example for the layout.


\subsection{Invocation}
\index{refart, invocation}
\index{refrep, invocation}

The \LaTeX\ local guide (if available) shows if this class is available 
at your \TeX\ installation or where to install it.  To use the 
\texttt{refart} class, simply call it with the \verb|\documentclass| 
command:

\begin{verbatim}
\documentclass[11pt,a4paper]{refart}
\usepackage{german} % other packages you may want 
\end{verbatim}

\subsection{Options}
\index{options}

The \texttt{refart} class replaces \texttt{article} and \texttt{refrep} 
replaces \texttt{report}. They support all options of these classes 
except for the \texttt{twocolumn} option.

It supports the additional option \texttt{square} which makes the 
\texttt{\textbackslash textheight} equal to the 
\texttt{\textbackslash textwidth}. 

Neither \texttt{refart} nor \texttt{refrep} support twocolumn 
layout, thus the commands \verb|\twocolumn| and \verb|\onecolumn| 
must not be used.

The index will be set in twocolumn format and you can't change it 
with the means of this class. 

\subsection{Layout changes}

\subsubsection{Page design}

\index{page design, horizontal}\marginlabel{Horizontal:}
In this design the usable area for text (\verb|\fullwidth|) is 
calculated as the paper width minus 2~inch.  Only a fraction of this 
width is used for the running text (\verb|\textwidth|), the remaining 
part forms a wide left margin (\verb|\leftmarginwidth|) which is used 
for headings and margin notes.  The \verb|\textwidth| is 70~\% of the 
\verb|\fullwidth| by default, but this can be changed with the 
\verb|\settextfraction| command\index{settextfraction} which accepts 
arguments between 0 and 1.


\index{page design, vertical}\marginlabel{Vertical:}
The text height is calculated as the paper height minus 2~inch. This 
leaves a top margin of 1~inch, which is modified by some pagestyles 
(see \ref{pagestyle}).

The pages are always set with a ragged bottom.

\subsubsection{Section headings}

The headings for \verb|\section|, \verb|\subsection| and 
\verb|\subsubsection| extend into the left margin, thus using the full 
width of the page.  They are not justified and hyphenation is 
discouraged.  A small space is kept free above and below the heading.  
Headings for \verb|\section| and \verb|\subsection| are set in a bold 
font.

The \texttt{refrep} class defines a different layout for the  
\verb|\chapter| command: It always starts a new page and prints the 
chapter headings in a large bold font with a thick line above and 
below. This heading uses the full width of the page.

A similar heading is created by the \verb|\part| commands which is 
available in both classes. It uses a roman part number instead of the 
arabic section number.

The \verb|\maketitle| commands sets the title of the document in the 
same layout when no special titlepage is requested.  (This is the 
default for \texttt{refart}.  To suppress the titlepage in a 
\texttt{refrep} document, you can use the \texttt{notitlepage} option.) 
The name of the author and the date is printed in italic flush right 
below the document title.

\subsubsection{Paragraphs}

Paragraphs are separated by a vertikal space (\verb|\parskip|) of 
half a line (\verb|0.5\baselineskip|) plus a strechtable length of 2pt.
Paragraphs are not indented.

The vertical spacing inside, above and below a list environment is the 
same as in the running text.

\subsection{Footnotes}\index{footnote}

The footnote layout consists of a small margin (1em) which contains 
the footnote symbol. A small space is set between the symbol and the 
footnote text. The paragraphs of the footnote are not indented. There 
is currently no space between two footnotes, I'm not sure it this will 
stay this way. The footnote symbol is set as a superscript. This may 
change in later versions. I'm relying on user feedback to finally 
solve this.

\subsubsection{Description environment}
\index{description environment}

The \texttt{description} environment will use the whole left margin 
for the description label. 

\seealso{\ref{layout}}
You will find examples in the section~\ref{layout}.

\subsubsection{Positioning of margin notes}

Margin notes (\verb|\marginpar|) are always put into the left margin. 
They use the whole width of the margin.

The minimum space between two margin notes is set to 0 to prevent 
them from being shifted around when many margin notes are used.

\subsubsection{Headers and Footers} \label{pagestyle}
\index{pagestyle}

The pagestyle \texttt{plain} puts the page number into the footer in 
the right corner. When the option \texttt{twoside} is active, the page 
number of left pages is put into the left corner.

\index{headings}
\index{myheadings}
The pagestyles \texttt{headings} and \texttt{myheadings} create a 
header which spans the whole width of the page. The headings contain 
the running head (\verb|\section| and \verb|\subsection| in 
\texttt{refart} and \verb|\chapter| and \verb|\section| in 
\texttt{refrep}) when \texttt{headings} is used or a fixed text that can 
defined  with the \texttt{\textbackslash markboth} command when 
\texttt{myheadings} is used. The heading will be set in a slanted 
font and underlined with a thin line.

\index{footings}
\index{myfootings}
In addition to the standard classes, \texttt{refman} supports a style 
for footers, which is used in this documentation. The information is 
exactly the same as in the headings but now printed in the footer with 
a thin line above.

To use a userdefined string you can say:
\begin{verbatim}
\pagestyle{myfootings} % or myheadings
\markboth{left title}{right title}
\end{verbatim}

The \texttt{heading} and \texttt{myheading} commands increase the top 
margin by one line while the \texttt{footings} and 
\texttt{myfootings} commands decrease the top margin by one line.
The pagestyles \texttt{empty} and \texttt{plain} leave the top margin 
unchanged. You should not combine headings and footings in one document.

\subsection{Additional commands}

\subsubsection{Marginlabel}
\index{marginlabel}

The command \verb|\marginlabel{xxx}| prints the text \texttt{xxx} right 
justified into the left margin. Please note that a 
\texttt{\textbackslash marginpar} will print it left justified.


\marginlabel{Example:} The word ``Example'' in the left margin is 
printed with the command \verb|\marginlabel{Example:}|

\subsubsection{Attention}
\index{attention}\index{attentionsymbol}\index{manfnt}

The command \cs{attention} puts an exclamation mark with an arrow 
pointing to the text into the left margin.\attention This is an 
example for \cs{attention}.

\renewcommand{\attentionsymbol}{\texttt{:-)}}
\attention
Since version 2.0c you can change the symbol used for the 
\cs{attention} command using a 
\verb|\renewcommand{\attentionsymbol}{\texttt\{:-)\}}|
command. To get the default back use
\verb|\renewcommand{\attentionsymbol}| \verb|{\large \bfseries ! $\rightarrow$}|
\renewcommand{\attentionsymbol}{\large \bfseries ! $\rightarrow$}

Since version 2.0c \cs{attention} takes an optional argument to 
define the symbol used in the margin. Thus you can change the symbol 
once without having to restore it later. Do not abuse this 
feature\attention[\texttt{:-(}], it is primarily meant as an support 
for the manfnt package to substitute the ``dangerous bend'' by a 
``double dangerous bend''.

If you have the manfnt-font available you can use the enclosed 
\texttt{manfnt} package. It gives you easy 
access to the symbols defined in this font.

\subsubsection{Seealso}
\index{seealso}

The command \verb|\seealso{n}| prints an arrow and its argument into 
the left margin. You will find examples for this in the left margin 
and in \seealso{1} chapter~1.

\subsubsection{Maxipage environment}
\index{maxipage}

The \texttt{maxipage} environment is a special kind of 
\texttt{minipage} which extends over the full width of the page. It 
can be used for long formulas or \texttt{tabular} environments. You may 
use \texttt{maxipage} environments inside floats. You cannot use 
margin notes inside a \texttt{maxipage} and no pagebreak will occur 
while in a \texttt{maxipage}. A \texttt{maxipage} is always a 
paragraph of its own with a thick line above and below. You can 
disable these lines with the \texttt{\textbackslash 
maxipagerulefalse}\index{maxipagerule}
command. They are on by default.

The following paragraph is an example for a \texttt{maxipage}:
\nopagebreak
\begin{maxipage}
This very long line is an example for a \texttt{maxipage}. It extends 
over the full width of the page, including the left margin.
\end{maxipage}\nopagebreak
This is normal text after the \texttt{maxipage}.

\subsubsection{Fullpage environment} \label{fullpage}
\index{fullpage}

The \texttt{fullpage} environment consists of one ore more pages where 
the text extends over the full width of the page. You cannot use 
margin notes inside a \texttt{fullpage} environment. A \texttt{fullpage} 
will always start and end on a page of its own. It may be used for 
large tables, program listings or anything that does not fit into the 
normal layout.

\seealso{See page \pageref{bild}}
Page~\pageref{bild} is an example for a \texttt{fullpage}.

\subsubsection{Noparskip}

The \verb|\noparskip| removes the vertical space between two 
paragraphs. It is similar to the \verb|\noindent| command that removes 
the indent of the first line of a paragraph.

\subsubsection{Setleftmarginwidth}
\index{setleftmarginwidth}

The \verb|\setleftmarginwidth| command is no longer supported. You can 
achieve similar results by using the \verb|\settextfraction| command.

\subsubsection{Descriptioncolon}
\index{descriptioncolon}

By default a colon is printed after the description label.
The command \texttt{\textbackslash description\-colonfalse}  disables 
the colon, the \texttt{\textbackslash description\-colontrue} 
re-enables ist.

\subsubsection{Descriptionleft}
\index{descriptionleft}

The \verb|\descriptionlefttrue| command sets the description label 
left justified into the margin. The default is right justified which 
will be achieved with \verb|\descriptionleftfalse|

\subsubsection{Maxipagerule}
\index{maxipagerule}

You can disable the rules before and after a \texttt{maxipage} with 
the \texttt{\textbackslash maxipage\-rulefalse} command and re-enable 
them with the \texttt{\textbackslash maxipageruletrue} command.  The 
default is on.  You should not mix \texttt{maxipage}s with and without 
rules in one document.

\subsubsection{Condbreak}
\index{condbreak}

The command \verb|\condbreak{2cm}| ensures, that the next 2~cm are 
either completely on this page or completely on the next. No 
pagebreak will appear in the next 2~cm.

This is really a hack to achieve what the \texttt{\textbackslash 
samepage} command often fails to do.

\subsubsection{Example}
\index{example}

The \texttt{example} environment acts like a \texttt{verse} 
environment but uses a \texttt{tt} font.  

\subsubsection{Pageperchapter}
\index{pageperchapter}

The command \verb|\pageperchapter| creates page number that start with 
1 for every new chapter. This may be useful for larger manuals. Since 
it works with chapters it is only available in the 
\texttt{refrep} class.

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\endinput

