add exmaples to chop,dump,info,merge,rip,sort man pages

(merged from hogg man page examples)

doc/oggz-chop.1

@@ -53,6 +53,28 @@ Do NOT include a Skeleton bitstream in the output.
 Display usage information and exit. 
 .IP "\-v, \-\-version" 10 
 Output version information and exit. 
+
+.SH EXAMPLES
+.PP
+Extract the first minute of file.ogx:
+.PP
+.RS
+\f(CWoggz chop -e 1:00 file.ogx\fP
+.RE
+.PP
+Extract from the second to the fifth minute of file.ogx:
+.PP
+.RS
+\f(CWoggz chop -s 2:00 -e 5:00 -o output.ogx file.ogx\fP
+.RE
+.PP
+Extract, specifying SMPTE-25 frame offsets:
+.PP
+.RS
+\f(CWoggz chop -s smpte-25:00:02:03::12 -e smpte-25:00:05:02::04 -o output.ogv file.ogv\fP
+.RE
+
+
 .SH "Server configuration" 
 .PP 
 The following configuration for Apache httpd will enable oggz-chop. As with 

doc/oggz-dump.1

@@ -91,6 +91,21 @@ standard output.
 Display usage information and exit. 
 .IP "\-v, \-\-version" 10 
 Output version information and exit. 
+
+.SH EXAMPLES
+.PP
+Dump all bitstreams in file.ogg:
+.PP
+.RS
+\f(CWoggz dump file.ogg\fP
+.RE
+.PP
+Dump only the Theora bitstream in file.ogv:
+.PP
+.RS
+\f(CWoggz dump -c theora file.ogv\fP
+.RE
+
 .SH "AUTHOR" 
 .PP 
 Conrad Parker        November 17, 2003;      

doc/oggz-info.1

@@ -57,6 +57,21 @@ kilobits per second (1000 bit/s)
 megabits per second (1000000 bit/s) 
 .IP "Gbps" 10 
 gigabits per second (1000000000 bit/s) 
+
+.SH EXAMPLES
+.PP
+Describe all bitstreams in file.ogg:
+.PP
+.RS
+\f(CWoggz info file.ogg\fP
+.RE
+.PP
+Describe only the Theora bitstream in file.ogv:
+.PP
+.RS
+\f(CWoggz info -c theora file.ogv\fP
+.RE
+
 .SH "AUTHOR" 
 .PP 
 Conrad Parker        March 10, 2005;      

doc/oggz-merge.1

@@ -54,6 +54,15 @@ standard output.
 Display usage information and exit. 
 .IP "\-v, \-\-version" 10 
 Output version information and exit. 
+
+.SH EXAMPLES
+.PP
+Merge pages of audio.oga and video.ogv:
+.PP
+.RS
+\f(CWoggz merge -o output.ogv audio.oga video.ogv\fP
+.RE
+
 .SH "AUTHOR" 
 .PP 
 Conrad Parker        September 21, 2004;      

doc/oggz-rip.1

@@ -57,6 +57,20 @@ starting at 0.
 .IP "\-c \fBcontent-type\fR \-\-content-type \fBcontent-type\fR" 10 
 Filter by content-type.  The following codec names 
 are currently detected: "cmml", "flac", "theora", "speex", "vorbis" 
+
+.SH EXAMPLES
+.PP
+Extract all bitstreams from file.ogg:
+.PP
+.RS
+\f(CWoggz rip -o output.ogg file.ogg\fP
+.RE
+.PP
+Extract only the Theora bitstream from file.ogv:
+.PP
+.RS
+\f(CWoggz rip -c theora -o output.ogv file.ogv\fP
+.RE
  
 .SH "AUTHOR" 
 .PP 

doc/oggz-sort.1

@@ -50,6 +50,15 @@ standard output.
 Display usage information and exit. 
 .IP "\-v, \-\-version" 10 
 Output version information and exit. 
+
+.SH EXAMPLES
+.PP
+Correct the page ordering in broken.ogv:
+.PP
+.RS
+\f(CWoggz sort -o fixed.ogv broken.ogv\fP
+.RE
+
 .SH "AUTHOR" 
 .PP 
 Conrad Parker        January 25, 2008;