cleanup doc index; make format similar to website

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

Commit the built specification to the repository.

We have traditionally avoided putting generated files in the
respository; it's a waste of space and makes for useless diffs.
However, the docbook tool situation still hasn't improved to
the point where the docs build out of the box for most people.

The real impetus was a short-term hack to simplify the website
reorg; if we ever do get things building cleanly, the server
should do that before pushing to the mirrors.

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

Clarify usage of ov_raw_tell a little bit.

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

Apparently gcc -dumpversion has worked at least since 2.7.2, use this for
version detection instead since it's cleaner and probably more reliable.

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

add PKG_CHECK_MODULES to acinclude.m4

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

New version of the interleave example that shows the possibility of non-contiguous eos pages. Ticket #503.

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

Update changelog for release.

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

Properly initialize the packetno field when returning header packets,
and start counting data packet sequence numbers with 3 instead of zero
so that all the ogg packets come out of the encoder with the same
packetno fields they would have in coming out of an Ogg file (as read by
libogg, anyway).

Previously data packets started counting from zero, and the packetno
field of the returned header packets was uninitialized.

We had two choices in resolving this. One was just to add 3 to the
vorbis_dsp_state and/or vorbis_block sequence field when writing it to
the ogg_packet packetno field. The other is to actually keep the
packetno in the internal sequence fields. I chose the later based on the
fact that this same field gets set directly from the ogg_packet packetno
on decode, so things are consistent.

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

Update version number and libvorbisenc revision number for release.

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

Update changelog for 1.1.1 release.

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

Update the encoder datestamp so we can tell if the stream was produced
with the bps/kbps fix in the management interface.

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

update link which is broken in packages

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

enable maintainer mode for autogen builds by default

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

add two newlines as input to pdfxmltex for systems where tex complains with LaTeX Error: Something's wrong--perhaps a missing \item for no discernable reason

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

Our documentation for ov_open_callbacks was pretty bad. It talks about files
(which isn't neccesarily true), and didn't document the 'datasource' parameter
at all.

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

Oops. The units (kbps/bps) fix also applies to min and max bitrate in this
interface.

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

highlevel_encode_setup.bitrate_av is in bps,
struct ovectl_ratemanage2_arg.bitrate_average_kbps is obviously in kbps.
So convert when reading/writing the latter (public) struct.

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

debian/watch file for vorbis

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

Fix up some documentation mistakes as pointed out in bugs #615 and #616

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

Remove a redundant line

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

ov_read_float() was missing from this reference to vorbisfile functions, as
pointed out on irc. Added it.

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

Some preprocessor directives in this file didn't start with a # in column 1,
which some compilers (reported with apple gcc 3.3 on OS X) correctly reject.
Fixed by moving them into column 1.

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

Initial commit.

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

Removed as it is in wrong project.

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

Initial commit.

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

Initial commit.

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

vorbis:
 * Use autoheader and config.h.in again (basically revert changeset:8766)
 * Use 'type' shell builtin instead of 'which' to locate libtoolize, since it's more portable and less prone to different behaviour

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

vorbis:
 * Don't use autoheader since we don't use config.h.in

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

Cleaned up references section and minor text improvements. -PK

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

Also move a parenthesis to match the correct bark formula in the reference source.

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

Correct a typo in the bark function definition s/0158/0185/ in the
second atan frequency scale.

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

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

Initial check in.

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

set release date in the release notes

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

Issue an explicit warning if the docs can't be built at 'make dist'
time, as is now required.

This is a little less broken than the previous config in that the dist
will need to have the build docs, and a normal build from a dist tarball
won't try. However if you --enable-docs on the dist tarball, it will
rebuild them even if they're up to date. Among other things, this makes
'make distcheck' annoying.

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

Include the built documentation in the distribution.

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

Properly filter out .svn directories from EXTRA_DIST included
directories.

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

Oops. Also remove the obsolete HACKING file from the distribution list.

Remove references to the 1.0 release from the todo file. :)

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

Documentation updates.

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

Bump version number for new release.

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

Don't build static code examples by default. Static linking is broken
(and unsupported) on recent MacOS X, but libtool hasn't learned this
yet.

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

adjust configure help formatting

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

Remove thomasvs' ChangeLog in favor of the new CHANGES document.

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

Add a CHANGES file with release notes. Only goes back to 1.0.

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

add #ifdef __WINS__ to symbian/config.h around pragmas (ignored by gcc)

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

add config.h to Symbian build, and use it to turn off a bunch of visual c
warnings, some of which are harmless.

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

include "os.h" in smallft.c, in turn including config.h (as per smiliar *.c
files)

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

fix _WIN32 check to exclude Symbian emulator builds

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

add Symbian OS support by Colin Ward (CSIRO)

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

First pass of full libvorbisenc doc modernization complete.  Only proofing remains.

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

Finished up first pass of modern vorbis_encode_ctl() doc

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

Remove a stray fprintf

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

remove needless whitespace, synchronize decls with defs

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

pass make distcheck

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

using autoheader to generate config.h so we get rid of the long compile
lines filled with defines.
I also added a ChangeLog, if people don't like that feel free to flame me down
and I'll remove it.

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

Correct two function name typos

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

