and add missing hyphens in SEE ALSO sections

Since theora version 3.2.1, the mapping from granules to time
has been shifted by 1, such that the first frame of a newly
encoded file is numbered 1, not 0. Detect that in auto_theora(),
and also report the Theora version in oggz info.

Adds oggz_bounded_seek_set() public API call.

For a single file, comma-separated output, don't put the
terminating newline on stdout, so that the program output
can be used in an HTML5 <video> codecs attribute.

(merged from hogg man page examples)

add 'codecs' tool, to show a list of codecs present in a bitstream (only the first link in a chain is supported)

throughout (#include with "" not <>)

For Mozilla bug 483912

The function guess() seems to me to be a stab-in-the-dark since it does
not know how long the file is in actual units. Here are the changes:

1) If guess() returns a position beyond the end of the file, reset to the end
2) Before guessing, determine the length in units.
3) Fix the output when DEBUG is defined.

See http://lists.xiph.org/pipermail/ogg-dev/2009-May/001390.html

This is returned by oggz_tell() and can be queried within a ReadPage callback.

The packetno has not yet been incremented, so the value to
check is off-by-one

Re: http://lists.xiph.org/pipermail/ogg-dev/2008-July/001108.html

this doesn't return anything at all, and whatever it might return isn't checked, so it might as well be void

Patch by Ralph Giles

Patch by Ian Malone: If the size for the mode section doesn't match
the number counted back then allow going forward one block and trying
again. oggzinfo with and without this change produce the same results
on about 1500 vorbis files (though they're mostly encoded using the
same quality setting).
See http://lists.xiph.org/pipermail/vorbis-dev/2009-March/019823.html

git-svn-id: http://svn.annodex.net/liboggz/trunk@3904 8158c8cd-e7e1-0310-9fa4-c5954c97daef

git-svn-id: http://svn.annodex.net/liboggz/trunk@3903 8158c8cd-e7e1-0310-9fa4-c5954c97daef

See https://bugzilla.mozilla.org/show_bug.cgi?id=475441#c47

git-svn-id: http://svn.annodex.net/liboggz/trunk@3902 8158c8cd-e7e1-0310-9fa4-c5954c97daef

git-svn-id: http://svn.annodex.net/liboggz/trunk@3898 8158c8cd-e7e1-0310-9fa4-c5954c97daef

git-svn-id: http://svn.annodex.net/liboggz/trunk@3890 8158c8cd-e7e1-0310-9fa4-c5954c97daef

port from libfishsound

git-svn-id: http://svn.annodex.net/liboggz/trunk@3889 8158c8cd-e7e1-0310-9fa4-c5954c97daef

Avoid overflow in comment lengths

git-svn-id: http://svn.annodex.net/liboggz/trunk@3882 8158c8cd-e7e1-0310-9fa4-c5954c97daef

git-svn-id: http://svn.annodex.net/liboggz/trunk@3881 8158c8cd-e7e1-0310-9fa4-c5954c97daef

page accumulator actually contains packets from the new GOP.
Previously we always included the last page with granulepos
from the previous GOP, in case it also contained the start of a
new packet. We now explicitly check if we can rule out this
possibility by remembering whether the successive page was
continued: we only include the earlier page if so.
This avoids adding preceding garbage where possible, ie. if
the keyframe starts a new page. This is uncommon with current
Theora encoders, but it is the normal (advised) case for Dirac.

git-svn-id: http://svn.annodex.net/liboggz/trunk@3880 8158c8cd-e7e1-0310-9fa4-c5954c97daef

Store Dirac pages from dist=0 (not offset=0 as for Theora)

git-svn-id: http://svn.annodex.net/liboggz/trunk@3879 8158c8cd-e7e1-0310-9fa4-c5954c97daef

git-svn-id: http://svn.annodex.net/liboggz/trunk@3878 8158c8cd-e7e1-0310-9fa4-c5954c97daef

Required for Mozilla bug 481933
Exposes detected HOLE_IN_DATA as return value from oggz_read(), oggz_read_input(),
+ add documentation for extra return values

git-svn-id: http://svn.annodex.net/liboggz/trunk@3877 8158c8cd-e7e1-0310-9fa4-c5954c97daef

git-svn-id: http://svn.annodex.net/liboggz/trunk@3876 8158c8cd-e7e1-0310-9fa4-c5954c97daef