# HG changeset patch # User diego # Date 1042105073 0 # Node ID 636c1e894a273b4bafac1ef4adf97c938f7018f2 # Parent a51f55c5a5a112a6c2259cf9ec171e6e9a347dc0 Appendix B and E numbered, encoding moved to a separate section. diff -r a51f55c5a5a1 -r 636c1e894a27 DOCS/bugreports.html --- 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 @@ -

Appendix B - How to report bugs

+

Appendix B - How to report bugs

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.

-

How to fix bugs

+

B.1 How to fix bugs

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.

-

How to report bugs

+

B.2 How to report bugs

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 only CVS to report bugs. CVS instructions can be found at the bottom of this page or in the - README. If this did not help please refer to - the list of known bugs and the + README. If this did not help please refer to the + list of known bugs and the rest of the documentation. If your problem is not known or not solvable by our instructions, then please report the bug.

@@ -69,7 +69,7 @@ problem or even an answer.

-

Where to report bugs?

+

B.3 Where to report bugs

Subscribe to the mplayer-users mailing list:
    http://mplayerhq.hu/mailman/listinfo/mplayer-users
@@ -86,9 +86,17 @@ subscribe to actually receive your answer.

-

What to report?

+

B.4 What to report

-

System Information:

+

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 + FTP server 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.

+ + +

B.4.1 System Information

-

Hardware & drivers:

+

B.4.2 Hardware and drivers

-

For compilation problems/errors

+

B.4.3 Compilation problems

Please include these files: @@ -178,12 +186,12 @@ -

For configure problems

+

B.4.4 Configure problems

Include configure.log. -

For playback problems

+

B.4.5 Playback problems

Please include the output of MPlayer at verbosity level 1, but remember to not truncate the output when you paste it into your mail. @@ -214,13 +222,14 @@ sufficient.

-

For crashes

+

B.4.6 Crashes

You have to run MPlayer inside gdb and send us the complete output or if you have a core dump of the crash you can extract useful information from the Core file. Here's how:

-

How to conserve information about a reproducible crash

+ +

B.4.6.1 How to conserve information about a reproducible crash

Recompile MPlayer with debugging code enabled: @@ -243,7 +252,7 @@     info all-registers

-

How to extract meaningful information from a core dump

+

B.4.6.2 How to extract meaningful information from a core dump

Please create the following command file:

@@ -255,16 +264,7 @@

    gdb mplayer --core=core -batch --command=command_file > mplayer.bug

-

General note

- -

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.

- - -

I know what I am doing...

+

