%
% === General definitions and packages to use
%
\usepackage[]{fancyhdr}   
\usepackage[]{natbib}
\usepackage{alltt}
\usepackage{times}
\usepackage{verbatim}
\usepackage{lscape}      % landscape mode of a single page
\usepackage[]{longtable} % allow tables longer than one page
\usepackage{makeidx}     % index of terms
\usepackage{algorithm}   % for describing algorithms with pseudo-code
\usepackage{algorithmic}
\usepackage{tabularx}    % allows line breaking in table columns

%
% === Some layout commands
%
\sloppy
\raggedbottom
\graphicspath{{Figs/}}
\makeindex
%
% with of the caption in longtable:
\setlength{\LTcapwidth}{0.9\textwidth} 
%
% Change brace type for comments in algorithmic
\renewcommand{\algorithmiccomment}[1]{(#1)}



%
% === Margins
%
\voffset-2.0cm
\headheight16pt
\headsep1.1cm
\textheight22cm
\hoffset-1.3cm
\oddsidemargin2.2cm
\textwidth14.0cm


%
% === Headings
%
\pagestyle{fancy}
\renewcommand{\chaptermark}[1]{\markboth{#1}{}}
\renewcommand{\sectionmark}[1]{\markright{\thesection\ #1}}
\fancyhf{}
\fancyhead[LE,RO]{\small{\sc\thepage}}
\fancyhead[LO]{\small{\scshape\rightmark}}
\fancyhead[RE]{\small{\scshape\leftmark}}
\renewcommand{\headrulewidth}{0.5pt}
\renewcommand{\footrulewidth}{0pt}
\fancypagestyle{plain}{%
  \fancyhead{}
  \renewcommand{\headrulewidth}{0pt}
}  


%
% === Page layout definitions
%
% Chapters and sections.
\newcommand{\levela}[1]    {\chapter{#1}}
\newcommand{\levelb}[1]    {\section{#1}}
\newcommand{\levelc}[1]    {\subsection{#1}}
\newcommand{\leveld}[1]    {\subsubsection{#1}}
\newcommand{\levele}[1]    {\paragraph{#1}}
%
% Document history
\newcommand{\starthistory} {\begin{table}[b]  \begin{tabular}{l p{11cm}} 
                             \hline {\bf History} & \\ }
\newcommand{\stophistory}  {\end{tabular} \end{table} }
%
% Symbol table
\newcommand{\startsymbols} {\begin{table}[!t] \begin{center} 
                            \begin{tabular}{l l l}
                            {\bf Here} & {\bf In ARTS} & {\bf Description} 
                            \\ \hline \\ } 
\newcommand{\stopsymbols}  {\\ \hline \end{tabular} 
                            \caption{Examples of symbols used in this chapter,
                            the corresponding notation in the ARTS source code
                            and a short description of the quantity. }
                            \end{center} \end{table}}      

%
% === Symbol definitions
%
\input{symbol_defs}



%
% === Command to write a ARTS variable or function with special style
%
\newcommand{\artsstyle}[1]      {\texttt{#1}}



%
% === Commands for easy indexing of term
%
% Index command to use when text and index reference are equal. Otherwise
% the normal \index command must be used.
\newcommand{\textindex}[1]   {#1\index{#1}}  
%
% Index command to make index for a workspace method. It writes out the
% function name in verbatim style and makes an index reference.
\newcommand{\wsmindex}[1]    {\artsstyle{#1}\index{workspace methods!#1}}  
%
% Index command to make index for workspace variable. Works as \wsmindex.
\newcommand{\wsvindex}[1]    {\artsstyle{#1}\index{workspace variables!#1}}  
%
% Index command to make index for a ARTS file. Works as \wsmindex.
\newcommand{\fileindex}[1]   {\artsstyle{#1}\index{ARTS files!#1}}
%
% Index command to make index for an internal function. Works as \wsmindex.
\newcommand{\funcindex}[1]   {\artsstyle{#1}\index{internal ARTS functions!#1}}
%
% Index command to make index for a ARTS data structure. Works as \wsmindex.
\newcommand{\typeindex}[1] {\artsstyle{#1}\index{data types!#1}}




%===   Start of report   ===================================================
\begin{document}


\bibliographystyle{agu}


%
% === Title page
%
\thispagestyle{plain}
\begin{center}
  \vspace*{2cm}
  {\Huge \verb|ARTS User Guide|\\}
  \vspace*{1cm}
  {\large by \\}
  \vspace*{1cm}
  {\large \bf Stefan B\"uhler\footnote{Institute of Environmental
      Physics, University of Bremen, Germany},  Claudia
    Emde\footnotemark[1], Patrick Eriksson\footnote{Department of
    Radio and Space Science, Chalmers University of Technology, Sweden}, 
    Wolfram Haas, Nikolay Koulev\footnotemark[1],
    Thomas Kuhn\footnotemark[1], Oliver Lemke\footnotemark[1]}\\
   \vspace*{2cm}
   {\large \today\\
    ARTS Version \input{auto_version}
   }
\end{center}
  \vspace*{4cm}
{\normalsize \bf
  \noindent
  This is a working document. The implementation approaches and the
  algorithms are preliminary and can be subject to changes. In addition,
  not all features described in this document are implemented in ARTS.
  
  We welcome gladly comments and reports on errors in the document.
  Send then an e-mail to: \verb|patrick@rss.chalmers.se| or 
  \verb|sbuehler@uni-bremen.de|.
}

\newpage                          
\thispagestyle{empty}
\vspace*{\fill}
\noindent
\begin{verbatim}
Copyright (C) 2000,2001 
Stefan Buehler <sbuehler@uni-bremen.de>
Patrick Eriksson <patrick@rss.chalmers.se>

The ARTS program is free software; you can redistribute it
and/or modify it under the terms of the GNU General Public
License as published by the Free Software Foundation; either
version 2, or (at your option) any later version.

This program is distributed in the hope that it will be
useful, but WITHOUT ANY WARRANTY; without even the implied
warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
PURPOSE.  See the GNU General Public License for more
details. 

You should have received a copy of the GNU General Public
License along with the program; if not, write to the Free
Software Foundation, Inc., 59 Temple Place - Suite 330,
Boston, MA 02111-1307, USA. 
\end{verbatim}
\cleardoublepage

\pagenumbering{roman}
\tableofcontents

\cleardoublepage
\pagenumbering{arabic}
     

%
% === The chapters
%
\include{introduction}
\include{concept}
\include{fm_definitions}
%
\part{Algorithm Descriptions}
\include{formalism}
\include{absorption}
%\include{rte}
\include{ppath}
%\include{los1d}
\include{scattering}
%\include{sensor}
%\include{reduction}
%\include{wfuns_atm}
%\include{measerr}
%\include{wfuns_sensor} 
\part{Implementation Issues}
\include{development}
\include{agendas}
\part{Mathematical functions}
\include{matrix_vector}
\include{interpolation}
\include{lin_alg}
\part{Theoretical background}
\include{polarization}
%\include{formats}
%\part{Utilities}
%\include{utilities}


%
% ===   Bibliography
                                %
\part{Bibliography and Appendices}
%
\bibliography{references}
%
% ===   Appendices
%
\begin{appendix}

\include{app_groups}
\include{app_methods}


%  \include{app_wsv}
%  \include{app_units}

\end{appendix}


%
% ===   Index
%
\printindex


%===   End of report   =====================================================
\end{document}



%%% Local Variables: 
%%% mode: latex 
%%% TeX-master: "uguide" 
%%% End:
