From bcb3fc6c1cddb2d667f8f10cbe5ee234be7e9306 Mon Sep 17 00:00:00 2001
From: Moritz Bunkus <moritz@bunkus.org>
Date: Sun, 22 Jun 2003 10:04:16 +0000
Subject: [PATCH] Added a man page for mkvextract.

---
 mkvextract.1 | 75 ++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 75 insertions(+)
 create mode 100644 mkvextract.1

diff --git a/mkvextract.1 b/mkvextract.1
new file mode 100644
index 000000000..6f5321a12
--- /dev/null
+++ b/mkvextract.1
@@ -0,0 +1,75 @@
+.TH MKVEXTRACT "1" "June 2003" "mkvextract v0.5.0" "User Commands"
+.SH NAME
+mkvextract \- extract tracks from Matroska files into other files
+.SH SYNOPSIS
+.B mkvextract
+[\fIoptions\fR] \fB-i\fR \fIinname\fR [\fITID1\fR:\fIoutname1\fR [\fITID2\fR:\fIoutname2\fR ...]]
+.SH DESCRIPTION
+.LP
+This program extracts selected tracks from a single Matroska file to other
+suitable file formats.
+.TP
+\fB\-i\fR \fIinname\fR
+Use '\fIinname\fR' as the source.
+.TP
+\fB\-c\fR \fIcharset\fR
+Sets the charset to convert the next text subtitle track to. Only valid if the
+next track ID targets a text subtitle track.
+.TP
+\fITID\fR:\fIoutname\fR
+Causes extraction of the track with the ID \fITID\fR into the file
+\fIoutname\fR if such a track exists in the source file. This option can be
+given mutliple times. The track IDs are the same as the ones output by
+\fBmkvmerge\fR's \fB--identify\fR option.
+.TP
+\fB\-v\fR, \fB\-\-verbose\fR
+Be verbose and show all the important Matroska elements as they're read.
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+Show usage information.
+.TP
+\fB\-V\fR, \fB\-\-version\fR
+Show version information.
+
+.SH NOTES
+The decision about the output format is based on the track type, not on the
+extension used for the output file name. The following track types are
+supported at the moment:
+.TP
+V_MS/VFW/FOURCC
+Fixed FPS video tracks with this CodecID are written to AVI files.
+.TP
+A_MPEG/L3, A_AC3
+These will be extracted to raw MP3 and AC3 files.
+.TP
+A_PCM/INT/LIT
+Raw PCM data will be written to a WAV file.
+.TP
+A_AAC/MPEG2/*
+All MPEG2 AAC files will be written into an AAC file with ADTS headers before
+each packet.
+.TP
+A_AAC/MPEG4/*
+All MPEG4 AAC files will be written into an AAC file with ADTS headers before
+each packet. The ADTS headers will not contain the deprecated emphasis field.
+.TP
+A_VORBIS
+Vorbis audio will be written into an Ogg/Vorbis file.
+.TP
+S_TEXT/UTF8
+Simple text subtitles will be written as SRT files.
+.TP
+S_TEXT/SSA, S_TEXT/ASS
+SSA and ASS text subtitles will be written as SSA/ASS files respectively.
+
+.SH AUTHOR
+.I mkvextract
+was written by Moritz Bunkus <moritz@bunkus.org>.
+.SH SEE ALSO
+.BR mkvmerge (1)
+.BR mkvinfo (1)
+.SH WWW
+The newest version can always be found at
+.UR http://www.bunkus.org/videotools/mkvtoolnix/
+<http://www.bunkus.org/videotools/mkvtoolnix/>
+.UE