Finished data structure docs

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

fix automake warning

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

add missing files

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

Correct a bug unnoticed until documenting; the 'window' field in the
vorbis_info struct should be the size of the bitrate reservoir in
seconds.

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

Incremental update to avoid losing ongoing work

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

generate uninstalled pc files

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

use pkg-config if we found the binary, otherwise use the old method

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

This patch autogenerates spec file from configure and fixes some spec issues

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

This patch fixes a few autotools issues with vorbis svn

* error out on autotools failures so warnings are caught early on
* move around AC_CANONICAL_HOST to squash warning
* add AC_CANONICAL_TARGET
* don't squash LIBS but set VORBIS_LIBS instead
* clean up AC_OUTPUT
* AUTOMAKE_OPTIONS = foreign only needs to be done toplevel
  (this can be verified by checking Makefile's generated in other directories
   and seeing that the var isn't used)
* use OGG_LIBS and VORBIS_LIBS in Makefile.am

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

Use an ogg_int32_t rather than a plain int32_t, since windows systems don't
have the latter defined. Problem reported by Stephen So.

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

Patch from Barry Bouwsma:

The problem was in using an int for the return value of a 64-bit
function.  All other references to this function in this source file
use a proper 64-bit value.  This function returns the offset within
the file, and this int wraps to <0 at 2GB, causing an EOS to be
returned for any offset at any further point in a larger file.

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

Set $Id$ keyword substitution for vorbis module

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

Mostly completed (but not proofread) the updated/modern libvorbisenc API overview document.

Also turned on $Id$ keyword substitution in SVN for the Vorbis module.

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

Fix one comment (bitrate.c no longer uses a circular packet queue)

Correct a bug-that-isn't-a-bug; the bitrate manager's setpoint gravity
code relied on subtlety that just took me a while to figure out even
though I wrote it.  Given that, I could see it causing trouble in the
future if other changes broke the subtlety, so I increased the
heavy-handed logic explicitness to bulletproof the gravity code in the
cases where there's a minimum but not a maximum and vice versa.

The only change that makes a difference: the bit reservoir is set to
the bias setpoint in initialization as opposed to always starting with
a full reservoir.  This is unrelated to above, but seemed like a good
idea.

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

Propogate fix (from chris, to the website) back to the original copy of the
documentation.

We need a better way to keep docs in sync, editing the website copy is
definitely a bad idea.

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

Work in progress: documentation update for libvorbisenc

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

Begin process of API documentation updates

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

Put AoTuV tunings merge (along with bugfixes) on the mainline.  This
is ready for wider correctness testing; no substantial issues
expected.

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

Correct a comment typo.

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

helps to update both references

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

also update the makefile for the rtp draft update

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

Update to the latest (but still expired) vorbis-rtp draft.

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

Properly escape the example C code in the chaining example html.

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

Set DOS line endings on MSVC project files; it can deal with unix line
endings otherwise, but these need to be correct no matter who makes the
package.

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

Turn on keyword subsitution for the spec source documents since we're
using this for releaseinfo.

Also remove the manual dates in favor of the automatic ones. Previously,
the manual ones meant something like 'last significant update' but it's
easy to forget. A little uglier, less work.

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

Correct a number of typos. Thanks to Dominik Kuhlen for pointing these
out.

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

correct a typo

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

Fix for typos in comment spec (bug #507)

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

Quote our macro name in AC_DEFUN() to avoid a warning in automake 1.8. Patch from Alexander
Winston.

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

Kill off small padding bug for super-small bitreservoir sizes.  It's
now accurate to the byte.

Monty

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

Kill another minor bug in bitrate reservoir setup when average isn't
specced (as it keys off nominal by default)

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

Correct nominal setting flaw in managed setup when mina nd max are
both specified.

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

Replace time-windowed bitrate management setup with a one-pass
'greedy' bit reservoir system.

Advantages:

no additional encoder latency
more predictable buffering
lower memory usage

These changes introduce two new vorbis_encode_ctls to get to the new
functionality.  The old ectl calls are still supported for
compatability and binary library compatability is not broken (but
libvorbis/file/enc need to be upgraded as a set).

...now going to update oggenc.

Monty

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

Spelling fixes.

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

Updated RPM spec by Warren Dukes (shank)

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

Moved vorbisenc functions back into the vorbis.dll for compatability reasons
Made the projects all link to the Multithreaded Static Runtime Lib...hopefully this will allow for the most portability.

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

Correct line endings on vorbis.dsw.

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

New working versions of the harmonized project files from John Edwards.
Apparently my hand editing messed up parsability.

There may be line-ending problems with vorbis.dsw.

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

Correct the source file lists for the VC6 projects against Makefile.am.

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

Continuing autotools creeping feature infection. Have autogen.sh fall
back to glibtoolize (as it's shipped by apple on macosx) if libtoolize
is not available. Bug 363.

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

Remove the apparently spuriously included vorbisenc.c from the vorbis.dll MSVC project file.

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

Updated VC6 project files by John Edwards

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

AM_MAINTAINER_MODE added
This allows for builds not to fail if automake is installed on the build system and it doesnt happen to be exact same version used during autogen.sh process.

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

The official application/ogg mime-type has been approved.

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