Commit e62e1cf1 authored by conrad's avatar conrad

remove .sgml files, use .1 directly

parent 7df1eb0e
......@@ -76,11 +76,9 @@ if test $HAVE_DOXYGEN = "false"; then
AC_MSG_WARN([*** doxygen not found, docs will not be built])
fi
# Check for docbook
AC_CHECK_PROGS(DOCBOOKTOMAN, docbook-to-man docbook2man, false)
AM_CONDITIONAL(HAVE_DOCBOOKTOMAN, test "x$DOCBOOKTOMAN" != "xfalse")
AC_CHECK_PROG(HAVE_DOCBOOK2HTML, docbook2html, true, false)
AM_CONDITIONAL(HAVE_DOCBOOK2HTML,$HAVE_DOCBOOK2HTML)
# Check for man2html
AC_CHECK_PROG(HAVE_MAN2HTML, man2html, true, false)
AM_CONDITIONAL(HAVE_MAN2HTML, $HAVE_MAN2HTML)
# Check for valgrind
VALGRIND_ENVIRONMENT=""
......
docdir=$(prefix)/share/doc/@PACKAGE@
if HAVE_DOCBOOKTOMAN
man_MANS = oggz.1 oggz-diff.1 oggz-dump.1 oggz-info.1 oggz-known-codecs.1 oggz-merge.1 oggz-chop.1 \
oggz-sort.1 oggz-rip.1 oggz-comment.1 oggz-scan.1 oggz-validate.1
else
man_MANS =
check:
@echo "Error: Unable to build man pages, docbook-to-man required"
@false
endif
EXTRA_DIST = $(man_MANS) Doxyfile.in \
forcefeed.fig forcefeed.eps forcefeed.png \
hungry.fig hungry.eps hungry.png \
oggz.1.sgml oggz-diff.1.sgml oggz-dump.1.sgml oggz-info.1.sgml oggz-known-codecs.1.sgml oggz-merge.1.sgml \
oggz-chop.1.sgml oggz-sort.1.sgml oggz-rip.1.sgml oggz-comment.1.sgml \
oggz-scan.1.sgml oggz-validate.1.sgml
hungry.fig hungry.eps hungry.png
# ensure doxygen-build.stamp is included, or else the documentation will
# not be built or distributed
......@@ -25,17 +15,9 @@ html: oggz.1.html oggz-diff.1.html oggz-dump.1.html oggz-info.1.html oggz-known-
oggz-merge.1.html oggz-chop.1.html oggz-sort.1.html oggz-rip.1.html oggz-comment.1.html \
oggz-scan.1.html oggz-validate.1.html
if HAVE_DOCBOOKTOMAN
%.1: %.1.sgml
$(DOCBOOKTOMAN) $< > $@
else
%.1: %.1.sgml
endif
if HAVE_DOCBOOK2HTML
%.1.html: %.1.sgml
-docbook2html $<
mv index.html $@
if HAVE_MAN2HTML
%.1.html: %.1
man2html $< > $@
endif
if HAVE_DOXYGEN
......
.TH "oggz-chop" "1"
.SH "NAME"
oggz-chop \(em Extract the part of an Ogg file between given start and/or end times.
.SH "SYNOPSIS"
.PP
\fBoggz-chop\fR [\-o \fBfilename\fR | \-\-output \fBfilename\fR ] [\-s \fBstart_time\fR | \-\-start \fBstart_time\fR ] [\-e \fBend_time\fR | \-\-end \fBend_time\fR ] [\-k | \-\-no-skeleton ] filename
.PP
\fBoggz-chop\fR [\-h | \-\-help ] [\-v | \-\-version ]
.SH "Description"
.PP
\fBoggz-chop\fR chops a section of an Ogg file.
It correctly interprets the granulepos timestamps of Ogg Vorbis, Speex,
FLAC and Theora bitstreams, and all bitstreams of Annodex files.
.PP
The output file contains copies of the headers of the input file, and
all the codec data required to correctly decode the content between the
start and end times specified on the commandline. For codecs with data
dependencies like video keyframes, the keyframe prior to the starting
time will be included in the output.
.PP
Note that \fBoggz-chop\fR operates by copying pages of
Ogg data; it does not strip partial packets from the first or last
data page included in the output. It does however ensure to set the
end of stream flag on the last page of each logical bitstream.
.PP
Skeleton handling: By default, the output will contain a Skeleton track
specifying the start of the chop as presentation time.
.SH "Options"
.PP
\fBoggz-chop\fR accepts the following options:
.SS "Output options"
.IP "\-o \fBfilename\fR, \-\-output \fBfilename\fR" 10
Write output to the specified
\fBfilename\fR instead of printing it to
standard output.
.IP "\-s \fBstart_time\fR, \-\-start \fBstart_time\fR" 10
Specify the start time of the chopped section to output.
.IP "\-e \fBend_time\fR, \-\-end \fBend_time\fR" 10
Specify the end time of the chopped section to output.
.IP "\-k , \-\-no-skeleton" 10
Do NOT include a Skeleton bitstream in the output.
.IP "\-h, \-\-help" 10
Display usage information and exit.
.IP "\-v, \-\-version" 10
Output version information and exit.
.SH "Server configuration"
.PP
The following configuration for Apache httpd will enable oggz-chop. As with
most Apache directives, this may of course be restricted to particular
Directories or Locations:
.PP
ScriptAlias /oggz-chop /usr/bin/oggz-chop
.PP
Action application/ogg /oggz-chop
.SS "HTTP/1.1 Cacheability"
.PP
oggz-chop generates Last-Modified HTTP headers, and
responds correctly to If-Modified-Since conditional GET requests.
.SH "AUTHOR"
.PP
Conrad Parker February 25, 2008;
.SH "COPYRIGHT"
.PP
Copyright \(co 2008 Annodex Association
.SH "SEE ALSO"
.PP
\fBoggz-validate\fP\fB(1)\fP,
\fBoggzmerge\fP\fB(1)\fP,
\fBoggzdump\fP\fB(1)\fP,
\fBhogg\fP\fB(1)\fP
.\" created by instant / docbook-to-man, Mon 23 Feb 2009, 12:35
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN"[
<!-- Process this file with docbook-to-man to generate an nroff manual
page: `docbook-to-man manpage.sgml > manpage.1'. You may view
the manual page with: `docbook-to-man manpage.sgml | nroff -man |
less'. A typical entry in a Makefile or Makefile.am is:
manpage.1: manpage.sgml
docbook-to-man $< > $@
-->
<!-- Fill in your name for FIRSTNAME and SURNAME. -->
<!ENTITY dhfirstname "<firstname>Conrad</firstname>">
<!ENTITY dhsurname "<surname>Parker</surname>">
<!-- Please adjust the date whenever revising the manpage. -->
<!ENTITY dhdate "<date>February 25, 2008</date>">
<!-- SECTION should be 1-8, maybe w/ subsection other parameters are
allowed: see man(7), man(1). -->
<!ENTITY dhsection "<manvolnum>1</manvolnum>">
<!ENTITY dhemail "<email>conrad@annodex.net</email>">
<!ENTITY dhusername "Annodex Association">
<!ENTITY dhucpackage "<refentrytitle>oggz-chop</refentrytitle>">
<!ENTITY dhpackage "oggz-chop">
<!ENTITY debian "<productname>Debian GNU/Linux</productname>">
<!ENTITY gnu "<acronym>GNU</acronym>">
]>
<refentry id="oggz-chop">
<refentryinfo>
<address>
&dhemail;
</address>
<author>
&dhfirstname;
&dhsurname;
</author>
<copyright>
<year>2008</year>
<holder>&dhusername;</holder>
</copyright>
&dhdate;
</refentryinfo>
<refmeta>
&dhucpackage;
&dhsection;
</refmeta>
<refnamediv>
<refname>&dhpackage;</refname>
<refpurpose>Extract the part of an Ogg file between given start and/or end times.
</refpurpose>
</refnamediv>
<!-- A warning of
"document type does not allow element "PARAMETER" here"
for all the <parameter> tags in the refsynopsisdiv.
Ignore them as the <parameter> tag still gets interpreted correctly in
the manpage. Deleting the tag however results in non-underlined
-->
<refsynopsisdiv>
<cmdsynopsis>
<command>&dhpackage;</command>
<group>
<arg choice="opt">-o <parameter>filename</parameter></arg>
<arg choice="opt">--output <parameter>filename</parameter></arg>
</group>
<group>
<arg choice="opt">-s <parameter>start_time</parameter></arg>
<arg choice="opt">--start <parameter>start_time</parameter></arg>
</group>
<group>
<arg choice="opt">-e <parameter>end_time</parameter></arg>
<arg choice="opt">--end <parameter>end_time</parameter></arg>
</group>
<group><arg choice="opt">-k</arg><arg choice="opt">--no-skeleton</arg></group>
<arg choice="plain">filename</arg>
</cmdsynopsis>
<cmdsynopsis>
<command>&dhpackage;</command>
<group><arg choice="opt">-h</arg><arg choice="opt">--help</arg></group>
<group><arg choice="opt">-v</arg><arg choice="opt">--version</arg></group>
</cmdsynopsis>
</refsynopsisdiv>
<refsect1>
<title>Description</title>
<para>
<command>&dhpackage;</command> chops a section of an Ogg file.
It correctly interprets the granulepos timestamps of Ogg Vorbis, Speex,
FLAC and Theora bitstreams, and all bitstreams of Annodex files.
</para>
<para>
The output file contains copies of the headers of the input file, and
all the codec data required to correctly decode the content between the
start and end times specified on the commandline. For codecs with data
dependencies like video keyframes, the keyframe prior to the starting
time will be included in the output.
</para>
<para>
Note that <command>&dhpackage</command> operates by copying pages of
Ogg data; it does not strip partial packets from the first or last
data page included in the output. It does however ensure to set the
end of stream flag on the last page of each logical bitstream.
</para>
<para>
Skeleton handling: By default, the output will contain a Skeleton track
specifying the start of the chop as presentation time.
</para>
</refsect1>
<refsect1>
<title>Options</title>
<para>
<command>&dhpackage;</command> accepts the following options:
</para>
<refsect2>
<title>Output options</title>
<variablelist>
<varlistentry>
<term>-o <parameter>filename</parameter>, --output <parameter>filename</parameter></term>
<listitem><para>Write output to the specified
<parameter>filename</parameter> instead of printing it to
standard output.
</para></listitem>
</varlistentry>
<varlistentry>
<term>-s <parameter>start_time</parameter>, --start <parameter>start_time</parameter></term>
<listitem><para>Specify the start time of the chopped section to output.
</para></listitem>
</varlistentry>
<varlistentry>
<term>-e <parameter>end_time</parameter>, --end <parameter>end_time</parameter></term>
<listitem><para>Specify the end time of the chopped section to output.
</para></listitem>
</varlistentry>
<varlistentry>
<term>-k , --no-skeleton</term>
<listitem><para>Do NOT include a Skeleton bitstream in the output.
</para></listitem>
</varlistentry>
</variablelist>
<title>Miscellaneous options</title>
<variablelist>
<varlistentry>
<term>-h, --help</term>
<listitem><para>Display usage information and exit.</para></listitem>
</varlistentry>
<varlistentry>
<term>-v, --version</term>
<listitem><para>Output version information and exit.</para></listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsect1>
<refsect1>
<title>Server configuration</title>
<para>
The following configuration for Apache httpd will enable oggz-chop. As with
most Apache directives, this may of course be restricted to particular
Directories or Locations:
</para>
<para>
ScriptAlias /oggz-chop /usr/bin/oggz-chop
</para><para>
Action application/ogg /oggz-chop
</para>
<refsect2>
<title>HTTP/1.1 Cacheability</title>
<para>
oggz-chop generates Last-Modified HTTP headers, and
responds correctly to If-Modified-Since conditional GET requests.
</para>
</refsect2>
</refsect1>
<refsect1>
<title>AUTHOR</title>
<para>
<author>
&dhfirstname; &dhsurname;
</author>
&dhdate
</para>
</refsect1>
<refsect1>
<title>COPYRIGHT</title>
<para>
Copyright &copy; 2008 &dhusername;
</para>
</refsect1>
<refsect1>
<title>SEE ALSO</title>
<para>
<citerefentry>
<refentrytitle>oggz-validate</refentrytitle>
<manvolnum>1</manvolnum>
</citerefentry>,
<citerefentry>
<refentrytitle>oggzmerge</refentrytitle>
<manvolnum>1</manvolnum>
</citerefentry>,
<citerefentry>
<refentrytitle>oggzdump</refentrytitle>
<manvolnum>1</manvolnum>
</citerefentry>,
<citerefentry>
<refentrytitle>hogg</refentrytitle>
<manvolnum>1</manvolnum>
</citerefentry>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:2
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:nil
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->
.TH "oggz-comment" "1"
.SH "NAME"
oggz-comment \(em List or edit comments in an Ogg file.
.SH "SYNOPSIS"
.PP
\fBoggz-comment\fR [\-l | \-\-list ]
.PP
\fBoggz-comment\fR [\-o \fBfilename\fR | \-\-output \fBfilename\fR ] [\-d | \-\-delete ] [\-a | \-\-all ] [\-s \fBserialno\fR | \-\-serialno \fBserialno\fR ] [\-c \fBcontent-type\fR | \-\-content-type \fBcontent-type\fR ] filename
.PP
\fBoggz-comment\fR [\-h | \-\-help ] [\-v | \-\-version ]
.SH "Description"
.PP
\fBoggz-comment\fR lists or edits the comments of
an Ogg file.
.SH "Options"
.PP
\fBoggz-comment\fR accepts the following options:
.SS "Listing options"
.IP "\-l, \-\-list" 10
List the comments in the given file.
.SS "Editing options"
.IP "\-o \fBfilename\fR, \-\-output \fBfilename\fR" 10
Write output to the specified
\fBfilename\fR.
.IP "\-d, \-\-delete" 10
Delete comments before editing.
.IP "\-a, \-\-all" 10
Edit comments for all logical bitstreams.
.IP "\-c \fBcontent-type\fR, \-\-content-type \fBcontent-type\fR" 10
Edit comments of the logical bitstreams with
specified \fBcontent-type\fR.
The following codec names are currently detected:
"cmml", "flac", "theora", "speex", "vorbis"
.IP "\-s \fBserialno\fR, \-\-serialno \fBserialno\fR" 10
Edit comments of the logical bitstream with
specified \fBserialno\fR.
.SS "Miscellaneous options"
.IP "\-h, \-\-help" 10
Display usage information and exit.
.IP "\-v, \-\-version" 10
Output version information and exit.
.SH "AUTHOR"
.PP
Kangyuan Niu August 5, 2007;
.SH "COPYRIGHT"
.PP
Copyright \(co 2007 Annodex Association
.SH "SEE ALSO"
.PP
\fBvorbiscomment\fP\fB(1)\fP,
\fBogginfo\fP\fB(1)\fP,
\fBoggzinfo\fP\fB(1)\fP,
\fBhogg\fP\fB(1)\fP
.\" created by instant / docbook-to-man, Mon 23 Feb 2009, 12:35
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN"[
<!-- Process this file with docbook-to-man to generate an nroff manual
page: `docbook-to-man manpage.sgml > manpage.1'. You may view
the manual page with: `docbook-to-man manpage.sgml | nroff -man |
less'. A typical entry in a Makefile or Makefile.am is:
manpage.1: manpage.sgml
docbook-to-man $< > $@
-->
<!-- Fill in your name for FIRSTNAME and SURNAME. -->
<!ENTITY dhfirstname "<firstname>Kangyuan</firstname>">
<!ENTITY dhsurname "<surname>Niu</surname>">
<!-- Please adjust the date whenever revising the manpage. -->
<!ENTITY dhdate "<date>August 5, 2007</date>">
<!-- SECTION should be 1-8, maybe w/ subsection other parameters are
allowed: see man(7), man(1). -->
<!ENTITY dhsection "<manvolnum>1</manvolnum>">
<!ENTITY dhemail "<email>conrad@metadecks.org</email>">
<!ENTITY dhusername "Annodex Association">
<!ENTITY dhucpackage "<refentrytitle>oggz-comment</refentrytitle>">
<!ENTITY dhpackage "oggz-comment">
<!ENTITY debian "<productname>Debian GNU/Linux</productname>">
<!ENTITY gnu "<acronym>GNU</acronym>">
]>
<refentry id="oggz-comment">
<refentryinfo>
<address>
&dhemail;
</address>
<author>
&dhfirstname;
&dhsurname;
</author>
<copyright>
<year>2007</year>
<holder>&dhusername;</holder>
</copyright>
&dhdate;
</refentryinfo>
<refmeta>
&dhucpackage;
&dhsection;
</refmeta>
<refnamediv>
<refname>&dhpackage;</refname>
<refpurpose>List or edit comments in an Ogg file.
</refpurpose>
</refnamediv>
<!-- A warning of
"document type does not allow element "PARAMETER" here"
for all the <parameter> tags in the refsynopsisdiv.
Ignore them as the <parameter> tag still gets interpreted correctly in
the manpage. Deleting the tag however results in non-underlined
-->
<refsynopsisdiv>
<cmdsynopsis>
<command>&dhpackage;</command>
<group><arg choice="opt">-l</arg><arg choice="opt">--list</arg></group>
</cmdsynopsis>
<cmdsynopsis>
<command>&dhpackage;</command>
<group>
<arg choice="opt">-o <parameter>filename</parameter></arg>
<arg choice="opt">--output <parameter>filename</parameter></arg>
</group>
<group><arg choice="opt">-d</arg><arg choice="opt">--delete</arg></group>
<group><arg choice="opt">-a</arg><arg choice="opt">--all</arg></group>
<group>
<arg choice="opt">-s <parameter>serialno</parameter></arg>
<arg choice="opt">--serialno <parameter>serialno</parameter></arg>
</group>
<group>
<arg choice="opt">-c <parameter>content-type</parameter></arg>
<arg choice="opt">--content-type <parameter>content-type</parameter></arg>
</group>
<arg choice="plain">filename</arg>
</cmdsynopsis>
<cmdsynopsis>
<command>&dhpackage;</command>
<group><arg choice="opt">-h</arg><arg choice="opt">--help</arg></group>
<group><arg choice="opt">-v</arg><arg choice="opt">--version</arg></group>
</cmdsynopsis>
</refsynopsisdiv>
<refsect1>
<title>Description</title>
<para>
<command>&dhpackage;</command> lists or edits the comments of
an Ogg file.
</para>
</refsect1>
<refsect1>
<title>Options</title>
<para>
<command>&dhpackage;</command> accepts the following options:
</para>
<refsect2>
<title>Listing options</title>
<variablelist>
<varlistentry>
<term>-l, --list</term>
<listitem><para>List the comments in the given file.</para></listitem>
</varlistentry>
</variablelist>
</refsect2>
<refsect2>
<title>Editing options</title>
<variablelist>
<varlistentry>
<term>-o <parameter>filename</parameter>, --output <parameter>filename</parameter></term>
<listitem><para>Write output to the specified
<parameter>filename</parameter>.
</para></listitem>
</varlistentry>
<varlistentry>
<term>-d, --delete</term>
<listitem><para>Delete comments before editing.</para></listitem>
</varlistentry>
</variablelist>
<varlistentry>
<term>-a, --all</term>
<listitem><para>Edit comments for all logical bitstreams.</para></listitem>
</varlistentry>
</variablelist>
<varlistentry>
<term>-c <parameter>content-type</parameter>, --content-type <parameter>content-type</parameter></term>
<listitem><para>Edit comments of the logical bitstreams with
specified <parameter>content-type</parameter>.
The following codec names are currently detected:
"cmml", "flac", "theora", "speex", "vorbis"
</para></listitem>
</varlistentry>
</varlistentry>
<varlistentry>
<term>-s <parameter>serialno</parameter>, --serialno <parameter>serialno</parameter></term>
<listitem><para>Edit comments of the logical bitstream with
specified <parameter>serialno</parameter>.</para></listitem>
</varlistentry>
</variablelist>
</refsect2>
<refsect2>
<title>Miscellaneous options</title>
<variablelist>
<varlistentry>
<term>-h, --help</term>
<listitem><para>Display usage information and exit.</para></listitem>
</varlistentry>
<varlistentry>
<term>-v, --version</term>
<listitem><para>Output version information and exit.</para></listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsect1>
<refsect1>
<title>AUTHOR</title>
<para>
<author>
&dhfirstname; &dhsurname;
</author>
&dhdate
</para>
</refsect1>
<refsect1>
<title>COPYRIGHT</title>
<para>
Copyright &copy; 2007 &dhusername;
</para>
</refsect1>
<refsect1>
<title>SEE ALSO</title>
<para>
<citerefentry>
<refentrytitle>vorbiscomment</refentrytitle>
<manvolnum>1</manvolnum>
</citerefentry>,
<citerefentry>
<refentrytitle>ogginfo</refentrytitle>
<manvolnum>1</manvolnum>
</citerefentry>,
<citerefentry>
<refentrytitle>oggzinfo</refentrytitle>
<manvolnum>1</manvolnum>
</citerefentry>,
<citerefentry>
<refentrytitle>hogg</refentrytitle>
<manvolnum>1</manvolnum>
</citerefentry>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:2
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:nil
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->
.TH "oggz-diff" "1"
.SH "NAME"
oggz-diff \(em Hexdump the packets of two Ogg files and output differences
.SH "SYNOPSIS"
.PP
\fBoggz-diff\fR [options] [OGGZDUMP_OPTIONS] [DIFF_OPTIONS] file1.ogg file2.ogg
.PP
\fB\fBoptions:\fR\fR [\-\-verbose ] [\-v | \-\-version ] [\-h | \-\-help ]
.PP
\fB\fBOGGZDUMP_OPTIONS:\fR\fR [\-b | \-\-binary ] [\-x | \-\-hexadecimal ] [\-c content-type | \-\-content-type content-type ] [\-s serialno | \-\-serialno serialno ] [\-O | \-\-hide-offset ] [\-S | \-\-hide-serialno ] [\-G | \-\-hide-granulepos ] [\-P | \-\-hide-packetno ]
.PP
\fB\fBDIFF_OPTIONS:\fR\fR [\-q | \-\-brief ] [\-C NUM | \-\-context[=NUM] ] [\-u | \-U NUM | \-\-unified[=NUM] ] [\-e | \-\-ed ] [\-\-normal ] [\-\-rcs ] [\-y | \-\-side-by-side ] [\-l | \-\-paginate ]
.SH "Description"
.PP
\fBoggz-diff\fR is a \fBsh\fR script which
uses \fBoggzdump\fR to generate hexadecimal packet dumps
of each input file, then outputs the difference between these dumps
using \fBdiff\fR.
.SH "Options"
.PP
\fBoggz-diff\fR forwards a subset of options
accepted by \fBoggzdump\fR and \fBdiff\fR.
See
\fBoggzdump\fP\fB(1)\fP and
\fBdiff\fP\fB(1)\fP for more detail.
.SS "oggzdump format options"
.IP "\-b, \-\-binary" 10
Generate a binary dump of each packet
.IP "\-x, \-\-hexadeciaml" 10
Generate a hexadecimal dump of each packet
.SS "oggzdump filtering options"
.IP "\-c \fBcontent-type\fR, \-\-content-type \fBcontent-type\fR" 10
Dump only the logical bitstreams for a specific
\fBcontent-type\fR. The following codec names
are currently detected: "cmml", "flac", "theora", "speex", "vorbis"
.IP "\-s \fBserialno\fR, \-\-serialno \fBserialno\fR" 10
Dump only the logical bitstream with specified
\fBserialno\fR.
.IP "\-O, \-\-hide-offset" 10
Hide the byte offset field of the preamble for
each packet dumped. This is particularly useful when comparing
Ogg bitstreams that differ only in page structure.
.IP "\-S, \-\-hide-serialno" 10
Hide the serialno field of the preamble for
each packet dumped. This is particularly useful when comparing
Ogg bitstreams that differ only in serialno assignment.
.IP "\-G, \-\-hide-granulepos" 10
Hide the granulepos field of the preamble for
each packet dumped.
.IP "\-P, \-\-hide-packetno" 10
Hide the packetno field of the preamble for
each packet dumped.
.SS "diff options"
.PP
The \-w (\-\-ignore-all-space) option to \fBdiff\fR is always implied.
.IP "\-q, \-\-brief" 10
Output only whether files differ.
.IP "\-C \fBNUM\fR, \-\-context[=\fBNUM\fR]" 10
Output NUM lines of copied context.
.IP "\-u, \-U \fBNUM\fR, \-\-unified[=\fBNUM\fR]" 10
Output NUM (default 3) lines of unified context.