Remove a misleading comment about VBR quality request range.

The documentation says the range is -0.1 to 1.0, but these comments
started the range at 0.0. Against expectations, it looks like the
documentation is correct.

Patch from Douglas Bagnall <douglas@paradise.net.nz>.

svn path=/trunk/vorbis/; revision=16790

Shift vorbisenc API docs into doxygen 2/2 (add doxygen)

Until now the libvorbisenc API has been documented via static html
pages in doc/vorbisenc/.  This patch moves that documentation into the
vorbisenc.h header.

For the most part, the text was copied unchanged, except where doxygen
was better able to say something in its own way.  For example, the
\deprecated tag changed the format of deprecation messages.  A few
trivial misspelling's were fixed, including some that doxygen caught.
Some of the narrative flow of the original was lost, as doxygen
reorders documentation according to its own plan, so I changed a few
phrases on account of this loss of context.

Some ordinary comments in the header were obviated by the doxygen and
removed.

Neither the overview documentation in overview.html nor the examples
in examples.html are included in the header, nor are the functions
that are exposed by including vorbisenc.h but which are actually
declared in codecs.h.

Patch from Douglas Bagnall <douglas@paradise.net.nz>.

svn path=/trunk/vorbis/; revision=16789

Shift vorbisenc API docs into doxygen 1/2 (reorder defines)

In order to group the documentation of the OV_ECTL_* constants used
with vorbis_encode_ctl, their definitions need to be adjacent.

This patch only moves the defines; the next only touches comments.

Patch from Douglas Bagnall <douglas@paradise.net.nz>.

svn path=/trunk/vorbis/; revision=16788

set HAVE_DOXYGEN=false in else

svn path=/trunk/vorbis/; revision=16786

Define the HAVE_DOXYGEN conditional unconditionally so the configure
script completes even with --disable-docs.

svn path=/trunk/vorbis/; revision=16785

add doxygen build system

svn path=/trunk/vorbis/; revision=16784

Add official channel ordering/location for 6.1/7.1 surround.

svn path=/trunk/vorbis/; revision=16781

Cleanup pass on the vorbisenc documentation.

svn path=/trunk/vorbis/; revision=16757

Add rough reference documentation for the main encoding calls.

These are a bit rough in that the main calls are declared in codec.h,
and not vorbisenc.h as one might expect for the encoder. Nevertheless
I felt this was helpful to those trying to use the encoder since there
is no 'Programming with libvorbis' documenation at all.

The error return values listed don't entirely match what the code will
actually provide, but they're all good ones to check for anyway.

Note of the new pages have hyperlinked function or structure names.

svn path=/trunk/vorbis/; revision=16756

Documenation fix: functions are in vorbisfile.h, not libvorbisfile.h.

svn path=/trunk/vorbis/; revision=16755

linked statically to c runtime for windows mobile.

svn path=/trunk/vorbis/; revision=16724

Put in the magic maintainer-mode invocation to configure.ac, otherwise sometimes
autotools goes off into a corner and shoots itself.

svn path=/trunk/vorbis/; revision=16701

Don't allow ordered codebooks with codeword lengths longer than 32 bits.

svn path=/trunk/vorbis/; revision=16597

Changed the C runtime library to the default option - dynamic runtime library.

svn path=/trunk/vorbis/; revision=16595

add pkg.m4 to vorbis, that way ./autogen.sh works on systems that dont have pkg-config installed

svn path=/trunk/vorbis/; revision=16592

Modify fix for Trac #1572; some files from the earliest beta
accidentally used an oversized phrasebook in res decode; allow these
[technically corrept] files to play.  The attack fix is still
watertight, the check is simply made in a different way.

svn path=/trunk/vorbis/; revision=16552

Bumped libogg version to 1.1.4 and fixed dynamic compilation because of missing export function.

svn path=/trunk/vorbis/; revision=16335

More extensive / difficult to abuse version of #1573 fix.  Makes it abunduntly clear that the DSP state is uninitialized.

