Release 1.0.1 1.0.1
authorConrad Parker <conrad@metadecks.org>
Wed, 7 Oct 2009 05:41:37 +0000 (14:41 +0900)
committerConrad Parker <conrad@metadecks.org>
Wed, 7 Oct 2009 05:41:37 +0000 (14:41 +0900)
ChangeLog
configure.ac
release_notes/liboggz-1.0.1.txt [new file with mode: 0644]

index 53b3383..6dbde61 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,22 @@
+Wed Oct  7 10:57:17 JST 2009 Conrad Parker <conrad@metadecks.org>
+
+       * Version 1.0.1
+
+       This release corrects timestamp calculation for Theora files with duplicate
+       frames, which are produced by the recently-released libtheora-1.1 encoder.
+
+       Public API:
+       * Updated shared version info to 7:1:6
+
+       Internal:
+       * Mozilla #516847 - calc gp for duplicate frames
+         Theora encodes duplicate frames as zero-length packets, so
+         increment the calculated granulepos correctly for these.
+
+       Documentation:
+       * Escape minus signs in man pages
+       * Fix typo in oggz-dump man page
+
 Tue Sep 15 07:27:18 JST 2009 Conrad Parker <conrad@metadecks.org>
 
        * Version 1.0.0
index 8d9f857..89bc6a7 100644 (file)
@@ -6,7 +6,7 @@ AC_PREREQ(2.53)
 
 AC_CANONICAL_TARGET
 
-AM_INIT_AUTOMAKE(liboggz, 1.0.0)
+AM_INIT_AUTOMAKE(liboggz, 1.0.1)
 AM_CONFIG_HEADER(config.h)
 
 ################################################################################
@@ -26,7 +26,7 @@ AM_CONFIG_HEADER(config.h)
 #     then set AGE to 0.                                                       #
 #                                                                              #
 ################################################################################
-SHARED_VERSION_INFO="7:0:6"
+SHARED_VERSION_INFO="7:1:6"
 SHLIB_VERSION_ARG=""
 
 # Checks for programs.
diff --git a/release_notes/liboggz-1.0.1.txt b/release_notes/liboggz-1.0.1.txt
new file mode 100644 (file)
index 0000000..9f31f6f
--- /dev/null
@@ -0,0 +1,149 @@
+Oggz 1.0.1 Release
+------------------
+
+Oggz comprises liboggz and the tool oggz, which provides commands to
+inspect, edit and validate Ogg files. The oggz-chop tool can also be
+used to serve time ranges of Ogg media over HTTP by any web server that
+supports CGI.
+
+liboggz is a C library for reading and writing Ogg files and streams.
+It offers various features over the reference libogg, including
+support for seeking, validation and timestamp interpretation. Ogg is
+an interleaving data container developed by Monty at Xiph.org,
+originally to support the Ogg Vorbis audio format but now used for
+many free codecs including Dirac, FLAC, Speex and Theora.
+
+This release is available as a source tarball at:
+
+http://downloads.xiph.org/releases/liboggz/liboggz-1.0.1.tar.gz
+
+
+New in this release
+===================
+
+This release corrects timestamp calculation for Theora files with duplicate
+frames, which are produced by the recently-released libtheora-1.1 encoder.
+
+Details
+=======
+
+Public API
+----------
+
+       * Updated shared version info to 7:1:6
+
+Internal
+--------
+
+       * Mozilla #516847 - calc gp for duplicate frames
+         Theora encodes duplicate frames as zero-length packets, so
+         increment the calculated granulepos correctly for these.
+
+Documentation
+-------------
+
+       * Escape minus signs in man pages
+       * Fix typo in oggz-dump man page
+
+
+About Oggz
+==========
+
+oggz tool
+---------
+
+Usage: oggz <subcommand> [options] filename ...
+
+oggz is a commandline tool for manipulating Ogg files. It supports
+multiplexed files conformant with RFC3533. Oggz can parse headers for
+CELT, CMML, FLAC, Kate, PCM, Speex, Theora and Vorbis, and can read and write
+Ogg Skeleton logical bitstreams.
+
+Commands:
+  help          Display help for a specific subcommand (eg. "oggz help chop")
+
+Reporting:
+  codecs        Display the list of codecs found in one or more files and
+                their bitstreams.
+  diff          Hexdump the packets of two Ogg files and output differences.
+  dump          Hexdump packets of an Ogg file, or revert an Ogg file from
+                such a hexdump.
+  info          Display information about one or more Ogg files and their
+                bitstreams.
+  scan          Scan an Ogg file and output characteristic landmarks.
+  validate      Validate the Ogg framing of one or more files.
+
+Extraction:
+  rip           Extract one or more logical bitstreams from an Ogg file.
+
+Editing:
+  chop          Extract the part of an Ogg file between given start and/or
+                end times.
+  comment       List or edit comments in an Ogg file.
+  merge         Merge Ogg files together, interleaving pages in order of
+                presentation time.
+  sort          Sort the pages of an Ogg file in order of presentation time.
+
+Miscellaneous:
+  known-codecs  List codecs known by this version of oggz
+
+
+The script bash-completion/oggz enables completion of tool options and codec
+names when using the bash shell. Source it from your .profile, or install it
+in /etc/bash_completion.d to enable it system-wide.
+
+
+liboggz
+-------
+
+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, 2005 and 2008
+        solution 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, CELT 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.xiph.org/oggz/doc/
+
+
+License
+-------
+
+Oggz is Free Software, available under a BSD style license.
+
+More information is available online at the Oggz homepage:
+
+    http://www.xiph.org/oggz/
+
+enjoy :)
+
+--
+Conrad Parker, Annodex Association
+http://www.annodex.net/