Appendix B and E numbered, encoding moved to a separate section.

git-svn-id: svn://svn.mplayerhq.hu/mplayer/trunk@8852 b3059339-0415-0410-9bf9-f77b7e298cf2
This commit is contained in:
diego 2003-01-09 09:37:53 +00:00
parent 1e170977a9
commit 0336518548
4 changed files with 99 additions and 75 deletions

View File

@ -10,7 +10,7 @@
<BODY>
<H1><A NAME="B">Appendix B - How to report bugs</A></H1>
<H1><A NAME="appendix_b">Appendix B - How to report bugs</A></H1>
<P>Good bug reports are a very valuable contribution to the development of any
software project. But just like writing good software, good problem reports
@ -21,7 +21,7 @@
instructions in this document closely.</P>
<H2>How to fix bugs</H2>
<H2><A NAME="fix">B.1 How to fix bugs</A></H2>
<P>If you feel have the necessary skills you are invited to have a go at fixing
the bug yourself. Or maybe you already did that? Please read
@ -31,15 +31,15 @@
mailing list will assist you if you have questions.</P>
<H2>How to report bugs</H2>
<H2><A NAME="report">B.2 How to report bugs</A></H2>
<P>First of all please try the latest CVS version of MPlayer as your bug
might already be fixed there. Development moves extremely fast, most problems
in official releases are reported within days or even hours, so please use
<B>only CVS</B> to report bugs. CVS instructions can be found at the bottom of
<A HREF="http://www.mplayerhq.hu/homepage/dload.html">this page</A> or in the
README. If this did not help please refer to
<A HREF="documentation.html#known_bugs">the list of known bugs</A> and the
README. If this did not help please refer to the
<A HREF="documentation.html#known_bugs">list of known bugs</A> and the
rest of the documentation. If your problem is not known or not solvable by our
instructions, then please report the bug.</P>
@ -69,7 +69,7 @@
problem or even an answer.</P>
<H3>Where to report bugs?</H3>
<H2><A NAME="where">B.3 Where to report bugs</A></H2>
<P>Subscribe to the mplayer-users mailing list:<BR>
&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="http://mplayerhq.hu/mailman/listinfo/mplayer-users">http://mplayerhq.hu/mailman/listinfo/mplayer-users</A><BR>
@ -86,9 +86,17 @@
subscribe to actually receive your answer.</P>
<H3>What to report?</H3>
<H2><A NAME ="what">B.4 What to report</A></H2>
<H4>System Information:</H4>
<P>You may need to include log, configuration or sample files in your bug
report. If some of them are quite big then it is better to upload them to our
<A HREF="ftp://mplayerhq.hu/MPlayer/incoming/">FTP server</A> in a compressed
format (gzip and bzip2 preferred) and include only the path and file name in
your bug report. Our mailing lists have a message size limit of 80k, if you
have something bigger you have to compress or upload it.</P>
<H3><A NAME="system">B.4.1 System Information</A></H3>
<UL>
<LI>Your Linux distribution or operating system and version e.g.:
@ -130,7 +138,7 @@
</UL>
<H4>Hardware &amp; drivers:</H4>
<H3><A NAME="hardware">B.4.2 Hardware and drivers</A></H3>
<UL>
<LI>CPU info (this works on Linux only):<BR>
@ -160,7 +168,7 @@
</UL>
<H4>For compilation problems/errors</H4>
<H3><A NAME="compilation">B.4.3 Compilation problems</A></H3>
Please include these files:
@ -178,12 +186,12 @@ Only if compilation fails below one of these directories, include these files:
</UL>
<H4>For configure problems</H4>
<H3><A NAME="configure">B.4.4 Configure problems</A></H3>
Include <CODE>configure.log</CODE>.
<H4>For playback problems</H4>
<H3><A NAME="playback">B.4.5 Playback problems</A></H3>
<P>Please include the output of MPlayer at verbosity level 1, but
remember to <B>not truncate the output</B> when you paste it into your mail.
@ -214,13 +222,14 @@ Include <CODE>configure.log</CODE>.
sufficient.</P>
<H4>For crashes</H4>
<H3><A NAME="crash">B.4.6 Crashes</A></H3>
<P>You have to run MPlayer inside <CODE>gdb</CODE> and send us the complete
output or if you have a core dump of the crash you can extract useful
information from the <CODE>Core</CODE> file. Here's how:</P>
<H4>How to conserve information about a reproducible crash</H4>
<H4><A NAME="debug">B.4.6.1 How to conserve information about a reproducible crash</A></H4>
Recompile MPlayer with debugging code enabled:
@ -243,7 +252,7 @@ return you to the command line prompt where you have to enter
&nbsp;&nbsp;&nbsp;&nbsp;info all-registers</CODE></P>
<H4>How to extract meaningful information from a core dump</H4>
<H4><A NAME="core">B.4.6.2 How to extract meaningful information from a core dump</A></H4>
<P>Please create the following command file:</P>
@ -255,16 +264,7 @@ return you to the command line prompt where you have to enter
<P>&nbsp;&nbsp;&nbsp;&nbsp;<CODE>gdb mplayer --core=core -batch --command=command_file &gt; mplayer.bug</CODE></P>
<H3>General note</H3>
<P>If something is quite big (logs for instance) then it is better to upload
it to the FTP server in a compressed format (gzip and bzip2 preferred) and
include only the path and filename in your bug report. Our mailing lists
have a message size limit of 80k, if you have something bigger you have to
compress or upload it.</P>
<H2>I know what I am doing...</H2>
<H2><A NAME="advusers">B.5 I know what I am doing...</A></H2>
<P>If you created a proper bug report following the steps above and you are
confident it is a bug in MPlayer, not a compiler problem or broken

