Commit a88b55b8 authored by Ron's avatar Ron

Tidy for normal manpage requirements/conventions

Also while we're in here, fix some formatting glitches, some things that
don't follow the normal manpage requirements or font conventions, drop
some formatting markup that isn't actually doing anything, and the note
that it was generated by docbook-to-man which is presumably responsible
for most or all of the above.

Updating the rest of the manpages similarly is left as an exercise for
people/days with more spare time.
parent 22c71cfb
.TH "oggz-rip" "1"
.SH "NAME"
oggz-rip \(em Extract one or more logical bitstreams from an Ogg file.
.SH "SYNOPSIS"
.PP
\fBoggz-rip\fR [\-o \fBfilename\fR | \-\-output \fBfilename\fR ] filename
.PP
\fBoggz-rip\fR [\-h | \-\-help ] [\-v | \-\-version ]
.SH "Description"
.PP
.TH OGGZ-RIP 1 "May 3, 2013"
.SH NAME
oggz-rip \- Extract one or more logical bitstreams from an Ogg file.
.SH SYNOPSIS
\fBoggz-rip\fR [\-o \fIfilename\fR | \-\-output \fIfilename\fR] \fIfilename\fR
\fBoggz-rip\fR [\-h | \-\-help] [\-v | \-\-version]
.SH DESCRIPTION
\fBoggz-rip\fR extracts one or more tracks from an Ogg file.
In Ogg terminology, \fBoggz-rip\fR extracts one or more logical bitstreams.
.PP
For example, to extract just the Vorbis audio track from any Ogg file:
.PP
\fBoggz-rip \-c vorbis input.ogx > output.ogg\fR
.PP
This will remove any other tracks: Skeleton, Theora, image, etc.
The output will be a valid Ogg Vorbis I file, suitable for use on
hardware players that do not support multiplexed (ie. multi-track)
......@@ -27,62 +24,62 @@ If the input file contains multiple bitstreams of the desired type,
then they can be selected by serialno with the \fB-s\fR option.
Use \fBoggz-info\fR to view the serialno of each track in a file.
.SH "Options"
.PP
.SH OPTIONS
\fBoggz-rip\fR accepts the following options:
.SS "Miscellaneous options"
.IP "\-o \fBfilename\fR, \-\-output \fBfilename\fR" 10
Write output to the specified
\fBfilename\fR instead of printing it to
.SS Miscellaneous options
.TP
.BI "\-o, \-\-output " filename
Write output to the specified \fIfilename\fR instead of printing it to
standard output.
.IP "\-h, \-\-help" 10
.TP
.B \-h, \-\-help
Display usage information and exit.
.IP "\-v, \-\-version" 10
.TP
.B \-v, \-\-version
Output version information and exit.
.SS "Filter options"
.PP
.SS Filter options
These options can be used multiple times. Pages matching ANY of
the filter options will be included into the output.
.IP "\-s \fBserialno\fR, \-\-serialno \fBserialno\fR" 10
.TP
.BI "\-s, \-\-serialno " serialno
Output streams with given serialno.
.IP "\-i \fBindex\fR, \-\-stream-index \fBindex\fR" 10
Filter by stream index. These are assigned to
streams in the order of their BOS pages,
starting at 0.
.IP "\-c \fBcontent-type\fR \-\-content-type \fBcontent-type\fR" 10
Filter by content-type.
Run \fBoggz-known-codecs\fP\fB(1)\fP for a full list
.TP
.BI "\-i, \-\-stream-index " index
Filter by stream index. These are assigned to streams in the order of their
BOS pages, starting at 0.
.TP
.BI "\-c, \-\-content-type " content-type
Filter by content-type. Run \fBoggz-known-codecs\fP(1) for a full list
of codecs known by the installed version of oggz.
.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
.SH AUTHOR
David Kuehling January 1, 2005;
.SH "COPYRIGHT"
.PP
.SH COPYRIGHT
Copyright \(co 2005 CSIRO Australia
.SH "SEE ALSO"
.PP
\fBoggz-merge\fP\fB(1)\fP,
\fBoggz-chop\fP\fB(1)\fP,
\fBoggz-dump\fP\fB(1)\fP,
\fBoggz-diff\fP\fB(1)\fP \fBhogg\fP\fB(1)\fP
.\" created by instant / docbook-to-man, Mon 23 Feb 2009, 12:35
.SH SEE ALSO
.BR oggz-merge (1),
.BR oggz-chop (1),
.BR oggz-dump (1),
.BR oggz-diff (1),
.BR hogg (1)
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment