gstreamer 1.1.3-x86-mingw32 → 1.1.4-x86-mingw32

data/vendor/local/share/doc/libtheora-1.1.1/latex/group__oldfuncs.tex

@@ -1,435 +1,438 @@
-\section{\-Legacy pre-\/1.0 \-C \-A\-P\-I}
-\label{group__oldfuncs}\index{\-Legacy pre-\/1.\-0 C A\-P\-I@{\-Legacy pre-\/1.\-0 C A\-P\-I}}
-\subsection*{\-Data \-Structures}
+\section{Legacy pre-\/1.0 C A\-P\-I}
+\label{group__oldfuncs}\index{Legacy pre-\/1.\-0 C A\-P\-I@{Legacy pre-\/1.\-0 C A\-P\-I}}
+\subsection*{Files}
+\begin{DoxyCompactItemize}
+\item 
+file {\bf theora.\-h}
+\begin{DoxyCompactList}\small\item\em The libtheora pre-\/1.\-0 legacy C A\-P\-I. \end{DoxyCompactList}\end{DoxyCompactItemize}
+\subsection*{Data Structures}
 \begin{DoxyCompactItemize}
 \item 
 struct {\bf yuv\-\_\-buffer}
-\begin{DoxyCompactList}\small\item\em \-A \-Y\-U\-V buffer for passing uncompressed frames to and from the codec. \end{DoxyCompactList}\item 
+\begin{DoxyCompactList}\small\item\em A Y\-U\-V buffer for passing uncompressed frames to and from the codec. \end{DoxyCompactList}\item 
 struct {\bf theora\-\_\-info}
-\begin{DoxyCompactList}\small\item\em \-Theora bitstream info. \end{DoxyCompactList}\item 
+\begin{DoxyCompactList}\small\item\em Theora bitstream info. \end{DoxyCompactList}\item 
 struct {\bf theora\-\_\-state}
-\begin{DoxyCompactList}\small\item\em \-Codec internal state and context. \end{DoxyCompactList}\item 
+\begin{DoxyCompactList}\small\item\em Codec internal state and context. \end{DoxyCompactList}\item 
 struct {\bf theora\-\_\-comment}
-\begin{DoxyCompactList}\small\item\em \-Comment header metadata. \end{DoxyCompactList}\end{DoxyCompactItemize}
-\subsection*{\-Files}
-\begin{DoxyCompactItemize}
-\item 
-file {\bf theora.\-h}
-\begin{DoxyCompactList}\small\item\em \-The libtheora pre-\/1.\-0 legacy \-C \-A\-P\-I. \end{DoxyCompactList}\end{DoxyCompactItemize}
-\subsection*{\-Defines}
+\begin{DoxyCompactList}\small\item\em Comment header metadata. \end{DoxyCompactList}\end{DoxyCompactItemize}
+\subsection*{Macros}
 \begin{DoxyCompactItemize}
 \item 
-\#define {\bf \-O\-C\-\_\-\-F\-A\-U\-L\-T}~-\/1
-\begin{DoxyCompactList}\small\item\em \-General failure. \end{DoxyCompactList}\item 
-\#define {\bf \-O\-C\-\_\-\-E\-I\-N\-V\-A\-L}~-\/10
-\begin{DoxyCompactList}\small\item\em \-Library encountered invalid internal data. \end{DoxyCompactList}\item 
-\#define {\bf \-O\-C\-\_\-\-D\-I\-S\-A\-B\-L\-E\-D}~-\/11
-\begin{DoxyCompactList}\small\item\em \-Requested action is disabled. \end{DoxyCompactList}\item 
-\#define {\bf \-O\-C\-\_\-\-B\-A\-D\-H\-E\-A\-D\-E\-R}~-\/20
-\begin{DoxyCompactList}\small\item\em \-Header packet was corrupt/invalid. \end{DoxyCompactList}\item 
-\#define {\bf \-O\-C\-\_\-\-N\-O\-T\-F\-O\-R\-M\-A\-T}~-\/21
-\begin{DoxyCompactList}\small\item\em \-Packet is not a theora packet. \end{DoxyCompactList}\item 
-\#define {\bf \-O\-C\-\_\-\-V\-E\-R\-S\-I\-O\-N}~-\/22
-\begin{DoxyCompactList}\small\item\em \-Bitstream version is not handled. \end{DoxyCompactList}\item 
-\#define {\bf \-O\-C\-\_\-\-I\-M\-P\-L}~-\/23
-\begin{DoxyCompactList}\small\item\em \-Feature or action not implemented. \end{DoxyCompactList}\item 
-\#define {\bf \-O\-C\-\_\-\-B\-A\-D\-P\-A\-C\-K\-E\-T}~-\/24
-\begin{DoxyCompactList}\small\item\em \-Packet is corrupt. \end{DoxyCompactList}\item 
-\#define {\bf \-O\-C\-\_\-\-N\-E\-W\-P\-A\-C\-K\-E\-T}~-\/25
-\begin{DoxyCompactList}\small\item\em \-Packet is an (ignorable) unhandled extension. \end{DoxyCompactList}\item 
-\#define {\bf \-O\-C\-\_\-\-D\-U\-P\-F\-R\-A\-M\-E}~1
-\begin{DoxyCompactList}\small\item\em \-Packet is a dropped frame. \end{DoxyCompactList}\end{DoxyCompactItemize}
-\subsection*{\-Typedefs}
+\#define {\bf O\-C\-\_\-\-F\-A\-U\-L\-T}~-\/1
+\begin{DoxyCompactList}\small\item\em General failure. \end{DoxyCompactList}\item 
+\#define {\bf O\-C\-\_\-\-E\-I\-N\-V\-A\-L}~-\/10
+\begin{DoxyCompactList}\small\item\em Library encountered invalid internal data. \end{DoxyCompactList}\item 
+\#define {\bf O\-C\-\_\-\-D\-I\-S\-A\-B\-L\-E\-D}~-\/11
+\begin{DoxyCompactList}\small\item\em Requested action is disabled. \end{DoxyCompactList}\item 
+\#define {\bf O\-C\-\_\-\-B\-A\-D\-H\-E\-A\-D\-E\-R}~-\/20
+\begin{DoxyCompactList}\small\item\em Header packet was corrupt/invalid. \end{DoxyCompactList}\item 
+\#define {\bf O\-C\-\_\-\-N\-O\-T\-F\-O\-R\-M\-A\-T}~-\/21
+\begin{DoxyCompactList}\small\item\em Packet is not a theora packet. \end{DoxyCompactList}\item 
+\#define {\bf O\-C\-\_\-\-V\-E\-R\-S\-I\-O\-N}~-\/22
+\begin{DoxyCompactList}\small\item\em Bitstream version is not handled. \end{DoxyCompactList}\item 
+\#define {\bf O\-C\-\_\-\-I\-M\-P\-L}~-\/23
+\begin{DoxyCompactList}\small\item\em Feature or action not implemented. \end{DoxyCompactList}\item 
+\#define {\bf O\-C\-\_\-\-B\-A\-D\-P\-A\-C\-K\-E\-T}~-\/24
+\begin{DoxyCompactList}\small\item\em Packet is corrupt. \end{DoxyCompactList}\item 
+\#define {\bf O\-C\-\_\-\-N\-E\-W\-P\-A\-C\-K\-E\-T}~-\/25
+\begin{DoxyCompactList}\small\item\em Packet is an (ignorable) unhandled extension. \end{DoxyCompactList}\item 
+\#define {\bf O\-C\-\_\-\-D\-U\-P\-F\-R\-A\-M\-E}~1
+\begin{DoxyCompactList}\small\item\em Packet is a dropped frame. \end{DoxyCompactList}\end{DoxyCompactItemize}
+\subsection*{Typedefs}
 \begin{DoxyCompactItemize}
 \item 
 typedef struct {\bf theora\-\_\-comment} {\bf theora\-\_\-comment}
-\begin{DoxyCompactList}\small\item\em \-Comment header metadata. \end{DoxyCompactList}\end{DoxyCompactItemize}
-\subsection*{\-Enumerations}
+\begin{DoxyCompactList}\small\item\em Comment header metadata. \end{DoxyCompactList}\end{DoxyCompactItemize}
+\subsection*{Enumerations}
 \begin{DoxyCompactItemize}
 \item 