svn path=/trunk/vorbis/; revision=16330

Similarly check for error in seeking_example

svn path=/trunk/vorbis/; revision=16329

Fix for Trac #1573.

This is two bugs.  The first is that vorbisfile_example.c ignores an
error code and plows ahead blindly if libvorbisfile reports the
current bitstream section is bad (OV_EBADLINK).

The second is that retrying after the error crashes libvorbisfile due
to the unitialized state.

svn path=/trunk/vorbis/; revision=16328

Commit fix to Trac #1572; the erroneous setup was being checked for, but not completely.

svn path=/trunk/vorbis/; revision=16327

Eliminate possibility of booklist overflow in res0/1/2 unpacking.

svn path=/trunk/vorbis/; revision=16326

Eliminate a correct but harmless 'unititialized variable' warning from libvorbisfile compile.

svn path=/trunk/vorbis/; revision=16246

Bump build system versions for release

Move the OV_EXCLUDE_STATIC_CALLBACKS define up to fix another symbol
warning ala Trac #1560

svn path=/trunk/vorbis/; revision=16243

Commit a vorbisfile short-file fix; consists of several fixes to reinitialization post-seek.  Fixes gentoo BZ# 276594

Important fix for games that use many small sound files; necessary to fix playback for single-audio-page Vorbis files.

svn path=/trunk/vorbis/; revision=16228

Remove trailing whitespace

svn path=/trunk/vorbis/; revision=16227

analysis output / trailing whitespace cleanup

svn path=/trunk/vorbis/; revision=16226

Trac #1549; enable slower but higher precision floor 0 LSP code.
Modern CPUs are fast enough to not even notice.

svn path=/trunk/vorbis/; revision=16225

applied Trac #1548

svn path=/trunk/vorbis/; revision=16224

