changeset 8851:636c1e894a27

Appendix B and E numbered, encoding moved to a separate section.
author diego
date Thu, 09 Jan 2003 09:37:53 +0000
parents a51f55c5a5a1
children 668cc9e77d2d
files DOCS/bugreports.html DOCS/documentation.html DOCS/encoding.html DOCS/users_against_developers.html
diffstat 4 files changed, 99 insertions(+), 75 deletions(-) [+]
line wrap: on
line diff
--- a/DOCS/bugreports.html	Thu Jan 09 09:35:01 2003 +0000
+++ b/DOCS/bugreports.html	Thu Jan 09 09:37:53 2003 +0000
@@ -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 @@
 </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 @@
   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 @@
   &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 @@
 <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
--- a/DOCS/documentation.html	Thu Jan 09 09:35:01 2003 +0000
+++ b/DOCS/documentation.html	Thu Jan 09 09:37:53 2003 +0000
@@ -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 @@
 <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 @@
     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 @@
      "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 @@
   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 @@
   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 @@
 
 
 
+<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 @@
 <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>
--- a/DOCS/encoding.html	Thu Jan 09 09:35:01 2003 +0000
+++ b/DOCS/encoding.html	Thu Jan 09 09:37:53 2003 +0000
@@ -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 @@
   -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 @@
     -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
--- a/DOCS/users_against_developers.html	Thu Jan 09 09:35:01 2003 +0000
+++ b/DOCS/users_against_developers.html	Thu Jan 09 09:37:53 2003 +0000
@@ -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">