[ogg-dev] HOgg Release 0.4.1

[Conrad Parker]

Here's some instructions for installing hogg on a current Ubuntu 8.10
(or Debian unstable? testing?) system, ie. if you don't already have
haskell's cabal system installed:

$ sudo apt-get install ghc6
$ wget http://hackage.haskell.org/packages/archive/cabal-install/0.6.0/cabal-install-0.6.0.tar.gz
$ tar zxf cabal-install-0.6.0.tar.gz
$ cd cabal-install-0.6.0
$ ./bootstrap.sh
$ cabal update
$ cabal install hogg

This is from memory; please correct if any extra/fewer steps are needed :-)

Conrad.

2008/12/23 Conrad Parker <conrad at metadecks.org>:
> 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.
>
> Hackage Installation
> --------------------
>
> HOgg is in Hackage, at:
> http://hackage.haskell.org/cgi-bin/hackage-scripts/package/hogg-0.4.1
>
> If you have the Hackage "cabal" system installed, simply run:
>
>    $ cabal update
>    $ cabal install hogg
>
> 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 at 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.
>