Tree [7c83bd] /
History



File Date Author Commit
debian 2001-12-19 calc calc [9fa8b4] changed version for doc dir
doc 2001-12-20 segher segher [6c97a7] lots of extremely minor fixes
include 2001-12-20 segher segher [6c97a7] lots of extremely minor fixes
mac 2000-11-22 xiphmont xiphmont [3217fb]
macosx 2001-11-16 giles giles [869789] Installation script and build fixes to use the ...
src 2001-12-21 segher segher [7c83bd] fix "interesting" warning
win32 2001-10-23 cwolf cwolf [9ad70c] add ogg_packet_clear and sort entries
.cvsignore 2001-02-26 jack jack [cd9686] updated cvsignores
AUTHORS 2000-09-03 jack jack [ec108e] Initial revision
CHANGES 2000-09-05 jack jack [304564] testing commit emails
COPYING 2001-02-26 xiphmont xiphmont [c0c180]
HACKING 2001-08-23 jsquyres jsquyres [8b7744] Note to self: run ispell *before* committing to...
Makefile.am 2000-11-18 jack jack [439894] more debian inclusion fixes
README 2001-03-22 xiphmont xiphmont [832a0e]
autogen.sh 2001-10-28 volsung volsung [ec0665] Argh. Never mind on the -I idea. automake 1.4...
configure.in 2001-12-19 jack jack [ea5edb] Update version number for release.
libogg.spec 2001-12-19 jack jack [ea5edb] Update version number for release.
ogg.m4 2001-10-28 volsung volsung [4e51b3] Sigh. Another typo. This one works, I swear.

Read Me

********************************************************************
*                                                                  *
* 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-2001             *
* by the XIPHOPHORUS Company http://www.xiph.org/                  *
*                                                                  *
********************************************************************

WHAT'S HERE:

This source distribution includes libogg and nothing else.  Other modules 
(eg, the modules vorbis, vorbis-tools and vorbis-plugins for the Vorbis 
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 and codebooks

./debian        Rules/spec files for building Debian .deb packages

./doc           Ogg specification documents

./win32		Win32 projects and build automation

./mac		MacOS 9 projects and build automation

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 'http://www.xiph.org/ogg/'.
Up to date technical documents, contact information, source code and
pre-built utilities may be found there.

BUILDING FROM CVS:

A standard cvs build should consist of nothing more than:

./autogen.sh
make 

and as root if desired :

make install

This will install the Ogg libraries (static and shared) into
/usr/local/lib, includes into /usr/local/include and API manpages
(once we write some) into /usr/local/man.

BUILDING FROM TARBALL DISTRIBUTIONS:

./configure
make

and optionally (as root):
make install

BUILDING RPMS:

RPMs may be built by:

make dist
rpm -ta libogg-<version>.tar.gz

BUILDING ON WIN32:

Use the project file in the win32 directory.  It should compile out of the box.
You can also run one of the batch files from the commandline.

E.g.: build_ogg_dynamic

BUILDING ON MACOS 9:

Ogg on MacOS 9 is built using CodeWarrior 5.3.  To build it, first
open ogg/mac/libogg.mcp, switch to the "Targets" pane, select
everything, and make the project.  In ogg/mac/Output you will now have
both debug and final versions of Ogg shared libraries to link your
projects against.

To build a project using Ogg, add access paths to your CodeWarrior
project for the ogg/include and ogg/mac/Output folders.  Be sure that
"interpret DOS and Unix paths" is turned on in your project; it can be
found in the "access paths" pane in your project settings.  Now simply
add the shared libraries you need to your project (OggLib at least)
and #include "ogg/ogg.h" wherever you need to acces Ogg functionality.

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

$Id: README,v 1.9 2001/03/22 00:29:37 xiphmont Exp $