correct FPU control word setting bug (Trac #1547)

svn path=/trunk/vorbis/; revision=16223

Commit additional hardening to seyup packet decode; some of the checks are redundant, but possibly a good proof against future changes.

svn path=/trunk/vorbis/; revision=16222

Fix for Mozilla BZ #501279

Will need to review/patch Tremor as well, more thorough pattern review
of unpacking in the face of incomplete header packets in progress in
mainline as well.

svn path=/trunk/vorbis/; revision=16218

Correct a potential* comment length sanity check overflow.

*as defined by the Derf Convention.

svn path=/trunk/vorbis/; revision=16217

Kick things off with a version bump

svn path=/trunk/vorbis/; revision=16216

Commit updates to the Vorbis I spec highlighting rejection cases
fixed in r16181 and 16182.

svn path=/trunk/vorbis/; revision=16183

Second half of fix to Mozilla BZ # 5000254: sanity check the floor 1
post list to reject files with repeated values that would result in
floor line segments with zero length.

svn path=/trunk/vorbis/; revision=16182

First half of fix for Mozilla BZ #500254

Residue code was not checking that its partition books were books with
specified/populated value mappings.  Fuzzer twiddled the book table suck that a valid codebook was being swapped out for a codebook with no value mapping.

svn path=/trunk/vorbis/; revision=16181

Update CHANGES for release

svn path=/trunk/vorbis/; revision=16168

Update macosx info.plist

svn path=/trunk/vorbis/; revision=16162

Oops, missed version update in configure.ac

svn path=/trunk/vorbis/; revision=16157

Bump lib version for full release.

svn path=/trunk/vorbis/; revision=16155

Bump versions for release candidate.  This time for real.

svn path=/trunk/vorbis/; revision=16077

Handle the case of single-entry codebooks; this had been broken accidentally in earlier security fixes.  Resolves GNOME 582942, thanks for the additional file to add to regression testing.

svn path=/trunk/vorbis/; revision=16073

Vorbis spec tex file patch from Max Horn
resolves bug #1541

svn path=/trunk/vorbis/; revision=16055

global replaced all tabs with whitespaces in the source to end some of
the ongoing formatting silliness.

...with apologies to the havoc this will wreak on svn blame being useful.

svn path=/trunk/vorbis/; revision=16037

Bump vendor string for 1.2.2 rc 1

svn path=/trunk/vorbis/; revision=16006

Remove obsolete/unsupported MS build targets to avoid sucking unsuspecting users into a tarpit.

svn path=/trunk/vorbis/; revision=16000

Fix some comment typos and spacing.

svn path=/trunk/vorbis/; revision=15996

Removed WholeProgramOptimization setting from static library project.

svn path=/trunk/vorbis/; revision=15975

wrapped vorbisfile.h static callbacks in #ifndef
OV_EXCLUDE_STATIC_CALLBACKS

svn path=/trunk/vorbis/; revision=15962

fix to #1362

svn path=/trunk/vorbis/; revision=15961

Attempted fix for #1377 and #1493

svn path=/trunk/vorbis/; revision=15960

Const-ify some static data tables.

Patch from eldar. Trac issue #1496.

svn path=/trunk/vorbis/; revision=15937

Correct another setup bug; extremely short links could get 'shadowed'
in the preferred serialno lookup if a backwards seek to find a
preceeding page goes back too far and lands in an entirely different
link.

svn path=/trunk/vorbis/; revision=15930

Bugfix to new bisection code: fix end of data marker

Still failing several chaining test vectors, DO NOT USE YET

svn path=/trunk/vorbis/; revision=15929

Complete first-cut rearrangement of bisection and initialization code to reduce stream seeks.

svn path=/trunk/vorbis/; revision=15928

Nip a potential bug in the bud (open2 was relying on the position of the vf->offset cursor not being disturbed from open1)

Fill in offsets and dataoffsets fileds in VF struct, even for non-seekable streams.

svn path=/trunk/vorbis/; revision=15927

Ongoing open refactoring to eliminate superfluous seeks and reads
during stream open

Move initial serial number cataloguing in each link to be part of the
inline header fetch process.

svn path=/trunk/vorbis/; revision=15926

Add an optimization case to _get_prev_page that avoids a redundant seek/resync/reread in the common seek case.

svn path=/trunk/vorbis/; revision=15925

set proper types on doc pngs

svn path=/trunk/vorbis/; revision=15924

Patch an uninitialized trailing space in the ATH in very high sample rates found by Erik.

svn path=/trunk/vorbis/; revision=15923

Update docs to eliminate typo that crept into LSP curve computation spec in the XML and latex versions of the doc.

svn path=/trunk/vorbis/; revision=15922

Patch for "seek broken for large files and on pure 32 bit architectures"

svn path=/trunk/vorbis/; revision=15921

Recompress PNGs as suggested in #1523, remove unused super-old Ogg logo

svn path=/trunk/vorbis/; revision=15920

Added Visual Studio 2008 project files

svn path=/trunk/vorbis/; revision=15899

Fix 'make distcheck'.

svn path=/trunk/vorbis/; revision=15754

Use colored link text instead of boxes for hyperrefs in the pdf output.

svn path=/trunk/vorbis/; revision=15753

pdflatex seems to want three invocations to get all the cross
references correct.

svn path=/trunk/vorbis/; revision=15752

Correct in incorrect xref name.

svn path=/trunk/vorbis/; revision=15751

Explicitly import the nameref TeX package.

On recent distributions, this is implied by using hyperref, but TeX Live
2007 doesn't import it.

svn path=/trunk/vorbis/; revision=15750

Corresponding configure script changes for building the latex
specification. These were omitted in the previous commit.

svn path=/trunk/vorbis/; revision=15749

Docbook to latex conversion of the spec by Max Horn.

We now build the specification document from latex source instead of the
older docbook method since may developers have had trouble getting the
docbook tools to work. It's also faster.

For now, the built documentation is still kept in svn and rebuilt only
if --enable-docs is passed to configure. We may relax this to rebuilding
only if the tools are available once we're more confident it will work
with common TeX installations.

svn path=/trunk/vorbis/; revision=15748

Apply the same progressive automake ordering from r15745 to aclocal.

svn path=/trunk/vorbis/; revision=15747

Check that the compiler supports -mv8 before adding it to the command
line on sun sparc. Issue #1458.

I haven't recieved confirmation this resolves the issue, but I don't see
how it can do much harm.

svn path=/trunk/vorbis/; revision=15746

Minor changelog update.

svn path=/trunk/vorbis/; revision=15737

one backslash too many

svn path=/trunk/vorbis/; revision=15685

Some more clarifications (hopefully not clear as mud :)

svn path=/trunk/vorbis/; revision=15684

Updated vsprops file and added a short README file which explains what to do in order to compile successfully from source distribution.

svn path=/trunk/vorbis/; revision=15682

configure.ac : Make sure configure script is valid even if PKG_CHECK_MODULES can't be expanded by aclocal.

svn path=/trunk/vorbis/; revision=15658

doc/xml/a1-encapsulation_ogg.xml : Fix broken tag.

svn path=/trunk/vorbis/; revision=15657

configure.ac : Fix --enable-docs logic which was badly broken.

svn path=/trunk/vorbis/; revision=15649

Used Unicode for all platforms.

svn path=/trunk/vorbis/; revision=15625

Added Windows CE support: Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I), Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I), Windows Mobile 6 Professional SDK (ARMV4I)