View File

@ -214,29 +214,17 @@
</LI>
</UL>
</LI>
<LI><A HREF="encoding.html">2.4 Encoding with MEncoder</A>
<LI><A HREF="#tv">2.4 TV input</A>
<UL>
<LI><A HREF="encoding.html#2pass">2.4.1 Encoding 2 or 3-pass MPEG-4 ("DIVX")</A></LI>
<LI><A HREF="encoding.html#rescaling">2.4.2 Rescaling movies</A></LI>
<LI><A HREF="encoding.html#copying">2.4.3 Stream copying</A></LI>
<LI><A HREF="encoding.html#fixing">2.4.4 Fixing AVIs with broken index</A></LI>
<LI><A HREF="encoding.html#libavcodec">2.4.5 Encoding with the libavcodec codec family</A></LI>
<LI><A HREF="encoding.html#image_files">2.4.6 Encoding from multiple input image files (JPEGs or PNGs)</A></LI>
<LI><A HREF="encoding.html#vobsub">2.4.7 Extracting DVD subtitles to a Vobsub file</A></LI>
<LI><A HREF="encoding.html#aspect">2.4.8 Preserving aspect ratio</A></LI>
<LI><A HREF="#tv_compilation">2.4.1 Compilation</A></LI>
<LI><A HREF="#tv_tips">2.4.2 Usage tips</A></LI>
<LI><A HREF="#tv_examples">2.4.3 Examples</A></LI>
</UL>
</LI>
<LI><A HREF="#tv">2.5 TV input</A>
<LI><A HREF="#edl">2.5 Edit Decision Lists (EDL)</A>
<UL>
<LI><A HREF="#tv_compilation">2.5.1 Compilation</A></LI>
<LI><A HREF="#tv_tips">2.5.2 Usage tips</A></LI>
<LI><A HREF="#tv_examples">2.5.3 Examples</A></LI>
</UL>
</LI>
<LI><A HREF="#edl">2.6 Edit Decision Lists (EDL)</A>
<UL>
<LI><A HREF="#edl_using">2.6.1 Using an EDL file</A></LI>
<LI><A HREF="#edl_making">2.6.2 Making an EDL file</A></LI>
<LI><A HREF="#edl_using">2.5.1 Using an EDL file</A></LI>
<LI><A HREF="#edl_making">2.5.2 Making an EDL file</A></LI>
</UL>
</LI>
</UL>
@ -298,22 +286,53 @@
<LI><A HREF="#cygwin">6.6 Cygwin</A></LI>
</UL>
</LI>
<LI><A HREF="encoding.html">7. Encoding with MEncoder</A>
<UL>
<LI><A HREF="encoding.html#2pass">7.1 Encoding 2 or 3-pass MPEG-4 ("DIVX")</A></LI>
<LI><A HREF="encoding.html#rescaling">7.2 Rescaling movies</A></LI>
<LI><A HREF="encoding.html#copying">7.3 Stream copying</A></LI>
<LI><A HREF="encoding.html#fixing">7.4 Fixing AVIs with broken index</A></LI>
<LI><A HREF="encoding.html#libavcodec">7.5 Encoding with the libavcodec codec family</A></LI>
<LI><A HREF="encoding.html#image_files">7.6 Encoding from multiple input image files (JPEGs or PNGs)</A></LI>
<LI><A HREF="encoding.html#vobsub">7.7 Extracting DVD subtitles to a Vobsub file</A></LI>
<LI><A HREF="encoding.html#aspect">7.8 Preserving aspect ratio</A></LI>
</UL>
</LI>
<LI><A HREF="#mailing_lists">Appendix A - Mailing lists</A></LI>
<LI><A HREF="bugreports.html">Appendix B - How to report bugs</A>
<UL>
<LI><A HREF="tech/patches.txt">Appendix B2 - How to send patches</A></LI>
<LI><A HREF="bugreports.html#fix">B.1 How to fix bugs</A></LI>
<LI><A HREF="bugreports.html#report">B.2 How to report bugs</A></LI>
<LI><A HREF="bugreports.html#where">B.3 Where to report bugs</A></LI>
<LI><A HREF="bugreports.html#what">B.4 What to report</A>
<UL>
<LI><A HREF="bugreports.html#system">B.4.1 System information</A></LI>
<LI><A HREF="bugreports.html#hardware">B.4.2 Hardware and Drivers</A></LI>
<LI><A HREF="bugreports.html#compilation">B.4.3 Compilation problems</A></LI>
<LI><A HREF="bugreports.html#configure">B.4.4 Configure problems</A></LI>
<LI><A HREF="bugreports.html#playback">B.4.5 Playback problems</A></LI>
<LI><A HREF="bugreports.html#crash">B.4.6 Crashes</A>
<UL>
<LI><A HREF="bugreports.html#debug">B.4.6.1 How to conserve information about a reproducible crash</A></LI>
<LI><A HREF="bugreports.html#core">B.4.6.2 How to extract meaningful information from a core dump</A></LI>
</UL>
</LI>
</UL>
</LI>
<LI><A HREF="bugreports.html#advusers">B.5 I know what I am doing...</A></LI>
</UL>
</LI>
<LI><A HREF="#known_bugs">Appendix C - Known bugs</A></LI>
<LI><A HREF="skin-en.html">Appendix D - MPlayer skin format</A></LI>
<LI><A HREF="users_against_developers.html">Appendix E - Developer Cries</A>
<UL>
<LI><A HREF="users_against_developers.html#gcc">GCC 2.96</A></LI>
<LI><A HREF="users_against_developers.html#binary">Binary distribution</A></LI>
<LI><A HREF="users_against_developers.html#nvidia">nVidia</A></LI>
<LI><A HREF="users_against_developers.html#barr">Joe Barr</A></LI>
<LI><A HREF="users_against_developers.html#gcc">E.1 GCC 2.96</A></LI>
<LI><A HREF="users_against_developers.html#binary">E.2 Binary distribution</A></LI>
<LI><A HREF="users_against_developers.html#nvidia">E.3 nVidia</A></LI>
<LI><A HREF="users_against_developers.html#barr">E.4 Joe Barr</A></LI>
</UL>
</LI>
<LI><A HREF="tech/patches.txt">Appendix F - How to send patches</A></LI>
</UL>
<HR>
@ -1034,8 +1053,6 @@
<LI>push any menu key you defined</LI>
</OL>
<P>
<H2><A NAME="rtc">1.5 RTC</A></H2>
@ -1098,16 +1115,13 @@ It's a clear way for everyone to become root.
<H2><A NAME="output">2.3</A> <A HREF="video.html">Video</A> &amp; <A HREF="sound.html">Audio</A> output devices</H2>
<H2><A NAME="encoding">2.4</A> <A HREF="encoding.html">MEncoder - An All-Purpose Encoder</A></H2>
<H2><A NAME="tv"><B>2.5 TV input</B></A></H2>
<H2><A NAME="tv"><B>2.4 TV input</B></A></H2>
<P>This section is about how to enable <B>watching/grabbing from V4L compatible
TV tuner</B>. See the man page for a description of TV options and keyboard
controls.</P>
<H3><A NAME="tv_compilation">2.5.1 Compilation</A></H3>
<H3><A NAME="tv_compilation">2.4.1 Compilation</A></H3>
<OL>
<LI>First, you have to recompile. <CODE>./configure</CODE> will autodetect
@ -1118,7 +1132,7 @@ controls.</P>
xawtv.</LI>
</OL>
<H3><A NAME="tv_tips">2.5.2 Usage tips</A></H3>
<H3><A NAME="tv_tips">2.4.2 Usage tips</A></H3>
The full listing of the options is available on the manual page. Here
are just a few tips:
@ -1186,7 +1200,7 @@ are just a few tips:
"full duplex" option in the sound server preference menu.</LI>
</UL>
<H3><A NAME="tv_examples">2.5.3 Examples</A></H3>
<H3><A NAME="tv_examples">2.4.3 Examples</A></H3>
<P>Dummy output, to AAlib :)<BR>
<CODE>&nbsp;&nbsp;&nbsp;&nbsp;mplayer -tv on:driver=dummy:width=640:height=480 -vo aa</CODE><BR>
@ -1228,7 +1242,7 @@ on:driver=v4l:width=640:height=480 -vo xv</CODE><BR>
in the horizontal direction due to a hardware limitation.</P>
<H2><A NAME="edl">2.6 Edit Decision Lists (EDL)</A></H2>
<H2><A NAME="edl">2.5 Edit Decision Lists (EDL)</A></H2>
<P>The edit decision list (EDL) system allows you to automatically skip or mute
sections of videos during playback, based on a movie specific EDL
@ -1248,12 +1262,12 @@ on:driver=v4l:width=640:height=480 -vo xv</CODE><BR>
If you happen to need more, change the <CODE>#define MAX_EDL_ENTRIES</CODE>
in the <CODE>edl.h</CODE> file.</P>
<H3><A NAME="edl_using">2.6.1 Using an EDL file</A></H3>
<H3><A NAME="edl_using">2.5.1 Using an EDL file</A></H3>
<P>Include the <CODE>-edl &lt;filename&gt;</CODE> flag when you run MPlayer,
with the name of the EDL file you want applied to the video.</P>
<H3><A NAME="edl_making">2.6.2 Making an EDL file</A></H3>
<H3><A NAME="edl_making">2.5.2 Making an EDL file</A></H3>
<P>The current EDL file format is:</P>
@ -1812,6 +1826,10 @@ end
<H1><A NAME="encoding">7.</A> <A HREF="encoding.html">Encoding with MEncoder</A></H1>
<H1><A NAME="mailing_lists">Appendix A - Mailing lists</A></H1>
<P>There are some public mailing lists on MPlayer. Unless explicitly
@ -2006,5 +2024,9 @@ No picture at all (just plain grey/green window):
<H1><A NAME="flame_wars">Appendix E</A> - <A HREF="users_against_developers.html">Developer Cries</A></H1>
<H1><A NAME="patches">Appendix F</A> - <A HREF="tech/patches.txt">How to send patches</A></H1>
</BODY>
</HTML>

