diff --git a/DOCS/xml/en/mencoder.xml b/DOCS/xml/en/mencoder.xml
index be9b857e70..42e6becbc9 100644
--- a/DOCS/xml/en/mencoder.xml
+++ b/DOCS/xml/en/mencoder.xml
@@ -14,6 +14,143 @@ for a wealth of discussions about all aspects of and problems related to
encoding with MEncoder.
+
+Selecting codecs and container formats
+
+
+ Audio and video codecs for encoding are selected with the
+ and options, respectively.
+ The following choices are available, although some may not have been
+ enabled at compiletime:
+
+
+Audio Codecs:
+
+
+
+
+Audio codec nameDescription
+
+
+
+ mp3lame
+ Encode to VBR, ABR or CBR MP3 with LAME
+
+
+ lavc
+ Use one of libavcodec's audio encoders
+
+
+ faac
+ FAAC AAC audio encoder
+
+
+ toolame
+ MPEG Audio Layer 2 encoder
+
+
+ twolame
+ MPEG Audio Layer 2 encoder based on tooLAME
+
+
+ pcm
+ Uncompressed PCM audio
+
+
+ copy
+ Do not reencode, just copy compressed frames
+
+
+
+
+
+
+
+Video codecs:
+
+
+
+Video codec nameDescription
+
+
+
+ lavc
+ Use one of libavcodec's video encoders
+
+
+ xvid
+ XviD, MPEG-4 Advanced Simple Profile codec
+
+
+ x264
+ x264, MPEG-4 AVC, aka H.264 codec
+
+
+ nuv
+ nuppel video, used by some realtime applications
+
+
+ raw
+ Uncompressed video frames
+
+
+ copy
+ Do not reencode, just copy compressed frames
+
+
+ frameno
+ Used for 3-pass encoding (not recommended)
+
+
+
+
+
+
+
+
+
+Selecting input file or device
+
+
+ MEncoder can encode from files or directly
+ from a DVD or VCD disc.
+ Simply include the filename on the command line to encode from a file,
+ or titlenumber or
+ tracknumber to encode
+ from a DVD title or VCD track.
+ If you have already copied a DVD to your hard drive (you can use a tool
+ such as dvdbackup, available on most systems),
+ and wish to encode from the copy, you should still use the
+ syntax, along with
+ followed by the path to the copied DVD root.
+
+ The and
+ options can also be used to override the paths to the device nodes
+ for reading directly from disc, if the defaults of
+ /dev/dvd and /dev/cdrom do
+ not work on your system.
+
+
+ When encoding from DVD, it is often desirable to select a chapter or
+ range of chapters to encode.
+ You can use the option for this purpose.
+ For example, 1-4
+ will only encode chapters 1 through 4 from the DVD.
+ This is especially useful if you will be making a 1400 MB encode
+ targetted for two CDs, since you can ensure the split occurs exactly
+ at a chapter boundary rather than in the middle of a scene.
+
+
+ If you have a supported TV capture card, you can also encode from the
+ TV-in device.
+ Use channelnumber as
+ the filename, and to configure various capture
+ settings.
+ DVB input works similarly.
+
+
+
+
Encoding two pass MPEG-4 ("DivX")
@@ -21,7 +158,9 @@ encoding with MEncoder.
The name comes from the fact that this method encodes the file twice.
The first encoding (dubbed pass) creates some temporary files
(*.log) with a size of few megabytes, do not delete
-them yet (you can delete the AVI). In the second pass, the two pass output
+them yet (you can delete the AVI or rather just not create any video by
+redirecting it into /dev/null).
+In the second pass, the two pass output
file is created, using the bitrate data from the temporary files. The
resulting file will have much better image quality. If this is the first
time you heard about this, you should consult some guides available on the
@@ -31,10 +170,10 @@ net.
copy audio track
-Two pass encode of a DVD to an MPEG-4 ("DivX") AVI while copying
-the audio track.
+Two pass encode of the second track a DVD to an MPEG-4 ("DivX")
+AVI while copying the audio track.
-mencoder dvd://2 -ovc lavc -lavcopts vcodec=mpeg4:vpass=1 -oac copy -o movie.avi
+mencoder dvd://2 -ovc lavc -lavcopts vcodec=mpeg4:vpass=1 -oac copy -o /dev/null
mencoder dvd://2 -ovc lavc -lavcopts vcodec=mpeg4:vpass=2 -oac copy -o movie.avi
@@ -45,6 +184,8 @@ mencoder dvd://2 -ovc lavc -lavcopts vcodec=mpeg4:vpass=2 -oac copy -o
Two pass encode of a DVD to an MPEG-4 ("DivX") AVI while encoding
the audio track to MP3.
+Be careful using this method as it may lead to audio/video desync in
+some cases.
mencoder dvd://2 -ovc lavc -lavcopts vcodec=mpeg4:vpass=1 -oac mp3lame -lameopts vbr=3 -o movie.avi
mencoder dvd://2 -ovc lavc -lavcopts vcodec=mpeg4:vpass=2 -oac mp3lame -lameopts vbr=3 -o movie.avi