B.5 I know what I am doing...

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 diff -r a51f55c5a5a1 -r 636c1e894a27 DOCS/documentation.html --- 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 @@ -

  • 2.4 Encoding with MEncoder +
  • 2.4 TV input
  • -
  • 2.5 TV input +
  • 2.5 Edit Decision Lists (EDL) -
  • -
  • 2.6 Edit Decision Lists (EDL) -
  • @@ -298,22 +286,53 @@
  • 6.6 Cygwin
  • +
  • 7. Encoding with MEncoder + +
  • Appendix A - Mailing lists
  • Appendix B - How to report bugs
  • Appendix C - Known bugs
  • Appendix D - MPlayer skin format
  • Appendix E - Developer Cries
  • +
  • Appendix F - How to send patches

  • @@ -1034,8 +1053,6 @@
  • push any menu key you defined
  • -

    -

    1.5 RTC

    @@ -1098,16 +1115,13 @@

    2.3 Video & Audio output devices

    -

    2.4 MEncoder - An All-Purpose Encoder

    - - -

    2.5 TV input

    +

    2.4 TV input

    This section is about how to enable watching/grabbing from V4L compatible TV tuner. See the man page for a description of TV options and keyboard controls.

    -

    2.5.1 Compilation

    +

    2.4.1 Compilation

    1. First, you have to recompile. ./configure will autodetect @@ -1118,7 +1132,7 @@ xawtv.
    -

    2.5.2 Usage tips

    +

    2.4.2 Usage tips

    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. -

    2.5.3 Examples

    +

    2.4.3 Examples

    Dummy output, to AAlib :)
        mplayer -tv on:driver=dummy:width=640:height=480 -vo aa
    @@ -1228,7 +1242,7 @@ in the horizontal direction due to a hardware limitation.

    -

    2.6 Edit Decision Lists (EDL)

    +

    2.5 Edit Decision Lists (EDL)

    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 #define MAX_EDL_ENTRIES in the edl.h file.

    -

    2.6.1 Using an EDL file

    +

    2.5.1 Using an EDL file

    Include the -edl <filename> flag when you run MPlayer, with the name of the EDL file you want applied to the video.

    -

    2.6.2 Making an EDL file

    +

    2.5.2 Making an EDL file

    The current EDL file format is:

    @@ -1812,6 +1826,10 @@ +

    7. Encoding with MEncoder

    + + +

    Appendix A - Mailing lists

    There are some public mailing lists on MPlayer. Unless explicitly @@ -2006,5 +2024,9 @@

    Appendix E - Developer Cries

    + +

    Appendix F - How to send patches

    + + diff -r a51f55c5a5a1 -r 636c1e894a27 DOCS/encoding.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 @@ -

    2.4 Encoding with MEncoder

    +

    7. Encoding with MEncoder

    For the complete list of available MEncoder options and examples, please see the man page.

    -

    2.4.1 Encoding 2 or 3-pass MPEG-4 ("DIVX")

    + +

    7.1 Encoding 2 or 3-pass MPEG-4 ("DIVX")

    2-pass encoding: the name comes from the fact that this method encodes the file twice. The first encoding (dubbed pass) @@ -78,7 +79,8 @@     mencoder -dvd 2 -ovc lavc -lavcopts vcodec=mpeg4:vpass=2 -oac copy -o movie.avi

    -

    2.4.2 Rescaling movies

    + +

    7.2 Rescaling movies

    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

    -

    2.4.3 Stream copying

    +

    7.3 Stream copying

    MEncoder can handle input streams in two ways: encode or copy them. This section is about copying.

    @@ -119,7 +121,7 @@ -

    2.4.4 Fixing AVIs with broken index or interleaving

    +

    7.4 Fixing AVIs with broken index or interleaving

    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 @@

    Command: mencoder -idx input.avi -ovc copy -oac copy -o output.avi

    -

    2.4.5 Encoding with the libavcodec codec family

    +

    7.5 Encoding with the libavcodec codec family

    libavcodec 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

    -

    2.4.6 Encoding from multiple input image files (JPEGs, PNGs or TGAs)

    +

    7.6 Encoding from multiple input image files (JPEGs, PNGs or TGAs)

    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

    -

    2.4.7 Extracting DVD subtitles to a Vobsub file

    +

    7.7 Extracting DVD subtitles to a Vobsub file

    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

    -

    2.4.8 Preserving aspect ratio

    +

    7.8 Preserving aspect ratio

    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 diff -r a51f55c5a5a1 -r 636c1e894a27 DOCS/users_against_developers.html --- 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 @@ -

    Appendix E - Developer Cries

    +

    Appendix E - Developer Cries

    There are two major topics which always cause huge dispute and flame on the mplayer-users mailing list. Number one is the topic of the

    -

    GCC 2.96

    +

    E.1 GCC 2.96

    The background: The GCC 2.95 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 @@ -

    Binary distribution

    +

    E.2 Binary distribution

    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.

    -

    nVidia

    +

    E.3 nVidia

    We dislike the fact that nVidia only provides binary drivers (for use with XFree86), which are often buggy. @@ -134,7 +134,7 @@ little power to help in this matter.

    -

    Joe Barr

    +

    E.4 Joe Barr

    Joe Barr became infamous by writing a less than favorable