Created manpage for vorbiscomment, but it needs to be finished before 1.0rc3...

Created manpage for vorbiscomment, but it needs to be finished before 1.0rc3 is released.  groff is vile!

svn path=/trunk/vorbis-tools/; revision=2894

vorbiscomment/Makefile.am

@@ -3,6 +3,8 @@
 AUTOMAKE_OPTIONS = foreign
 
 bin_PROGRAMS = vorbiscomment
+mandir = @MANDIR@
+man_MANS = vorbiscomment.1
 
 INCLUDES = @OGG_CFLAGS@ @VORBIS_CFLAGS@ @SHARE_CFLAGS@
 
@@ -11,6 +13,8 @@ vorbiscomment_DEPENDENCIES = @SHARE_LIBS@
 
 vorbiscomment_SOURCES = vcedit.c vcedit.h vcomment.c
 
+EXTRA_DIST = $(man_MANS)
+
 debug:
 	$(MAKE) all CFLAGS="@DEBUG@"
 

vorbiscomment/vorbiscomment.1

+.\" Process this file with
+.\" groff -man -Tascii vorbiscomment.1
+.\"
+.TH VORBISCOMMENT 1 "December 21, 2001" Xiphophorus "Vorbis Tools"
+
+.SH NAME
+vorbiscomment \- edits Ogg Vorbis comments
+
+.SH SYNOPSIS
+.B vorbiscomment
+.RB [ -l ]
+.I file.ogg
+.br
+.B vorbiscomment
+.B -a
+.B [ -t \*(lqtag=value\*(rq ]
+.I in.ogg
+.I out.ogg
+.br
+.B vorbiscomment
+.B -w
+.I in.ogg
+.I out.ogg
+
+.SH DESCRIPTION
+.B vorbiscomment
+reads Ogg Vorbis audio files and decodes them to the devices specified
+on the command line.  By default,
+
+.SH OPTIONS
+.IP "-a"
+append comment.
+.IP "-c"
+.IP "-h"
+Show command help.
+.IP "-l"
+.IP "-q"
+.IP "-t"
+.IP "-w"
+
+.SH EXAMPLES
+.\" Examples go here
+
+.SH AUTHORS
+
+.TP
+Program Authors:
+.br
+Michael Smith <msmith@labyrinth.net.au>
+.br
+Ralph Giles <giles@ashlu.bc.ca>
+.br
+
+.TP
+Manpage Author:
+.br
+Christopher L Cheney <ccheney@debian.org>