% $Id$
% latex2html -show_section_numbers -split 0 -html_version 4.0 Vorbis_I_spec.tex
%\documentclass[a4paper]{article}
\documentclass[a4paper]{scrartcl}
%\documentclass[twoside,idxtotoc,bibtotoc,a4paper,12pt,BCOR12mm,DIV13]{scrbook}

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% Packages
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

% ...
%\usepackage[margin=3cm]{geometry}
\usepackage{a4wide}

% ...
\usepackage{enumitem}

% ...
\usepackage[english]{babel}

%\usepackage[latin1]{inputenc}
%\usepackage[T1]{fontenc}

% Do not indent paragraphs, instead separate them via vertical spacing
\usepackage{parskip}

% Support for graphics, provides \includegraphics
\usepackage{graphicx}
%\graphicspath{{images/}}	% Specify subdir containing the images

% Hyperref enriches the generated PDF with clickable links,
% and provides many other useful features.
\usepackage{nameref}
%\usepackage{hyperref}
\usepackage[colorlinks]{hyperref}
%\usepackage[pdfborder={0 0 0}]{hyperref}
\def\sectionautorefname{Section}	% Write section with capital 'S'
\def\subsectionautorefname{Subsection}	% Write subsection with capital 'S'


% provides the 'comment' env, which is useful to temporarily comment out a block of code
\usepackage{verbatim}

% ...
%\usepackage{listings}
%\lstset{language=Pascal} 

% The fancyvrb package provides the "Verbatim" environment, which,
% unlike the built-in "verbatim", allows embedding TeX commands, as
% well as tons of other neat stuff (line numbers, formatting adjustments, ...)
\usepackage{fancyvrb}
%\fvset{tabsize=4,fontsize=\scriptsize,numbers=left}
\fvset{tabsize=4,fontsize=\small}
%\fvset{tabsize=4}

% ...
\usepackage{color}      % Colored text, used for \TODO macro

% ...
\usepackage[nohyphen]{underscore}

% ...
\usepackage{capt-of}

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% Custom commands
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

% Custom ref command, using hyperrefs autoref & nameref, to simulate the 
% behavior of DocBooks's 'xref'.
\newcommand{\xref}[1]{\autoref{#1}, ``\nameref{#1}''}

%...
\newcommand{\link}[2]{\hyperref[#1]{#2}}

% Redefine \~ to generate something that looks more appropriate when used in text.
\renewcommand{\~}{$\sim$}

% ...
\newenvironment{note}{\subparagraph*{Note:}}{}

% ...
\let\programlisting\Verbatim
\let\endprogramlisting\endVerbatim

% ...
\newcommand{\function}[1]{\texttt{#1}}
\newcommand{\filename}[1]{\texttt{#1}}
\newcommand{\varname}[1]{\texttt{#1}}
\newcommand{\literal}[1]{\texttt{#1}}

% ...
\newcommand{\TODO}[1]{\textcolor{red}{*** #1 ***}}
\newcommand{\NOTE}[1]{\textcolor{blue}{*** #1 ***}}

\DeclareGraphicsExtensions{.pdf,.png}


% TODO/FIXME: Things to watch out for:
% - Translate some chars: ~ -> $\sim$,  % -> \%, & -> \&, ...

\begin{document}


\title{Vorbis I specification}
\author{Xiph.org Foundation}
\maketitle

\tableofcontents

\include{01-introduction}
\include{02-bitpacking}
\include{03-codebook}
\include{04-codec}
\include{05-comment}
\include{06-floor0}
\include{07-floor1}
\include{08-residue}
\include{09-helper}
\include{10-tables}

\appendix
\include{a1-encapsulation-ogg}
\include{a2-encapsulation-rtp}

\include{footer}

 
% TODO: Use a bibliography, as in the example below?
\begin{thebibliography}{99} 
 
\bibitem{Sporer/Brandenburg/Edler} T.~Sporer, K.~Brandenburg and B.~Edler, 
The use of multirate filter banks for coding of high quality digital audio,
\url{http://www.iocon.com/resource/docs/ps/eusipco_corrected.ps}.


\end{thebibliography}

\end{document}
