/usr/share/doc/libtheora-doc/latex/index.tex is in libtheora-doc 1.1.1+dfsg.1-14.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 | \section{Introduction}\label{index_intro}
This is the documentation for {\ttfamily libtheora} C A\+PI. The current reference implementation for {\tt Theora}, a free, patent-\/unencumbered video codec. Theora is derived from On2\textquotesingle{}s V\+P3 codec with additional features and integration with Ogg multimedia formats by {\tt the Xiph.\+Org Foundation}. Complete documentation of the format itself is available in {\tt the Theora specification}.\subsection{Organization}\label{index_Organization}
The functions documented here are actually subdivided into three separate libraries\+:
\begin{DoxyItemize}
\item {\ttfamily libtheoraenc} contains the encoder interface, described in \doxyref{Functions for Encoding}{p.}{group__encfuncs}.
\item {\ttfamily libtheoradec} contains the decoder interface and routines shared with the encoder. You must also link to this if you link to {\ttfamily libtheoraenc}. The routines in this library are described in \doxyref{Functions for Decoding}{p.}{group__decfuncs} and \doxyref{Functions Shared by Encode and Decode}{p.}{group__basefuncs}.
\item {\ttfamily libtheora} contains the \doxyref{Legacy pre-\/1.\+0 C A\+PI}{p.}{group__oldfuncs}.
\end{DoxyItemize}
New code should link to {\ttfamily libtheoradec} and, if using encoder features, {\ttfamily libtheoraenc}. Together these two export both the standard and the legacy A\+PI, so this is all that is needed by any code. The older {\ttfamily libtheora} library is provided just for compatibility with older build configurations.
In general the recommended 1.\+x A\+PI symbols can be distinguished by their {\ttfamily th\+\_\+} or {\ttfamily T\+H\+\_\+} namespace prefix. The older, legacy A\+PI uses {\ttfamily theora\+\_\+} or {\ttfamily O\+C\+\_\+} prefixes instead.
|