Release 0.4.1

darcs-hash:20081223053942-4b390-6be82482bedc2bc75f1c8690f204290397a9aeed.gz

README

@@ -3,7 +3,7 @@ HOgg -- Ogg encapsulation stuffz
 ------------------------------------------------------------
 
 Requirements:
-        - Cabal (tested with various version from 1.1.3 to 1.1.8 and darcs)
+        - Cabal (tested with various version from 1.1.3 to 1.6.0)
 
         - Data.ByteString, included with GHC >= 6.6, and available separately
           for GHC 6.4 at:

_publish/Makefile

@@ -33,7 +33,8 @@ graph: darcs
 	mv "/tmp/$(IMGNAME)" "$(PROJECT)/images/$(IMGNAME)"	&& \
 	chmod 644 "$(PROJECT)/images/$(IMGNAME)"
 
-publish: haddock graph
+#publish: haddock graph
+publish: graph
 	rsync -ave ssh $(PROJECT) $(SERVER):$(REMOTE)
 
 clean:

hogg.cabal

@@ -1,5 +1,5 @@
 Name:          hogg
-Version:       0.4.0
+Version:       0.4.1
 License:       BSD3
 License-file:  LICENSE
 Copyright:     Conrad Parker, 2007-2008
@@ -18,7 +18,7 @@ Build-Type:    Simple
 Cabal-Version: >= 1.2
 Tested-With:   GHC==6.8.2
 
-Extra-source-files:  README
+Extra-source-files:  README hogg.1
 
 ------------------------------------------------------------------------
 -- See the README file for information about configuring Build-Depends.
@@ -36,7 +36,7 @@ flag http
                This is optional and off by default.
 library
     if flag(splitBase)
-      build-depends: base>=3, mtl, HUnit, array, bytestring, containers, random, time
+      build-depends: base>=3, mtl, HUnit, array, bytestring, containers, random, time, old-locale
     else
 -- For GHC 6.6, fps is built in
       build-depends: base, mtl, HUnit, time

release_notes/hogg-0.4.1.txt

@@ -0,0 +1,131 @@
+HOgg 0.4.1 Released
+-------------------
+
+The HOgg package provides a commandline tool for manipulating Ogg files,
+and a corresponding Haskell library. HOgg is in hackage, or on the web at:
+
+  http://www.kfish.org/~conrad/software/hogg/
+
+This is the fourth public release. The focus is on correctness of Ogg
+parsing, production and editing. The capabilities of the hogg commandline
+tool are roughly on par with those of the oggz* [0] tools.
+
+HOgg supports chained and multiplexed Ogg bitstreams conformant with
+RFC3533[1]. HOgg can parse headers for CELT, CMML, FLAC, OggPCM, Speex, Theora
+and Vorbis media codecs, and can read and write Ogg Skeleton bitstreams.
+
+[0] Oggz: http://www.annodex.net/software/liboggz/index.html
+[1] RFC3533: http://www.ietf.org/rfc/rfc3533.txt
+
+
+New in this release
+-------------------
+
+This release is updated for Hackage, the Haskell source packaging system.
+
+The hogg tool contains a new subcommand for generating man pages, "hogg man".
+Additionally, an autogenerated version of the main hogg man page (hogg.1)
+is distributed with the source tarball.
+
+Installation
+------------
+
+I am very interested in hearing about problems with building or installing
+the package, particularly from people who are not yet familiar with building
+from Haskell source. You need ghc instead of gcc; it compiles to a binary:
+
+    $ cabal configure
+    $ cabal build
+    $ cabal install
+
+(A ./Setup.hs is also included, which may be used in place of the "cabal"
+command if that not present).
+
+Building of this release has been tested with:
+  * GHC version 6.8.2 [2]
+  * The Haskell build system "Cabal" version 1.6.0.1 [3]
+
+The GHC and Cabal versions listed above span the packages available in most
+current distributions. I've tested on Debian unstable and Ubuntu 8.10. I'm
+particularly interested to hear reports of build success or failure on other
+distributions or operating systems.
+
+[2] GHC: http://www.haskell.org/ghc/
+[3] Cabal: http://www.haskell.org/cabal/
+
+
+Usage
+-----
+
+$ hogg help
+Usage: hogg <subcommand> [options] filename ...
+
+  hogg is a commandline tool for manipulating Ogg files. It supports chained 
+  and multiplexed files conformant with RFC3533. Hogg can parse headers for 
+  CELT, CMML, FLAC, PCM, Speex, Theora and Vorbis, and can read and write Ogg 
+  Skeleton logical bitstreams.
+
+Commands:
+  help          Display help for a specific subcommand (eg. "hogg help chop")
+  man           Generate Unix man page for a specific subcommand (eg. "hogg man chop")
+
+Reporting:
+  info          Display information about the specified files and their bitstreams
+  dump          Hexdump packets of an Ogg file
+  pagedump      Display page structure of an Ogg file
+  dumpraw       Dump raw (unparsed) page data
+
+Extraction:
+  rip           Rip selected logical bistreams from an Ogg file (default: all)
+  reconstruct   Reconstruct an Ogg file by doing a full packet demux
+
+Editing:
+  chop          Extract a section (specify start and/or end time)
+  merge         Merge, interleaving pages in order of presentation time
+  sort          Rewrite with correct page ordering
+  addskel       Write a Skeleton logical bitstream
+
+Miscellaneous:
+  known-codecs  List codecs known by this version of hogg
+
+Please report bugs to <ogg-dev@xiph.org>
+
+
+New subcommand man
+------------------
+
+$ hogg help man
+man: Generate Unix man page for a specific subcommand (eg. "hogg man chop")
+Usage: hogg man [options]
+
+Examples:
+  Generate a man page for the "hogg chop" subcommand:
+    hogg man chop
+
+Options:
+  -h, -?  --help     Display this help and exit
+  -V      --version  Output version information and exit
+
+$ hogg man man
+.TH HOGG 1 "December 2008" "hogg" "Annodex"
+.SH SYNOPSIS
+
+.B hogg
+.RI man
+...
+
+
+Source
+------
+
+Source code is available from the darcs repository at:
+
+  darcs get http://www.kfish.org/~conrad/software/hogg/
+
+Tarballs are available from:
+
+  http://www.kfish.org/~conrad/software/hogg/
+
+cheers,
+
+Conrad.