svn path=/trunk/vorbis/; revision=15620

Refactored Visual Studio 2005 project files. Added static, dynamic library support, and x64 platform support.

svn path=/trunk/vorbis/; revision=15609

Moved Visual Studio 6 project files into own folder.

svn path=/trunk/vorbis/; revision=15608

Add ov_fopen to win32/vorbisfile.def
See http://lists.xiph.org/pipermail/vorbis-dev/2008-December/019657.html

svn path=/trunk/vorbis/; revision=15566

programming.html: clarify that ogg_sync_clear() is an alternative to
ogg_sync_destroy() -- ie. this paragraph is not a typo.
Need for clarification suggested by Philipp Schafft.

svn path=/trunk/vorbis/; revision=15565

Update outdated documentation to refer to the new media types.  Bump version number.  Fill changelog.

svn path=/trunk/vorbis/; revision=15540

Second patch to correct #1456

svn path=/trunk/vorbis/; revision=15533

Fix for bug #1456-- the 'bulletproofing' from CVE-2008-1420 inadvertantly
rejects a harmless/legal (if suboptimal) codebook arrangement that was
apparently used in 1.0b1.

svn path=/trunk/vorbis/; revision=15532

An attempt at a complete version of the patch submitted in #1291.  Also
updated autogenerating utils (not tested) and tried to eliminate all
resulting warnings.

svn path=/trunk/vorbis/; revision=15531

Add vorbis_version_string to the dll export list.

Patch by Aoyumi. This is a followup to the addition of this api call
in r15346.

svn path=/trunk/vorbis/; revision=15530

Copyright date on license had not been updated correctly

svn path=/trunk/vorbis/; revision=15505

Add a missing link to vorbisfile_example.c.html

svn path=/trunk/vorbis/; revision=15474

Don't make build depend on an XML file that no longer exists.

svn path=/trunk/vorbis/; revision=15401

For MinGW, use fseeko64 instead of _fseeki64 (which MinGW doesn't know about).

svn path=/trunk/vorbis/; revision=15376

Removed unused variables.

svn path=/trunk/vorbis/; revision=15351

For x86_64 with GNU C, use same solution for vorbis_ftoi as for win64.

svn path=/trunk/vorbis/; revision=15350

Use _fseeki64 on Windows, where fseek is always 32-bit.  Seek correctly when Vorbis file is over
2GB in size.  Patch by Peter Harris.

svn path=/trunk/vorbis/; revision=15347

define GENERAL_VENDOR_STRING and ENCODE_VENDOR_STRING.  Patch by Aoyumi.

svn path=/trunk/vorbis/; revision=15346