xiph/ogg: Reference implementation of the Ogg media container. Mirror of https://git.xiph.org/ogg.git @ 7330ab2e35df046afaf4b3821435c93865b24bcf

Reference implementation of the Ogg media container. Mirror of https://git.xiph.org/ogg.git https://xiph.org/ogg/

Ralph Giles 7330ab2e35 Bump version number and dates for release.		%!s(int64=13) %!d(string=hai) anos
doc	68c7f55cf6 Bump version number and dates for release.	%!s(int64=13) %!d(string=hai) anos
include	237a3081dc Add ogg_stream_flush_fill to compliment ogg_stream_pageout_fill because ogg_stream_flush will produce multiple pages when >4096 bytes and >4 packets are available.	%!s(int64=13) %!d(string=hai) anos
macosx	c60a5250df update CHANGES	%!s(int64=15) %!d(string=hai) anos
src	edb31b1ba8 Fix a comment typo.	%!s(int64=13) %!d(string=hai) anos
symbian	baebf2b97b add support for Symbian OS, from Colin Ward (CSIRO)	%!s(int64=20) %!d(string=hai) anos
win32	0664bdc1dd Fixed project configuration which referenced two CRT versions in output binaries.	%!s(int64=14) %!d(string=hai) anos
AUTHORS	c8a1e86b9c Update the author list with recent contributors.	%!s(int64=13) %!d(string=hai) anos
CHANGES	a121f3fc61 Bump library versioning and changelog for release.	%!s(int64=13) %!d(string=hai) anos
COPYING	6977847eda	%!s(int64=22) %!d(string=hai) anos
Makefile.am	715e304b16 Remove the makefile reference to the macos directory.	%!s(int64=13) %!d(string=hai) anos
README	057df48964 Update the README.	%!s(int64=13) %!d(string=hai) anos
autogen.sh	9bf530e2fc Port automake 1.10 support from libtheora.	%!s(int64=17) %!d(string=hai) anos
configure.in	a121f3fc61 Bump library versioning and changelog for release.	%!s(int64=13) %!d(string=hai) anos
libogg.spec.in	7389045722 update doc/libogg in libogg.spec.in, as reported by thosmos in #vorbis	%!s(int64=17) %!d(string=hai) anos
ogg-uninstalled.pc.in	7548908a61 This patch adds an -uninstalled.pc file so other libs/tools can use it	%!s(int64=20) %!d(string=hai) anos
ogg.m4	bc1fba1d51 Applied patch to make it easier to disable use of Ogg when neeeded. Closes #1280. Now on to find the scattered duplicates	%!s(int64=17) %!d(string=hai) anos
ogg.pc.in	7548908a61 This patch adds an -uninstalled.pc file so other libs/tools can use it	%!s(int64=20) %!d(string=hai) anos

		
			
			
				README
			
		
		
	
			
				********************************************************************
*                                                                  *
* THIS FILE IS PART OF THE OggVorbis SOFTWARE CODEC SOURCE CODE.   *
* USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS     *
* GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE *
* IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING.       *
*                                                                  *
* THE OggVorbis SOURCE CODE IS (C) COPYRIGHT 1994-2011             *
* by the Xiph.Org Foundation http://www.xiph.org/                  *
*                                                                  *
********************************************************************

= WHAT'S HERE =

This source distribution includes libogg and nothing else. Other modules 
(eg, the modules libvorbis, vorbis-tools for the Vorbis music codec,
libtheora for the Theora video codec) contain the codec libraries for
use with Ogg bitstreams.

Directory:

./src  		The source for libogg, a BSD-license inplementation of 
		the public domain Ogg bitstream format

./include       Library API headers

./doc           Ogg specification and libogg API documents

./win32		Win32 projects and build automation

./macosx	Mac OS X project and build files

= WHAT IS OGG? =

Ogg project codecs use the Ogg bitstream format to arrange the raw,
compressed bitstream into a more robust, useful form.  For example,
the Ogg bitstream makes seeking, time stamping and error recovery
possible, as well as mixing several sepearate, concurrent media
streams into a single physical bitstream.

= CONTACT =

The Ogg homepage is located at 'https://www.xiph.org/ogg/'.
Up to date technical documents, contact information, source code and
pre-built utilities may be found there.

BUILDING FROM TARBALL DISTRIBUTIONS:

./configure
make

and optionally (as root):
make install

This will install the Ogg libraries (static and shared) into
/usr/local/lib, includes into /usr/local/include and API
documentation into /usr/local/share/doc.

BUILDING FROM REPOSITORY SOURCE:

A standard svn build should consist of nothing more than:

./autogen.sh
make 

and as root if desired :

make install

BUILDING ON WIN32:

Use the project file in the win32 directory. It should compile out of the box.

CROSS COMPILING FROM LINUX TO WIN32:

It is also possible to cross compile from Linux to windows using the MinGW
cross tools and even to run the test suite under Wine, the Linux/*nix
windows emulator.

On Debian and Ubuntu systems, these cross compiler tools can be installed
by doing:

    sudo apt-get mingw32 mingw32-binutils mingw32-runtime wine

Once these tools are installed its possible to compile and test by
executing the following commands, or something similar depending on
your system:

    ./configure --host=i586-mingw32msvc --target=i586-mingw32msvc \
         --build=i586-linux
    make
    make check

(Build instructions for Ogg codecs such as vorbis are similar and may
be found in those source modules' README files)

$Id$

			
		