\documentclass{article}

% this goes to /home/www.vlba.nrao.edu/internal/operations/difx
% call the upper directory YYY-MM-DD and change "current" sym link to
% point there.

% TODO

% doc problems: dir issues, safedir, use of difxlog
% Add reference to spacecraft functionality



% Notes to potential editors:
% 1. Please don't change the line wrapping.  Exactly one sentence per line!
% 2. Update "date" and "version" below with each update
% 3. Notation :
%       Program names and other text to be typed by user or returned by the computer in {\tt }
%       Variables or arguments in {\em } or in $<$ $>$

\usepackage{fullpage}
\usepackage{graphics}
\usepackage{fancyvrb}
\usepackage{url}
\usepackage{color}
\definecolor{darkblue}{rgb}{0,0.2,0.4}
\usepackage[colorlinks,linkcolor=darkblue,citecolor=blue,urlcolor=blue,pdftitle={DiFX User Guide},pdfauthor={Walter Brisken}]{hyperref}


\begin{document}

%\newcommand{\difxoneone}{{\resizebox{!}{10pt}{\includegraphics{11.pdf}}}}
%\newcommand{\difxoneone}{\ }
%\newcommand{\difxonefive}{\ }
%\newcommand{\difxtwozero}{{\resizebox{!}{10pt}{\includegraphics{20.pdf}}}}
%\newcommand{\difxtwozeroone}{{\resizebox{!}{10pt}{\includegraphics{201.pdf}}}}
\newcommand{\Oa}[1]{\hspace{-12pt}\makebox[12pt]{$\star$}#1}
\newcommand{\Da}[1]{\hspace{-12pt}\makebox[12pt]{$\times$}#1}
\newcommand{\bfit}[1]{{\textrm{\textit{\textmd{#1}}}}}


\begin{center}

\vspace{5pt}

{\LARGE A Guide to the DiFX Software Correlator}

\vspace{5pt}

{\Large Version 2.8}


\vspace{10pt}

{\it Walter Brisken}

\vspace{5pt}

National Radio Astronomy Observatory

\vspace{5pt}
\today

\end{center}

\tableofcontents

\section{Introduction}

This manual is intended for many different audiences.
Typically a particular reader will only need to be concerned with a small portion of this guide, but there are a number of cross-references between sections.
This manual assumes some familiarity with Mark5 units, Linux, and the general way in which a VLBI correlator is used.
The following topics are discussed: running DiFX, coexistence issues with the VLBA hardware correlator, explanation of various file/document types, and detailed installation instructions.
This manual covers DiFX version 2.5 and will be kept up to date with each official update to DiFX.
Please report any errors that are found in this manual to {\tt wbrisken@nrao.edu} .

\subsection{Notation}

Text written in {\tt typewriter} font represents literal text and is to be transcribed verbatim when typing and text in {\em italics} is to be substituted with other text, such as the specific value of the named variable.
To be consistent with this notation, all mention of programs by name or filenames (and portions thereof) are written in {\tt typewriter} font.

\input{difx_versions.tex}

%\input{difx_setup.tex}

%\input{difx_vlba.tex}

\input{difx_pulsars.tex}

\input{difx_conventions.tex}

\input{difx_programs.tex}

\input{difx_files.tex}

\input{difx_xml.tex}

\input{difx_messages.tex}

%\input{difx_database.tex}

%\input{difx_installation.tex}

\input{difx_endmatter.tex}

\end{document}

