When a match fails, the index of the position in the link needs to
 be 64 bits.

op_find_initial_pcm_offset() would swallow any holes at the start
 of a link, but seekable streams did not use it when crossing a
 link boundary, so they would report a hole.
This unifies the hole reporting between the two, and also
 simplifies the seeking code (which also needs to ignore holes) a
 bit.

1) Check for allocation failure and fall back to merely scanning a
 file for consistent timestamps instead of loading it to RAM.
2) Report holes, but do not quit scanning/loading unless they cause
 a discontinuity in the timestamps.

The simple git-version script asks git for the current
revision, and falls back to 'unknown' if the result is
empty. This will have little effect until we have tags
in the repository.

We use the FILE_VERSION_FILTER option on doxygen to
embed this in the documentation with each file reference.

Unfortunately, there doesn't seem to be a way to
set PROJECT_NUMBER globally in the same way. This
commit unsets that option to avoid confusing references
in the generated documentation.

Just runs doxygen for us, an optionally latex.
The 'clean' target removes the doxygen output
directories.

This is just to help us validate the api docs as they're
added. By using a minimal Doxyfile we save space, make
it easier to read, and avoid warnings from deprecated
and unknown options across different doxygen versions.

Apparently just declaring the functions in the header is not good
 enough.
Currently completely untested.

3f18c55f moved it out of opus/, so strip the prefix.

If a source file moves (as in the previous commit), any stale
dependencies will block execution of 'make' because they
define a dependency relationship to an non-existant file.

The obvious thing to do is 'make clean' to get rid of the
dependency files, but of course that fails the same way.
To support this recovery, skip the include directive if
the GNU make variable MAKECMDGOALS is 'clean', exempting
this target from dependency checks.

Based on an example in the GNU make manual.

This matches the convention used by opus itself, where
headers are included without a prefix, and the build
must do -I/path/to/opus to find the appropriate versions.

More consistent formatting, s/file/stream/g, and finish adding
 function warning attributes.

The actual problem was that opus-uninstalled.pc was forcing static
 linking, but not including all the relevant libraries.

This is needed to pick up -lm for libopus when it requires it.

Move this out of opusfile_example and into the API proper.

It's not actually used by the examples anymore.

Needed to build on my Fedora 16 machine.

This fixes the build to use the headers returned by pkg-config.
The opus library assumes the called will pass -I/path/to/opus
so #include <opus.h> will work.

It wasn't used, and version control has now preserved it forever,
 so no reason to keep it around.

It wasn't actually implemented.

Seeking and playback work, at least as far as the examples test
 them.
There are probably still lots of bugs.