-enum {\bf theora\-\_\-colorspace} \{ {\bf \-O\-C\-\_\-\-C\-S\-\_\-\-U\-N\-S\-P\-E\-C\-I\-F\-I\-E\-D}, 
-{\bf \-O\-C\-\_\-\-C\-S\-\_\-\-I\-T\-U\-\_\-\-R\-E\-C\-\_\-470\-M}, 
-{\bf \-O\-C\-\_\-\-C\-S\-\_\-\-I\-T\-U\-\_\-\-R\-E\-C\-\_\-470\-B\-G}, 
-{\bf \-O\-C\-\_\-\-C\-S\-\_\-\-N\-S\-P\-A\-C\-E\-S}
+enum {\bf theora\-\_\-colorspace} \{ {\bf O\-C\-\_\-\-C\-S\-\_\-\-U\-N\-S\-P\-E\-C\-I\-F\-I\-E\-D}, 
+{\bf O\-C\-\_\-\-C\-S\-\_\-\-I\-T\-U\-\_\-\-R\-E\-C\-\_\-470\-M}, 
+{\bf O\-C\-\_\-\-C\-S\-\_\-\-I\-T\-U\-\_\-\-R\-E\-C\-\_\-470\-B\-G}, 
+{\bf O\-C\-\_\-\-C\-S\-\_\-\-N\-S\-P\-A\-C\-E\-S}
  \}
-\begin{DoxyCompactList}\small\item\em \-A \-Colorspace. \end{DoxyCompactList}\item 
-enum {\bf theora\-\_\-pixelformat} \{ {\bf \-O\-C\-\_\-\-P\-F\-\_\-420}, 
-{\bf \-O\-C\-\_\-\-P\-F\-\_\-\-R\-S\-V\-D}, 
-{\bf \-O\-C\-\_\-\-P\-F\-\_\-422}, 
-{\bf \-O\-C\-\_\-\-P\-F\-\_\-444}
+\begin{DoxyCompactList}\small\item\em A Colorspace. \end{DoxyCompactList}\item 
+enum {\bf theora\-\_\-pixelformat} \{ {\bf O\-C\-\_\-\-P\-F\-\_\-420}, 
+{\bf O\-C\-\_\-\-P\-F\-\_\-\-R\-S\-V\-D}, 
+{\bf O\-C\-\_\-\-P\-F\-\_\-422}, 
+{\bf O\-C\-\_\-\-P\-F\-\_\-444}
  \}
-\begin{DoxyCompactList}\small\item\em \-A \-Chroma subsampling. \end{DoxyCompactList}\end{DoxyCompactItemize}
-\subsection*{\-Functions}
+\begin{DoxyCompactList}\small\item\em A Chroma subsampling. \end{DoxyCompactList}\end{DoxyCompactItemize}
+\subsection*{Functions}
 \begin{DoxyCompactItemize}
 \item 
 const char $\ast$ {\bf theora\-\_\-version\-\_\-string} (void)
-\begin{DoxyCompactList}\small\item\em \-Retrieve a human-\/readable string to identify the encoder vendor and version. \end{DoxyCompactList}\item 
+\begin{DoxyCompactList}\small\item\em Retrieve a human-\/readable string to identify the encoder vendor and version. \end{DoxyCompactList}\item 
 ogg\-\_\-uint32\-\_\-t {\bf theora\-\_\-version\-\_\-number} (void)
-\begin{DoxyCompactList}\small\item\em \-Retrieve a 32-\/bit version number. \end{DoxyCompactList}\item 
+\begin{DoxyCompactList}\small\item\em Retrieve a 32-\/bit version number. \end{DoxyCompactList}\item 
 int {\bf theora\-\_\-encode\-\_\-init} ({\bf theora\-\_\-state} $\ast$th, {\bf theora\-\_\-info} $\ast$ti)
-\begin{DoxyCompactList}\small\item\em \-Initialize the theora encoder. \end{DoxyCompactList}\item 
+\begin{DoxyCompactList}\small\item\em Initialize the theora encoder. \end{DoxyCompactList}\item 
 int {\bf theora\-\_\-encode\-\_\-\-Y\-U\-Vin} ({\bf theora\-\_\-state} $\ast$t, {\bf yuv\-\_\-buffer} $\ast$yuv)
-\begin{DoxyCompactList}\small\item\em \-Submit a \-Y\-U\-V buffer to the theora encoder. \end{DoxyCompactList}\item 
+\begin{DoxyCompactList}\small\item\em Submit a Y\-U\-V buffer to the theora encoder. \end{DoxyCompactList}\item 
 int {\bf theora\-\_\-encode\-\_\-packetout} ({\bf theora\-\_\-state} $\ast$t, int last\-\_\-p, ogg\-\_\-packet $\ast$op)
-\begin{DoxyCompactList}\small\item\em \-Request the next packet of encoded video. \end{DoxyCompactList}\item 
+\begin{DoxyCompactList}\small\item\em Request the next packet of encoded video. \end{DoxyCompactList}\item 
 int {\bf theora\-\_\-encode\-\_\-header} ({\bf theora\-\_\-state} $\ast$t, ogg\-\_\-packet $\ast$op)
-\begin{DoxyCompactList}\small\item\em \-Request a packet containing the initial header. \end{DoxyCompactList}\item 
+\begin{DoxyCompactList}\small\item\em Request a packet containing the initial header. \end{DoxyCompactList}\item 
 int {\bf theora\-\_\-encode\-\_\-comment} ({\bf theora\-\_\-comment} $\ast$tc, ogg\-\_\-packet $\ast$op)
-\begin{DoxyCompactList}\small\item\em \-Request a comment header packet from provided metadata. \end{DoxyCompactList}\item 
+\begin{DoxyCompactList}\small\item\em Request a comment header packet from provided metadata. \end{DoxyCompactList}\item 
 int {\bf theora\-\_\-encode\-\_\-tables} ({\bf theora\-\_\-state} $\ast$t, ogg\-\_\-packet $\ast$op)
-\begin{DoxyCompactList}\small\item\em \-Request a packet containing the codebook tables for the stream. \end{DoxyCompactList}\item 
+\begin{DoxyCompactList}\small\item\em Request a packet containing the codebook tables for the stream. \end{DoxyCompactList}\item 
 int {\bf theora\-\_\-decode\-\_\-header} ({\bf theora\-\_\-info} $\ast$ci, {\bf theora\-\_\-comment} $\ast$cc, ogg\-\_\-packet $\ast$op)
-\begin{DoxyCompactList}\small\item\em \-Decode an \-Ogg packet, with the expectation that the packet contains an initial header, comment data or codebook tables. \end{DoxyCompactList}\item 
+\begin{DoxyCompactList}\small\item\em Decode an Ogg packet, with the expectation that the packet contains an initial header, comment data or codebook tables. \end{DoxyCompactList}\item 
 int {\bf theora\-\_\-decode\-\_\-init} ({\bf theora\-\_\-state} $\ast$th, {\bf theora\-\_\-info} $\ast$c)
-\begin{DoxyCompactList}\small\item\em \-Initialize a \doxyref{theora\-\_\-state}{p.}{structtheora__state} handle for decoding. \end{DoxyCompactList}\item 
+\begin{DoxyCompactList}\small\item\em Initialize a \doxyref{theora\-\_\-state}{p.}{structtheora__state} handle for decoding. \end{DoxyCompactList}\item 
 int {\bf theora\-\_\-decode\-\_\-packetin} ({\bf theora\-\_\-state} $\ast$th, ogg\-\_\-packet $\ast$op)
-\begin{DoxyCompactList}\small\item\em \-Input a packet containing encoded data into the theora decoder. \end{DoxyCompactList}\item 
+\begin{DoxyCompactList}\small\item\em Input a packet containing encoded data into the theora decoder. \end{DoxyCompactList}\item 
 int {\bf theora\-\_\-decode\-\_\-\-Y\-U\-Vout} ({\bf theora\-\_\-state} $\ast$th, {\bf yuv\-\_\-buffer} $\ast$yuv)
-\begin{DoxyCompactList}\small\item\em \-Output the next available frame of decoded \-Y\-U\-V data. \end{DoxyCompactList}\item 
+\begin{DoxyCompactList}\small\item\em Output the next available frame of decoded Y\-U\-V data. \end{DoxyCompactList}\item 
 int {\bf theora\-\_\-packet\-\_\-isheader} (ogg\-\_\-packet $\ast$op)
-\begin{DoxyCompactList}\small\item\em \-Report whether a theora packet is a header or not \-This function does no verification beyond checking the header flag bit so it should not be used for bitstream identification; use \doxyref{theora\-\_\-decode\-\_\-header()}{p.}{group__oldfuncs_ga02915e63c1bd733ee291f577a8b75a82} for that. \end{DoxyCompactList}\item 
+\begin{DoxyCompactList}\small\item\em Report whether a theora packet is a header or not This function does no verification beyond checking the header flag bit so it should not be used for bitstream identification; use \doxyref{theora\-\_\-decode\-\_\-header()}{p.}{group__oldfuncs_ga02915e63c1bd733ee291f577a8b75a82} for that. \end{DoxyCompactList}\item 
 int {\bf theora\-\_\-packet\-\_\-iskeyframe} (ogg\-\_\-packet $\ast$op)
-\begin{DoxyCompactList}\small\item\em \-Report whether a theora packet is a keyframe or not. \end{DoxyCompactList}\item 
+\begin{DoxyCompactList}\small\item\em Report whether a theora packet is a keyframe or not. \end{DoxyCompactList}\item 
 int {\bf theora\-\_\-granule\-\_\-shift} ({\bf theora\-\_\-info} $\ast$ti)
-\begin{DoxyCompactList}\small\item\em \-Report the granulepos shift radix. \end{DoxyCompactList}\item 
+\begin{DoxyCompactList}\small\item\em Report the granulepos shift radix. \end{DoxyCompactList}\item 
 ogg\-\_\-int64\-\_\-t {\bf theora\-\_\-granule\-\_\-frame} ({\bf theora\-\_\-state} $\ast$th, ogg\-\_\-int64\-\_\-t granulepos)
-\begin{DoxyCompactList}\small\item\em \-Convert a granulepos to an absolute frame index, starting at 0. \end{DoxyCompactList}\item 
+\begin{DoxyCompactList}\small\item\em Convert a granulepos to an absolute frame index, starting at 0. \end{DoxyCompactList}\item 
 double {\bf theora\-\_\-granule\-\_\-time} ({\bf theora\-\_\-state} $\ast$th, ogg\-\_\-int64\-\_\-t granulepos)
-\begin{DoxyCompactList}\small\item\em \-Convert a granulepos to absolute time in seconds. \end{DoxyCompactList}\item 
+\begin{DoxyCompactList}\small\item\em Convert a granulepos to absolute time in seconds. \end{DoxyCompactList}\item 
 void {\bf theora\-\_\-info\-\_\-init} ({\bf theora\-\_\-info} $\ast$c)
-\begin{DoxyCompactList}\small\item\em \-Initialize a \doxyref{theora\-\_\-info}{p.}{structtheora__info} structure. \end{DoxyCompactList}\item 
+\begin{DoxyCompactList}\small\item\em Initialize a \doxyref{theora\-\_\-info}{p.}{structtheora__info} structure. \end{DoxyCompactList}\item 
 void {\bf theora\-\_\-info\-\_\-clear} ({\bf theora\-\_\-info} $\ast$c)
-\begin{DoxyCompactList}\small\item\em \-Clear a \doxyref{theora\-\_\-info}{p.}{structtheora__info} structure. \end{DoxyCompactList}\item 
+\begin{DoxyCompactList}\small\item\em Clear a \doxyref{theora\-\_\-info}{p.}{structtheora__info} structure. \end{DoxyCompactList}\item 
 void {\bf theora\-\_\-clear} ({\bf theora\-\_\-state} $\ast$t)
-\begin{DoxyCompactList}\small\item\em \-Free all internal data associated with a \doxyref{theora\-\_\-state}{p.}{structtheora__state} handle. \end{DoxyCompactList}\item 
+\begin{DoxyCompactList}\small\item\em Free all internal data associated with a \doxyref{theora\-\_\-state}{p.}{structtheora__state} handle. \end{DoxyCompactList}\item 
 void {\bf theora\-\_\-comment\-\_\-init} ({\bf theora\-\_\-comment} $\ast$tc)
-\begin{DoxyCompactList}\small\item\em \-Initialize an allocated \doxyref{theora\-\_\-comment}{p.}{structtheora__comment} structure. \end{DoxyCompactList}\item 
+\begin{DoxyCompactList}\small\item\em Initialize an allocated \doxyref{theora\-\_\-comment}{p.}{structtheora__comment} structure. \end{DoxyCompactList}\item 
 void {\bf theora\-\_\-comment\-\_\-add} ({\bf theora\-\_\-comment} $\ast$tc, char $\ast$comment)
-\begin{DoxyCompactList}\small\item\em \-Add a comment to an initialized \doxyref{theora\-\_\-comment}{p.}{structtheora__comment} structure. \end{DoxyCompactList}\item 
+\begin{DoxyCompactList}\small\item\em Add a comment to an initialized \doxyref{theora\-\_\-comment}{p.}{structtheora__comment} structure. \end{DoxyCompactList}\item 
 void {\bf theora\-\_\-comment\-\_\-add\-\_\-tag} ({\bf theora\-\_\-comment} $\ast$tc, char $\ast$tag, char $\ast$value)
-\begin{DoxyCompactList}\small\item\em \-Add a comment to an initialized \doxyref{theora\-\_\-comment}{p.}{structtheora__comment} structure. \end{DoxyCompactList}\item 
+\begin{DoxyCompactList}\small\item\em Add a comment to an initialized \doxyref{theora\-\_\-comment}{p.}{structtheora__comment} structure. \end{DoxyCompactList}\item 
 char $\ast$ {\bf theora\-\_\-comment\-\_\-query} ({\bf theora\-\_\-comment} $\ast$tc, char $\ast$tag, int count)
-\begin{DoxyCompactList}\small\item\em \-Look up a comment value by tag. \end{DoxyCompactList}\item 
+\begin{DoxyCompactList}\small\item\em Look up a comment value by tag. \end{DoxyCompactList}\item 
 int {\bf theora\-\_\-comment\-\_\-query\-\_\-count} ({\bf theora\-\_\-comment} $\ast$tc, char $\ast$tag)
-\begin{DoxyCompactList}\small\item\em \-Look up the number of instances of a tag. \end{DoxyCompactList}\item 
+\begin{DoxyCompactList}\small\item\em Look up the number of instances of a tag. \end{DoxyCompactList}\item 
 void {\bf theora\-\_\-comment\-\_\-clear} ({\bf theora\-\_\-comment} $\ast$tc)
-\begin{DoxyCompactList}\small\item\em \-Clear an allocated \doxyref{theora\-\_\-comment}{p.}{structtheora__comment} struct so that it can be freed. \end{DoxyCompactList}\item 
+\begin{DoxyCompactList}\small\item\em Clear an allocated \doxyref{theora\-\_\-comment}{p.}{structtheora__comment} struct so that it can be freed. \end{DoxyCompactList}\item 
 int {\bf theora\-\_\-control} ({\bf theora\-\_\-state} $\ast$th, int req, void $\ast$buf, size\-\_\-t buf\-\_\-sz)
-\begin{DoxyCompactList}\small\item\em \-Encoder control function. \end{DoxyCompactList}\end{DoxyCompactItemize}
+\begin{DoxyCompactList}\small\item\em Encoder control function. \end{DoxyCompactList}\end{DoxyCompactItemize}
 \subsection*{theora\-\_\-control() codes}
 \begin{DoxyCompactItemize}
 \item 
-\#define {\bf \-T\-H\-\_\-\-D\-E\-C\-C\-T\-L\-\_\-\-G\-E\-T\-\_\-\-P\-P\-L\-E\-V\-E\-L\-\_\-\-M\-A\-X}~(1)
-\begin{DoxyCompactList}\small\item\em \-Get the maximum post-\/processing level. \end{DoxyCompactList}\item 
-\#define {\bf \-T\-H\-\_\-\-D\-E\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-P\-P\-L\-E\-V\-E\-L}~(3)
-\begin{DoxyCompactList}\small\item\em \-Set the post-\/processing level. \end{DoxyCompactList}\item 
-\#define {\bf \-T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-K\-E\-Y\-F\-R\-A\-M\-E\-\_\-\-F\-R\-E\-Q\-U\-E\-N\-C\-Y\-\_\-\-F\-O\-R\-C\-E}~(4)
-\begin{DoxyCompactList}\small\item\em \-Sets the maximum distance between key frames. \end{DoxyCompactList}\item 
-\#define {\bf \-T\-H\-\_\-\-D\-E\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-G\-R\-A\-N\-P\-O\-S}~(5)
-\begin{DoxyCompactList}\small\item\em \-Set the granule position. \end{DoxyCompactList}\item 
-\#define {\bf \-T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-Q\-U\-A\-N\-T\-\_\-\-P\-A\-R\-A\-M\-S}~(2)
-\begin{DoxyCompactList}\small\item\em \-Sets the quantization parameters to use. \end{DoxyCompactList}\item 
-\#define {\bf \-T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-V\-P3\-\_\-\-C\-O\-M\-P\-A\-T\-I\-B\-L\-E}~(10)
-\begin{DoxyCompactList}\small\item\em \-Disables any encoder features that would prevent lossless transcoding back to \-V\-P3. \end{DoxyCompactList}\item 
-\#define {\bf \-T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-G\-E\-T\-\_\-\-S\-P\-L\-E\-V\-E\-L\-\_\-\-M\-A\-X}~(12)
-\begin{DoxyCompactList}\small\item\em \-Gets the maximum speed level. \end{DoxyCompactList}\item 
-\#define {\bf \-T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-S\-P\-L\-E\-V\-E\-L}~(14)
-\begin{DoxyCompactList}\small\item\em \-Sets the speed level. \end{DoxyCompactList}\end{DoxyCompactItemize}
+\#define {\bf T\-H\-\_\-\-D\-E\-C\-C\-T\-L\-\_\-\-G\-E\-T\-\_\-\-P\-P\-L\-E\-V\-E\-L\-\_\-\-M\-A\-X}~(1)
+\begin{DoxyCompactList}\small\item\em Get the maximum post-\/processing level. \end{DoxyCompactList}\item 
+\#define {\bf T\-H\-\_\-\-D\-E\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-P\-P\-L\-E\-V\-E\-L}~(3)
+\begin{DoxyCompactList}\small\item\em Set the post-\/processing level. \end{DoxyCompactList}\item 
+\#define {\bf T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-K\-E\-Y\-F\-R\-A\-M\-E\-\_\-\-F\-R\-E\-Q\-U\-E\-N\-C\-Y\-\_\-\-F\-O\-R\-C\-E}~(4)
+\begin{DoxyCompactList}\small\item\em Sets the maximum distance between key frames. \end{DoxyCompactList}\item 
+\#define {\bf T\-H\-\_\-\-D\-E\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-G\-R\-A\-N\-P\-O\-S}~(5)
+\begin{DoxyCompactList}\small\item\em Set the granule position. \end{DoxyCompactList}\item 
+\#define {\bf T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-Q\-U\-A\-N\-T\-\_\-\-P\-A\-R\-A\-M\-S}~(2)
+\begin{DoxyCompactList}\small\item\em Sets the quantization parameters to use. \end{DoxyCompactList}\item 
+\#define {\bf T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-V\-P3\-\_\-\-C\-O\-M\-P\-A\-T\-I\-B\-L\-E}~(10)
+\begin{DoxyCompactList}\small\item\em Disables any encoder features that would prevent lossless transcoding back to V\-P3. \end{DoxyCompactList}\item 
+\#define {\bf T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-G\-E\-T\-\_\-\-S\-P\-L\-E\-V\-E\-L\-\_\-\-M\-A\-X}~(12)
+\begin{DoxyCompactList}\small\item\em Gets the maximum speed level. \end{DoxyCompactList}\item 
+\#define {\bf T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-S\-P\-L\-E\-V\-E\-L}~(14)
+\begin{DoxyCompactList}\small\item\em Sets the speed level. \end{DoxyCompactList}\end{DoxyCompactItemize}
+
+
+\subsection{Detailed Description}
 
 
-\subsection{\-Define \-Documentation}
-\index{\-Legacy pre-\/1.\-0 C A\-P\-I@{\-Legacy pre-\/1.\-0 C A\-P\-I}!\-O\-C\-\_\-\-B\-A\-D\-H\-E\-A\-D\-E\-R@{\-O\-C\-\_\-\-B\-A\-D\-H\-E\-A\-D\-E\-R}}
-\index{\-O\-C\-\_\-\-B\-A\-D\-H\-E\-A\-D\-E\-R@{\-O\-C\-\_\-\-B\-A\-D\-H\-E\-A\-D\-E\-R}!Legacy pre-1.0 C API@{\-Legacy pre-\/1.\-0 C A\-P\-I}}
-\subsubsection[{\-O\-C\-\_\-\-B\-A\-D\-H\-E\-A\-D\-E\-R}]{\setlength{\rightskip}{0pt plus 5cm}\#define {\bf \-O\-C\-\_\-\-B\-A\-D\-H\-E\-A\-D\-E\-R}~-\/20}\label{group__oldfuncs_ga809cbad2eb36be17a235a3cadfb737ba}
+\subsection{Macro Definition Documentation}
+\index{Legacy pre-\/1.\-0 C A\-P\-I@{Legacy pre-\/1.\-0 C A\-P\-I}!O\-C\-\_\-\-B\-A\-D\-H\-E\-A\-D\-E\-R@{O\-C\-\_\-\-B\-A\-D\-H\-E\-A\-D\-E\-R}}
+\index{O\-C\-\_\-\-B\-A\-D\-H\-E\-A\-D\-E\-R@{O\-C\-\_\-\-B\-A\-D\-H\-E\-A\-D\-E\-R}!Legacy pre-1.0 C API@{Legacy pre-\/1.\-0 C A\-P\-I}}
+\subsubsection[{O\-C\-\_\-\-B\-A\-D\-H\-E\-A\-D\-E\-R}]{\setlength{\rightskip}{0pt plus 5cm}\#define O\-C\-\_\-\-B\-A\-D\-H\-E\-A\-D\-E\-R~-\/20}\label{group__oldfuncs_ga809cbad2eb36be17a235a3cadfb737ba}
 
 
-\-Header packet was corrupt/invalid. 
+Header packet was corrupt/invalid. 
 
-\index{\-Legacy pre-\/1.\-0 C A\-P\-I@{\-Legacy pre-\/1.\-0 C A\-P\-I}!\-O\-C\-\_\-\-B\-A\-D\-P\-A\-C\-K\-E\-T@{\-O\-C\-\_\-\-B\-A\-D\-P\-A\-C\-K\-E\-T}}
-\index{\-O\-C\-\_\-\-B\-A\-D\-P\-A\-C\-K\-E\-T@{\-O\-C\-\_\-\-B\-A\-D\-P\-A\-C\-K\-E\-T}!Legacy pre-1.0 C API@{\-Legacy pre-\/1.\-0 C A\-P\-I}}
-\subsubsection[{\-O\-C\-\_\-\-B\-A\-D\-P\-A\-C\-K\-E\-T}]{\setlength{\rightskip}{0pt plus 5cm}\#define {\bf \-O\-C\-\_\-\-B\-A\-D\-P\-A\-C\-K\-E\-T}~-\/24}\label{group__oldfuncs_ga117774c062a63dfad2a5b4d092fa2bb1}
+\index{Legacy pre-\/1.\-0 C A\-P\-I@{Legacy pre-\/1.\-0 C A\-P\-I}!O\-C\-\_\-\-B\-A\-D\-P\-A\-C\-K\-E\-T@{O\-C\-\_\-\-B\-A\-D\-P\-A\-C\-K\-E\-T}}
+\index{O\-C\-\_\-\-B\-A\-D\-P\-A\-C\-K\-E\-T@{O\-C\-\_\-\-B\-A\-D\-P\-A\-C\-K\-E\-T}!Legacy pre-1.0 C API@{Legacy pre-\/1.\-0 C A\-P\-I}}
+\subsubsection[{O\-C\-\_\-\-B\-A\-D\-P\-A\-C\-K\-E\-T}]{\setlength{\rightskip}{0pt plus 5cm}\#define O\-C\-\_\-\-B\-A\-D\-P\-A\-C\-K\-E\-T~-\/24}\label{group__oldfuncs_ga117774c062a63dfad2a5b4d092fa2bb1}
 
 
-\-Packet is corrupt. 
+Packet is corrupt. 
 
-\index{\-Legacy pre-\/1.\-0 C A\-P\-I@{\-Legacy pre-\/1.\-0 C A\-P\-I}!\-O\-C\-\_\-\-D\-I\-S\-A\-B\-L\-E\-D@{\-O\-C\-\_\-\-D\-I\-S\-A\-B\-L\-E\-D}}
-\index{\-O\-C\-\_\-\-D\-I\-S\-A\-B\-L\-E\-D@{\-O\-C\-\_\-\-D\-I\-S\-A\-B\-L\-E\-D}!Legacy pre-1.0 C API@{\-Legacy pre-\/1.\-0 C A\-P\-I}}
-\subsubsection[{\-O\-C\-\_\-\-D\-I\-S\-A\-B\-L\-E\-D}]{\setlength{\rightskip}{0pt plus 5cm}\#define {\bf \-O\-C\-\_\-\-D\-I\-S\-A\-B\-L\-E\-D}~-\/11}\label{group__oldfuncs_ga38b9fa0af856d5930c534db26e2ac2d1}
+\index{Legacy pre-\/1.\-0 C A\-P\-I@{Legacy pre-\/1.\-0 C A\-P\-I}!O\-C\-\_\-\-D\-I\-S\-A\-B\-L\-E\-D@{O\-C\-\_\-\-D\-I\-S\-A\-B\-L\-E\-D}}
+\index{O\-C\-\_\-\-D\-I\-S\-A\-B\-L\-E\-D@{O\-C\-\_\-\-D\-I\-S\-A\-B\-L\-E\-D}!Legacy pre-1.0 C API@{Legacy pre-\/1.\-0 C A\-P\-I}}
+\subsubsection[{O\-C\-\_\-\-D\-I\-S\-A\-B\-L\-E\-D}]{\setlength{\rightskip}{0pt plus 5cm}\#define O\-C\-\_\-\-D\-I\-S\-A\-B\-L\-E\-D~-\/11}\label{group__oldfuncs_ga38b9fa0af856d5930c534db26e2ac2d1}
 
 
-\-Requested action is disabled. 
+Requested action is disabled. 
 
-\index{\-Legacy pre-\/1.\-0 C A\-P\-I@{\-Legacy pre-\/1.\-0 C A\-P\-I}!\-O\-C\-\_\-\-D\-U\-P\-F\-R\-A\-M\-E@{\-O\-C\-\_\-\-D\-U\-P\-F\-R\-A\-M\-E}}
-\index{\-O\-C\-\_\-\-D\-U\-P\-F\-R\-A\-M\-E@{\-O\-C\-\_\-\-D\-U\-P\-F\-R\-A\-M\-E}!Legacy pre-1.0 C API@{\-Legacy pre-\/1.\-0 C A\-P\-I}}
-\subsubsection[{\-O\-C\-\_\-\-D\-U\-P\-F\-R\-A\-M\-E}]{\setlength{\rightskip}{0pt plus 5cm}\#define {\bf \-O\-C\-\_\-\-D\-U\-P\-F\-R\-A\-M\-E}~1}\label{group__oldfuncs_ga84a8d2f5080ad62b415a4e7551941cbb}
+\index{Legacy pre-\/1.\-0 C A\-P\-I@{Legacy pre-\/1.\-0 C A\-P\-I}!O\-C\-\_\-\-D\-U\-P\-F\-R\-A\-M\-E@{O\-C\-\_\-\-D\-U\-P\-F\-R\-A\-M\-E}}
+\index{O\-C\-\_\-\-D\-U\-P\-F\-R\-A\-M\-E@{O\-C\-\_\-\-D\-U\-P\-F\-R\-A\-M\-E}!Legacy pre-1.0 C API@{Legacy pre-\/1.\-0 C A\-P\-I}}
+\subsubsection[{O\-C\-\_\-\-D\-U\-P\-F\-R\-A\-M\-E}]{\setlength{\rightskip}{0pt plus 5cm}\#define O\-C\-\_\-\-D\-U\-P\-F\-R\-A\-M\-E~1}\label{group__oldfuncs_ga84a8d2f5080ad62b415a4e7551941cbb}
 
 
-\-Packet is a dropped frame. 
+Packet is a dropped frame. 
 
-\index{\-Legacy pre-\/1.\-0 C A\-P\-I@{\-Legacy pre-\/1.\-0 C A\-P\-I}!\-O\-C\-\_\-\-E\-I\-N\-V\-A\-L@{\-O\-C\-\_\-\-E\-I\-N\-V\-A\-L}}
-\index{\-O\-C\-\_\-\-E\-I\-N\-V\-A\-L@{\-O\-C\-\_\-\-E\-I\-N\-V\-A\-L}!Legacy pre-1.0 C API@{\-Legacy pre-\/1.\-0 C A\-P\-I}}
-\subsubsection[{\-O\-C\-\_\-\-E\-I\-N\-V\-A\-L}]{\setlength{\rightskip}{0pt plus 5cm}\#define {\bf \-O\-C\-\_\-\-E\-I\-N\-V\-A\-L}~-\/10}\label{group__oldfuncs_ga43d15091b1a03a734a124e9a04d3be55}
+\index{Legacy pre-\/1.\-0 C A\-P\-I@{Legacy pre-\/1.\-0 C A\-P\-I}!O\-C\-\_\-\-E\-I\-N\-V\-A\-L@{O\-C\-\_\-\-E\-I\-N\-V\-A\-L}}
+\index{O\-C\-\_\-\-E\-I\-N\-V\-A\-L@{O\-C\-\_\-\-E\-I\-N\-V\-A\-L}!Legacy pre-1.0 C API@{Legacy pre-\/1.\-0 C A\-P\-I}}
+\subsubsection[{O\-C\-\_\-\-E\-I\-N\-V\-A\-L}]{\setlength{\rightskip}{0pt plus 5cm}\#define O\-C\-\_\-\-E\-I\-N\-V\-A\-L~-\/10}\label{group__oldfuncs_ga43d15091b1a03a734a124e9a04d3be55}
 
 
-\-Library encountered invalid internal data. 
+Library encountered invalid internal data. 
 
-\index{\-Legacy pre-\/1.\-0 C A\-P\-I@{\-Legacy pre-\/1.\-0 C A\-P\-I}!\-O\-C\-\_\-\-F\-A\-U\-L\-T@{\-O\-C\-\_\-\-F\-A\-U\-L\-T}}
-\index{\-O\-C\-\_\-\-F\-A\-U\-L\-T@{\-O\-C\-\_\-\-F\-A\-U\-L\-T}!Legacy pre-1.0 C API@{\-Legacy pre-\/1.\-0 C A\-P\-I}}
-\subsubsection[{\-O\-C\-\_\-\-F\-A\-U\-L\-T}]{\setlength{\rightskip}{0pt plus 5cm}\#define {\bf \-O\-C\-\_\-\-F\-A\-U\-L\-T}~-\/1}\label{group__oldfuncs_gaa4370e13ed3aea6441ccf69dcab2506e}
+\index{Legacy pre-\/1.\-0 C A\-P\-I@{Legacy pre-\/1.\-0 C A\-P\-I}!O\-C\-\_\-\-F\-A\-U\-L\-T@{O\-C\-\_\-\-F\-A\-U\-L\-T}}
+\index{O\-C\-\_\-\-F\-A\-U\-L\-T@{O\-C\-\_\-\-F\-A\-U\-L\-T}!Legacy pre-1.0 C API@{Legacy pre-\/1.\-0 C A\-P\-I}}
+\subsubsection[{O\-C\-\_\-\-F\-A\-U\-L\-T}]{\setlength{\rightskip}{0pt plus 5cm}\#define O\-C\-\_\-\-F\-A\-U\-L\-T~-\/1}\label{group__oldfuncs_gaa4370e13ed3aea6441ccf69dcab2506e}
 
 
-\-General failure. 
+General failure. 
 
-\index{\-Legacy pre-\/1.\-0 C A\-P\-I@{\-Legacy pre-\/1.\-0 C A\-P\-I}!\-O\-C\-\_\-\-I\-M\-P\-L@{\-O\-C\-\_\-\-I\-M\-P\-L}}
-\index{\-O\-C\-\_\-\-I\-M\-P\-L@{\-O\-C\-\_\-\-I\-M\-P\-L}!Legacy pre-1.0 C API@{\-Legacy pre-\/1.\-0 C A\-P\-I}}
-\subsubsection[{\-O\-C\-\_\-\-I\-M\-P\-L}]{\setlength{\rightskip}{0pt plus 5cm}\#define {\bf \-O\-C\-\_\-\-I\-M\-P\-L}~-\/23}\label{group__oldfuncs_ga895dc2597b3bf9c97bf7701c6eff5b0c}
+\index{Legacy pre-\/1.\-0 C A\-P\-I@{Legacy pre-\/1.\-0 C A\-P\-I}!O\-C\-\_\-\-I\-M\-P\-L@{O\-C\-\_\-\-I\-M\-P\-L}}
+\index{O\-C\-\_\-\-I\-M\-P\-L@{O\-C\-\_\-\-I\-M\-P\-L}!Legacy pre-1.0 C API@{Legacy pre-\/1.\-0 C A\-P\-I}}
+\subsubsection[{O\-C\-\_\-\-I\-M\-P\-L}]{\setlength{\rightskip}{0pt plus 5cm}\#define O\-C\-\_\-\-I\-M\-P\-L~-\/23}\label{group__oldfuncs_ga895dc2597b3bf9c97bf7701c6eff5b0c}
 
 
-\-Feature or action not implemented. 
+Feature or action not implemented. 
 
-\index{\-Legacy pre-\/1.\-0 C A\-P\-I@{\-Legacy pre-\/1.\-0 C A\-P\-I}!\-O\-C\-\_\-\-N\-E\-W\-P\-A\-C\-K\-E\-T@{\-O\-C\-\_\-\-N\-E\-W\-P\-A\-C\-K\-E\-T}}
-\index{\-O\-C\-\_\-\-N\-E\-W\-P\-A\-C\-K\-E\-T@{\-O\-C\-\_\-\-N\-E\-W\-P\-A\-C\-K\-E\-T}!Legacy pre-1.0 C API@{\-Legacy pre-\/1.\-0 C A\-P\-I}}
-\subsubsection[{\-O\-C\-\_\-\-N\-E\-W\-P\-A\-C\-K\-E\-T}]{\setlength{\rightskip}{0pt plus 5cm}\#define {\bf \-O\-C\-\_\-\-N\-E\-W\-P\-A\-C\-K\-E\-T}~-\/25}\label{group__oldfuncs_ga60be4dc92c933eac3542bce3ce076496}
+\index{Legacy pre-\/1.\-0 C A\-P\-I@{Legacy pre-\/1.\-0 C A\-P\-I}!O\-C\-\_\-\-N\-E\-W\-P\-A\-C\-K\-E\-T@{O\-C\-\_\-\-N\-E\-W\-P\-A\-C\-K\-E\-T}}
+\index{O\-C\-\_\-\-N\-E\-W\-P\-A\-C\-K\-E\-T@{O\-C\-\_\-\-N\-E\-W\-P\-A\-C\-K\-E\-T}!Legacy pre-1.0 C API@{Legacy pre-\/1.\-0 C A\-P\-I}}
+\subsubsection[{O\-C\-\_\-\-N\-E\-W\-P\-A\-C\-K\-E\-T}]{\setlength{\rightskip}{0pt plus 5cm}\#define O\-C\-\_\-\-N\-E\-W\-P\-A\-C\-K\-E\-T~-\/25}\label{group__oldfuncs_ga60be4dc92c933eac3542bce3ce076496}
 
 
-\-Packet is an (ignorable) unhandled extension. 
+Packet is an (ignorable) unhandled extension. 
 
-\index{\-Legacy pre-\/1.\-0 C A\-P\-I@{\-Legacy pre-\/1.\-0 C A\-P\-I}!\-O\-C\-\_\-\-N\-O\-T\-F\-O\-R\-M\-A\-T@{\-O\-C\-\_\-\-N\-O\-T\-F\-O\-R\-M\-A\-T}}
-\index{\-O\-C\-\_\-\-N\-O\-T\-F\-O\-R\-M\-A\-T@{\-O\-C\-\_\-\-N\-O\-T\-F\-O\-R\-M\-A\-T}!Legacy pre-1.0 C API@{\-Legacy pre-\/1.\-0 C A\-P\-I}}
-\subsubsection[{\-O\-C\-\_\-\-N\-O\-T\-F\-O\-R\-M\-A\-T}]{\setlength{\rightskip}{0pt plus 5cm}\#define {\bf \-O\-C\-\_\-\-N\-O\-T\-F\-O\-R\-M\-A\-T}~-\/21}\label{group__oldfuncs_ga9558d6d9eacd2273c8da27f945d725ad}
+\index{Legacy pre-\/1.\-0 C A\-P\-I@{Legacy pre-\/1.\-0 C A\-P\-I}!O\-C\-\_\-\-N\-O\-T\-F\-O\-R\-M\-A\-T@{O\-C\-\_\-\-N\-O\-T\-F\-O\-R\-M\-A\-T}}
+\index{O\-C\-\_\-\-N\-O\-T\-F\-O\-R\-M\-A\-T@{O\-C\-\_\-\-N\-O\-T\-F\-O\-R\-M\-A\-T}!Legacy pre-1.0 C API@{Legacy pre-\/1.\-0 C A\-P\-I}}
+\subsubsection[{O\-C\-\_\-\-N\-O\-T\-F\-O\-R\-M\-A\-T}]{\setlength{\rightskip}{0pt plus 5cm}\#define O\-C\-\_\-\-N\-O\-T\-F\-O\-R\-M\-A\-T~-\/21}\label{group__oldfuncs_ga9558d6d9eacd2273c8da27f945d725ad}
 
 
-\-Packet is not a theora packet. 
+Packet is not a theora packet. 
 
-\index{\-Legacy pre-\/1.\-0 C A\-P\-I@{\-Legacy pre-\/1.\-0 C A\-P\-I}!\-O\-C\-\_\-\-V\-E\-R\-S\-I\-O\-N@{\-O\-C\-\_\-\-V\-E\-R\-S\-I\-O\-N}}
-\index{\-O\-C\-\_\-\-V\-E\-R\-S\-I\-O\-N@{\-O\-C\-\_\-\-V\-E\-R\-S\-I\-O\-N}!Legacy pre-1.0 C API@{\-Legacy pre-\/1.\-0 C A\-P\-I}}
-\subsubsection[{\-O\-C\-\_\-\-V\-E\-R\-S\-I\-O\-N}]{\setlength{\rightskip}{0pt plus 5cm}\#define {\bf \-O\-C\-\_\-\-V\-E\-R\-S\-I\-O\-N}~-\/22}\label{group__oldfuncs_ga4611cfd61160405721d1e2ab0ec2564b}
+\index{Legacy pre-\/1.\-0 C A\-P\-I@{Legacy pre-\/1.\-0 C A\-P\-I}!O\-C\-\_\-\-V\-E\-R\-S\-I\-O\-N@{O\-C\-\_\-\-V\-E\-R\-S\-I\-O\-N}}
+\index{O\-C\-\_\-\-V\-E\-R\-S\-I\-O\-N@{O\-C\-\_\-\-V\-E\-R\-S\-I\-O\-N}!Legacy pre-1.0 C API@{Legacy pre-\/1.\-0 C A\-P\-I}}
+\subsubsection[{O\-C\-\_\-\-V\-E\-R\-S\-I\-O\-N}]{\setlength{\rightskip}{0pt plus 5cm}\#define O\-C\-\_\-\-V\-E\-R\-S\-I\-O\-N~-\/22}\label{group__oldfuncs_ga4611cfd61160405721d1e2ab0ec2564b}
 
 
-\-Bitstream version is not handled. 
+Bitstream version is not handled. 
 
-\index{\-Legacy pre-\/1.\-0 C A\-P\-I@{\-Legacy pre-\/1.\-0 C A\-P\-I}!\-T\-H\-\_\-\-D\-E\-C\-C\-T\-L\-\_\-\-G\-E\-T\-\_\-\-P\-P\-L\-E\-V\-E\-L\-\_\-\-M\-A\-X@{\-T\-H\-\_\-\-D\-E\-C\-C\-T\-L\-\_\-\-G\-E\-T\-\_\-\-P\-P\-L\-E\-V\-E\-L\-\_\-\-M\-A\-X}}
-\index{\-T\-H\-\_\-\-D\-E\-C\-C\-T\-L\-\_\-\-G\-E\-T\-\_\-\-P\-P\-L\-E\-V\-E\-L\-\_\-\-M\-A\-X@{\-T\-H\-\_\-\-D\-E\-C\-C\-T\-L\-\_\-\-G\-E\-T\-\_\-\-P\-P\-L\-E\-V\-E\-L\-\_\-\-M\-A\-X}!Legacy pre-1.0 C API@{\-Legacy pre-\/1.\-0 C A\-P\-I}}
-\subsubsection[{\-T\-H\-\_\-\-D\-E\-C\-C\-T\-L\-\_\-\-G\-E\-T\-\_\-\-P\-P\-L\-E\-V\-E\-L\-\_\-\-M\-A\-X}]{\setlength{\rightskip}{0pt plus 5cm}\#define {\bf \-T\-H\-\_\-\-D\-E\-C\-C\-T\-L\-\_\-\-G\-E\-T\-\_\-\-P\-P\-L\-E\-V\-E\-L\-\_\-\-M\-A\-X}~(1)}\label{group__oldfuncs_gab31f251c9319f2140d247585d30b3d07}
+\index{Legacy pre-\/1.\-0 C A\-P\-I@{Legacy pre-\/1.\-0 C A\-P\-I}!T\-H\-\_\-\-D\-E\-C\-C\-T\-L\-\_\-\-G\-E\-T\-\_\-\-P\-P\-L\-E\-V\-E\-L\-\_\-\-M\-A\-X@{T\-H\-\_\-\-D\-E\-C\-C\-T\-L\-\_\-\-G\-E\-T\-\_\-\-P\-P\-L\-E\-V\-E\-L\-\_\-\-M\-A\-X}}
+\index{T\-H\-\_\-\-D\-E\-C\-C\-T\-L\-\_\-\-G\-E\-T\-\_\-\-P\-P\-L\-E\-V\-E\-L\-\_\-\-M\-A\-X@{T\-H\-\_\-\-D\-E\-C\-C\-T\-L\-\_\-\-G\-E\-T\-\_\-\-P\-P\-L\-E\-V\-E\-L\-\_\-\-M\-A\-X}!Legacy pre-1.0 C API@{Legacy pre-\/1.\-0 C A\-P\-I}}
+\subsubsection[{T\-H\-\_\-\-D\-E\-C\-C\-T\-L\-\_\-\-G\-E\-T\-\_\-\-P\-P\-L\-E\-V\-E\-L\-\_\-\-M\-A\-X}]{\setlength{\rightskip}{0pt plus 5cm}\#define T\-H\-\_\-\-D\-E\-C\-C\-T\-L\-\_\-\-G\-E\-T\-\_\-\-P\-P\-L\-E\-V\-E\-L\-\_\-\-M\-A\-X~(1)}\label{group__oldfuncs_gab31f251c9319f2140d247585d30b3d07}
 
 
-\-Get the maximum post-\/processing level. 
+Get the maximum post-\/processing level. 
 
-\-The decoder supports a post-\/processing filter that can improve the appearance of the decoded images. \-This returns the highest level setting for this post-\/processor, corresponding to maximum improvement and computational expense. \index{\-Legacy pre-\/1.\-0 C A\-P\-I@{\-Legacy pre-\/1.\-0 C A\-P\-I}!\-T\-H\-\_\-\-D\-E\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-G\-R\-A\-N\-P\-O\-S@{\-T\-H\-\_\-\-D\-E\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-G\-R\-A\-N\-P\-O\-S}}
-\index{\-T\-H\-\_\-\-D\-E\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-G\-R\-A\-N\-P\-O\-S@{\-T\-H\-\_\-\-D\-E\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-G\-R\-A\-N\-P\-O\-S}!Legacy pre-1.0 C API@{\-Legacy pre-\/1.\-0 C A\-P\-I}}
-\subsubsection[{\-T\-H\-\_\-\-D\-E\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-G\-R\-A\-N\-P\-O\-S}]{\setlength{\rightskip}{0pt plus 5cm}\#define {\bf \-T\-H\-\_\-\-D\-E\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-G\-R\-A\-N\-P\-O\-S}~(5)}\label{group__oldfuncs_ga1e870c654d35394f0d490045df04e0f5}
+The decoder supports a post-\/processing filter that can improve the appearance of the decoded images. This returns the highest level setting for this post-\/processor, corresponding to maximum improvement and computational expense. \index{Legacy pre-\/1.\-0 C A\-P\-I@{Legacy pre-\/1.\-0 C A\-P\-I}!T\-H\-\_\-\-D\-E\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-G\-R\-A\-N\-P\-O\-S@{T\-H\-\_\-\-D\-E\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-G\-R\-A\-N\-P\-O\-S}}
+\index{T\-H\-\_\-\-D\-E\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-G\-R\-A\-N\-P\-O\-S@{T\-H\-\_\-\-D\-E\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-G\-R\-A\-N\-P\-O\-S}!Legacy pre-1.0 C API@{Legacy pre-\/1.\-0 C A\-P\-I}}
+\subsubsection[{T\-H\-\_\-\-D\-E\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-G\-R\-A\-N\-P\-O\-S}]{\setlength{\rightskip}{0pt plus 5cm}\#define T\-H\-\_\-\-D\-E\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-G\-R\-A\-N\-P\-O\-S~(5)}\label{group__oldfuncs_ga1e870c654d35394f0d490045df04e0f5}
 
 
-\-Set the granule position. 
+Set the granule position. 
 
-\-Call this after a seek, to update the internal granulepos in the decoder, to insure that subsequent frames are marked properly. \-If you track timestamps yourself and do not use the granule postion returned by the decoder, then you do not need to use this control. \index{\-Legacy pre-\/1.\-0 C A\-P\-I@{\-Legacy pre-\/1.\-0 C A\-P\-I}!\-T\-H\-\_\-\-D\-E\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-P\-P\-L\-E\-V\-E\-L@{\-T\-H\-\_\-\-D\-E\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-P\-P\-L\-E\-V\-E\-L}}
-\index{\-T\-H\-\_\-\-D\-E\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-P\-P\-L\-E\-V\-E\-L@{\-T\-H\-\_\-\-D\-E\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-P\-P\-L\-E\-V\-E\-L}!Legacy pre-1.0 C API@{\-Legacy pre-\/1.\-0 C A\-P\-I}}
-\subsubsection[{\-T\-H\-\_\-\-D\-E\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-P\-P\-L\-E\-V\-E\-L}]{\setlength{\rightskip}{0pt plus 5cm}\#define {\bf \-T\-H\-\_\-\-D\-E\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-P\-P\-L\-E\-V\-E\-L}~(3)}\label{group__oldfuncs_ga87774c35e1a755a84e2d705b38ebef0d}
+Call this after a seek, to update the internal granulepos in the decoder, to insure that subsequent frames are marked properly. If you track timestamps yourself and do not use the granule postion returned by the decoder, then you do not need to use this control. \index{Legacy pre-\/1.\-0 C A\-P\-I@{Legacy pre-\/1.\-0 C A\-P\-I}!T\-H\-\_\-\-D\-E\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-P\-P\-L\-E\-V\-E\-L@{T\-H\-\_\-\-D\-E\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-P\-P\-L\-E\-V\-E\-L}}
+\index{T\-H\-\_\-\-D\-E\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-P\-P\-L\-E\-V\-E\-L@{T\-H\-\_\-\-D\-E\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-P\-P\-L\-E\-V\-E\-L}!Legacy pre-1.0 C API@{Legacy pre-\/1.\-0 C A\-P\-I}}
+\subsubsection[{T\-H\-\_\-\-D\-E\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-P\-P\-L\-E\-V\-E\-L}]{\setlength{\rightskip}{0pt plus 5cm}\#define T\-H\-\_\-\-D\-E\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-P\-P\-L\-E\-V\-E\-L~(3)}\label{group__oldfuncs_ga87774c35e1a755a84e2d705b38ebef0d}
 
 
-\-Set the post-\/processing level. 
+Set the post-\/processing level. 
 
-\-Sets the level of post-\/processing to use when decoding the compressed stream. \-This must be a value between zero (off) and the maximum returned by \-T\-H\-\_\-\-D\-E\-C\-C\-T\-L\-\_\-\-G\-E\-T\-\_\-\-P\-P\-L\-E\-V\-E\-L\-\_\-\-M\-A\-X. \index{\-Legacy pre-\/1.\-0 C A\-P\-I@{\-Legacy pre-\/1.\-0 C A\-P\-I}!\-T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-G\-E\-T\-\_\-\-S\-P\-L\-E\-V\-E\-L\-\_\-\-M\-A\-X@{\-T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-G\-E\-T\-\_\-\-S\-P\-L\-E\-V\-E\-L\-\_\-\-M\-A\-X}}
-\index{\-T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-G\-E\-T\-\_\-\-S\-P\-L\-E\-V\-E\-L\-\_\-\-M\-A\-X@{\-T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-G\-E\-T\-\_\-\-S\-P\-L\-E\-V\-E\-L\-\_\-\-M\-A\-X}!Legacy pre-1.0 C API@{\-Legacy pre-\/1.\-0 C A\-P\-I}}
-\subsubsection[{\-T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-G\-E\-T\-\_\-\-S\-P\-L\-E\-V\-E\-L\-\_\-\-M\-A\-X}]{\setlength{\rightskip}{0pt plus 5cm}\#define {\bf \-T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-G\-E\-T\-\_\-\-S\-P\-L\-E\-V\-E\-L\-\_\-\-M\-A\-X}~(12)}\label{group__oldfuncs_ga9baf5bdd206e80c78a8fd44687e89783}
+Sets the level of post-\/processing to use when decoding the compressed stream. This must be a value between zero (off) and the maximum returned by T\-H\-\_\-\-D\-E\-C\-C\-T\-L\-\_\-\-G\-E\-T\-\_\-\-P\-P\-L\-E\-V\-E\-L\-\_\-\-M\-A\-X. \index{Legacy pre-\/1.\-0 C A\-P\-I@{Legacy pre-\/1.\-0 C A\-P\-I}!T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-G\-E\-T\-\_\-\-S\-P\-L\-E\-V\-E\-L\-\_\-\-M\-A\-X@{T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-G\-E\-T\-\_\-\-S\-P\-L\-E\-V\-E\-L\-\_\-\-M\-A\-X}}
+\index{T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-G\-E\-T\-\_\-\-S\-P\-L\-E\-V\-E\-L\-\_\-\-M\-A\-X@{T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-G\-E\-T\-\_\-\-S\-P\-L\-E\-V\-E\-L\-\_\-\-M\-A\-X}!Legacy pre-1.0 C API@{Legacy pre-\/1.\-0 C A\-P\-I}}
+\subsubsection[{T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-G\-E\-T\-\_\-\-S\-P\-L\-E\-V\-E\-L\-\_\-\-M\-A\-X}]{\setlength{\rightskip}{0pt plus 5cm}\#define T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-G\-E\-T\-\_\-\-S\-P\-L\-E\-V\-E\-L\-\_\-\-M\-A\-X~(12)}\label{group__oldfuncs_ga9baf5bdd206e80c78a8fd44687e89783}
 
 
-\-Gets the maximum speed level. 
+Gets the maximum speed level. 
 
-\-Higher speed levels favor quicker encoding over better quality per bit. \-Depending on the encoding mode, and the internal algorithms used, quality may actually improve, but in this case bitrate will also likely increase. \-In any case, overall rate/distortion performance will probably decrease. \-The maximum value, and the meaning of each value, may change depending on the current encoding mode (\-V\-B\-R vs. \-C\-Q\-I, etc.).
+Higher speed levels favor quicker encoding over better quality per bit. Depending on the encoding mode, and the internal algorithms used, quality may actually improve, but in this case bitrate will also likely increase. In any case, overall rate/distortion performance will probably decrease. The maximum value, and the meaning of each value, may change depending on the current encoding mode (V\-B\-R vs. C\-Q\-I, etc.).
 
 
-\begin{DoxyParams}[1]{\-Parameters}
-\mbox{\tt out}  & {\em buf} & int\-: \-The maximum encoding speed level. \\
+\begin{DoxyParams}[1]{Parameters}
+\mbox{\tt out}  & {\em buf} & int\-: The maximum encoding speed level. \\
 \hline
 \end{DoxyParams}
 
-\begin{DoxyRetVals}{\-Return values}
-{\em \-O\-C\-\_\-\-F\-A\-U\-L\-T} & {\itshape \doxyref{theora\-\_\-state}{p.}{structtheora__state}\/} or {\itshape buf\/} is {\ttfamily \-N\-U\-L\-L}. \\
+\begin{DoxyRetVals}{Return values}
+{\em O\-C\-\_\-\-F\-A\-U\-L\-T} & {\itshape \doxyref{theora\-\_\-state}{p.}{structtheora__state}} or {\itshape buf} is {\ttfamily N\-U\-L\-L}. \\
 \hline
-{\em \-O\-C\-\_\-\-E\-I\-N\-V\-A\-L} & {\itshape buf\-\_\-sz\/} is not {\ttfamily sizeof(int)}. \\
+{\em O\-C\-\_\-\-E\-I\-N\-V\-A\-L} & {\itshape buf\-\_\-sz} is not {\ttfamily sizeof(int)}. \\
 \hline
-{\em \-O\-C\-\_\-\-I\-M\-P\-L} & \-Not supported by this implementation in the current encoding mode. \\
+{\em O\-C\-\_\-\-I\-M\-P\-L} & Not supported by this implementation in the current encoding mode. \\
 \hline
 \end{DoxyRetVals}
-\index{\-Legacy pre-\/1.\-0 C A\-P\-I@{\-Legacy pre-\/1.\-0 C A\-P\-I}!\-T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-K\-E\-Y\-F\-R\-A\-M\-E\-\_\-\-F\-R\-E\-Q\-U\-E\-N\-C\-Y\-\_\-\-F\-O\-R\-C\-E@{\-T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-K\-E\-Y\-F\-R\-A\-M\-E\-\_\-\-F\-R\-E\-Q\-U\-E\-N\-C\-Y\-\_\-\-F\-O\-R\-C\-E}}
-\index{\-T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-K\-E\-Y\-F\-R\-A\-M\-E\-\_\-\-F\-R\-E\-Q\-U\-E\-N\-C\-Y\-\_\-\-F\-O\-R\-C\-E@{\-T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-K\-E\-Y\-F\-R\-A\-M\-E\-\_\-\-F\-R\-E\-Q\-U\-E\-N\-C\-Y\-\_\-\-F\-O\-R\-C\-E}!Legacy pre-1.0 C API@{\-Legacy pre-\/1.\-0 C A\-P\-I}}
-\subsubsection[{\-T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-K\-E\-Y\-F\-R\-A\-M\-E\-\_\-\-F\-R\-E\-Q\-U\-E\-N\-C\-Y\-\_\-\-F\-O\-R\-C\-E}]{\setlength{\rightskip}{0pt plus 5cm}\#define {\bf \-T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-K\-E\-Y\-F\-R\-A\-M\-E\-\_\-\-F\-R\-E\-Q\-U\-E\-N\-C\-Y\-\_\-\-F\-O\-R\-C\-E}~(4)}\label{group__oldfuncs_ga27e755e15b4b5604c54974b304037a49}
+\index{Legacy pre-\/1.\-0 C A\-P\-I@{Legacy pre-\/1.\-0 C A\-P\-I}!T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-K\-E\-Y\-F\-R\-A\-M\-E\-\_\-\-F\-R\-E\-Q\-U\-E\-N\-C\-Y\-\_\-\-F\-O\-R\-C\-E@{T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-K\-E\-Y\-F\-R\-A\-M\-E\-\_\-\-F\-R\-E\-Q\-U\-E\-N\-C\-Y\-\_\-\-F\-O\-R\-C\-E}}
+\index{T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-K\-E\-Y\-F\-R\-A\-M\-E\-\_\-\-F\-R\-E\-Q\-U\-E\-N\-C\-Y\-\_\-\-F\-O\-R\-C\-E@{T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-K\-E\-Y\-F\-R\-A\-M\-E\-\_\-\-F\-R\-E\-Q\-U\-E\-N\-C\-Y\-\_\-\-F\-O\-R\-C\-E}!Legacy pre-1.0 C API@{Legacy pre-\/1.\-0 C A\-P\-I}}
+\subsubsection[{T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-K\-E\-Y\-F\-R\-A\-M\-E\-\_\-\-F\-R\-E\-Q\-U\-E\-N\-C\-Y\-\_\-\-F\-O\-R\-C\-E}]{\setlength{\rightskip}{0pt plus 5cm}\#define T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-K\-E\-Y\-F\-R\-A\-M\-E\-\_\-\-F\-R\-E\-Q\-U\-E\-N\-C\-Y\-\_\-\-F\-O\-R\-C\-E~(4)}\label{group__oldfuncs_ga27e755e15b4b5604c54974b304037a49}
 
 
-\-Sets the maximum distance between key frames. 
+Sets the maximum distance between key frames. 
 
-\-This can be changed during an encode, but will be bounded by {\ttfamily 1$<$$<$\doxyref{th\-\_\-info\-::keyframe\-\_\-granule\-\_\-shift}{p.}{structth__info_a693ca4ab11fbc0c3f32594b4bb8766ed}}. \-If it is set before encoding begins, \doxyref{th\-\_\-info\-::keyframe\-\_\-granule\-\_\-shift}{p.}{structth__info_a693ca4ab11fbc0c3f32594b4bb8766ed} will be enlarged appropriately.
+This can be changed during an encode, but will be bounded by {\ttfamily 1$<$$<$\doxyref{th\-\_\-info\-::keyframe\-\_\-granule\-\_\-shift}{p.}{structth__info_a693ca4ab11fbc0c3f32594b4bb8766ed}}. If it is set before encoding begins, \doxyref{th\-\_\-info\-::keyframe\-\_\-granule\-\_\-shift}{p.}{structth__info_a693ca4ab11fbc0c3f32594b4bb8766ed} will be enlarged appropriately.
 
 
-\begin{DoxyParams}[1]{\-Parameters}
-\mbox{\tt in}  & {\em buf} & {\ttfamily ogg\-\_\-uint32\-\_\-t}\-: \-The maximum distance between key frames. \\
+\begin{DoxyParams}[1]{Parameters}
+\mbox{\tt in}  & {\em buf} & {\ttfamily ogg\-\_\-uint32\-\_\-t}\-: The maximum distance between key frames. \\
 \hline
-\mbox{\tt out}  & {\em buf} & {\ttfamily ogg\-\_\-uint32\-\_\-t}\-: \-The actual maximum distance set. \\
+\mbox{\tt out}  & {\em buf} & {\ttfamily ogg\-\_\-uint32\-\_\-t}\-: The actual maximum distance set. \\
 \hline
 \end{DoxyParams}
 
-\begin{DoxyRetVals}{\-Return values}
-{\em \-O\-C\-\_\-\-F\-A\-U\-L\-T} & {\itshape \doxyref{theora\-\_\-state}{p.}{structtheora__state}\/} or {\itshape buf\/} is {\ttfamily \-N\-U\-L\-L}. \\
+\begin{DoxyRetVals}{Return values}
+{\em O\-C\-\_\-\-F\-A\-U\-L\-T} & {\itshape \doxyref{theora\-\_\-state}{p.}{structtheora__state}} or {\itshape buf} is {\ttfamily N\-U\-L\-L}. \\
 \hline
-{\em \-O\-C\-\_\-\-E\-I\-N\-V\-A\-L} & {\itshape buf\-\_\-sz\/} is not {\ttfamily sizeof(ogg\-\_\-uint32\-\_\-t)}. \\
+{\em O\-C\-\_\-\-E\-I\-N\-V\-A\-L} & {\itshape buf\-\_\-sz} is not {\ttfamily sizeof(ogg\-\_\-uint32\-\_\-t)}. \\
 \hline
-{\em \-O\-C\-\_\-\-I\-M\-P\-L} & \-Not supported by this implementation. \\
+{\em O\-C\-\_\-\-I\-M\-P\-L} & Not supported by this implementation. \\
 \hline
 \end{DoxyRetVals}
-\index{\-Legacy pre-\/1.\-0 C A\-P\-I@{\-Legacy pre-\/1.\-0 C A\-P\-I}!\-T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-Q\-U\-A\-N\-T\-\_\-\-P\-A\-R\-A\-M\-S@{\-T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-Q\-U\-A\-N\-T\-\_\-\-P\-A\-R\-A\-M\-S}}
-\index{\-T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-Q\-U\-A\-N\-T\-\_\-\-P\-A\-R\-A\-M\-S@{\-T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-Q\-U\-A\-N\-T\-\_\-\-P\-A\-R\-A\-M\-S}!Legacy pre-1.0 C API@{\-Legacy pre-\/1.\-0 C A\-P\-I}}
-\subsubsection[{\-T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-Q\-U\-A\-N\-T\-\_\-\-P\-A\-R\-A\-M\-S}]{\setlength{\rightskip}{0pt plus 5cm}\#define {\bf \-T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-Q\-U\-A\-N\-T\-\_\-\-P\-A\-R\-A\-M\-S}~(2)}\label{group__oldfuncs_ga3befcdd66678f8d27034f9c4b16d1b9c}
+\index{Legacy pre-\/1.\-0 C A\-P\-I@{Legacy pre-\/1.\-0 C A\-P\-I}!T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-Q\-U\-A\-N\-T\-\_\-\-P\-A\-R\-A\-M\-S@{T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-Q\-U\-A\-N\-T\-\_\-\-P\-A\-R\-A\-M\-S}}
+\index{T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-Q\-U\-A\-N\-T\-\_\-\-P\-A\-R\-A\-M\-S@{T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-Q\-U\-A\-N\-T\-\_\-\-P\-A\-R\-A\-M\-S}!Legacy pre-1.0 C API@{Legacy pre-\/1.\-0 C A\-P\-I}}
+\subsubsection[{T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-Q\-U\-A\-N\-T\-\_\-\-P\-A\-R\-A\-M\-S}]{\setlength{\rightskip}{0pt plus 5cm}\#define T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-Q\-U\-A\-N\-T\-\_\-\-P\-A\-R\-A\-M\-S~(2)}\label{group__oldfuncs_ga3befcdd66678f8d27034f9c4b16d1b9c}
 
 
-\-Sets the quantization parameters to use. 
+Sets the quantization parameters to use. 
 
 \label{group__oldfuncs_encctlcodes_old}%
- \-The parameters are copied, not stored by reference, so they can be freed after this call. {\ttfamily \-N\-U\-L\-L} may be specified to revert to the default parameters.
+The parameters are copied, not stored by reference, so they can be freed after this call. {\ttfamily N\-U\-L\-L} may be specified to revert to the default parameters.
 
 
-\begin{DoxyParams}[1]{\-Parameters}
+\begin{DoxyParams}[1]{Parameters}
 \mbox{\tt in}  & {\em buf} & \doxyref{th\-\_\-quant\-\_\-info}{p.}{structth__quant__info} \\
 \hline
 \end{DoxyParams}
 
-\begin{DoxyRetVals}{\-Return values}
-{\em \-O\-C\-\_\-\-F\-A\-U\-L\-T} & {\itshape \doxyref{theora\-\_\-state}{p.}{structtheora__state}\/} is {\ttfamily \-N\-U\-L\-L}. \\
+\begin{DoxyRetVals}{Return values}
+{\em O\-C\-\_\-\-F\-A\-U\-L\-T} & {\itshape \doxyref{theora\-\_\-state}{p.}{structtheora__state}} is {\ttfamily N\-U\-L\-L}. \\
 \hline
-{\em \-O\-C\-\_\-\-E\-I\-N\-V\-A\-L} & \-Encoding has already begun, the quantization parameters are not acceptable to this version of the encoder, {\itshape buf\/} is {\ttfamily \-N\-U\-L\-L} and {\itshape buf\-\_\-sz\/} is not zero, or {\itshape buf\/} is non-\/{\ttfamily \-N\-U\-L\-L} and {\itshape buf\-\_\-sz\/} is not {\ttfamily sizeof(\doxyref{th\-\_\-quant\-\_\-info}{p.}{structth__quant__info})}. \\
+{\em O\-C\-\_\-\-E\-I\-N\-V\-A\-L} & Encoding has already begun, the quantization parameters are not acceptable to this version of the encoder, {\itshape buf} is {\ttfamily N\-U\-L\-L} and {\itshape buf\-\_\-sz} is not zero, or {\itshape buf} is non-\/{\ttfamily N\-U\-L\-L} and {\itshape buf\-\_\-sz} is not {\ttfamily sizeof(\doxyref{th\-\_\-quant\-\_\-info}{p.}{structth__quant__info})}. \\
 \hline
-{\em \-O\-C\-\_\-\-I\-M\-P\-L} & \-Not supported by this implementation. \\
+{\em O\-C\-\_\-\-I\-M\-P\-L} & Not supported by this implementation. \\
 \hline
 \end{DoxyRetVals}
-\index{\-Legacy pre-\/1.\-0 C A\-P\-I@{\-Legacy pre-\/1.\-0 C A\-P\-I}!\-T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-S\-P\-L\-E\-V\-E\-L@{\-T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-S\-P\-L\-E\-V\-E\-L}}
-\index{\-T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-S\-P\-L\-E\-V\-E\-L@{\-T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-S\-P\-L\-E\-V\-E\-L}!Legacy pre-1.0 C API@{\-Legacy pre-\/1.\-0 C A\-P\-I}}
-\subsubsection[{\-T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-S\-P\-L\-E\-V\-E\-L}]{\setlength{\rightskip}{0pt plus 5cm}\#define {\bf \-T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-S\-P\-L\-E\-V\-E\-L}~(14)}\label{group__oldfuncs_gabd9fbcb6a25a77d991d3620164fe59d6}
+\index{Legacy pre-\/1.\-0 C A\-P\-I@{Legacy pre-\/1.\-0 C A\-P\-I}!T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-S\-P\-L\-E\-V\-E\-L@{T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-S\-P\-L\-E\-V\-E\-L}}
+\index{T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-S\-P\-L\-E\-V\-E\-L@{T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-S\-P\-L\-E\-V\-E\-L}!Legacy pre-1.0 C API@{Legacy pre-\/1.\-0 C A\-P\-I}}
+\subsubsection[{T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-S\-P\-L\-E\-V\-E\-L}]{\setlength{\rightskip}{0pt plus 5cm}\#define T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-S\-P\-L\-E\-V\-E\-L~(14)}\label{group__oldfuncs_gabd9fbcb6a25a77d991d3620164fe59d6}
 
 
-\-Sets the speed level. 
+Sets the speed level. 
 
-\-By default a speed value of 1 is used.
+By default a speed value of 1 is used.
 
 
-\begin{DoxyParams}[1]{\-Parameters}
-\mbox{\tt in}  & {\em buf} & int\-: \-The new encoding speed level. 0 is slowest, larger values use less \-C\-P\-U. \\
+\begin{DoxyParams}[1]{Parameters}
+\mbox{\tt in}  & {\em buf} & int\-: The new encoding speed level. 0 is slowest, larger values use less C\-P\-U. \\
 \hline
 \end{DoxyParams}
 
-\begin{DoxyRetVals}{\-Return values}
-{\em \-O\-C\-\_\-\-F\-A\-U\-L\-T} & {\itshape \doxyref{theora\-\_\-state}{p.}{structtheora__state}\/} or {\itshape buf\/} is {\ttfamily \-N\-U\-L\-L}. \\
+\begin{DoxyRetVals}{Return values}
+{\em O\-C\-\_\-\-F\-A\-U\-L\-T} & {\itshape \doxyref{theora\-\_\-state}{p.}{structtheora__state}} or {\itshape buf} is {\ttfamily N\-U\-L\-L}. \\
 \hline
-{\em \-O\-C\-\_\-\-E\-I\-N\-V\-A\-L} & {\itshape buf\-\_\-sz\/} is not {\ttfamily sizeof(int)}, or the encoding speed level is out of bounds. \-The maximum encoding speed level may be implementation-\/ and encoding mode-\/specific, and can be obtained via \doxyref{\-T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-G\-E\-T\-\_\-\-S\-P\-L\-E\-V\-E\-L\-\_\-\-M\-A\-X}{p.}{group__oldfuncs_ga9baf5bdd206e80c78a8fd44687e89783}. \\
+{\em O\-C\-\_\-\-E\-I\-N\-V\-A\-L} & {\itshape buf\-\_\-sz} is not {\ttfamily sizeof(int)}, or the encoding speed level is out of bounds. The maximum encoding speed level may be implementation-\/ and encoding mode-\/specific, and can be obtained via \doxyref{T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-G\-E\-T\-\_\-\-S\-P\-L\-E\-V\-E\-L\-\_\-\-M\-A\-X}{p.}{group__oldfuncs_ga9baf5bdd206e80c78a8fd44687e89783}. \\
 \hline
-{\em \-O\-C\-\_\-\-I\-M\-P\-L} & \-Not supported by this implementation in the current encoding mode. \\
+{\em O\-C\-\_\-\-I\-M\-P\-L} & Not supported by this implementation in the current encoding mode. \\
 \hline
 \end{DoxyRetVals}
-\index{\-Legacy pre-\/1.\-0 C A\-P\-I@{\-Legacy pre-\/1.\-0 C A\-P\-I}!\-T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-V\-P3\-\_\-\-C\-O\-M\-P\-A\-T\-I\-B\-L\-E@{\-T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-V\-P3\-\_\-\-C\-O\-M\-P\-A\-T\-I\-B\-L\-E}}
-\index{\-T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-V\-P3\-\_\-\-C\-O\-M\-P\-A\-T\-I\-B\-L\-E@{\-T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-V\-P3\-\_\-\-C\-O\-M\-P\-A\-T\-I\-B\-L\-E}!Legacy pre-1.0 C API@{\-Legacy pre-\/1.\-0 C A\-P\-I}}
-\subsubsection[{\-T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-V\-P3\-\_\-\-C\-O\-M\-P\-A\-T\-I\-B\-L\-E}]{\setlength{\rightskip}{0pt plus 5cm}\#define {\bf \-T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-V\-P3\-\_\-\-C\-O\-M\-P\-A\-T\-I\-B\-L\-E}~(10)}\label{group__oldfuncs_ga382d685a39a34d8e6ba76b00d804efd8}
+\index{Legacy pre-\/1.\-0 C A\-P\-I@{Legacy pre-\/1.\-0 C A\-P\-I}!T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-V\-P3\-\_\-\-C\-O\-M\-P\-A\-T\-I\-B\-L\-E@{T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-V\-P3\-\_\-\-C\-O\-M\-P\-A\-T\-I\-B\-L\-E}}
+\index{T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-V\-P3\-\_\-\-C\-O\-M\-P\-A\-T\-I\-B\-L\-E@{T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-V\-P3\-\_\-\-C\-O\-M\-P\-A\-T\-I\-B\-L\-E}!Legacy pre-1.0 C API@{Legacy pre-\/1.\-0 C A\-P\-I}}
+\subsubsection[{T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-V\-P3\-\_\-\-C\-O\-M\-P\-A\-T\-I\-B\-L\-E}]{\setlength{\rightskip}{0pt plus 5cm}\#define T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-V\-P3\-\_\-\-C\-O\-M\-P\-A\-T\-I\-B\-L\-E~(10)}\label{group__oldfuncs_ga382d685a39a34d8e6ba76b00d804efd8}
 
 
-\-Disables any encoder features that would prevent lossless transcoding back to \-V\-P3. 
+Disables any encoder features that would prevent lossless transcoding back to V\-P3. 
 
-\-This primarily means disabling block-\/level \-Q\-I values and not using 4\-M\-V mode when any of the luma blocks in a macro block are not coded. \-It also includes using the \-V\-P3 quantization tables and \-Huffman codes; if you set them explicitly after calling this function, the resulting stream will not be \-V\-P3-\/compatible. \-If you enable \-V\-P3-\/compatibility when encoding 4\-:2\-:2 or 4\-:4\-:4 source material, or when using a picture region smaller than the full frame (e.\-g. a non-\/multiple-\/of-\/16 width or height), then non-\/\-V\-P3 bitstream features will still be disabled, but the stream will still not be \-V\-P3-\/compatible, as \-V\-P3 was not capable of encoding such formats. \-If you call this after encoding has already begun, then the quantization tables and codebooks cannot be changed, but the frame-\/level features will be enabled or disabled as requested.
+This primarily means disabling block-\/level Q\-I values and not using 4\-M\-V mode when any of the luma blocks in a macro block are not coded. It also includes using the V\-P3 quantization tables and Huffman codes; if you set them explicitly after calling this function, the resulting stream will not be V\-P3-\/compatible. If you enable V\-P3-\/compatibility when encoding 4\-:2\-:2 or 4\-:4\-:4 source material, or when using a picture region smaller than the full frame (e.\-g. a non-\/multiple-\/of-\/16 width or height), then non-\/\-V\-P3 bitstream features will still be disabled, but the stream will still not be V\-P3-\/compatible, as V\-P3 was not capable of encoding such formats. If you call this after encoding has already begun, then the quantization tables and codebooks cannot be changed, but the frame-\/level features will be enabled or disabled as requested.
 
 
-\begin{DoxyParams}[1]{\-Parameters}
-\mbox{\tt in}  & {\em buf} & {\ttfamily int}\-: a non-\/zero value to enable \-V\-P3 compatibility, or 0 to disable it (the default). \\
+\begin{DoxyParams}[1]{Parameters}
+\mbox{\tt in}  & {\em buf} & {\ttfamily int}\-: a non-\/zero value to enable V\-P3 compatibility, or 0 to disable it (the default). \\
 \hline
-\mbox{\tt out}  & {\em buf} & {\ttfamily int}\-: 1 if all bitstream features required for \-V\-P3-\/compatibility could be set, and 0 otherwise. \-The latter will be returned if the pixel format is not 4\-:2\-:0, the picture region is smaller than the full frame, or if encoding has begun, preventing the quantization tables and codebooks from being set. \\
+\mbox{\tt out}  & {\em buf} & {\ttfamily int}\-: 1 if all bitstream features required for V\-P3-\/compatibility could be set, and 0 otherwise. The latter will be returned if the pixel format is not 4\-:2\-:0, the picture region is smaller than the full frame, or if encoding has begun, preventing the quantization tables and codebooks from being set. \\
 \hline
 \end{DoxyParams}
 
-\begin{DoxyRetVals}{\-Return values}
-{\em \-O\-C\-\_\-\-F\-A\-U\-L\-T} & {\itshape \doxyref{theora\-\_\-state}{p.}{structtheora__state}\/} or {\itshape buf\/} is {\ttfamily \-N\-U\-L\-L}. \\
+\begin{DoxyRetVals}{Return values}
+{\em O\-C\-\_\-\-F\-A\-U\-L\-T} & {\itshape \doxyref{theora\-\_\-state}{p.}{structtheora__state}} or {\itshape buf} is {\ttfamily N\-U\-L\-L}. \\
 \hline
-{\em \-O\-C\-\_\-\-E\-I\-N\-V\-A\-L} & {\itshape buf\-\_\-sz\/} is not {\ttfamily sizeof(int)}. \\
+{\em O\-C\-\_\-\-E\-I\-N\-V\-A\-L} & {\itshape buf\-\_\-sz} is not {\ttfamily sizeof(int)}. \\
 \hline
-{\em \-O\-C\-\_\-\-I\-M\-P\-L} & \-Not supported by this implementation. \\
+{\em O\-C\-\_\-\-I\-M\-P\-L} & Not supported by this implementation. \\
 \hline
 \end{DoxyRetVals}
 
 
-\subsection{\-Typedef \-Documentation}
-\index{\-Legacy pre-\/1.\-0 C A\-P\-I@{\-Legacy pre-\/1.\-0 C A\-P\-I}!theora\-\_\-comment@{theora\-\_\-comment}}
-\index{theora\-\_\-comment@{theora\-\_\-comment}!Legacy pre-1.0 C API@{\-Legacy pre-\/1.\-0 C A\-P\-I}}
+\subsection{Typedef Documentation}
+\index{Legacy pre-\/1.\-0 C A\-P\-I@{Legacy pre-\/1.\-0 C A\-P\-I}!theora\-\_\-comment@{theora\-\_\-comment}}
+\index{theora\-\_\-comment@{theora\-\_\-comment}!Legacy pre-1.0 C API@{Legacy pre-\/1.\-0 C A\-P\-I}}
 \subsubsection[{theora\-\_\-comment}]{\setlength{\rightskip}{0pt plus 5cm}typedef struct {\bf theora\-\_\-comment}  {\bf theora\-\_\-comment}}\label{group__oldfuncs_gaa504e8a56a4bf9c8e44f77d05aef0bb5}
 
 
-\-Comment header metadata. 
+Comment header metadata. 
 
-\-This structure holds the in-\/stream metadata corresponding to the 'comment' header packet.
+This structure holds the in-\/stream metadata corresponding to the 'comment' header packet.
 
-\-Meta data is stored as a series of (tag, value) pairs, in length-\/encoded string vectors. \-The first occurence of the '=' character delimits the tag and value. \-A particular tag may occur more than once. \-The character set encoding for the strings is always \-U\-T\-F-\/8, but the tag names are limited to case-\/insensitive \-A\-S\-C\-I\-I. \-See the spec for details.
+Meta data is stored as a series of (tag, value) pairs, in length-\/encoded string vectors. The first occurence of the '=' character delimits the tag and value. A particular tag may occur more than once. The character set encoding for the strings is always U\-T\-F-\/8, but the tag names are limited to case-\/insensitive A\-S\-C\-I\-I. See the spec for details.
 
-\-In filling in this structure, \doxyref{theora\-\_\-decode\-\_\-header()}{p.}{group__oldfuncs_ga02915e63c1bd733ee291f577a8b75a82} will null-\/terminate the user\-\_\-comment strings for safety. \-However, the bitstream format itself treats them as 8-\/bit clean, and so the length array should be treated as authoritative for their length. 
+In filling in this structure, \doxyref{theora\-\_\-decode\-\_\-header()}{p.}{group__oldfuncs_ga02915e63c1bd733ee291f577a8b75a82} will null-\/terminate the user\-\_\-comment strings for safety. However, the bitstream format itself treats them as 8-\/bit clean, and so the length array should be treated as authoritative for their length. 
 
-\subsection{\-Enumeration \-Type \-Documentation}
-\index{\-Legacy pre-\/1.\-0 C A\-P\-I@{\-Legacy pre-\/1.\-0 C A\-P\-I}!theora\-\_\-colorspace@{theora\-\_\-colorspace}}
-\index{theora\-\_\-colorspace@{theora\-\_\-colorspace}!Legacy pre-1.0 C API@{\-Legacy pre-\/1.\-0 C A\-P\-I}}
+\subsection{Enumeration Type Documentation}
+\index{Legacy pre-\/1.\-0 C A\-P\-I@{Legacy pre-\/1.\-0 C A\-P\-I}!theora\-\_\-colorspace@{theora\-\_\-colorspace}}
+\index{theora\-\_\-colorspace@{theora\-\_\-colorspace}!Legacy pre-1.0 C API@{Legacy pre-\/1.\-0 C A\-P\-I}}
 \subsubsection[{theora\-\_\-colorspace}]{\setlength{\rightskip}{0pt plus 5cm}enum {\bf theora\-\_\-colorspace}}\label{group__oldfuncs_gaa567da4ce591f7373149ce3ef3acdac9}
 
 
-\-A \-Colorspace. 
+A Colorspace. 
 
 \begin{Desc}
-\item[\-Enumerator\-: ]\par
+\item[Enumerator\-: ]\par
 \begin{description}
-\index{\-O\-C\-\_\-\-C\-S\-\_\-\-U\-N\-S\-P\-E\-C\-I\-F\-I\-E\-D@{\-O\-C\-\_\-\-C\-S\-\_\-\-U\-N\-S\-P\-E\-C\-I\-F\-I\-E\-D}!\-Legacy pre-\/1.\-0 C A\-P\-I@{\-Legacy pre-\/1.\-0 C A\-P\-I}}\index{\-Legacy pre-\/1.\-0 C A\-P\-I@{\-Legacy pre-\/1.\-0 C A\-P\-I}!\-O\-C\-\_\-\-C\-S\-\_\-\-U\-N\-S\-P\-E\-C\-I\-F\-I\-E\-D@{\-O\-C\-\_\-\-C\-S\-\_\-\-U\-N\-S\-P\-E\-C\-I\-F\-I\-E\-D}}\item[{\em 
-\-O\-C\-\_\-\-C\-S\-\_\-\-U\-N\-S\-P\-E\-C\-I\-F\-I\-E\-D\label{group__oldfuncs_ggaa567da4ce591f7373149ce3ef3acdac9abf217cf83d7d7cbf73295e6689f5cf5f}
-}]\-The colorspace is unknown or unspecified. \index{\-O\-C\-\_\-\-C\-S\-\_\-\-I\-T\-U\-\_\-\-R\-E\-C\-\_\-470\-M@{\-O\-C\-\_\-\-C\-S\-\_\-\-I\-T\-U\-\_\-\-R\-E\-C\-\_\-470\-M}!\-Legacy pre-\/1.\-0 C A\-P\-I@{\-Legacy pre-\/1.\-0 C A\-P\-I}}\index{\-Legacy pre-\/1.\-0 C A\-P\-I@{\-Legacy pre-\/1.\-0 C A\-P\-I}!\-O\-C\-\_\-\-C\-S\-\_\-\-I\-T\-U\-\_\-\-R\-E\-C\-\_\-470\-M@{\-O\-C\-\_\-\-C\-S\-\_\-\-I\-T\-U\-\_\-\-R\-E\-C\-\_\-470\-M}}\item[{\em 
-\-O\-C\-\_\-\-C\-S\-\_\-\-I\-T\-U\-\_\-\-R\-E\-C\-\_\-470\-M\label{group__oldfuncs_ggaa567da4ce591f7373149ce3ef3acdac9ab20c9851a21ab148fef0bf2c00c0a294}
-}]\-This is the best option for '\-N\-T\-S\-C' content. \index{\-O\-C\-\_\-\-C\-S\-\_\-\-I\-T\-U\-\_\-\-R\-E\-C\-\_\-470\-B\-G@{\-O\-C\-\_\-\-C\-S\-\_\-\-I\-T\-U\-\_\-\-R\-E\-C\-\_\-470\-B\-G}!\-Legacy pre-\/1.\-0 C A\-P\-I@{\-Legacy pre-\/1.\-0 C A\-P\-I}}\index{\-Legacy pre-\/1.\-0 C A\-P\-I@{\-Legacy pre-\/1.\-0 C A\-P\-I}!\-O\-C\-\_\-\-C\-S\-\_\-\-I\-T\-U\-\_\-\-R\-E\-C\-\_\-470\-B\-G@{\-O\-C\-\_\-\-C\-S\-\_\-\-I\-T\-U\-\_\-\-R\-E\-C\-\_\-470\-B\-G}}\item[{\em 
-\-O\-C\-\_\-\-C\-S\-\_\-\-I\-T\-U\-\_\-\-R\-E\-C\-\_\-470\-B\-G\label{group__oldfuncs_ggaa567da4ce591f7373149ce3ef3acdac9a04f8fa2da26f9ec513f514163705666a}
-}]\-This is the best option for '\-P\-A\-L' content. \index{\-O\-C\-\_\-\-C\-S\-\_\-\-N\-S\-P\-A\-C\-E\-S@{\-O\-C\-\_\-\-C\-S\-\_\-\-N\-S\-P\-A\-C\-E\-S}!\-Legacy pre-\/1.\-0 C A\-P\-I@{\-Legacy pre-\/1.\-0 C A\-P\-I}}\index{\-Legacy pre-\/1.\-0 C A\-P\-I@{\-Legacy pre-\/1.\-0 C A\-P\-I}!\-O\-C\-\_\-\-C\-S\-\_\-\-N\-S\-P\-A\-C\-E\-S@{\-O\-C\-\_\-\-C\-S\-\_\-\-N\-S\-P\-A\-C\-E\-S}}\item[{\em 
-\-O\-C\-\_\-\-C\-S\-\_\-\-N\-S\-P\-A\-C\-E\-S\label{group__oldfuncs_ggaa567da4ce591f7373149ce3ef3acdac9a640b572f11fa7102d434e1c605aaa186}
-}]\-This marks the end of the defined colorspaces. \end{description}
+\index{O\-C\-\_\-\-C\-S\-\_\-\-U\-N\-S\-P\-E\-C\-I\-F\-I\-E\-D@{O\-C\-\_\-\-C\-S\-\_\-\-U\-N\-S\-P\-E\-C\-I\-F\-I\-E\-D}!Legacy pre-\/1.\-0 C A\-P\-I@{Legacy pre-\/1.\-0 C A\-P\-I}}\index{Legacy pre-\/1.\-0 C A\-P\-I@{Legacy pre-\/1.\-0 C A\-P\-I}!O\-C\-\_\-\-C\-S\-\_\-\-U\-N\-S\-P\-E\-C\-I\-F\-I\-E\-D@{O\-C\-\_\-\-C\-S\-\_\-\-U\-N\-S\-P\-E\-C\-I\-F\-I\-E\-D}}\item[{\em 
+O\-C\-\_\-\-C\-S\-\_\-\-U\-N\-S\-P\-E\-C\-I\-F\-I\-E\-D\label{group__oldfuncs_ggaa567da4ce591f7373149ce3ef3acdac9abf217cf83d7d7cbf73295e6689f5cf5f}
+}]The colorspace is unknown or unspecified. \index{O\-C\-\_\-\-C\-S\-\_\-\-I\-T\-U\-\_\-\-R\-E\-C\-\_\-470\-M@{O\-C\-\_\-\-C\-S\-\_\-\-I\-T\-U\-\_\-\-R\-E\-C\-\_\-470\-M}!Legacy pre-\/1.\-0 C A\-P\-I@{Legacy pre-\/1.\-0 C A\-P\-I}}\index{Legacy pre-\/1.\-0 C A\-P\-I@{Legacy pre-\/1.\-0 C A\-P\-I}!O\-C\-\_\-\-C\-S\-\_\-\-I\-T\-U\-\_\-\-R\-E\-C\-\_\-470\-M@{O\-C\-\_\-\-C\-S\-\_\-\-I\-T\-U\-\_\-\-R\-E\-C\-\_\-470\-M}}\item[{\em 
+O\-C\-\_\-\-C\-S\-\_\-\-I\-T\-U\-\_\-\-R\-E\-C\-\_\-470\-M\label{group__oldfuncs_ggaa567da4ce591f7373149ce3ef3acdac9ab20c9851a21ab148fef0bf2c00c0a294}
+}]This is the best option for 'N\-T\-S\-C' content. \index{O\-C\-\_\-\-C\-S\-\_\-\-I\-T\-U\-\_\-\-R\-E\-C\-\_\-470\-B\-G@{O\-C\-\_\-\-C\-S\-\_\-\-I\-T\-U\-\_\-\-R\-E\-C\-\_\-470\-B\-G}!Legacy pre-\/1.\-0 C A\-P\-I@{Legacy pre-\/1.\-0 C A\-P\-I}}\index{Legacy pre-\/1.\-0 C A\-P\-I@{Legacy pre-\/1.\-0 C A\-P\-I}!O\-C\-\_\-\-C\-S\-\_\-\-I\-T\-U\-\_\-\-R\-E\-C\-\_\-470\-B\-G@{O\-C\-\_\-\-C\-S\-\_\-\-I\-T\-U\-\_\-\-R\-E\-C\-\_\-470\-B\-G}}\item[{\em 
+O\-C\-\_\-\-C\-S\-\_\-\-I\-T\-U\-\_\-\-R\-E\-C\-\_\-470\-B\-G\label{group__oldfuncs_ggaa567da4ce591f7373149ce3ef3acdac9a04f8fa2da26f9ec513f514163705666a}
+}]This is the best option for 'P\-A\-L' content. \index{O\-C\-\_\-\-C\-S\-\_\-\-N\-S\-P\-A\-C\-E\-S@{O\-C\-\_\-\-C\-S\-\_\-\-N\-S\-P\-A\-C\-E\-S}!Legacy pre-\/1.\-0 C A\-P\-I@{Legacy pre-\/1.\-0 C A\-P\-I}}\index{Legacy pre-\/1.\-0 C A\-P\-I@{Legacy pre-\/1.\-0 C A\-P\-I}!O\-C\-\_\-\-C\-S\-\_\-\-N\-S\-P\-A\-C\-E\-S@{O\-C\-\_\-\-C\-S\-\_\-\-N\-S\-P\-A\-C\-E\-S}}\item[{\em 
+O\-C\-\_\-\-C\-S\-\_\-\-N\-S\-P\-A\-C\-E\-S\label{group__oldfuncs_ggaa567da4ce591f7373149ce3ef3acdac9a640b572f11fa7102d434e1c605aaa186}
+}]This marks the end of the defined colorspaces. \end{description}
 \end{Desc}
 
-\index{\-Legacy pre-\/1.\-0 C A\-P\-I@{\-Legacy pre-\/1.\-0 C A\-P\-I}!theora\-\_\-pixelformat@{theora\-\_\-pixelformat}}
-\index{theora\-\_\-pixelformat@{theora\-\_\-pixelformat}!Legacy pre-1.0 C API@{\-Legacy pre-\/1.\-0 C A\-P\-I}}
+\index{Legacy pre-\/1.\-0 C A\-P\-I@{Legacy pre-\/1.\-0 C A\-P\-I}!theora\-\_\-pixelformat@{theora\-\_\-pixelformat}}
+\index{theora\-\_\-pixelformat@{theora\-\_\-pixelformat}!Legacy pre-1.0 C API@{Legacy pre-\/1.\-0 C A\-P\-I}}
 \subsubsection[{theora\-\_\-pixelformat}]{\setlength{\rightskip}{0pt plus 5cm}enum {\bf theora\-\_\-pixelformat}}\label{group__oldfuncs_gae169da05bfaaf4e964a6866552d45079}
 
 
-\-A \-Chroma subsampling. 
+A Chroma subsampling. 
 
-\-These enumerate the available chroma subsampling options supported by the theora format. \-See \-Section 4.\-4 of the specification for exact definitions. \begin{Desc}
-\item[\-Enumerator\-: ]\par
+These enumerate the available chroma subsampling options supported by the theora format. See Section 4.\-4 of the specification for exact definitions. \begin{Desc}
+\item[Enumerator\-: ]\par
 \begin{description}
-\index{\-O\-C\-\_\-\-P\-F\-\_\-420@{\-O\-C\-\_\-\-P\-F\-\_\-420}!\-Legacy pre-\/1.\-0 C A\-P\-I@{\-Legacy pre-\/1.\-0 C A\-P\-I}}\index{\-Legacy pre-\/1.\-0 C A\-P\-I@{\-Legacy pre-\/1.\-0 C A\-P\-I}!\-O\-C\-\_\-\-P\-F\-\_\-420@{\-O\-C\-\_\-\-P\-F\-\_\-420}}\item[{\em 
-\-O\-C\-\_\-\-P\-F\-\_\-420\label{group__oldfuncs_ggae169da05bfaaf4e964a6866552d45079a4e451af01be2645511b0e431f5225d2b}
-}]\-Chroma subsampling by 2 in each direction (4\-:2\-:0) \index{\-O\-C\-\_\-\-P\-F\-\_\-\-R\-S\-V\-D@{\-O\-C\-\_\-\-P\-F\-\_\-\-R\-S\-V\-D}!\-Legacy pre-\/1.\-0 C A\-P\-I@{\-Legacy pre-\/1.\-0 C A\-P\-I}}\index{\-Legacy pre-\/1.\-0 C A\-P\-I@{\-Legacy pre-\/1.\-0 C A\-P\-I}!\-O\-C\-\_\-\-P\-F\-\_\-\-R\-S\-V\-D@{\-O\-C\-\_\-\-P\-F\-\_\-\-R\-S\-V\-D}}\item[{\em 
-\-O\-C\-\_\-\-P\-F\-\_\-\-R\-S\-V\-D\label{group__oldfuncs_ggae169da05bfaaf4e964a6866552d45079a7d21c63341ad299766839c83ed1216eb}
-}]\-Reserved value. \index{\-O\-C\-\_\-\-P\-F\-\_\-422@{\-O\-C\-\_\-\-P\-F\-\_\-422}!\-Legacy pre-\/1.\-0 C A\-P\-I@{\-Legacy pre-\/1.\-0 C A\-P\-I}}\index{\-Legacy pre-\/1.\-0 C A\-P\-I@{\-Legacy pre-\/1.\-0 C A\-P\-I}!\-O\-C\-\_\-\-P\-F\-\_\-422@{\-O\-C\-\_\-\-P\-F\-\_\-422}}\item[{\em 
-\-O\-C\-\_\-\-P\-F\-\_\-422\label{group__oldfuncs_ggae169da05bfaaf4e964a6866552d45079a36a88c55b7ddd5aedeac2d61d57fee5b}
-}]\-Horizonatal chroma subsampling by 2 (4\-:2\-:2) \index{\-O\-C\-\_\-\-P\-F\-\_\-444@{\-O\-C\-\_\-\-P\-F\-\_\-444}!\-Legacy pre-\/1.\-0 C A\-P\-I@{\-Legacy pre-\/1.\-0 C A\-P\-I}}\index{\-Legacy pre-\/1.\-0 C A\-P\-I@{\-Legacy pre-\/1.\-0 C A\-P\-I}!\-O\-C\-\_\-\-P\-F\-\_\-444@{\-O\-C\-\_\-\-P\-F\-\_\-444}}\item[{\em 
-\-O\-C\-\_\-\-P\-F\-\_\-444\label{group__oldfuncs_ggae169da05bfaaf4e964a6866552d45079a1d5c6d1b0365e06b4a87880b7825f044}
-}]\-No chroma subsampling at all (4\-:4\-:4) \end{description}
+\index{O\-C\-\_\-\-P\-F\-\_\-420@{O\-C\-\_\-\-P\-F\-\_\-420}!Legacy pre-\/1.\-0 C A\-P\-I@{Legacy pre-\/1.\-0 C A\-P\-I}}\index{Legacy pre-\/1.\-0 C A\-P\-I@{Legacy pre-\/1.\-0 C A\-P\-I}!O\-C\-\_\-\-P\-F\-\_\-420@{O\-C\-\_\-\-P\-F\-\_\-420}}\item[{\em 
+O\-C\-\_\-\-P\-F\-\_\-420\label{group__oldfuncs_ggae169da05bfaaf4e964a6866552d45079a4e451af01be2645511b0e431f5225d2b}
+}]Chroma subsampling by 2 in each direction (4\-:2\-:0) \index{O\-C\-\_\-\-P\-F\-\_\-\-R\-S\-V\-D@{O\-C\-\_\-\-P\-F\-\_\-\-R\-S\-V\-D}!Legacy pre-\/1.\-0 C A\-P\-I@{Legacy pre-\/1.\-0 C A\-P\-I}}\index{Legacy pre-\/1.\-0 C A\-P\-I@{Legacy pre-\/1.\-0 C A\-P\-I}!O\-C\-\_\-\-P\-F\-\_\-\-R\-S\-V\-D@{O\-C\-\_\-\-P\-F\-\_\-\-R\-S\-V\-D}}\item[{\em 
+O\-C\-\_\-\-P\-F\-\_\-\-R\-S\-V\-D\label{group__oldfuncs_ggae169da05bfaaf4e964a6866552d45079a7d21c63341ad299766839c83ed1216eb}
+}]Reserved value. \index{O\-C\-\_\-\-P\-F\-\_\-422@{O\-C\-\_\-\-P\-F\-\_\-422}!Legacy pre-\/1.\-0 C A\-P\-I@{Legacy pre-\/1.\-0 C A\-P\-I}}\index{Legacy pre-\/1.\-0 C A\-P\-I@{Legacy pre-\/1.\-0 C A\-P\-I}!O\-C\-\_\-\-P\-F\-\_\-422@{O\-C\-\_\-\-P\-F\-\_\-422}}\item[{\em 
+O\-C\-\_\-\-P\-F\-\_\-422\label{group__oldfuncs_ggae169da05bfaaf4e964a6866552d45079a36a88c55b7ddd5aedeac2d61d57fee5b}
+}]Horizonatal chroma subsampling by 2 (4\-:2\-:2) \index{O\-C\-\_\-\-P\-F\-\_\-444@{O\-C\-\_\-\-P\-F\-\_\-444}!Legacy pre-\/1.\-0 C A\-P\-I@{Legacy pre-\/1.\-0 C A\-P\-I}}\index{Legacy pre-\/1.\-0 C A\-P\-I@{Legacy pre-\/1.\-0 C A\-P\-I}!O\-C\-\_\-\-P\-F\-\_\-444@{O\-C\-\_\-\-P\-F\-\_\-444}}\item[{\em 
+O\-C\-\_\-\-P\-F\-\_\-444\label{group__oldfuncs_ggae169da05bfaaf4e964a6866552d45079a1d5c6d1b0365e06b4a87880b7825f044}
+}]No chroma subsampling at all (4\-:4\-:4) \end{description}
 \end{Desc}
 
 
 
-\subsection{\-Function \-Documentation}
-\index{\-Legacy pre-\/1.\-0 C A\-P\-I@{\-Legacy pre-\/1.\-0 C A\-P\-I}!theora\-\_\-clear@{theora\-\_\-clear}}
-\index{theora\-\_\-clear@{theora\-\_\-clear}!Legacy pre-1.0 C API@{\-Legacy pre-\/1.\-0 C A\-P\-I}}
-\subsubsection[{theora\-\_\-clear}]{\setlength{\rightskip}{0pt plus 5cm}void {\bf theora\-\_\-clear} (
+\subsection{Function Documentation}
+\index{Legacy pre-\/1.\-0 C A\-P\-I@{Legacy pre-\/1.\-0 C A\-P\-I}!theora\-\_\-clear@{theora\-\_\-clear}}
+\index{theora\-\_\-clear@{theora\-\_\-clear}!Legacy pre-1.0 C API@{Legacy pre-\/1.\-0 C A\-P\-I}}
+\subsubsection[{theora\-\_\-clear}]{\setlength{\rightskip}{0pt plus 5cm}void theora\-\_\-clear (
 \begin{DoxyParamCaption}
 \item[{{\bf theora\-\_\-state} $\ast$}]{t}
 \end{DoxyParamCaption}
 )}\label{group__oldfuncs_gab252d5d81b925136dda72e8f1c09c5eb}
 
 
-\-Free all internal data associated with a \doxyref{theora\-\_\-state}{p.}{structtheora__state} handle. 
+Free all internal data associated with a \doxyref{theora\-\_\-state}{p.}{structtheora__state} handle. 
 
 
-\begin{DoxyParams}{\-Parameters}
-{\em t} & \-A \doxyref{theora\-\_\-state}{p.}{structtheora__state} handle. \\
+\begin{DoxyParams}{Parameters}
+{\em t} & A \doxyref{theora\-\_\-state}{p.}{structtheora__state} handle. \\
 \hline
 \end{DoxyParams}
-\index{\-Legacy pre-\/1.\-0 C A\-P\-I@{\-Legacy pre-\/1.\-0 C A\-P\-I}!theora\-\_\-comment\-\_\-add@{theora\-\_\-comment\-\_\-add}}
-\index{theora\-\_\-comment\-\_\-add@{theora\-\_\-comment\-\_\-add}!Legacy pre-1.0 C API@{\-Legacy pre-\/1.\-0 C A\-P\-I}}
-\subsubsection[{theora\-\_\-comment\-\_\-add}]{\setlength{\rightskip}{0pt plus 5cm}void {\bf theora\-\_\-comment\-\_\-add} (
+\index{Legacy pre-\/1.\-0 C A\-P\-I@{Legacy pre-\/1.\-0 C A\-P\-I}!theora\-\_\-comment\-\_\-add@{theora\-\_\-comment\-\_\-add}}
+\index{theora\-\_\-comment\-\_\-add@{theora\-\_\-comment\-\_\-add}!Legacy pre-1.0 C API@{Legacy pre-\/1.\-0 C A\-P\-I}}
+\subsubsection[{theora\-\_\-comment\-\_\-add}]{\setlength{\rightskip}{0pt plus 5cm}void theora\-\_\-comment\-\_\-add (
 \begin{DoxyParamCaption}
 \item[{{\bf theora\-\_\-comment} $\ast$}]{tc, }
 \item[{char $\ast$}]{comment}
@@ -437,18 +440,18 @@ int {\bf theora\-\_\-control} ({\bf theora\-\_\-state} $\ast$th, int req, void $
 )}\label{group__oldfuncs_ga650642ed23894e41109bbc42ec393ed4}
 
 
-\-Add a comment to an initialized \doxyref{theora\-\_\-comment}{p.}{structtheora__comment} structure. 
+Add a comment to an initialized \doxyref{theora\-\_\-comment}{p.}{structtheora__comment} structure. 
 
 
-\begin{DoxyParams}{\-Parameters}
-{\em tc} & \-A previously initialized theora comment structure \\
+\begin{DoxyParams}{Parameters}
+{\em tc} & A previously initialized theora comment structure \\
 \hline
-{\em comment} & \-A null-\/terminated string encoding the comment in the form \char`\"{}\-T\-A\-G=the value\char`\"{}\\
+{\em comment} & A null-\/terminated string encoding the comment in the form \char`\"{}\-T\-A\-G=the value\char`\"{}\\
 \hline
 \end{DoxyParams}
-\-Neither \doxyref{theora\-\_\-comment\-\_\-add()}{p.}{group__oldfuncs_ga650642ed23894e41109bbc42ec393ed4} nor \doxyref{theora\-\_\-comment\-\_\-add\-\_\-tag()}{p.}{group__oldfuncs_ga339bd80b5bf4bb168b7052d8ec0b5a92} support comments containing null values, although the bitstream format supports this. \-To add such comments you will need to manipulate the \doxyref{theora\-\_\-comment}{p.}{structtheora__comment} structure directly. \index{\-Legacy pre-\/1.\-0 C A\-P\-I@{\-Legacy pre-\/1.\-0 C A\-P\-I}!theora\-\_\-comment\-\_\-add\-\_\-tag@{theora\-\_\-comment\-\_\-add\-\_\-tag}}
-\index{theora\-\_\-comment\-\_\-add\-\_\-tag@{theora\-\_\-comment\-\_\-add\-\_\-tag}!Legacy pre-1.0 C API@{\-Legacy pre-\/1.\-0 C A\-P\-I}}
-\subsubsection[{theora\-\_\-comment\-\_\-add\-\_\-tag}]{\setlength{\rightskip}{0pt plus 5cm}void {\bf theora\-\_\-comment\-\_\-add\-\_\-tag} (
+Neither \doxyref{theora\-\_\-comment\-\_\-add()}{p.}{group__oldfuncs_ga650642ed23894e41109bbc42ec393ed4} nor \doxyref{theora\-\_\-comment\-\_\-add\-\_\-tag()}{p.}{group__oldfuncs_ga339bd80b5bf4bb168b7052d8ec0b5a92} support comments containing null values, although the bitstream format supports this. To add such comments you will need to manipulate the \doxyref{theora\-\_\-comment}{p.}{structtheora__comment} structure directly. \index{Legacy pre-\/1.\-0 C A\-P\-I@{Legacy pre-\/1.\-0 C A\-P\-I}!theora\-\_\-comment\-\_\-add\-\_\-tag@{theora\-\_\-comment\-\_\-add\-\_\-tag}}
+\index{theora\-\_\-comment\-\_\-add\-\_\-tag@{theora\-\_\-comment\-\_\-add\-\_\-tag}!Legacy pre-1.0 C API@{Legacy pre-\/1.\-0 C A\-P\-I}}
+\subsubsection[{theora\-\_\-comment\-\_\-add\-\_\-tag}]{\setlength{\rightskip}{0pt plus 5cm}void theora\-\_\-comment\-\_\-add\-\_\-tag (
 \begin{DoxyParamCaption}
 \item[{{\bf theora\-\_\-comment} $\ast$}]{tc, }
 \item[{char $\ast$}]{tag, }
@@ -457,52 +460,52 @@ int {\bf theora\-\_\-control} ({\bf theora\-\_\-state} $\ast$th, int req, void $
 )}\label{group__oldfuncs_ga339bd80b5bf4bb168b7052d8ec0b5a92}
 
 
-\-Add a comment to an initialized \doxyref{theora\-\_\-comment}{p.}{structtheora__comment} structure. 
+Add a comment to an initialized \doxyref{theora\-\_\-comment}{p.}{structtheora__comment} structure. 
 
 
-\begin{DoxyParams}{\-Parameters}
-{\em tc} & \-A previously initialized theora comment structure \\
+\begin{DoxyParams}{Parameters}
+{\em tc} & A previously initialized theora comment structure \\
 \hline
-{\em tag} & \-A null-\/terminated string containing the tag associated with the comment. \\
+{\em tag} & A null-\/terminated string containing the tag associated with the comment. \\
 \hline
-{\em value} & \-The corresponding value as a null-\/terminated string\\
+{\em value} & The corresponding value as a null-\/terminated string\\
 \hline
 \end{DoxyParams}
-\-Neither \doxyref{theora\-\_\-comment\-\_\-add()}{p.}{group__oldfuncs_ga650642ed23894e41109bbc42ec393ed4} nor \doxyref{theora\-\_\-comment\-\_\-add\-\_\-tag()}{p.}{group__oldfuncs_ga339bd80b5bf4bb168b7052d8ec0b5a92} support comments containing null values, although the bitstream format supports this. \-To add such comments you will need to manipulate the \doxyref{theora\-\_\-comment}{p.}{structtheora__comment} structure directly. \index{\-Legacy pre-\/1.\-0 C A\-P\-I@{\-Legacy pre-\/1.\-0 C A\-P\-I}!theora\-\_\-comment\-\_\-clear@{theora\-\_\-comment\-\_\-clear}}
-\index{theora\-\_\-comment\-\_\-clear@{theora\-\_\-comment\-\_\-clear}!Legacy pre-1.0 C API@{\-Legacy pre-\/1.\-0 C A\-P\-I}}
-\subsubsection[{theora\-\_\-comment\-\_\-clear}]{\setlength{\rightskip}{0pt plus 5cm}void {\bf theora\-\_\-comment\-\_\-clear} (
+Neither \doxyref{theora\-\_\-comment\-\_\-add()}{p.}{group__oldfuncs_ga650642ed23894e41109bbc42ec393ed4} nor \doxyref{theora\-\_\-comment\-\_\-add\-\_\-tag()}{p.}{group__oldfuncs_ga339bd80b5bf4bb168b7052d8ec0b5a92} support comments containing null values, although the bitstream format supports this. To add such comments you will need to manipulate the \doxyref{theora\-\_\-comment}{p.}{structtheora__comment} structure directly. \index{Legacy pre-\/1.\-0 C A\-P\-I@{Legacy pre-\/1.\-0 C A\-P\-I}!theora\-\_\-comment\-\_\-clear@{theora\-\_\-comment\-\_\-clear}}
+\index{theora\-\_\-comment\-\_\-clear@{theora\-\_\-comment\-\_\-clear}!Legacy pre-1.0 C API@{Legacy pre-\/1.\-0 C A\-P\-I}}
+\subsubsection[{theora\-\_\-comment\-\_\-clear}]{\setlength{\rightskip}{0pt plus 5cm}void theora\-\_\-comment\-\_\-clear (
 \begin{DoxyParamCaption}
 \item[{{\bf theora\-\_\-comment} $\ast$}]{tc}
 \end{DoxyParamCaption}
 )}\label{group__oldfuncs_ga04c07c2eefba3a433e43f9fbde14719f}
 
 
-\-Clear an allocated \doxyref{theora\-\_\-comment}{p.}{structtheora__comment} struct so that it can be freed. 
+Clear an allocated \doxyref{theora\-\_\-comment}{p.}{structtheora__comment} struct so that it can be freed. 
 
 
-\begin{DoxyParams}{\-Parameters}
-{\em tc} & \-An allocated \doxyref{theora\-\_\-comment}{p.}{structtheora__comment} structure. \\
+\begin{DoxyParams}{Parameters}
+{\em tc} & An allocated \doxyref{theora\-\_\-comment}{p.}{structtheora__comment} structure. \\
 \hline
 \end{DoxyParams}
-\index{\-Legacy pre-\/1.\-0 C A\-P\-I@{\-Legacy pre-\/1.\-0 C A\-P\-I}!theora\-\_\-comment\-\_\-init@{theora\-\_\-comment\-\_\-init}}
-\index{theora\-\_\-comment\-\_\-init@{theora\-\_\-comment\-\_\-init}!Legacy pre-1.0 C API@{\-Legacy pre-\/1.\-0 C A\-P\-I}}
-\subsubsection[{theora\-\_\-comment\-\_\-init}]{\setlength{\rightskip}{0pt plus 5cm}void {\bf theora\-\_\-comment\-\_\-init} (
+\index{Legacy pre-\/1.\-0 C A\-P\-I@{Legacy pre-\/1.\-0 C A\-P\-I}!theora\-\_\-comment\-\_\-init@{theora\-\_\-comment\-\_\-init}}
+\index{theora\-\_\-comment\-\_\-init@{theora\-\_\-comment\-\_\-init}!Legacy pre-1.0 C API@{Legacy pre-\/1.\-0 C A\-P\-I}}
+\subsubsection[{theora\-\_\-comment\-\_\-init}]{\setlength{\rightskip}{0pt plus 5cm}void theora\-\_\-comment\-\_\-init (
 \begin{DoxyParamCaption}
 \item[{{\bf theora\-\_\-comment} $\ast$}]{tc}
 \end{DoxyParamCaption}
 )}\label{group__oldfuncs_ga811b92785df3bdbbebb3de612d9d6ce0}
 
 
-\-Initialize an allocated \doxyref{theora\-\_\-comment}{p.}{structtheora__comment} structure. 
+Initialize an allocated \doxyref{theora\-\_\-comment}{p.}{structtheora__comment} structure. 
 
 
-\begin{DoxyParams}{\-Parameters}
-{\em tc} & \-An allocated \doxyref{theora\-\_\-comment}{p.}{structtheora__comment} structure \\
+\begin{DoxyParams}{Parameters}
+{\em tc} & An allocated \doxyref{theora\-\_\-comment}{p.}{structtheora__comment} structure \\
 \hline
 \end{DoxyParams}
-\index{\-Legacy pre-\/1.\-0 C A\-P\-I@{\-Legacy pre-\/1.\-0 C A\-P\-I}!theora\-\_\-comment\-\_\-query@{theora\-\_\-comment\-\_\-query}}
-\index{theora\-\_\-comment\-\_\-query@{theora\-\_\-comment\-\_\-query}!Legacy pre-1.0 C API@{\-Legacy pre-\/1.\-0 C A\-P\-I}}
-\subsubsection[{theora\-\_\-comment\-\_\-query}]{\setlength{\rightskip}{0pt plus 5cm}char$\ast$ {\bf theora\-\_\-comment\-\_\-query} (
+\index{Legacy pre-\/1.\-0 C A\-P\-I@{Legacy pre-\/1.\-0 C A\-P\-I}!theora\-\_\-comment\-\_\-query@{theora\-\_\-comment\-\_\-query}}
+\index{theora\-\_\-comment\-\_\-query@{theora\-\_\-comment\-\_\-query}!Legacy pre-1.0 C API@{Legacy pre-\/1.\-0 C A\-P\-I}}
+\subsubsection[{theora\-\_\-comment\-\_\-query}]{\setlength{\rightskip}{0pt plus 5cm}char$\ast$ theora\-\_\-comment\-\_\-query (
 \begin{DoxyParamCaption}
 \item[{{\bf theora\-\_\-comment} $\ast$}]{tc, }
 \item[{char $\ast$}]{tag, }
@@ -511,31 +514,31 @@ int {\bf theora\-\_\-control} ({\bf theora\-\_\-state} $\ast$th, int req, void $
 )}\label{group__oldfuncs_ga4361f6001abb5c83c36a2ddfb648a8dc}
 
 
-\-Look up a comment value by tag. 
+Look up a comment value by tag. 
 
 
-\begin{DoxyParams}{\-Parameters}
-{\em tc} & \-Tn initialized \doxyref{theora\-\_\-comment}{p.}{structtheora__comment} structure \\
+\begin{DoxyParams}{Parameters}
+{\em tc} & Tn initialized \doxyref{theora\-\_\-comment}{p.}{structtheora__comment} structure \\
 \hline
-{\em tag} & \-The tag to look up \\
+{\em tag} & The tag to look up \\
 \hline
-{\em count} & \-The instance of the tag. \-The same tag can appear multiple times, each with a distinct and ordered value, so an index is required to retrieve them all. \\
+{\em count} & The instance of the tag. The same tag can appear multiple times, each with a distinct and ordered value, so an index is required to retrieve them all. \\
 \hline
 \end{DoxyParams}
-\begin{DoxyReturn}{\-Returns}
-\-A pointer to the queried tag's value 
+\begin{DoxyReturn}{Returns}
+A pointer to the queried tag's value 
 \end{DoxyReturn}
 
-\begin{DoxyRetVals}{\-Return values}
-{\em \-N\-U\-L\-L} & \-No matching tag is found\\
+\begin{DoxyRetVals}{Return values}
+{\em N\-U\-L\-L} & No matching tag is found\\
 \hline
 \end{DoxyRetVals}
-\begin{DoxyNote}{\-Note}
-\-Use \doxyref{theora\-\_\-comment\-\_\-query\-\_\-count()}{p.}{group__oldfuncs_ga10f66a3c752442a3e0c0098e0f88df8b} to get the legal range for the count parameter. 
+\begin{DoxyNote}{Note}
+Use \doxyref{theora\-\_\-comment\-\_\-query\-\_\-count()}{p.}{group__oldfuncs_ga10f66a3c752442a3e0c0098e0f88df8b} to get the legal range for the count parameter. 
 \end{DoxyNote}
-\index{\-Legacy pre-\/1.\-0 C A\-P\-I@{\-Legacy pre-\/1.\-0 C A\-P\-I}!theora\-\_\-comment\-\_\-query\-\_\-count@{theora\-\_\-comment\-\_\-query\-\_\-count}}
-\index{theora\-\_\-comment\-\_\-query\-\_\-count@{theora\-\_\-comment\-\_\-query\-\_\-count}!Legacy pre-1.0 C API@{\-Legacy pre-\/1.\-0 C A\-P\-I}}
-\subsubsection[{theora\-\_\-comment\-\_\-query\-\_\-count}]{\setlength{\rightskip}{0pt plus 5cm}int {\bf theora\-\_\-comment\-\_\-query\-\_\-count} (
+\index{Legacy pre-\/1.\-0 C A\-P\-I@{Legacy pre-\/1.\-0 C A\-P\-I}!theora\-\_\-comment\-\_\-query\-\_\-count@{theora\-\_\-comment\-\_\-query\-\_\-count}}
+\index{theora\-\_\-comment\-\_\-query\-\_\-count@{theora\-\_\-comment\-\_\-query\-\_\-count}!Legacy pre-1.0 C API@{Legacy pre-\/1.\-0 C A\-P\-I}}
+\subsubsection[{theora\-\_\-comment\-\_\-query\-\_\-count}]{\setlength{\rightskip}{0pt plus 5cm}int theora\-\_\-comment\-\_\-query\-\_\-count (
 \begin{DoxyParamCaption}
 \item[{{\bf theora\-\_\-comment} $\ast$}]{tc, }
 \item[{char $\ast$}]{tag}
@@ -543,21 +546,21 @@ int {\bf theora\-\_\-control} ({\bf theora\-\_\-state} $\ast$th, int req, void $
 )}\label{group__oldfuncs_ga10f66a3c752442a3e0c0098e0f88df8b}
 
 
-\-Look up the number of instances of a tag. 
+Look up the number of instances of a tag. 
 
 
-\begin{DoxyParams}{\-Parameters}
-{\em tc} & \-An initialized \doxyref{theora\-\_\-comment}{p.}{structtheora__comment} structure \\
+\begin{DoxyParams}{Parameters}
+{\em tc} & An initialized \doxyref{theora\-\_\-comment}{p.}{structtheora__comment} structure \\
 \hline
-{\em tag} & \-The tag to look up \\
+{\em tag} & The tag to look up \\
 \hline
 \end{DoxyParams}
-\begin{DoxyReturn}{\-Returns}
-\-The number on instances of a particular tag.
+\begin{DoxyReturn}{Returns}
+The number on instances of a particular tag.
 \end{DoxyReturn}
-\-Call this first when querying for a specific tag and then interate over the number of instances with separate calls to \doxyref{theora\-\_\-comment\-\_\-query()}{p.}{group__oldfuncs_ga4361f6001abb5c83c36a2ddfb648a8dc} to retrieve all instances in order. \index{\-Legacy pre-\/1.\-0 C A\-P\-I@{\-Legacy pre-\/1.\-0 C A\-P\-I}!theora\-\_\-control@{theora\-\_\-control}}
-\index{theora\-\_\-control@{theora\-\_\-control}!Legacy pre-1.0 C API@{\-Legacy pre-\/1.\-0 C A\-P\-I}}
-\subsubsection[{theora\-\_\-control}]{\setlength{\rightskip}{0pt plus 5cm}int {\bf theora\-\_\-control} (
+Call this first when querying for a specific tag and then interate over the number of instances with separate calls to \doxyref{theora\-\_\-comment\-\_\-query()}{p.}{group__oldfuncs_ga4361f6001abb5c83c36a2ddfb648a8dc} to retrieve all instances in order. \index{Legacy pre-\/1.\-0 C A\-P\-I@{Legacy pre-\/1.\-0 C A\-P\-I}!theora\-\_\-control@{theora\-\_\-control}}
+\index{theora\-\_\-control@{theora\-\_\-control}!Legacy pre-1.0 C API@{Legacy pre-\/1.\-0 C A\-P\-I}}
+\subsubsection[{theora\-\_\-control}]{\setlength{\rightskip}{0pt plus 5cm}int theora\-\_\-control (
 \begin{DoxyParamCaption}
 \item[{{\bf theora\-\_\-state} $\ast$}]{th, }
 \item[{int}]{req, }
@@ -567,22 +570,22 @@ int {\bf theora\-\_\-control} ({\bf theora\-\_\-state} $\ast$th, int req, void $
 )}\label{group__oldfuncs_ga186773db3bc8cd550047e7df1b2ba2c9}
 
 
-\-Encoder control function. 
+Encoder control function. 
 
-\-This is used to provide advanced control the encoding process. 
-\begin{DoxyParams}{\-Parameters}
-{\em th} & \-A \doxyref{theora\-\_\-state}{p.}{structtheora__state} handle. \\
+This is used to provide advanced control the encoding process. 
+\begin{DoxyParams}{Parameters}
+{\em th} & A \doxyref{theora\-\_\-state}{p.}{structtheora__state} handle. \\
 \hline
-{\em req} & \-The control code to process. \-See \doxyref{the list of available }{p.}{group__oldfuncs_encctlcodes_old} control codes" for details. \\
+{\em req} & The control code to process. See \doxyref{the list of available }{p.}{group__oldfuncs_encctlcodes_old} control codes" for details. \\
 \hline
-{\em buf} & \-The parameters for this control code. \\
+{\em buf} & The parameters for this control code. \\
 \hline
-{\em buf\-\_\-sz} & \-The size of the parameter buffer. \\
+{\em buf\-\_\-sz} & The size of the parameter buffer. \\
 \hline
 \end{DoxyParams}
-\index{\-Legacy pre-\/1.\-0 C A\-P\-I@{\-Legacy pre-\/1.\-0 C A\-P\-I}!theora\-\_\-decode\-\_\-header@{theora\-\_\-decode\-\_\-header}}
-\index{theora\-\_\-decode\-\_\-header@{theora\-\_\-decode\-\_\-header}!Legacy pre-1.0 C API@{\-Legacy pre-\/1.\-0 C A\-P\-I}}
-\subsubsection[{theora\-\_\-decode\-\_\-header}]{\setlength{\rightskip}{0pt plus 5cm}int {\bf theora\-\_\-decode\-\_\-header} (
+\index{Legacy pre-\/1.\-0 C A\-P\-I@{Legacy pre-\/1.\-0 C A\-P\-I}!theora\-\_\-decode\-\_\-header@{theora\-\_\-decode\-\_\-header}}
+\index{theora\-\_\-decode\-\_\-header@{theora\-\_\-decode\-\_\-header}!Legacy pre-1.0 C API@{Legacy pre-\/1.\-0 C A\-P\-I}}
+\subsubsection[{theora\-\_\-decode\-\_\-header}]{\setlength{\rightskip}{0pt plus 5cm}int theora\-\_\-decode\-\_\-header (
 \begin{DoxyParamCaption}
 \item[{{\bf theora\-\_\-info} $\ast$}]{ci, }
 \item[{{\bf theora\-\_\-comment} $\ast$}]{cc, }
@@ -591,34 +594,34 @@ int {\bf theora\-\_\-control} ({\bf theora\-\_\-state} $\ast$th, int req, void $
 )}\label{group__oldfuncs_ga02915e63c1bd733ee291f577a8b75a82}
 
 
-\-Decode an \-Ogg packet, with the expectation that the packet contains an initial header, comment data or codebook tables. 
+Decode an Ogg packet, with the expectation that the packet contains an initial header, comment data or codebook tables. 
 
 
-\begin{DoxyParams}{\-Parameters}
-{\em ci} & \-A \doxyref{theora\-\_\-info}{p.}{structtheora__info} structure to fill. \-This must have been previously initialized with \doxyref{theora\-\_\-info\-\_\-init()}{p.}{group__oldfuncs_ga3091c87d48f1faba018c5956379a6d90}. \-If {\itshape op\/} contains an initial header, \doxyref{theora\-\_\-decode\-\_\-header()}{p.}{group__oldfuncs_ga02915e63c1bd733ee291f577a8b75a82} will fill {\itshape ci\/} with the parsed header values. \-If {\itshape op\/} contains codebook tables, \doxyref{theora\-\_\-decode\-\_\-header()}{p.}{group__oldfuncs_ga02915e63c1bd733ee291f577a8b75a82} will parse these and attach an internal representation to {\itshape ci-\/$>$codec\-\_\-setup\/}. \\
+\begin{DoxyParams}{Parameters}
+{\em ci} & A \doxyref{theora\-\_\-info}{p.}{structtheora__info} structure to fill. This must have been previously initialized with \doxyref{theora\-\_\-info\-\_\-init()}{p.}{group__oldfuncs_ga3091c87d48f1faba018c5956379a6d90}. If {\itshape op} contains an initial header, \doxyref{theora\-\_\-decode\-\_\-header()}{p.}{group__oldfuncs_ga02915e63c1bd733ee291f577a8b75a82} will fill {\itshape ci} with the parsed header values. If {\itshape op} contains codebook tables, \doxyref{theora\-\_\-decode\-\_\-header()}{p.}{group__oldfuncs_ga02915e63c1bd733ee291f577a8b75a82} will parse these and attach an internal representation to {\itshape ci-\/$>$codec\-\_\-setup}. \\
 \hline
-{\em cc} & \-A \doxyref{theora\-\_\-comment}{p.}{structtheora__comment} structure to fill. \-If {\itshape op\/} contains comment data, \doxyref{theora\-\_\-decode\-\_\-header()}{p.}{group__oldfuncs_ga02915e63c1bd733ee291f577a8b75a82} will fill {\itshape cc\/} with the parsed comments. \\
+{\em cc} & A \doxyref{theora\-\_\-comment}{p.}{structtheora__comment} structure to fill. If {\itshape op} contains comment data, \doxyref{theora\-\_\-decode\-\_\-header()}{p.}{group__oldfuncs_ga02915e63c1bd733ee291f577a8b75a82} will fill {\itshape cc} with the parsed comments. \\
 \hline
-{\em op} & \-An ogg\-\_\-packet structure which you expect contains an initial header, comment data or codebook tables.\\
+{\em op} & An ogg\-\_\-packet structure which you expect contains an initial header, comment data or codebook tables.\\
 \hline
 \end{DoxyParams}
 
-\begin{DoxyRetVals}{\-Return values}
-{\em \-O\-C\-\_\-\-B\-A\-D\-H\-E\-A\-D\-E\-R} & {\itshape op\/} is \-N\-U\-L\-L; \-O\-R the first byte of {\itshape op-\/$>$packet\/} has the signature of an initial packet, but op is not a b\-\_\-o\-\_\-s packet; \-O\-R this packet has the signature of an initial header packet, but an initial header packet has already been seen; \-O\-R this packet has the signature of a comment packet, but the initial header has not yet been seen; \-O\-R this packet has the signature of a comment packet, but contains invalid data; \-O\-R this packet has the signature of codebook tables, but the initial header or comments have not yet been seen; \-O\-R this packet has the signature of codebook tables, but contains invalid data; \-O\-R the stream being decoded has a compatible version but this packet does not have the signature of a theora initial header, comments, or codebook packet \\
+\begin{DoxyRetVals}{Return values}
+{\em O\-C\-\_\-\-B\-A\-D\-H\-E\-A\-D\-E\-R} & {\itshape op} is N\-U\-L\-L; O\-R the first byte of {\itshape op-\/$>$packet} has the signature of an initial packet, but op is not a b\-\_\-o\-\_\-s packet; O\-R this packet has the signature of an initial header packet, but an initial header packet has already been seen; O\-R this packet has the signature of a comment packet, but the initial header has not yet been seen; O\-R this packet has the signature of a comment packet, but contains invalid data; O\-R this packet has the signature of codebook tables, but the initial header or comments have not yet been seen; O\-R this packet has the signature of codebook tables, but contains invalid data; O\-R the stream being decoded has a compatible version but this packet does not have the signature of a theora initial header, comments, or codebook packet \\
 \hline
-{\em \-O\-C\-\_\-\-V\-E\-R\-S\-I\-O\-N} & \-The packet data of {\itshape op\/} is an initial header with a version which is incompatible with this version of libtheora. \\
+{\em O\-C\-\_\-\-V\-E\-R\-S\-I\-O\-N} & The packet data of {\itshape op} is an initial header with a version which is incompatible with this version of libtheora. \\
 \hline
-{\em \-O\-C\-\_\-\-N\-E\-W\-P\-A\-C\-K\-E\-T} & the stream being decoded has an incompatible (future) version and contains an unknown signature. \\
+{\em O\-C\-\_\-\-N\-E\-W\-P\-A\-C\-K\-E\-T} & the stream being decoded has an incompatible (future) version and contains an unknown signature. \\
 \hline
-{\em 0} & \-Success\\
+{\em 0} & Success\\
 \hline
 \end{DoxyRetVals}
-\begin{DoxyNote}{\-Note}
-\-The normal usage is that \doxyref{theora\-\_\-decode\-\_\-header()}{p.}{group__oldfuncs_ga02915e63c1bd733ee291f577a8b75a82} be called on the first three packets of a theora logical bitstream in succession. 
+\begin{DoxyNote}{Note}
+The normal usage is that \doxyref{theora\-\_\-decode\-\_\-header()}{p.}{group__oldfuncs_ga02915e63c1bd733ee291f577a8b75a82} be called on the first three packets of a theora logical bitstream in succession. 
 \end{DoxyNote}
-\index{\-Legacy pre-\/1.\-0 C A\-P\-I@{\-Legacy pre-\/1.\-0 C A\-P\-I}!theora\-\_\-decode\-\_\-init@{theora\-\_\-decode\-\_\-init}}
-\index{theora\-\_\-decode\-\_\-init@{theora\-\_\-decode\-\_\-init}!Legacy pre-1.0 C API@{\-Legacy pre-\/1.\-0 C A\-P\-I}}
-\subsubsection[{theora\-\_\-decode\-\_\-init}]{\setlength{\rightskip}{0pt plus 5cm}int {\bf theora\-\_\-decode\-\_\-init} (
+\index{Legacy pre-\/1.\-0 C A\-P\-I@{Legacy pre-\/1.\-0 C A\-P\-I}!theora\-\_\-decode\-\_\-init@{theora\-\_\-decode\-\_\-init}}
+\index{theora\-\_\-decode\-\_\-init@{theora\-\_\-decode\-\_\-init}!Legacy pre-1.0 C API@{Legacy pre-\/1.\-0 C A\-P\-I}}
+\subsubsection[{theora\-\_\-decode\-\_\-init}]{\setlength{\rightskip}{0pt plus 5cm}int theora\-\_\-decode\-\_\-init (
 \begin{DoxyParamCaption}
 \item[{{\bf theora\-\_\-state} $\ast$}]{th, }
 \item[{{\bf theora\-\_\-info} $\ast$}]{c}
@@ -626,23 +629,23 @@ int {\bf theora\-\_\-control} ({\bf theora\-\_\-state} $\ast$th, int req, void $
 )}\label{group__oldfuncs_ga264907c66003799ff77ecbd09eb33d2c}
 
 
-\-Initialize a \doxyref{theora\-\_\-state}{p.}{structtheora__state} handle for decoding. 
+Initialize a \doxyref{theora\-\_\-state}{p.}{structtheora__state} handle for decoding. 
 
 
-\begin{DoxyParams}{\-Parameters}
-{\em th} & \-The \doxyref{theora\-\_\-state}{p.}{structtheora__state} handle to initialize. \\
+\begin{DoxyParams}{Parameters}
+{\em th} & The \doxyref{theora\-\_\-state}{p.}{structtheora__state} handle to initialize. \\
 \hline
-{\em c} & \-A \doxyref{theora\-\_\-info}{p.}{structtheora__info} struct filled with the desired decoding parameters. \-This is of course usually obtained from a previous call to \doxyref{theora\-\_\-decode\-\_\-header()}{p.}{group__oldfuncs_ga02915e63c1bd733ee291f577a8b75a82}. \\
+{\em c} & A \doxyref{theora\-\_\-info}{p.}{structtheora__info} struct filled with the desired decoding parameters. This is of course usually obtained from a previous call to \doxyref{theora\-\_\-decode\-\_\-header()}{p.}{group__oldfuncs_ga02915e63c1bd733ee291f577a8b75a82}. \\
 \hline
 \end{DoxyParams}
 
-\begin{DoxyRetVals}{\-Return values}
-{\em 0} & \-Success \\
+\begin{DoxyRetVals}{Return values}
+{\em 0} & Success \\
 \hline
 \end{DoxyRetVals}
-\index{\-Legacy pre-\/1.\-0 C A\-P\-I@{\-Legacy pre-\/1.\-0 C A\-P\-I}!theora\-\_\-decode\-\_\-packetin@{theora\-\_\-decode\-\_\-packetin}}
-\index{theora\-\_\-decode\-\_\-packetin@{theora\-\_\-decode\-\_\-packetin}!Legacy pre-1.0 C API@{\-Legacy pre-\/1.\-0 C A\-P\-I}}
-\subsubsection[{theora\-\_\-decode\-\_\-packetin}]{\setlength{\rightskip}{0pt plus 5cm}int {\bf theora\-\_\-decode\-\_\-packetin} (
+\index{Legacy pre-\/1.\-0 C A\-P\-I@{Legacy pre-\/1.\-0 C A\-P\-I}!theora\-\_\-decode\-\_\-packetin@{theora\-\_\-decode\-\_\-packetin}}
+\index{theora\-\_\-decode\-\_\-packetin@{theora\-\_\-decode\-\_\-packetin}!Legacy pre-1.0 C API@{Legacy pre-\/1.\-0 C A\-P\-I}}
+\subsubsection[{theora\-\_\-decode\-\_\-packetin}]{\setlength{\rightskip}{0pt plus 5cm}int theora\-\_\-decode\-\_\-packetin (
 \begin{DoxyParamCaption}
 \item[{{\bf theora\-\_\-state} $\ast$}]{th, }
 \item[{ogg\-\_\-packet $\ast$}]{op}
@@ -650,25 +653,25 @@ int {\bf theora\-\_\-control} ({\bf theora\-\_\-state} $\ast$th, int req, void $
 )}\label{group__oldfuncs_gaa65a9e53b46fd54ab344bd599fa96975}
 
 
-\-Input a packet containing encoded data into the theora decoder. 
+Input a packet containing encoded data into the theora decoder. 
 
 
-\begin{DoxyParams}{\-Parameters}
-{\em th} & \-A \doxyref{theora\-\_\-state}{p.}{structtheora__state} handle previously initialized for decoding. \\
+\begin{DoxyParams}{Parameters}
+{\em th} & A \doxyref{theora\-\_\-state}{p.}{structtheora__state} handle previously initialized for decoding. \\
 \hline
-{\em op} & \-An ogg\-\_\-packet containing encoded theora data. \\
+{\em op} & An ogg\-\_\-packet containing encoded theora data. \\
 \hline
 \end{DoxyParams}
 
-\begin{DoxyRetVals}{\-Return values}
-{\em 0} & \-Success \\
+\begin{DoxyRetVals}{Return values}
+{\em 0} & Success \\
 \hline
-{\em \-O\-C\-\_\-\-B\-A\-D\-P\-A\-C\-K\-E\-T} & {\itshape op\/} does not contain encoded video data \\
+{\em O\-C\-\_\-\-B\-A\-D\-P\-A\-C\-K\-E\-T} & {\itshape op} does not contain encoded video data \\
 \hline
 \end{DoxyRetVals}
-\index{\-Legacy pre-\/1.\-0 C A\-P\-I@{\-Legacy pre-\/1.\-0 C A\-P\-I}!theora\-\_\-decode\-\_\-\-Y\-U\-Vout@{theora\-\_\-decode\-\_\-\-Y\-U\-Vout}}
-\index{theora\-\_\-decode\-\_\-\-Y\-U\-Vout@{theora\-\_\-decode\-\_\-\-Y\-U\-Vout}!Legacy pre-1.0 C API@{\-Legacy pre-\/1.\-0 C A\-P\-I}}
-\subsubsection[{theora\-\_\-decode\-\_\-\-Y\-U\-Vout}]{\setlength{\rightskip}{0pt plus 5cm}int {\bf theora\-\_\-decode\-\_\-\-Y\-U\-Vout} (
+\index{Legacy pre-\/1.\-0 C A\-P\-I@{Legacy pre-\/1.\-0 C A\-P\-I}!theora\-\_\-decode\-\_\-\-Y\-U\-Vout@{theora\-\_\-decode\-\_\-\-Y\-U\-Vout}}
+\index{theora\-\_\-decode\-\_\-\-Y\-U\-Vout@{theora\-\_\-decode\-\_\-\-Y\-U\-Vout}!Legacy pre-1.0 C API@{Legacy pre-\/1.\-0 C A\-P\-I}}
+\subsubsection[{theora\-\_\-decode\-\_\-\-Y\-U\-Vout}]{\setlength{\rightskip}{0pt plus 5cm}int theora\-\_\-decode\-\_\-\-Y\-U\-Vout (
 \begin{DoxyParamCaption}
 \item[{{\bf theora\-\_\-state} $\ast$}]{th, }
 \item[{{\bf yuv\-\_\-buffer} $\ast$}]{yuv}
@@ -676,23 +679,23 @@ int {\bf theora\-\_\-control} ({\bf theora\-\_\-state} $\ast$th, int req, void $
 )}\label{group__oldfuncs_ga09d47c80e1e94bff0a46a496816b8daa}
 
 
-\-Output the next available frame of decoded \-Y\-U\-V data. 
+Output the next available frame of decoded Y\-U\-V data. 
 
 
-\begin{DoxyParams}{\-Parameters}
-{\em th} & \-A \doxyref{theora\-\_\-state}{p.}{structtheora__state} handle previously initialized for decoding. \\
+\begin{DoxyParams}{Parameters}
+{\em th} & A \doxyref{theora\-\_\-state}{p.}{structtheora__state} handle previously initialized for decoding. \\
 \hline
-{\em yuv} & \-A \doxyref{yuv\-\_\-buffer}{p.}{structyuv__buffer} in which libtheora should place the decoded data. \-Note that the buffer struct itself is allocated by the user, but that the luma and chroma pointers will be filled in by the library. \-Also note that these luma and chroma regions should be considered read-\/only by the user. \\
+{\em yuv} & A \doxyref{yuv\-\_\-buffer}{p.}{structyuv__buffer} in which libtheora should place the decoded data. Note that the buffer struct itself is allocated by the user, but that the luma and chroma pointers will be filled in by the library. Also note that these luma and chroma regions should be considered read-\/only by the user. \\
 \hline
 \end{DoxyParams}
 
-\begin{DoxyRetVals}{\-Return values}
-{\em 0} & \-Success \\
+\begin{DoxyRetVals}{Return values}
+{\em 0} & Success \\
 \hline
 \end{DoxyRetVals}
-\index{\-Legacy pre-\/1.\-0 C A\-P\-I@{\-Legacy pre-\/1.\-0 C A\-P\-I}!theora\-\_\-encode\-\_\-comment@{theora\-\_\-encode\-\_\-comment}}
-\index{theora\-\_\-encode\-\_\-comment@{theora\-\_\-encode\-\_\-comment}!Legacy pre-1.0 C API@{\-Legacy pre-\/1.\-0 C A\-P\-I}}
-\subsubsection[{theora\-\_\-encode\-\_\-comment}]{\setlength{\rightskip}{0pt plus 5cm}int {\bf theora\-\_\-encode\-\_\-comment} (
+\index{Legacy pre-\/1.\-0 C A\-P\-I@{Legacy pre-\/1.\-0 C A\-P\-I}!theora\-\_\-encode\-\_\-comment@{theora\-\_\-encode\-\_\-comment}}
+\index{theora\-\_\-encode\-\_\-comment@{theora\-\_\-encode\-\_\-comment}!Legacy pre-1.0 C API@{Legacy pre-\/1.\-0 C A\-P\-I}}
+\subsubsection[{theora\-\_\-encode\-\_\-comment}]{\setlength{\rightskip}{0pt plus 5cm}int theora\-\_\-encode\-\_\-comment (
 \begin{DoxyParamCaption}
 \item[{{\bf theora\-\_\-comment} $\ast$}]{tc, }
 \item[{ogg\-\_\-packet $\ast$}]{op}
@@ -700,23 +703,23 @@ int {\bf theora\-\_\-control} ({\bf theora\-\_\-state} $\ast$th, int req, void $
 )}\label{group__oldfuncs_ga45e8db0713eaaca0f1144f3724cb834a}
 
 
-\-Request a comment header packet from provided metadata. 
+Request a comment header packet from provided metadata. 
 
-\-A pointer to the comment data is placed in a user-\/provided ogg\-\_\-packet structure. 
-\begin{DoxyParams}{\-Parameters}
-{\em tc} & \-A \doxyref{theora\-\_\-comment}{p.}{structtheora__comment} structure filled with the desired metadata \\
+A pointer to the comment data is placed in a user-\/provided ogg\-\_\-packet structure. 
+\begin{DoxyParams}{Parameters}
+{\em tc} & A \doxyref{theora\-\_\-comment}{p.}{structtheora__comment} structure filled with the desired metadata \\
 \hline
-{\em op} & \-An ogg\-\_\-packet structure to fill. libtheora will set all elements of this structure, including a pointer to the encoded comment data. \-The memory for the comment data is owned by libtheora. \\
+{\em op} & An ogg\-\_\-packet structure to fill. libtheora will set all elements of this structure, including a pointer to the encoded comment data. The memory for the comment data is owned by libtheora. \\
 \hline
 \end{DoxyParams}
 
-\begin{DoxyRetVals}{\-Return values}
-{\em 0} & \-Success \\
+\begin{DoxyRetVals}{Return values}
+{\em 0} & Success \\
 \hline
 \end{DoxyRetVals}
-\index{\-Legacy pre-\/1.\-0 C A\-P\-I@{\-Legacy pre-\/1.\-0 C A\-P\-I}!theora\-\_\-encode\-\_\-header@{theora\-\_\-encode\-\_\-header}}
-\index{theora\-\_\-encode\-\_\-header@{theora\-\_\-encode\-\_\-header}!Legacy pre-1.0 C API@{\-Legacy pre-\/1.\-0 C A\-P\-I}}
-\subsubsection[{theora\-\_\-encode\-\_\-header}]{\setlength{\rightskip}{0pt plus 5cm}int {\bf theora\-\_\-encode\-\_\-header} (
+\index{Legacy pre-\/1.\-0 C A\-P\-I@{Legacy pre-\/1.\-0 C A\-P\-I}!theora\-\_\-encode\-\_\-header@{theora\-\_\-encode\-\_\-header}}
+\index{theora\-\_\-encode\-\_\-header@{theora\-\_\-encode\-\_\-header}!Legacy pre-1.0 C API@{Legacy pre-\/1.\-0 C A\-P\-I}}
+\subsubsection[{theora\-\_\-encode\-\_\-header}]{\setlength{\rightskip}{0pt plus 5cm}int theora\-\_\-encode\-\_\-header (
 \begin{DoxyParamCaption}
 \item[{{\bf theora\-\_\-state} $\ast$}]{t, }
 \item[{ogg\-\_\-packet $\ast$}]{op}
@@ -724,23 +727,23 @@ int {\bf theora\-\_\-control} ({\bf theora\-\_\-state} $\ast$th, int req, void $
 )}\label{group__oldfuncs_ga451feb58d6bde726edbae193689887be}
 
 
-\-Request a packet containing the initial header. 
+Request a packet containing the initial header. 
 
-\-A pointer to the header data is placed in a user-\/provided ogg\-\_\-packet structure. 
-\begin{DoxyParams}{\-Parameters}
-{\em t} & \-A \doxyref{theora\-\_\-state}{p.}{structtheora__state} handle previously initialized for encoding. \\
+A pointer to the header data is placed in a user-\/provided ogg\-\_\-packet structure. 
+\begin{DoxyParams}{Parameters}
+{\em t} & A \doxyref{theora\-\_\-state}{p.}{structtheora__state} handle previously initialized for encoding. \\
 \hline
-{\em op} & \-An ogg\-\_\-packet structure to fill. libtheora will set all elements of this structure, including a pointer to the header data. \-The memory for the header data is owned by libtheora. \\
+{\em op} & An ogg\-\_\-packet structure to fill. libtheora will set all elements of this structure, including a pointer to the header data. The memory for the header data is owned by libtheora. \\
 \hline
 \end{DoxyParams}
 
-\begin{DoxyRetVals}{\-Return values}
-{\em 0} & \-Success \\
+\begin{DoxyRetVals}{Return values}
+{\em 0} & Success \\
 \hline
 \end{DoxyRetVals}
-\index{\-Legacy pre-\/1.\-0 C A\-P\-I@{\-Legacy pre-\/1.\-0 C A\-P\-I}!theora\-\_\-encode\-\_\-init@{theora\-\_\-encode\-\_\-init}}
-\index{theora\-\_\-encode\-\_\-init@{theora\-\_\-encode\-\_\-init}!Legacy pre-1.0 C API@{\-Legacy pre-\/1.\-0 C A\-P\-I}}
-\subsubsection[{theora\-\_\-encode\-\_\-init}]{\setlength{\rightskip}{0pt plus 5cm}int {\bf theora\-\_\-encode\-\_\-init} (
+\index{Legacy pre-\/1.\-0 C A\-P\-I@{Legacy pre-\/1.\-0 C A\-P\-I}!theora\-\_\-encode\-\_\-init@{theora\-\_\-encode\-\_\-init}}
+\index{theora\-\_\-encode\-\_\-init@{theora\-\_\-encode\-\_\-init}!Legacy pre-1.0 C API@{Legacy pre-\/1.\-0 C A\-P\-I}}
+\subsubsection[{theora\-\_\-encode\-\_\-init}]{\setlength{\rightskip}{0pt plus 5cm}int theora\-\_\-encode\-\_\-init (
 \begin{DoxyParamCaption}
 \item[{{\bf theora\-\_\-state} $\ast$}]{th, }
 \item[{{\bf theora\-\_\-info} $\ast$}]{ti}
@@ -748,23 +751,23 @@ int {\bf theora\-\_\-control} ({\bf theora\-\_\-state} $\ast$th, int req, void $
 )}\label{group__oldfuncs_ga0f7ad4d4b2343278cb4ba8fb2bd5109a}
 
 
-\-Initialize the theora encoder. 
+Initialize the theora encoder. 
 
 
-\begin{DoxyParams}{\-Parameters}
-{\em th} & \-The \doxyref{theora\-\_\-state}{p.}{structtheora__state} handle to initialize for encoding. \\
+\begin{DoxyParams}{Parameters}
+{\em th} & The \doxyref{theora\-\_\-state}{p.}{structtheora__state} handle to initialize for encoding. \\
 \hline
-{\em ti} & \-A \doxyref{theora\-\_\-info}{p.}{structtheora__info} struct filled with the desired encoding parameters. \\
+{\em ti} & A \doxyref{theora\-\_\-info}{p.}{structtheora__info} struct filled with the desired encoding parameters. \\
 \hline
 \end{DoxyParams}
 
-\begin{DoxyRetVals}{\-Return values}
-{\em 0} & \-Success \\
+\begin{DoxyRetVals}{Return values}
+{\em 0} & Success \\
 \hline
 \end{DoxyRetVals}
-\index{\-Legacy pre-\/1.\-0 C A\-P\-I@{\-Legacy pre-\/1.\-0 C A\-P\-I}!theora\-\_\-encode\-\_\-packetout@{theora\-\_\-encode\-\_\-packetout}}
-\index{theora\-\_\-encode\-\_\-packetout@{theora\-\_\-encode\-\_\-packetout}!Legacy pre-1.0 C API@{\-Legacy pre-\/1.\-0 C A\-P\-I}}
-\subsubsection[{theora\-\_\-encode\-\_\-packetout}]{\setlength{\rightskip}{0pt plus 5cm}int {\bf theora\-\_\-encode\-\_\-packetout} (
+\index{Legacy pre-\/1.\-0 C A\-P\-I@{Legacy pre-\/1.\-0 C A\-P\-I}!theora\-\_\-encode\-\_\-packetout@{theora\-\_\-encode\-\_\-packetout}}
+\index{theora\-\_\-encode\-\_\-packetout@{theora\-\_\-encode\-\_\-packetout}!Legacy pre-1.0 C API@{Legacy pre-\/1.\-0 C A\-P\-I}}
+\subsubsection[{theora\-\_\-encode\-\_\-packetout}]{\setlength{\rightskip}{0pt plus 5cm}int theora\-\_\-encode\-\_\-packetout (
 \begin{DoxyParamCaption}
 \item[{{\bf theora\-\_\-state} $\ast$}]{t, }
 \item[{int}]{last\-\_\-p, }
@@ -773,29 +776,29 @@ int {\bf theora\-\_\-control} ({\bf theora\-\_\-state} $\ast$th, int req, void $
 )}\label{group__oldfuncs_ga5f4929677a735bc2198c2309d235f1b3}
 
 
-\-Request the next packet of encoded video. 
+Request the next packet of encoded video. 
 
-\-The encoded data is placed in a user-\/provided ogg\-\_\-packet structure. 
-\begin{DoxyParams}{\-Parameters}
-{\em t} & \-A \doxyref{theora\-\_\-state}{p.}{structtheora__state} handle previously initialized for encoding. \\
+The encoded data is placed in a user-\/provided ogg\-\_\-packet structure. 
+\begin{DoxyParams}{Parameters}
+{\em t} & A \doxyref{theora\-\_\-state}{p.}{structtheora__state} handle previously initialized for encoding. \\
 \hline
 {\em last\-\_\-p} & whether this is the last packet the encoder should produce. \\
 \hline
-{\em op} & \-An ogg\-\_\-packet structure to fill. libtheora will set all elements of this structure, including a pointer to encoded data. \-The memory for the encoded data is owned by libtheora. \\
+{\em op} & An ogg\-\_\-packet structure to fill. libtheora will set all elements of this structure, including a pointer to encoded data. The memory for the encoded data is owned by libtheora. \\
 \hline
 \end{DoxyParams}
 
-\begin{DoxyRetVals}{\-Return values}
-{\em 0} & \-No internal storage exists \-O\-R no packet is ready \\
+\begin{DoxyRetVals}{Return values}
+{\em 0} & No internal storage exists O\-R no packet is ready \\
 \hline
-{\em -\/1} & \-The encoding process has completed \\
+{\em -\/1} & The encoding process has completed \\
 \hline
-{\em 1} & \-Success \\
+{\em 1} & Success \\
 \hline
 \end{DoxyRetVals}
-\index{\-Legacy pre-\/1.\-0 C A\-P\-I@{\-Legacy pre-\/1.\-0 C A\-P\-I}!theora\-\_\-encode\-\_\-tables@{theora\-\_\-encode\-\_\-tables}}
-\index{theora\-\_\-encode\-\_\-tables@{theora\-\_\-encode\-\_\-tables}!Legacy pre-1.0 C API@{\-Legacy pre-\/1.\-0 C A\-P\-I}}
-\subsubsection[{theora\-\_\-encode\-\_\-tables}]{\setlength{\rightskip}{0pt plus 5cm}int {\bf theora\-\_\-encode\-\_\-tables} (
+\index{Legacy pre-\/1.\-0 C A\-P\-I@{Legacy pre-\/1.\-0 C A\-P\-I}!theora\-\_\-encode\-\_\-tables@{theora\-\_\-encode\-\_\-tables}}
+\index{theora\-\_\-encode\-\_\-tables@{theora\-\_\-encode\-\_\-tables}!Legacy pre-1.0 C API@{Legacy pre-\/1.\-0 C A\-P\-I}}
+\subsubsection[{theora\-\_\-encode\-\_\-tables}]{\setlength{\rightskip}{0pt plus 5cm}int theora\-\_\-encode\-\_\-tables (
 \begin{DoxyParamCaption}
 \item[{{\bf theora\-\_\-state} $\ast$}]{t, }
 \item[{ogg\-\_\-packet $\ast$}]{op}
@@ -803,23 +806,23 @@ int {\bf theora\-\_\-control} ({\bf theora\-\_\-state} $\ast$th, int req, void $
 )}\label{group__oldfuncs_ga5085baf20855b283fa01fc948505d9d2}
 
 
-\-Request a packet containing the codebook tables for the stream. 
+Request a packet containing the codebook tables for the stream. 
 
-\-A pointer to the codebook data is placed in a user-\/provided ogg\-\_\-packet structure. 
-\begin{DoxyParams}{\-Parameters}
-{\em t} & \-A \doxyref{theora\-\_\-state}{p.}{structtheora__state} handle previously initialized for encoding. \\
+A pointer to the codebook data is placed in a user-\/provided ogg\-\_\-packet structure. 
+\begin{DoxyParams}{Parameters}
+{\em t} & A \doxyref{theora\-\_\-state}{p.}{structtheora__state} handle previously initialized for encoding. \\
 \hline
-{\em op} & \-An ogg\-\_\-packet structure to fill. libtheora will set all elements of this structure, including a pointer to the codebook data. \-The memory for the header data is owned by libtheora. \\
+{\em op} & An ogg\-\_\-packet structure to fill. libtheora will set all elements of this structure, including a pointer to the codebook data. The memory for the header data is owned by libtheora. \\
 \hline
 \end{DoxyParams}
 
-\begin{DoxyRetVals}{\-Return values}
-{\em 0} & \-Success \\
+\begin{DoxyRetVals}{Return values}
+{\em 0} & Success \\
 \hline
 \end{DoxyRetVals}
-\index{\-Legacy pre-\/1.\-0 C A\-P\-I@{\-Legacy pre-\/1.\-0 C A\-P\-I}!theora\-\_\-encode\-\_\-\-Y\-U\-Vin@{theora\-\_\-encode\-\_\-\-Y\-U\-Vin}}
-\index{theora\-\_\-encode\-\_\-\-Y\-U\-Vin@{theora\-\_\-encode\-\_\-\-Y\-U\-Vin}!Legacy pre-1.0 C API@{\-Legacy pre-\/1.\-0 C A\-P\-I}}
-\subsubsection[{theora\-\_\-encode\-\_\-\-Y\-U\-Vin}]{\setlength{\rightskip}{0pt plus 5cm}int {\bf theora\-\_\-encode\-\_\-\-Y\-U\-Vin} (
+\index{Legacy pre-\/1.\-0 C A\-P\-I@{Legacy pre-\/1.\-0 C A\-P\-I}!theora\-\_\-encode\-\_\-\-Y\-U\-Vin@{theora\-\_\-encode\-\_\-\-Y\-U\-Vin}}
+\index{theora\-\_\-encode\-\_\-\-Y\-U\-Vin@{theora\-\_\-encode\-\_\-\-Y\-U\-Vin}!Legacy pre-1.0 C API@{Legacy pre-\/1.\-0 C A\-P\-I}}
+\subsubsection[{theora\-\_\-encode\-\_\-\-Y\-U\-Vin}]{\setlength{\rightskip}{0pt plus 5cm}int theora\-\_\-encode\-\_\-\-Y\-U\-Vin (
 \begin{DoxyParamCaption}
 \item[{{\bf theora\-\_\-state} $\ast$}]{t, }
 \item[{{\bf yuv\-\_\-buffer} $\ast$}]{yuv}
@@ -827,27 +830,27 @@ int {\bf theora\-\_\-control} ({\bf theora\-\_\-state} $\ast$th, int req, void $
 )}\label{group__oldfuncs_gac0d33d896ca70cedfc94c5986d947078}
 
 
-\-Submit a \-Y\-U\-V buffer to the theora encoder. 
+Submit a Y\-U\-V buffer to the theora encoder. 
 
 
-\begin{DoxyParams}{\-Parameters}
-{\em t} & \-A \doxyref{theora\-\_\-state}{p.}{structtheora__state} handle previously initialized for encoding. \\
+\begin{DoxyParams}{Parameters}
+{\em t} & A \doxyref{theora\-\_\-state}{p.}{structtheora__state} handle previously initialized for encoding. \\
 \hline
-{\em yuv} & \-A buffer of \-Y\-U\-V data to encode. \-Note that both the \doxyref{yuv\-\_\-buffer}{p.}{structyuv__buffer} struct and the luma/chroma buffers within should be allocated by the user. \\
+{\em yuv} & A buffer of Y\-U\-V data to encode. Note that both the \doxyref{yuv\-\_\-buffer}{p.}{structyuv__buffer} struct and the luma/chroma buffers within should be allocated by the user. \\
 \hline
 \end{DoxyParams}
 
-\begin{DoxyRetVals}{\-Return values}
-{\em \-O\-C\-\_\-\-E\-I\-N\-V\-A\-L} & \-Encoder is not ready, or is finished. \\
+\begin{DoxyRetVals}{Return values}
+{\em O\-C\-\_\-\-E\-I\-N\-V\-A\-L} & Encoder is not ready, or is finished. \\
 \hline
-{\em -\/1} & \-The size of the given frame differs from those previously input \\
+{\em -\/1} & The size of the given frame differs from those previously input \\
 \hline
-{\em 0} & \-Success \\
+{\em 0} & Success \\
 \hline
 \end{DoxyRetVals}
-\index{\-Legacy pre-\/1.\-0 C A\-P\-I@{\-Legacy pre-\/1.\-0 C A\-P\-I}!theora\-\_\-granule\-\_\-frame@{theora\-\_\-granule\-\_\-frame}}
-\index{theora\-\_\-granule\-\_\-frame@{theora\-\_\-granule\-\_\-frame}!Legacy pre-1.0 C API@{\-Legacy pre-\/1.\-0 C A\-P\-I}}
-\subsubsection[{theora\-\_\-granule\-\_\-frame}]{\setlength{\rightskip}{0pt plus 5cm}ogg\-\_\-int64\-\_\-t {\bf theora\-\_\-granule\-\_\-frame} (
+\index{Legacy pre-\/1.\-0 C A\-P\-I@{Legacy pre-\/1.\-0 C A\-P\-I}!theora\-\_\-granule\-\_\-frame@{theora\-\_\-granule\-\_\-frame}}
+\index{theora\-\_\-granule\-\_\-frame@{theora\-\_\-granule\-\_\-frame}!Legacy pre-1.0 C API@{Legacy pre-\/1.\-0 C A\-P\-I}}
+\subsubsection[{theora\-\_\-granule\-\_\-frame}]{\setlength{\rightskip}{0pt plus 5cm}ogg\-\_\-int64\-\_\-t theora\-\_\-granule\-\_\-frame (
 \begin{DoxyParamCaption}
 \item[{{\bf theora\-\_\-state} $\ast$}]{th, }
 \item[{ogg\-\_\-int64\-\_\-t}]{granulepos}
@@ -855,55 +858,55 @@ int {\bf theora\-\_\-control} ({\bf theora\-\_\-state} $\ast$th, int req, void $
 )}\label{group__oldfuncs_ga7bfa3ceb2fb4b41a282456c56e1dd269}
 
 
-\-Convert a granulepos to an absolute frame index, starting at 0. 
+Convert a granulepos to an absolute frame index, starting at 0. 
 
-\-The granulepos is interpreted in the context of a given \doxyref{theora\-\_\-state}{p.}{structtheora__state} handle.
+The granulepos is interpreted in the context of a given \doxyref{theora\-\_\-state}{p.}{structtheora__state} handle.
 
-\-Note that while the granulepos encodes the frame count (i.\-e. starting from 1) this call returns the frame index, starting from zero. \-Thus \-One can calculate the presentation time by multiplying the index by the rate.
+Note that while the granulepos encodes the frame count (i.\-e. starting from 1) this call returns the frame index, starting from zero. Thus One can calculate the presentation time by multiplying the index by the rate.
 
 
-\begin{DoxyParams}{\-Parameters}
-{\em th} & \-A previously initialized \doxyref{theora\-\_\-state}{p.}{structtheora__state} handle (encode or decode) \\
+\begin{DoxyParams}{Parameters}
+{\em th} & A previously initialized \doxyref{theora\-\_\-state}{p.}{structtheora__state} handle (encode or decode) \\
 \hline
-{\em granulepos} & \-The granulepos to convert. \\
+{\em granulepos} & The granulepos to convert. \\
 \hline
 \end{DoxyParams}
-\begin{DoxyReturn}{\-Returns}
-\-The frame index corresponding to {\itshape granulepos\/}. 
+\begin{DoxyReturn}{Returns}
+The frame index corresponding to {\itshape granulepos}. 
 \end{DoxyReturn}
 
-\begin{DoxyRetVals}{\-Return values}
-{\em -\/1} & \-The given granulepos is undefined (i.\-e. negative)\\
+\begin{DoxyRetVals}{Return values}
+{\em -\/1} & The given granulepos is undefined (i.\-e. negative)\\
 \hline
 \end{DoxyRetVals}
-\-Thus function was added in the 1.\-0alpha4 release. \index{\-Legacy pre-\/1.\-0 C A\-P\-I@{\-Legacy pre-\/1.\-0 C A\-P\-I}!theora\-\_\-granule\-\_\-shift@{theora\-\_\-granule\-\_\-shift}}
-\index{theora\-\_\-granule\-\_\-shift@{theora\-\_\-granule\-\_\-shift}!Legacy pre-1.0 C API@{\-Legacy pre-\/1.\-0 C A\-P\-I}}
-\subsubsection[{theora\-\_\-granule\-\_\-shift}]{\setlength{\rightskip}{0pt plus 5cm}int {\bf theora\-\_\-granule\-\_\-shift} (
+Thus function was added in the 1.\-0alpha4 release. \index{Legacy pre-\/1.\-0 C A\-P\-I@{Legacy pre-\/1.\-0 C A\-P\-I}!theora\-\_\-granule\-\_\-shift@{theora\-\_\-granule\-\_\-shift}}
+\index{theora\-\_\-granule\-\_\-shift@{theora\-\_\-granule\-\_\-shift}!Legacy pre-1.0 C API@{Legacy pre-\/1.\-0 C A\-P\-I}}
+\subsubsection[{theora\-\_\-granule\-\_\-shift}]{\setlength{\rightskip}{0pt plus 5cm}int theora\-\_\-granule\-\_\-shift (
 \begin{DoxyParamCaption}
 \item[{{\bf theora\-\_\-info} $\ast$}]{ti}
 \end{DoxyParamCaption}
 )}\label{group__oldfuncs_gacd9360e6a47139c761002410af457a02}
 
 
-\-Report the granulepos shift radix. 
+Report the granulepos shift radix. 
 
-\-When embedded in \-Ogg, \-Theora uses a two-\/part granulepos, splitting the 64-\/bit field into two pieces. \-The more-\/significant section represents the frame count at the last keyframe, and the less-\/significant section represents the count of frames since the last keyframe. \-In this way the overall field is still non-\/decreasing with time, but usefully encodes a pointer to the last keyframe, which is necessary for correctly restarting decode after a seek.
+When embedded in Ogg, Theora uses a two-\/part granulepos, splitting the 64-\/bit field into two pieces. The more-\/significant section represents the frame count at the last keyframe, and the less-\/significant section represents the count of frames since the last keyframe. In this way the overall field is still non-\/decreasing with time, but usefully encodes a pointer to the last keyframe, which is necessary for correctly restarting decode after a seek.
 
-\-This function reports the number of bits used to represent the distance to the last keyframe, and thus how the granulepos field must be shifted or masked to obtain the two parts.
+This function reports the number of bits used to represent the distance to the last keyframe, and thus how the granulepos field must be shifted or masked to obtain the two parts.
 
-\-Since libtheora returns compressed data in an ogg\-\_\-packet structure, this may be generally useful even if the \-Theora packets are not being used in an \-Ogg container.
+Since libtheora returns compressed data in an ogg\-\_\-packet structure, this may be generally useful even if the Theora packets are not being used in an Ogg container.
 
 
-\begin{DoxyParams}{\-Parameters}
-{\em ti} & \-A previously initialized \doxyref{theora\-\_\-info}{p.}{structtheora__info} struct \\
+\begin{DoxyParams}{Parameters}
+{\em ti} & A previously initialized \doxyref{theora\-\_\-info}{p.}{structtheora__info} struct \\
 \hline
 \end{DoxyParams}
-\begin{DoxyReturn}{\-Returns}
-\-The bit shift dividing the two granulepos fields
+\begin{DoxyReturn}{Returns}
+The bit shift dividing the two granulepos fields
 \end{DoxyReturn}
-\-This function was added in the 1.\-0alpha5 release. \index{\-Legacy pre-\/1.\-0 C A\-P\-I@{\-Legacy pre-\/1.\-0 C A\-P\-I}!theora\-\_\-granule\-\_\-time@{theora\-\_\-granule\-\_\-time}}
-\index{theora\-\_\-granule\-\_\-time@{theora\-\_\-granule\-\_\-time}!Legacy pre-1.0 C API@{\-Legacy pre-\/1.\-0 C A\-P\-I}}
-\subsubsection[{theora\-\_\-granule\-\_\-time}]{\setlength{\rightskip}{0pt plus 5cm}double {\bf theora\-\_\-granule\-\_\-time} (
+This function was added in the 1.\-0alpha5 release. \index{Legacy pre-\/1.\-0 C A\-P\-I@{Legacy pre-\/1.\-0 C A\-P\-I}!theora\-\_\-granule\-\_\-time@{theora\-\_\-granule\-\_\-time}}
+\index{theora\-\_\-granule\-\_\-time@{theora\-\_\-granule\-\_\-time}!Legacy pre-1.0 C API@{Legacy pre-\/1.\-0 C A\-P\-I}}
+\subsubsection[{theora\-\_\-granule\-\_\-time}]{\setlength{\rightskip}{0pt plus 5cm}double theora\-\_\-granule\-\_\-time (
 \begin{DoxyParamCaption}
 \item[{{\bf theora\-\_\-state} $\ast$}]{th, }
 \item[{ogg\-\_\-int64\-\_\-t}]{granulepos}
@@ -911,136 +914,136 @@ int {\bf theora\-\_\-control} ({\bf theora\-\_\-state} $\ast$th, int req, void $
 )}\label{group__oldfuncs_ga4376358b12b9fa23ce6fe21cb5c65ac6}
 
 
-\-Convert a granulepos to absolute time in seconds. 
+Convert a granulepos to absolute time in seconds. 
 
-\-The granulepos is interpreted in the context of a given \doxyref{theora\-\_\-state}{p.}{structtheora__state} handle, and gives the end time of a frame's presentation as used in \-Ogg mux ordering.
+The granulepos is interpreted in the context of a given \doxyref{theora\-\_\-state}{p.}{structtheora__state} handle, and gives the end time of a frame's presentation as used in Ogg mux ordering.
 
 
-\begin{DoxyParams}{\-Parameters}
-{\em th} & \-A previously initialized \doxyref{theora\-\_\-state}{p.}{structtheora__state} handle (encode or decode) \\
+\begin{DoxyParams}{Parameters}
+{\em th} & A previously initialized \doxyref{theora\-\_\-state}{p.}{structtheora__state} handle (encode or decode) \\
 \hline
-{\em granulepos} & \-The granulepos to convert. \\
+{\em granulepos} & The granulepos to convert. \\
 \hline
 \end{DoxyParams}
-\begin{DoxyReturn}{\-Returns}
-\-The absolute time in seconds corresponding to {\itshape granulepos\/}. \-This is the \char`\"{}end time\char`\"{} for the frame, or the latest time it should be displayed. \-It is not the presentation time. 
+\begin{DoxyReturn}{Returns}
+The absolute time in seconds corresponding to {\itshape granulepos}. This is the \char`\"{}end time\char`\"{} for the frame, or the latest time it should be displayed. It is not the presentation time. 
 \end{DoxyReturn}
 
-\begin{DoxyRetVals}{\-Return values}
-{\em -\/1.} & \-The given granulepos is undefined (i.\-e. negative), or \\
+\begin{DoxyRetVals}{Return values}
+{\em -\/1.} & The given granulepos is undefined (i.\-e. negative), or \\
 \hline
-{\em -\/1.} & \-The function has been disabled because floating point support is not available. \\
+{\em -\/1.} & The function has been disabled because floating point support is not available. \\
 \hline
 \end{DoxyRetVals}
-\index{\-Legacy pre-\/1.\-0 C A\-P\-I@{\-Legacy pre-\/1.\-0 C A\-P\-I}!theora\-\_\-info\-\_\-clear@{theora\-\_\-info\-\_\-clear}}
-\index{theora\-\_\-info\-\_\-clear@{theora\-\_\-info\-\_\-clear}!Legacy pre-1.0 C API@{\-Legacy pre-\/1.\-0 C A\-P\-I}}
-\subsubsection[{theora\-\_\-info\-\_\-clear}]{\setlength{\rightskip}{0pt plus 5cm}void {\bf theora\-\_\-info\-\_\-clear} (
+\index{Legacy pre-\/1.\-0 C A\-P\-I@{Legacy pre-\/1.\-0 C A\-P\-I}!theora\-\_\-info\-\_\-clear@{theora\-\_\-info\-\_\-clear}}
+\index{theora\-\_\-info\-\_\-clear@{theora\-\_\-info\-\_\-clear}!Legacy pre-1.0 C API@{Legacy pre-\/1.\-0 C A\-P\-I}}
+\subsubsection[{theora\-\_\-info\-\_\-clear}]{\setlength{\rightskip}{0pt plus 5cm}void theora\-\_\-info\-\_\-clear (
 \begin{DoxyParamCaption}
 \item[{{\bf theora\-\_\-info} $\ast$}]{c}
 \end{DoxyParamCaption}
 )}\label{group__oldfuncs_gaba7022d58edbc4825cacad03f68b3e0d}
 
 
-\-Clear a \doxyref{theora\-\_\-info}{p.}{structtheora__info} structure. 
+Clear a \doxyref{theora\-\_\-info}{p.}{structtheora__info} structure. 
 
-\-All values within the given \doxyref{theora\-\_\-info}{p.}{structtheora__info} structure are cleared, and associated internal codec setup data is freed. 
-\begin{DoxyParams}{\-Parameters}
-{\em c} & \-A \doxyref{theora\-\_\-info}{p.}{structtheora__info} struct to initialize. \\
+All values within the given \doxyref{theora\-\_\-info}{p.}{structtheora__info} structure are cleared, and associated internal codec setup data is freed. 
+\begin{DoxyParams}{Parameters}
+{\em c} & A \doxyref{theora\-\_\-info}{p.}{structtheora__info} struct to initialize. \\
 \hline
 \end{DoxyParams}
-\index{\-Legacy pre-\/1.\-0 C A\-P\-I@{\-Legacy pre-\/1.\-0 C A\-P\-I}!theora\-\_\-info\-\_\-init@{theora\-\_\-info\-\_\-init}}
-\index{theora\-\_\-info\-\_\-init@{theora\-\_\-info\-\_\-init}!Legacy pre-1.0 C API@{\-Legacy pre-\/1.\-0 C A\-P\-I}}
-\subsubsection[{theora\-\_\-info\-\_\-init}]{\setlength{\rightskip}{0pt plus 5cm}void {\bf theora\-\_\-info\-\_\-init} (
+\index{Legacy pre-\/1.\-0 C A\-P\-I@{Legacy pre-\/1.\-0 C A\-P\-I}!theora\-\_\-info\-\_\-init@{theora\-\_\-info\-\_\-init}}
+\index{theora\-\_\-info\-\_\-init@{theora\-\_\-info\-\_\-init}!Legacy pre-1.0 C API@{Legacy pre-\/1.\-0 C A\-P\-I}}
+\subsubsection[{theora\-\_\-info\-\_\-init}]{\setlength{\rightskip}{0pt plus 5cm}void theora\-\_\-info\-\_\-init (
 \begin{DoxyParamCaption}
 \item[{{\bf theora\-\_\-info} $\ast$}]{c}
 \end{DoxyParamCaption}
 )}\label{group__oldfuncs_ga3091c87d48f1faba018c5956379a6d90}
 
 
-\-Initialize a \doxyref{theora\-\_\-info}{p.}{structtheora__info} structure. 
+Initialize a \doxyref{theora\-\_\-info}{p.}{structtheora__info} structure. 
 
-\-All values within the given \doxyref{theora\-\_\-info}{p.}{structtheora__info} structure are initialized, and space is allocated within libtheora for internal codec setup data. 
-\begin{DoxyParams}{\-Parameters}
-{\em c} & \-A \doxyref{theora\-\_\-info}{p.}{structtheora__info} struct to initialize. \\
+All values within the given \doxyref{theora\-\_\-info}{p.}{structtheora__info} structure are initialized, and space is allocated within libtheora for internal codec setup data. 
+\begin{DoxyParams}{Parameters}
+{\em c} & A \doxyref{theora\-\_\-info}{p.}{structtheora__info} struct to initialize. \\
 \hline
 \end{DoxyParams}
-\index{\-Legacy pre-\/1.\-0 C A\-P\-I@{\-Legacy pre-\/1.\-0 C A\-P\-I}!theora\-\_\-packet\-\_\-isheader@{theora\-\_\-packet\-\_\-isheader}}
-\index{theora\-\_\-packet\-\_\-isheader@{theora\-\_\-packet\-\_\-isheader}!Legacy pre-1.0 C API@{\-Legacy pre-\/1.\-0 C A\-P\-I}}
-\subsubsection[{theora\-\_\-packet\-\_\-isheader}]{\setlength{\rightskip}{0pt plus 5cm}int {\bf theora\-\_\-packet\-\_\-isheader} (
+\index{Legacy pre-\/1.\-0 C A\-P\-I@{Legacy pre-\/1.\-0 C A\-P\-I}!theora\-\_\-packet\-\_\-isheader@{theora\-\_\-packet\-\_\-isheader}}
+\index{theora\-\_\-packet\-\_\-isheader@{theora\-\_\-packet\-\_\-isheader}!Legacy pre-1.0 C API@{Legacy pre-\/1.\-0 C A\-P\-I}}
+\subsubsection[{theora\-\_\-packet\-\_\-isheader}]{\setlength{\rightskip}{0pt plus 5cm}int theora\-\_\-packet\-\_\-isheader (
 \begin{DoxyParamCaption}
 \item[{ogg\-\_\-packet $\ast$}]{op}
 \end{DoxyParamCaption}
 )}\label{group__oldfuncs_gab969f9d0407683f0e5abe73d0839a25b}
 
 
-\-Report whether a theora packet is a header or not \-This function does no verification beyond checking the header flag bit so it should not be used for bitstream identification; use \doxyref{theora\-\_\-decode\-\_\-header()}{p.}{group__oldfuncs_ga02915e63c1bd733ee291f577a8b75a82} for that. 
+Report whether a theora packet is a header or not This function does no verification beyond checking the header flag bit so it should not be used for bitstream identification; use \doxyref{theora\-\_\-decode\-\_\-header()}{p.}{group__oldfuncs_ga02915e63c1bd733ee291f577a8b75a82} for that. 
 
 
-\begin{DoxyParams}{\-Parameters}
-{\em op} & \-An ogg\-\_\-packet containing encoded theora data. \\
+\begin{DoxyParams}{Parameters}
+{\em op} & An ogg\-\_\-packet containing encoded theora data. \\
 \hline
 \end{DoxyParams}
 
-\begin{DoxyRetVals}{\-Return values}
-{\em 1} & \-The packet is a header packet \\
+\begin{DoxyRetVals}{Return values}
+{\em 1} & The packet is a header packet \\
 \hline
-{\em 0} & \-The packet is not a header packet (and so contains frame data)\\
+{\em 0} & The packet is not a header packet (and so contains frame data)\\
 \hline
 \end{DoxyRetVals}
-\-Thus function was added in the 1.\-0alpha4 release. \index{\-Legacy pre-\/1.\-0 C A\-P\-I@{\-Legacy pre-\/1.\-0 C A\-P\-I}!theora\-\_\-packet\-\_\-iskeyframe@{theora\-\_\-packet\-\_\-iskeyframe}}
-\index{theora\-\_\-packet\-\_\-iskeyframe@{theora\-\_\-packet\-\_\-iskeyframe}!Legacy pre-1.0 C API@{\-Legacy pre-\/1.\-0 C A\-P\-I}}
-\subsubsection[{theora\-\_\-packet\-\_\-iskeyframe}]{\setlength{\rightskip}{0pt plus 5cm}int {\bf theora\-\_\-packet\-\_\-iskeyframe} (
+Thus function was added in the 1.\-0alpha4 release. \index{Legacy pre-\/1.\-0 C A\-P\-I@{Legacy pre-\/1.\-0 C A\-P\-I}!theora\-\_\-packet\-\_\-iskeyframe@{theora\-\_\-packet\-\_\-iskeyframe}}
+\index{theora\-\_\-packet\-\_\-iskeyframe@{theora\-\_\-packet\-\_\-iskeyframe}!Legacy pre-1.0 C API@{Legacy pre-\/1.\-0 C A\-P\-I}}
+\subsubsection[{theora\-\_\-packet\-\_\-iskeyframe}]{\setlength{\rightskip}{0pt plus 5cm}int theora\-\_\-packet\-\_\-iskeyframe (
 \begin{DoxyParamCaption}
 \item[{ogg\-\_\-packet $\ast$}]{op}
 \end{DoxyParamCaption}
 )}\label{group__oldfuncs_ga39ccc8f847a748d7074c926b4fdd12b2}
 
 
-\-Report whether a theora packet is a keyframe or not. 
+Report whether a theora packet is a keyframe or not. 
 
 
-\begin{DoxyParams}{\-Parameters}
-{\em op} & \-An ogg\-\_\-packet containing encoded theora data. \\
+\begin{DoxyParams}{Parameters}
+{\em op} & An ogg\-\_\-packet containing encoded theora data. \\
 \hline
 \end{DoxyParams}
 
-\begin{DoxyRetVals}{\-Return values}
-{\em 1} & \-The packet contains a keyframe image \\
+\begin{DoxyRetVals}{Return values}
+{\em 1} & The packet contains a keyframe image \\
 \hline
-{\em 0} & \-The packet is contains an interframe delta \\
+{\em 0} & The packet is contains an interframe delta \\
 \hline
-{\em -\/1} & \-The packet is not an image data packet at all\\
+{\em -\/1} & The packet is not an image data packet at all\\
 \hline
 \end{DoxyRetVals}
-\-Thus function was added in the 1.\-0alpha4 release. \index{\-Legacy pre-\/1.\-0 C A\-P\-I@{\-Legacy pre-\/1.\-0 C A\-P\-I}!theora\-\_\-version\-\_\-number@{theora\-\_\-version\-\_\-number}}
-\index{theora\-\_\-version\-\_\-number@{theora\-\_\-version\-\_\-number}!Legacy pre-1.0 C API@{\-Legacy pre-\/1.\-0 C A\-P\-I}}
-\subsubsection[{theora\-\_\-version\-\_\-number}]{\setlength{\rightskip}{0pt plus 5cm}ogg\-\_\-uint32\-\_\-t {\bf theora\-\_\-version\-\_\-number} (
+Thus function was added in the 1.\-0alpha4 release. \index{Legacy pre-\/1.\-0 C A\-P\-I@{Legacy pre-\/1.\-0 C A\-P\-I}!theora\-\_\-version\-\_\-number@{theora\-\_\-version\-\_\-number}}
+\index{theora\-\_\-version\-\_\-number@{theora\-\_\-version\-\_\-number}!Legacy pre-1.0 C API@{Legacy pre-\/1.\-0 C A\-P\-I}}
+\subsubsection[{theora\-\_\-version\-\_\-number}]{\setlength{\rightskip}{0pt plus 5cm}ogg\-\_\-uint32\-\_\-t theora\-\_\-version\-\_\-number (
 \begin{DoxyParamCaption}
 \item[{void}]{}
 \end{DoxyParamCaption}
 )}\label{group__oldfuncs_gad181f4b19d455dcc2bef2533530b84c8}
 
 
-\-Retrieve a 32-\/bit version number. 
+Retrieve a 32-\/bit version number. 
 
-\-This number is composed of a 16-\/bit major version, 8-\/bit minor version and 8 bit sub-\/version, composed as follows\-: 
+This number is composed of a 16-\/bit major version, 8-\/bit minor version and 8 bit sub-\/version, composed as follows\-: 
 \begin{DoxyPre}
    (VERSION\_MAJOR<<16) + (VERSION\_MINOR<<8) + (VERSION\_SUB)
 \end{DoxyPre}
- \begin{DoxyReturn}{\-Returns}
-\-The version number. 
+ \begin{DoxyReturn}{Returns}
+The version number. 
 \end{DoxyReturn}
-\index{\-Legacy pre-\/1.\-0 C A\-P\-I@{\-Legacy pre-\/1.\-0 C A\-P\-I}!theora\-\_\-version\-\_\-string@{theora\-\_\-version\-\_\-string}}
-\index{theora\-\_\-version\-\_\-string@{theora\-\_\-version\-\_\-string}!Legacy pre-1.0 C API@{\-Legacy pre-\/1.\-0 C A\-P\-I}}
-\subsubsection[{theora\-\_\-version\-\_\-string}]{\setlength{\rightskip}{0pt plus 5cm}const char$\ast$ {\bf theora\-\_\-version\-\_\-string} (
+\index{Legacy pre-\/1.\-0 C A\-P\-I@{Legacy pre-\/1.\-0 C A\-P\-I}!theora\-\_\-version\-\_\-string@{theora\-\_\-version\-\_\-string}}
+\index{theora\-\_\-version\-\_\-string@{theora\-\_\-version\-\_\-string}!Legacy pre-1.0 C API@{Legacy pre-\/1.\-0 C A\-P\-I}}
+\subsubsection[{theora\-\_\-version\-\_\-string}]{\setlength{\rightskip}{0pt plus 5cm}const char$\ast$ theora\-\_\-version\-\_\-string (
 \begin{DoxyParamCaption}
 \item[{void}]{}
 \end{DoxyParamCaption}
 )}\label{group__oldfuncs_ga5a3da8fd262a60f055f96536eec06df2}
 
 
-\-Retrieve a human-\/readable string to identify the encoder vendor and version. 
+Retrieve a human-\/readable string to identify the encoder vendor and version. 
 
-\begin{DoxyReturn}{\-Returns}
-\-A version string. 
+\begin{DoxyReturn}{Returns}
+A version string. 
 \end{DoxyReturn}