add 0.9.3 release notes
authorconrad <conrad@8158c8cd-e7e1-0310-9fa4-c5954c97daef>
Fri, 7 Oct 2005 06:33:25 +0000 (06:33 +0000)
committerconrad <conrad@8158c8cd-e7e1-0310-9fa4-c5954c97daef>
Fri, 7 Oct 2005 06:33:25 +0000 (06:33 +0000)
git-svn-id: http://svn.annodex.net/liboggz/trunk@1568 8158c8cd-e7e1-0310-9fa4-c5954c97daef

release_notes/liboggz-0.9.3.txt [new file with mode: 0644]

diff --git a/release_notes/liboggz-0.9.3.txt b/release_notes/liboggz-0.9.3.txt
new file mode 100644 (file)
index 0000000..dca43c8
--- /dev/null
@@ -0,0 +1,124 @@
+Oggz 0.9.3 Release
+------------------
+
+Oggz comprises liboggz and the command-line tools oggzinfo, oggzdump,
+oggzdiff, oggzmerge, oggzrip, oggz-scan and oggz-validate.
+
+liboggz is a C library providing a simple programming interface for reading
+and writing Ogg files and streams. Ogg is an interleaving data container
+developed by Monty at Xiph.Org, originally to support the Ogg Vorbis audio
+format.
+
+This release is available as a source tarball at:
+
+http://www.annodex.net/software/liboggz/download/liboggz-0.9.3.tar.gz
+
+New in this release:
+
+        * New oggz-scan tool (silvia)
+
+        oggz-scan displays timestamps of characteristic features in an Ogg
+        file. 'oggz-scan --keyframes file.ogg' displays timestamps of
+        unforced Theora keyframes, which are a useful rough approximation of
+        shot boundaries. Results can be output as plain text, CMML or HTML.
+
+        * Improvements to oggz-validate:
+          - added page-level validation, ensuring that a page that ends zero
+          packets has the correct granulepos, -1. (MikeS)
+          - added a check that any Theora bos pages come before Vorbis and
+          Speex bos pages. (ticket:156) (conrad)
+          - correct handling of chained files (ticket: 162) (conrad)
+
+        * win32 build fix for oggz tools (j^)
+
+        * Other bugfixes / closed tickets:
+
+        liboggz: replace internal typedef of oggz_off_t, use off_t instead
+          of long (ticket:161) (Grayfox)
+        examples/fix-eos: discard trailing incomplete packets from the end
+          of the stream. (MikeS)
+        remove autogenerated manpages (ticket:155) (conrad, silvia)
+
+About Oggz
+----------
+
+Oggz comprises liboggz and the command-line tools oggzinfo, oggzdump,
+oggzdiff, oggzmerge, oggzrip, oggz-scan and oggz-validate.
+
+liboggz supports the flexibility afforded by the Ogg file format while
+presenting the following API niceties:
+
+        * Full API documentation
+
+        * Comprehensive test suite of read, write and seeking behavior.
+        The entire test suite can be run under valgrind if available.
+
+        * Developed and tested on GNU/Linux, Darwin/MacOSX, Win32 and
+        Symbian OS. May work on other Unix-like systems via GNU autoconf.
+        For Win32: nmake Makefiles, Visual Studio .NET 2003 solution files
+        and Visual C++ 6.0 workspace files are provided in the source
+        distribution.
+
+        * Strict adherence to the formatting requirements of Ogg bitstreams,
+        to ensure that only valid bitstreams are generated; writes can fail
+        if you try to write illegally structured packets.
+
+        * A simple, callback based open/read/close or open/write/close
+        interface to raw Ogg files.
+
+        * Writing automatically interleaves with packet queuing, and provides  
+        callback based notification when this queue is empty
+
+        * A customisable seeking abstraction for seeking on multitrack Ogg
+        data. Seeking works easily and reliably on multitrack and multi-codec
+        streams, and can transparently parse Theora, Speex, Vorbis, FLAC,
+        CMML and Ogg Skeleton headers  without requiring linking to those
+        libraries. This allows efficient use on servers and other devices
+        that need to parse and seek within Ogg files, but do not need to do
+        a full media decode.
+
+Full documentation of the liboggz API, customization and installation,
+and mux and demux examples can be read online at:
+
+    http://www.annodex.net/software/liboggz/html/
+
+Tools
+-----
+
+The Oggz source tarball also contains the following command-line tools,
+which are useful for debugging and testing Ogg bitstreams:
+
+        * oggzinfo: Display information about one or more Ogg files and
+        their bitstreams.
+
+        * oggzdump: Hexdump packets of an Ogg file, or revert an Ogg file
+        from such a hexdump.
+
+        * oggzdiff: Hexdump the packets of two Ogg files and output
+        differences.
+
+        * oggzmerge: Merge Ogg files together, interleaving pages in order
+        of presentation time.
+
+        * oggzrip: Extract one or more logical bitstreams from an Ogg file.
+
+        * oggz-scan: Scan an Ogg file and output characteristic landmarks.
+
+        * oggz-validate: Validate the Ogg framing of one or more files.
+
+License
+-------
+
+Oggz is Free Software, available under a BSD style license.
+
+More information is available online at the Oggz homepage:
+
+    http://www.annodex.net/software/liboggz/
+
+enjoy :)
+
+--
+Conrad Parker
+Senior Software Engineer, Continuous Media Web, CSIRO Australia
+http://www.annodex.net/   http://www.ict.csiro.au/cmweb/