View File

@ -10,12 +10,13 @@
<BODY>
<H2><A NAME="encoding">2.4 Encoding with MEncoder</A></H2>
<H1><A NAME="encoding">7. Encoding with MEncoder</A></H1>
<P>For the complete list of available MEncoder options and examples, please see
the man page.</P>
<H3><A NAME="2pass">2.4.1 Encoding 2 or 3-pass MPEG-4 ("DIVX")</A></H3>
<H2><A NAME="2pass">7.1 Encoding 2 or 3-pass MPEG-4 ("DIVX")</A></H2>
<P><U><B>2-pass encoding:</B></U> the name comes from the fact that this method
encodes the file <I>twice</I>. The first encoding (dubbed <I>pass</I>)
@ -78,7 +79,8 @@
&nbsp;&nbsp;&nbsp;&nbsp;mencoder -dvd 2 -ovc lavc
-lavcopts vcodec=mpeg4:vpass=2 -oac copy -o movie.avi</CODE></P>
<H3><A NAME="rescaling">2.4.2 Rescaling movies</A></H3>
<H2><A NAME="rescaling">7.2 Rescaling movies</A></H2>
<P>Often the need to resize movie images' size emerges. Its reasons can be
many: decreasing file size, network bandwidth, etc. Most people
@ -98,7 +100,7 @@
output.avi</CODE></P>
<H3><A NAME="copying">2.4.3 Stream copying</A></H3>
<H2><A NAME="copying">7.3 Stream copying</A></H2>
<P>MEncoder can handle input streams in two ways: <B>encode</B> or
<B>copy</B> them. This section is about <B>copying</B>.</P>
@ -119,7 +121,7 @@
</UL>
<H3><A NAME="fixing">2.4.4 Fixing AVIs with broken index or interleaving</A></H3>
<H2><A NAME="fixing">7.4 Fixing AVIs with broken index or interleaving</A></H2>
<P>Easiest thing. We simply copy the video and audio streams, and
MEncoder generates the index. Of course this cannot fix possible bugs
@ -130,7 +132,7 @@
<P>Command: <CODE>mencoder -idx input.avi -ovc copy -oac copy -o output.avi</CODE></P>
<H3><A NAME="libavcodec">2.4.5 Encoding with the libavcodec codec family</A></H3>
<H2><A NAME="libavcodec">7.5 Encoding with the libavcodec codec family</A></H2>
<P><A HREF="codecs.html#libavcodec">libavcodec</A> provides simple encoding to a
lot of interesting video and audio formats (currently its audio codecs are
@ -157,7 +159,7 @@
-lavcopts vcodec=mjpeg -oac copy</CODE></P>
<H3><A NAME="image_files">2.4.6 Encoding from multiple input image files (JPEGs, PNGs or TGAs)</A></H3>
<H2><A NAME="image_files">7.6 Encoding from multiple input image files (JPEGs, PNGs or TGAs)</A></H2>
<P>MEncoder is capable of creating movies from one or more JPEG, PNG or TGA
files. With simple framecopy it can create MJPEG (Motion JPEG), MPNG
@ -203,7 +205,7 @@ Explanation of the process:
-o output.avi</CODE></P>
<H3><A NAME="vobsub">2.4.7 Extracting DVD subtitles to a Vobsub file</A></H3>
<H2><A NAME="vobsub">7.7 Extracting DVD subtitles to a Vobsub file</A></H2>
<P>MEncoder is capable of extracting subtitles from a DVD into
Vobsub fomat files. They consist of a pair of files ending in
@ -244,7 +246,7 @@ Explanation of the process:
-vobsuboutindex 0 -vobsuboutid fr -sid 1</CODE></P>
<H3><A NAME="aspect">2.4.8 Preserving aspect ratio</A></H3>
<H2><A NAME="aspect">7.8 Preserving aspect ratio</A></H2>
<P>DVDs and SVCDs (i.e. MPEG1/2) files contain an aspect ratio value,
which describes how should the player scale the video stream, so humans

View File

@ -10,14 +10,14 @@
<BODY>
<H1>Appendix E - Developer Cries</H1>
<H1><A NAME="appendix_e">Appendix E - Developer Cries</A></H1>
<P>There are two major topics which always cause huge dispute and flame on the
<A HREF="http://mplayerhq.hu/pipermail/mplayer-users/">mplayer-users</A>
mailing list. Number one is the topic of the</P>
<H2><A NAME="gcc">GCC 2.96</A></H2>
<H2><A NAME="gcc">E.1 GCC 2.96</A></H2>
<P><B>The background:</B> The GCC <B>2.95</B> series is an official GNU release
and version 2.95.3 of GCC is the most bug-free in that series.
@ -96,7 +96,7 @@
</OL>
<H2><A NAME="binary">Binary distribution</A></H2>
<H2><A NAME="binary">E.2 Binary distribution</A></H2>
<P>MPlayer previously contained source from the OpenDivX project, which
disallows binary redistribution. This code has been removed in version
@ -112,7 +112,7 @@
CPU family.</P>
<H2><A NAME="nvidia">nVidia</A></H2>
<H2><A NAME="nvidia">E.3 nVidia</A></H2>
<P>We dislike the fact that <A HREF="http://www.nvidia.com">nVidia</A>
only provides binary drivers (for use with XFree86), which are often buggy.
@ -134,7 +134,7 @@
little power to help in this matter.</P>
<H2><A NAME="barr">Joe Barr</A></H2>
<H2><A NAME="barr">E.4 Joe Barr</A></H2>
<P>Joe Barr became infamous by writing a less than favorable
<A HREF="http://www.linuxworld.com/site-stories/2001/1214.mplayer.html">