Incremental update. Nearing beta 2, four more new descriptions to go...monty_branch_20000724

Monty

svn path=/branches/monty_branch_20000724/vorbis/; revision=585

18 files changed, 363 insertions, 0 deletions

diff --git a/debian/README.debian b/debian/README.debian
new file mode 100644
index 00000000..aa3db803
--- /dev/null
+++ b/debian/README.debian
@@ -0,0 +1,14 @@
+Ogg Vorbis for Debian
+---------------------
+
+Ogg Vorbis currently does not have a shared library. it is a goal for the
+future, but presently, any compiling using the codec should be done as
+follows:
+
+	gcc [flags] -c X.c
+	gcc [flags] /usr/lib/vorbisfile.a /usr/lib/libvorbis.a \
+		X.o -o X
+
+Of course, only include the .a's that are required for your program.
+
+ -- Michael Beattie <mickyb@es.co.nz>, Mon, 26 Jun 2000 18:59:56 +1200
diff --git a/debian/README.examples b/debian/README.examples
new file mode 100644
index 00000000..a7598865
--- /dev/null
+++ b/debian/README.examples
@@ -0,0 +1,11 @@
+Example tools using vorbis.
+
+The examples/ directory contains some example source files to build tools
+using the vorbis codec. The Makefile is only included to show how they are
+compiled. It contains relative references to the libraries in the source
+tree, so it will *not* work without being edited first.
+
+The misc.h included in chaining_example and seeking_test just allows the
+use of a debugging malloc. (defined in misc.c) It is safe to comment out.
+
+ -- Michael Beattie <mickyb@es.co.nz>, Mon, 26 Jun 2000 18:59:56 +1200
diff --git a/debian/changelog b/debian/changelog
new file mode 100644
index 00000000..767c008b
--- /dev/null
+++ b/debian/changelog
@@ -0,0 +1,16 @@
+vorbis (1.0beta1-1) unstable; urgency=low
+
+  * First Beta, Ready for debian release.
+
+ -- Michael Beattie <mickyb@es.co.nz>  Fri, 30 Jun 2000 19:26:59 +1200
+
+vorbis (0.0-1) unstable; urgency=low
+
+  * Initial Release.
+  * Initial package, not placed in archive.
+
+ -- Michael Beattie <mickyb@es.co.nz>  Mon, 26 Jun 2000 18:59:56 +1200
+
+Local variables:
+mode: debian-changelog
+End:
diff --git a/debian/control b/debian/control
new file mode 100644
index 00000000..463d9ff6
--- /dev/null
+++ b/debian/control
@@ -0,0 +1,78 @@
+Source: vorbis
+Section: sound
+Priority: optional
+Maintainer: Michael Beattie <mickyb@es.co.nz>
+Standards-Version: 3.0.1
+
+Package: libvorbis-dev
+Section: devel
+Architecture: any
+Description: The OGG Vorbis lossy audio compression codec.
+ This Package contains the development library's and header files for
+ Ogg Vorbis.
+ .
+ Ogg Vorbis is a fully Open, non-proprietary, patent-and-royalty-free,
+ general-purpose compressed audio format for high quality (44.1-48.0kHz,
+ 16+ bit, polyphonic) audio and music at fixed and variable bitrates
+ from 16 to 128 kbps/channel. This places Vorbis in the same class as
+ audio representations including MPEG-1 audio layer 3, MPEG-4
+ audio (AAC and TwinVQ), and PAC.
+
+Package: xmms-vorbis
+Architecture: i386
+Depends: ${shlibs:Depends}, xmms
+Description: An xmms plugin to play Ogg Vorbis files.
+ This Package contains a plugin for xmms to play files encoded using the
+ Ogg Vorbis lossy audio compression codec.
+ .
+ Ogg Vorbis is a fully Open, non-proprietary, patent-and-royalty-free,
+ general-purpose compressed audio format for high quality (44.1-48.0kHz,
+ 16+ bit, polyphonic) audio and music at fixed and variable bitrates
+ from 16 to 128 kbps/channel. This places Vorbis in the same class as
+ audio representations including MPEG-1 audio layer 3, MPEG-4
+ audio (AAC and TwinVQ), and PAC.
+
+Package: ogg123
+Architecture: any
+Depends: ${shlibs:Depends}
+Description: A player for Ogg Vorbis files.
+ This Package contains a commandline player for files encoded using the
+ Ogg Vorbis lossy audio compression codec.
+ .
+ Ogg Vorbis is a fully Open, non-proprietary, patent-and-royalty-free,
+ general-purpose compressed audio format for high quality (44.1-48.0kHz,
+ 16+ bit, polyphonic) audio and music at fixed and variable bitrates
+ from 16 to 128 kbps/channel. This places Vorbis in the same class as
+ audio representations including MPEG-1 audio layer 3, MPEG-4
+ audio (AAC and TwinVQ), and PAC.
+
+Package: vorbize
+Architecture: any
+Depends: ${shlibs:Depends}
+Suggests: ogg123 | xmms-vorbis
+Description: An encoder for the Ogg Vorbis lossy audio compression codec.
+ This Package contains an Ogg Vorbis encoder.
+ NOTE: Currently vorbis only works with 44kHz, 16bit stereo raw PCM or
+ wav files. Use sox to coax any other formats into line.
+ .
+ Ogg Vorbis is a fully Open, non-proprietary, patent-and-royalty-free,
+ general-purpose compressed audio format for high quality (44.1-48.0kHz,
+ 16+ bit, polyphonic) audio and music at fixed and variable bitrates
+ from 16 to 128 kbps/channel. This places Vorbis in the same class as
+ audio representations including MPEG-1 audio layer 3, MPEG-4
+ audio (AAC and TwinVQ), and PAC.
+
+Package: mp3tovorbis
+Architecture: any
+Depends: vorbize, mpg123
+Description: An encoder for the Ogg Vorbis lossy audio compression codec.
+ This Package contains an mp3tovorbis script which you can use to
+ convert your .mp3 files to .ogg
+ NOTE: this will only work on 44kHz 16bit stereo mp3's
+ .
+ Ogg Vorbis is a fully Open, non-proprietary, patent-and-royalty-free,
+ general-purpose compressed audio format for high quality (44.1-48.0kHz,
+ 16+ bit, polyphonic) audio and music at fixed and variable bitrates
+ from 16 to 128 kbps/channel. This places Vorbis in the same class as
+ audio representations including MPEG-1 audio layer 3, MPEG-4
+ audio (AAC and TwinVQ), and PAC.
diff --git a/debian/copyright b/debian/copyright
new file mode 100644
index 00000000..a2463f8e
--- /dev/null
+++ b/debian/copyright
@@ -0,0 +1,25 @@
+This package was debianized by Michael Beattie <mickyb@es.co.nz> on
+Mon, 26 Jun 2000 18:59:56 +1200.
+
+It was downloaded from http://www.xiph.org/ogg/vorbis/ (via CVS)
+
+Upstream Author(s): Monty <monty@xiph.org>
+
+Copyright:
+
+   This program is free software; you can redistribute it and/or modify
+   it under the terms of the GNU General Public License as published by
+   the Free Software Foundation; version 2 dated June, 1991.
+
+   This program is distributed in the hope that it will be useful,
+   but WITHOUT ANY WARRANTY; without even the implied warranty of
+   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+   GNU General Public License for more details.
+
+   You should have received a copy of the GNU General Public License
+   along with this program;  if not, write to the Free Software
+   Foundation, Inc., 59 Temple Place - Suite 330, Boston,
+   MA 02111-1307, USA.
+
+On Debian GNU/Linux systems, the complete text of the GNU General
+Public License can be found in /usr/share/common-licenses/GPL'.
diff --git a/debian/dirs b/debian/dirs
new file mode 100644
index 00000000..0d97de53
--- /dev/null
+++ b/debian/dirs
@@ -0,0 +1,3 @@
+usr/lib
+usr/include/vorbis/book
+usr/share/doc/libvorbis-dev/html
diff --git a/debian/docs b/debian/docs
new file mode 100644
index 00000000..a7d3a859
--- /dev/null
+++ b/debian/docs
@@ -0,0 +1,3 @@
+README
+todo.txt
+debian/README.examples
diff --git a/debian/examples b/debian/examples
new file mode 100644
index 00000000..a1adfae4
--- /dev/null
+++ b/debian/examples
@@ -0,0 +1,6 @@
+examples/Makefile
+examples/chaining_example.c
+examples/decoder_example.c
+examples/encoder_example.c
+examples/seeking_test.c
+examples/vorbisfile_example.c
diff --git a/debian/mp3tovorbis.dirs b/debian/mp3tovorbis.dirs
new file mode 100644
index 00000000..e7724817
--- /dev/null
+++ b/debian/mp3tovorbis.dirs
@@ -0,0 +1 @@
+usr/bin
diff --git a/debian/mp3tovorbis.docs b/debian/mp3tovorbis.docs
new file mode 100644
index 00000000..843d9055
--- /dev/null
+++ b/debian/mp3tovorbis.docs
@@ -0,0 +1 @@
+vorbis-tools/README
\ No newline at end of file
diff --git a/debian/ogg123.dirs b/debian/ogg123.dirs
new file mode 100644
index 00000000..e7724817
--- /dev/null
+++ b/debian/ogg123.dirs
@@ -0,0 +1 @@
+usr/bin
diff --git a/debian/ogg123.docs b/debian/ogg123.docs
new file mode 100644
index 00000000..8f7da824
--- /dev/null
+++ b/debian/ogg123.docs
@@ -0,0 +1 @@
+vorbis-tools/README
diff --git a/debian/override.Lintian b/debian/override.Lintian
new file mode 100644
index 00000000..5733a47a
--- /dev/null
+++ b/debian/override.Lintian
@@ -0,0 +1 @@
+xmms-vorbis: shlib-with-non-pic-code
diff --git a/debian/rules b/debian/rules
new file mode 100755
index 00000000..6c4105cc
--- /dev/null
+++ b/debian/rules
@@ -0,0 +1,197 @@
+#!/usr/bin/make -f
+# Sample debian/rules that uses debhelper. 
+# GNU copyright 1997 by Joey Hess.
+# Modified for Ogg Vorbis, 2000 by Michael Beattie
+
+# Uncomment this to turn on verbose mode. 
+#export DH_VERBOSE=1
+
+# This is the debhelper compatability version to use.
+export DH_COMPAT=1
+
+# This has to be exported to make some magic below work.
+export DH_OPTIONS
+
+build: build-stamp
+build-stamp:
+	dh_testdir
+
+	./configure --prefix=/usr --mandir=\$${prefix}/share/man --infodir=\$${prefix}/share/info
+	# Add here commands to compile the package.
+	$(MAKE)
+	cd vorbis-tools && $(MAKE) && $(MAKE) ogg123
+	cd xmms && $(MAKE)
+
+	touch build-stamp
+
+EXTRA_CLEAN= vorbis-tools cmdline xmms vq huff kmpg
+clean:
+	dh_testdir
+	dh_testroot
+	rm -f build-stamp 
+
+	# Add here commands to clean up after the build process.
+	-$(MAKE) distclean
+	-@for dir in $(EXTRA_CLEAN); do (cd $$dir && $(MAKE) $(MFLAGS) distclean) || exit 1; done
+
+	dh_clean
+
+
+# Build architecture-independent files here.
+binary-arch: libvorbis-dev ogg123 vorbize xmms-vorbis mp3tovorbis
+
+libvorbis-dev: DH_OPTIONS=-plibvorbis-dev
+libvorbis-dev: build
+	# Need this version of debhelper for DH_OPTIONS to work.
+	dh_testversion 1.1.17
+	dh_testdir
+	dh_testroot
+	dh_clean -k
+	dh_installdirs
+
+	-cp -a include/vorbis/*.h `pwd`/debian/tmp/usr/include/vorbis/
+	-cp -a include/vorbis/book/*.vqh `pwd`/debian/tmp/usr/include/vorbis/book/
+	-cp lib/*.a `pwd`/debian/tmp/usr/lib/
+
+	-cp docs/*.html docs/*.png `pwd`/debian/tmp/usr/share/doc/libvorbis-dev/html/
+
+	dh_installdocs
+	dh_installexamples
+	dh_installmanpages
+#	dh_installinfo
+#	dh_undocumented
+	dh_installchangelogs 
+	dh_strip
+	dh_link
+	dh_compress
+	dh_fixperms
+	dh_installdeb
+#	dh_makeshlibs
+#	dh_shlibdeps
+	dh_gencontrol -u -isp
+	dh_md5sums
+	dh_builddeb
+
+
+
+ogg123: DH_OPTIONS=-pogg123
+ogg123: build
+	# Need this version of debhelper for DH_OPTIONS to work.
+	dh_testversion 1.1.17
+	dh_testdir
+	dh_testroot
+	dh_clean -k
+	dh_installdirs
+
+	install -m 755 vorbis-tools/ogg123 `pwd`/debian/ogg123/usr/bin/
+
+	dh_installdocs
+#	dh_installmenu
+	dh_installmanpages
+#	dh_installinfo
+	dh_undocumented ogg123.1
+	dh_installchangelogs vorbis-tools/Changelog
+	dh_strip
+	dh_link
+	dh_compress
+	dh_fixperms
+	dh_installdeb
+#	dh_makeshlibs
+	dh_shlibdeps
+	dh_gencontrol -u -isp
+	dh_md5sums
+	dh_builddeb
+
+
+
+vorbize: DH_OPTIONS=-pvorbize
+vorbize: build
+	# Need this version of debhelper for DH_OPTIONS to work.
+	dh_testversion 1.1.17
+	dh_testdir
+	dh_testroot
+	dh_clean -k
+	dh_installdirs
+
+	install -m 755 vorbis-tools/vorbize `pwd`/debian/vorbize/usr/bin/
+
+	dh_installdocs
+#	dh_installmenu
+	dh_installmanpages
+#	dh_installinfo
+	dh_undocumented vorbize.1
+	dh_installchangelogs vorbis-tools/Changelog
+	dh_strip
+	dh_link
+	dh_compress
+	dh_fixperms
+	dh_installdeb
+#	dh_makeshlibs
+	dh_shlibdeps
+	dh_gencontrol -u -isp
+	dh_md5sums
+	dh_builddeb
+
+
+
+mp3tovorbis: DH_OPTIONS=-pmp3tovorbis
+mp3tovorbis: build
+	# Need this version of debhelper for DH_OPTIONS to work.
+	dh_testversion 1.1.17
+	dh_testdir
+	dh_testroot
+	dh_clean -k
+	dh_installdirs
+
+	install -m 755 vorbis-tools/mp3tovorbis `pwd`/debian/mp3tovorbis/usr/bin/
+
+	dh_installdocs
+#	dh_installmenu
+	dh_installmanpages
+#	dh_installinfo
+	dh_undocumented mp3tovorbis.1
+	dh_installchangelogs vorbis-tools/Changelog
+	dh_strip
+	dh_link
+	dh_compress
+	dh_fixperms
+	dh_installdeb
+#	dh_makeshlibs
+#	dh_shlibdeps
+	dh_gencontrol -u -isp
+	dh_md5sums
+	dh_builddeb
+
+
+
+xmms-vorbis: DH_OPTIONS=-pxmms-vorbis
+xmms-vorbis: build install
+	# Need this version of debhelper for DH_OPTIONS to work.
+	dh_testversion 1.1.17
+	dh_testdir
+	dh_testroot
+	dh_clean -k
+	dh_installdirs
+
+	install -m 644 xmms/libvorbis.so `pwd`/debian/xmms-vorbis/usr/lib/xmms/Input/
+
+	dh_installdocs
+	dh_installchangelogs 
+	dh_strip
+	dh_link
+	dh_compress
+	dh_fixperms
+	dh_installdeb
+#
+	dh_shlibdeps
+	dh_gencontrol -u -isp
+	dh_md5sums
+	dh_builddeb
+
+
+# Build architecture-dependent files here.
+binary-indep:
+
+
+binary: binary-indep binary-arch
+.PHONY: build clean binary-indep binary-arch binary install
diff --git a/debian/vorbize.dirs b/debian/vorbize.dirs
new file mode 100644
index 00000000..e7724817
--- /dev/null
+++ b/debian/vorbize.dirs
@@ -0,0 +1 @@
+usr/bin
diff --git a/debian/vorbize.docs b/debian/vorbize.docs
new file mode 100644
index 00000000..843d9055
--- /dev/null
+++ b/debian/vorbize.docs
@@ -0,0 +1 @@
+vorbis-tools/README
\ No newline at end of file
diff --git a/debian/xmms-vorbis.dirs b/debian/xmms-vorbis.dirs
new file mode 100644
index 00000000..d382c88a
--- /dev/null
+++ b/debian/xmms-vorbis.dirs
@@ -0,0 +1 @@
+usr/lib/xmms/Input
diff --git a/debian/xmms-vorbis.docs b/debian/xmms-vorbis.docs
new file mode 100644
index 00000000..76a44b63
--- /dev/null
+++ b/debian/xmms-vorbis.docs
@@ -0,0 +1,2 @@
+xmms/README
+debian/override.Lintian