From 6eaad0c49243d14040b0e478eec734eb73a9cc6c Mon Sep 17 00:00:00 2001 From: wight Date: Sun, 30 Nov 2003 13:07:40 +0000 Subject: attack git-svn-id: svn://svn.mplayerhq.hu/mplayer/trunk@11541 b3059339-0415-0410-9bf9-f77b7e298cf2 --- DOCS/xml/en/audio.xml | 10 ++-- DOCS/xml/en/bugreports.xml | 43 +++++++++--------- DOCS/xml/en/bugs.xml | 11 +++-- DOCS/xml/en/cd-dvd.xml | 13 +++--- DOCS/xml/en/codecs.xml | 7 +-- DOCS/xml/en/documentation.xml | 17 +++---- DOCS/xml/en/faq.xml | 79 +++++++++++++++++--------------- DOCS/xml/en/formats.xml | 10 ++-- DOCS/xml/en/history.xml | 63 ++++++++++++++------------ DOCS/xml/en/install.xml | 49 +++++++++++--------- DOCS/xml/en/mail-lists.xml | 49 ++++++++++---------- DOCS/xml/en/mencoder.xml | 15 +++--- DOCS/xml/en/ports.xml | 103 ++++++++++++++++++++++-------------------- DOCS/xml/en/skin.xml | 63 ++++++++++++++------------ DOCS/xml/en/tvinput.xml | 25 +++++----- DOCS/xml/en/usage.xml | 4 +- DOCS/xml/en/users-vs-dev.xml | 9 ++-- DOCS/xml/en/video.xml | 60 ++++++++++++------------ 18 files changed, 335 insertions(+), 295 deletions(-) (limited to 'DOCS/xml') diff --git a/DOCS/xml/en/audio.xml b/DOCS/xml/en/audio.xml index 4d32a9fabc..94be9fcd71 100644 --- a/DOCS/xml/en/audio.xml +++ b/DOCS/xml/en/audio.xml @@ -400,7 +400,7 @@ Use automatic insertion of filters and optimize for quality. Use no automatic insertion of filters and no optimization. -Warning: It may be possible to crash MPlayer +Warning: It may be possible to crash MPlayer using this setting. @@ -492,7 +492,7 @@ to rectify the difference. Up/Downsampling -MPlayer fully supports sound up/down-sampling through the +MPlayer fully supports sound up/down-sampling through the filter. It can be used if you have a fixed frequency sound card or if you are stuck with an old sound card that is only capable of max 44.1kHz. This filter is automatically enabled if @@ -740,9 +740,9 @@ would amplify the sound by 10.1dB and hard-clip if the sound level is too high. This filter has a second feature: It measures the overall maximum sound level -and prints out that level when MPlayer exits. This volume estimate can be used -for setting the sound level in MEncoder such that the maximum dynamic range is -utilized. +and prints out that level when MPlayer exits. +This volume estimate can be used for setting the sound level in +MEncoder such that the maximum dynamic range is utilized. diff --git a/DOCS/xml/en/bugreports.xml b/DOCS/xml/en/bugreports.xml index 59c0551841..82baeea5ff 100644 --- a/DOCS/xml/en/bugreports.xml +++ b/DOCS/xml/en/bugreports.xml @@ -7,9 +7,9 @@ Good bug reports are a very valuable contribution to the development of any software project. But just like writing good software, good problem reports involve some work. Please realize that most developers are extremely busy and receive obscene amounts of email. So while your feedback is crucial in improving -MPlayer and very much appreciated, please understand that you have to provide -all of the information we request and follow -the instructions in this document closely. +MPlayer and very much appreciated, please understand +that you have to provide all of the information +we request and follow the instructions in this document closely. How to fix bugs @@ -17,7 +17,7 @@ the instructions in this document closely. 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 this short document to find out how to -get your code included in MPlayer. The people on the +get your code included in MPlayer. The people on the mplayer-dev-eng mailing list will assist you if you have questions. @@ -25,11 +25,12 @@ mailing list will assist you if you have questions. 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. This includes -binary packages of MPlayer. CVS instructions can be found at the bottom of +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. This +includes binary packages of MPlayer. 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 rest of the documentation. If your @@ -40,7 +41,7 @@ problem is not known or not solvable by our instructions, then please report the Please do not send bug reports privately to individual developers. This is community work and thus there might be several people interested in it. Sometimes other users already experienced your troubles and know how to circumvent a problem -even if it is a bug in MPlayer code. +even if it is a bug in MPlayer code. @@ -245,9 +246,9 @@ If your problem is specific to one or more files, then please upload the offende Also upload a small text file having the same base name as your file with a .txt extension. Describe the problem you are having with the particular file there and -include your email address as well as the output of MPlayer at verbosity level 1. -Usually the first 1-5 MB of a file are enough to reproduce the problem, but to be -sure we ask you to: +include your email address as well as the output of MPlayer +at verbosity level 1. Usually the first 1-5 MB of a file are enough to reproduce +the problem, but to be sure we ask you to: dd if=yourfile of=smallfile bs=1024k count=5 It will take the first five megabytes of 'your-file' and write it to 'small-file'. Then try again on @@ -270,12 +271,12 @@ the crash you can extract useful information from the Core file. Here's how: How to conserve information about a reproducible crash -Recompile MPlayer with debugging code enabled: +Recompile MPlayer with debugging code enabled: ./configure --enable-debug=3 make -and then run MPlayer within gdb using: +and then run MPlayer within gdb using: gdb ./mplayer You are now within gdb. Type: run -v options-to-mplayer filename @@ -309,18 +310,18 @@ Then simply execute this command: 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 file, you have already -read the documentation and you could not find a solution, your sound drivers are -OK, then you might want to subscribe to the mplayer-advusers list and send your -bug report there to get a better and faster answer. +it is a bug in MPlayer, not a compiler problem or broken +file, you have already read the documentation and you could not find a solution, +your sound drivers are OK, then you might want to subscribe to the mplayer-advusers +list and send your bug report there to get a better and faster answer. Please be advised that if you post newbie questions or questions answered in the manual there, you will be ignored or flamed instead of getting an appropriate answer. So do not flame us and subscribe to -advusers only if you really know what you are -doing and feel like being an advanced MPlayer user or developer. If you meet these -criteria it should not be difficult to find out how to subscribe... +doing and feel like being an advanced MPlayer user or +developer. If you meet these criteria it should not be difficult to find out how to subscribe... diff --git a/DOCS/xml/en/bugs.xml b/DOCS/xml/en/bugs.xml index ae3a61d115..50b0f36b44 100644 --- a/DOCS/xml/en/bugs.xml +++ b/DOCS/xml/en/bugs.xml @@ -13,13 +13,14 @@ General SIGILL (signal 4): -Problem: you compiled and run MPlayer on different machines -(for example compiled on P3 and running on Celeron) -Solution: compile MPlayer on the same machine where you will use it! +Problem: you compiled and run MPlayer on +different machines (for example compiled on P3 and running on Celeron) +Solution: compile MPlayer on the same machine +where you will use it! Workaround: ./configure --disable-sse etc. options -"Internal buffer inconsistency" during MEncoder run: +"Internal buffer inconsistency" during MEncoder run: Problem: known problem when lame < 3.90 was compiled with gcc 2.96 or 3.x. Solution: use lame >=3.90. Workaround: compile lame with gcc 2.95.x and remove any already installed @@ -53,7 +54,7 @@ it's sound card (driver) problem. audio buffer problems (buffer size badly detected) -Workaround: MPlayer's option +Workaround: MPlayer's option diff --git a/DOCS/xml/en/cd-dvd.xml b/DOCS/xml/en/cd-dvd.xml index 60533d90da..c172a0d10d 100644 --- a/DOCS/xml/en/cd-dvd.xml +++ b/DOCS/xml/en/cd-dvd.xml @@ -93,9 +93,9 @@ line with the option. MPlayer uses libdvdread and libdvdcss for DVD decryption and playback. These two libraries are contained in the libmpdvdkit2/ -subdirectory of the MPlayer source tree, you do not have to install them separately. -We opted for this solution because we had to fix a libdvdread -bug and apply a patch which adds +subdirectory of the MPlayer source tree, you do not have +to install them separately. We opted for this solution because we had to fix a +libdvdread bug and apply a patch which adds cracked CSS keys caching support to libdvdcss This results in a large speed increase because the keys do not have to be cracked every time before playing. @@ -119,9 +119,10 @@ facilities. Useful if you want to play encoded VOBs from hard disk. Compile and install libcss 0.0.1 (not newer) for this -(If MPlayer fails to detect it, use the -option). To use it, you need to be root, use a suid root MPlayer binary or let -MPlayer call the suid-root fibmap_mplayer wrapper program. +(If MPlayer fails to detect it, use the + option). To use it, you need to be root, +use a suid root MPlayer binary or let +MPlayer call the suid-root fibmap_mplayer wrapper program. diff --git a/DOCS/xml/en/codecs.xml b/DOCS/xml/en/codecs.xml index 418aefe1e8..83c1a2a9d5 100644 --- a/DOCS/xml/en/codecs.xml +++ b/DOCS/xml/en/codecs.xml @@ -531,14 +531,14 @@ decoders: COMPILING MPLAYER WITH QUICKTIME LIBRARIES SUPPORT currently only 32bit Intel platforms are supported. -download MPlayer CVS +download MPlayer CVS download QuickTime DLL pack from extract QuickTime DLL pack to your Win32 codecs directory (default: /usr/local/lib/codecs/) -compile MPlayer +compile MPlayer @@ -726,7 +726,8 @@ libraries. For installation instructions please see the AAC (Advanced Audio Coding) is an audio codec sometimes found in MOV and MP4 files. An open source decoder called FAAD is available from . -MPlayer includes libfaad 2.0RC1, so you do not need to get it separately. +MPlayer includes libfaad 2.0RC1, so you do not need +to get it separately. diff --git a/DOCS/xml/en/documentation.xml b/DOCS/xml/en/documentation.xml index 808a4f37e6..a340237554 100644 --- a/DOCS/xml/en/documentation.xml +++ b/DOCS/xml/en/documentation.xml @@ -28,7 +28,7 @@ -MPlayer - The Movie Player for LINUX +<application>MPlayer</application> - The Movie Player for LINUX March 24, 2003 @@ -112,18 +112,19 @@ but the speed is also amazing. -MEncoder (MPlayer's Movie Encoder) is a simple movie -encoder, designed to encode MPlayer-playable movies +MEncoder (MPlayer's Movie +Encoder) is a simple movie encoder, designed to encode +MPlayer-playable movies (AVI/ASF/OGG/DVD/VCD/VOB/MPG/MOV/VIV/FLI/RM/NUV/NET/PVA) -to other MPlayer-playable formats (see below). It can encode with various codecs, -like DivX4 (1 or 2 passes), libavcodec, -PCM/MP3/VBR MP3 audio. Also has powerful plugin -system for video manipulation. +to other MPlayer-playable formats (see below). It +can encode with various codecs, like DivX4 +(1 or 2 passes), libavcodec, PCM/MP3/VBR MP3 +audio. Also has powerful plugin system for video manipulation. -MEncoder features +<application>MEncoder</application> features Encoding from the wide range of fileformats and decoders of MPlayer diff --git a/DOCS/xml/en/faq.xml b/DOCS/xml/en/faq.xml index b420968486..e4435f5d62 100644 --- a/DOCS/xml/en/faq.xml +++ b/DOCS/xml/en/faq.xml @@ -25,7 +25,7 @@ How can I support MPlayer development? We are more than happy to accept your hardware and software donations. -They help us in continuously improving MPlayer. +They help us in continuously improving MPlayer. @@ -112,7 +112,7 @@ to 3.1 to solve the problem. How to install gcc is described in the -Configure ends with this text, and MPlayer won't compile! +Configure ends with this text, and MPlayer won't compile! Your gcc does not support even i386 for '-march' and '-mcpu' @@ -144,14 +144,14 @@ Great, I have gcc 3.0.1 from Red Hat/Mandrake, then I'm fine! No, since there have been/are issues with these compilers as well. -To check the status of current compilers' MPlayer support, see the -Installation section. +To check the status of current compilers' MPlayer +support, see the Installation section. -I tried to compile MPlayer, but I got this output: +I tried to compile MPlayer, but I got this output: In file included from /usr/include/g++-v3/bits/std_cwchar.h:42, from /usr/include/g++-v3/bits/fpos.h:40, @@ -185,12 +185,13 @@ list (the word 'ideg' is described below): And we have idegs. And our idegcounter overflowed again and again. -Unfortunately MPlayer is out of our control. It's used by lamers, Linux -users who can't even use Windows, and never tried to compile a kernel. They -installed (with default options) Mandrake or Red Hat or SuSE, and without -RTFM'ing they send messages saying 'it doesn't work! help me! please! i'm -new to Linux! help! oh! help me!'. We can't stop them, but at least we try -to force them to RTFM and to read the messages of ./configure and MPlayer. +Unfortunately MPlayer is out of our control. +It's used by lamers, Linux users who can't even use Windows, and never +tried to compile a kernel. They installed (with default options) Mandrake +or Red Hat or SuSE, and without RTFM'ing they send messages saying +'it doesn't work! help me! please! i'm new to Linux! help! oh! help me!'. +We can't stop them, but at least we try to force them to RTFM and to read +the messages of ./configure and MPlayer. And you clever guys come and flame us with gcc 2.96 and binary packages. @@ -290,8 +291,8 @@ Upgrade your kernel, modutils and MPlayer. -During 'make', MPlayer complains about X11 libraries. I don't understand, -I DO have X installed!? +During 'make', MPlayer complains about X11 libraries. +I don't understand, I DO have X installed!? ... but you don't have the X development package installed. Or not correctly. @@ -321,7 +322,8 @@ You have to edit SVGAlib's Makefile.cfg and comment -I compiled MPlayer with libdvdcss/libdivxdecore support, but when I try to start it, it says: +I compiled MPlayer with libdvdcss/libdivxdecore support, +but when I try to start it, it says: error while loading shared libraries: lib*.so.0: cannot load shared object file: No such file or directory @@ -346,7 +348,7 @@ or newer should be good). Since it is not our fault, please do -MPlayer dies with segmentation fault upon pthread check! +MPlayer dies with segmentation fault upon pthread check! chmod 644 /usr/lib/libc.so @@ -515,7 +517,7 @@ And what is "Faszom(C)ounter"? "Fasz" is a Hungarian word you don't want to know, the others are -connected to the perverted minds of the MPlayer developers. +connected to the perverted minds of the MPlayer developers. @@ -601,7 +603,7 @@ to Yes -How can I run MPlayer in the background? +How can I run MPlayer in the background? Use: @@ -622,7 +624,7 @@ Do you have a stray codecs.conf file in ~/.mplayer/, /etc/, /usr/local/etc/ or a similar location? Remove it, outdated codecs.conf files can cause obscure -problems. MPlayer will use its builtin one instead. +problems. MPlayer will use its builtin one instead. @@ -665,7 +667,7 @@ then there is a problem with your kernel/libc. Maybe you are using some security patches (for example Solar Designer's OpenWall patch) which forces loading libraries to very low addresses. Because l3codeca.acm is a non-relocatable DLL, it must be loaded to 0x00400000, we can't -change this. You should use a non-patched kernel, or use MPlayer's +change this. You should use a non-patched kernel, or use MPlayer's option to disable using l3codeca.acm. @@ -687,10 +689,11 @@ documentation to see if you can improve performance. MPlayer interrupted by signal 4 in module: decode_video -Try running MPlayer on the machine you compiled on. Or recompile with runtime -CPU detection (./configure --enable-runtime-cpudetection). -Don't use MPlayer on a CPU different from the one it was compiled on, without -using the feature mentioned just now. +Try running MPlayer on the machine you compiled on. +Or recompile with runtime CPU detection +(./configure --enable-runtime-cpudetection). +Don't use MPlayer on a CPU different from the one +it was compiled on, without using the feature mentioned just now. @@ -759,7 +762,7 @@ This can have multiple reasons. Your CPU and/or video card and/or -bus is too slow. MPlayer displays a message if this is the case (and the +bus is too slow. MPlayer displays a message if this is the case (and the dropped frames counter goes up fast). @@ -884,7 +887,7 @@ I have no sound when playing a video and get error messages similar to this one: Are you running KDE or GNOME with the ARTS or ESD sound daemon? Try disabling the sound daemon or use the or -option to make MPlayer use ARTS or ESD. +option to make MPlayer use ARTS or ESD. @@ -908,8 +911,8 @@ Help me! It works only if running as root! It's a DGA limitation. You should become root -(su -), and try again. Another solution is making MPlayer SUID -root, but it's not recommended! +(su -), and try again. Another solution is making +MPlayer SUID root, but it's not recommended! chown root /usr/local/bin/mplayer chmod 755 /usr/local/bin/mplayer @@ -918,7 +921,7 @@ root, but it's not recommended! This is a big security risk! Never do this on a server or on a computer that you do not control completely because -other users can gain root privileges through SUID root MPlayer. +other users can gain root privileges through SUID root MPlayer. You have been warned. @@ -1038,7 +1041,7 @@ in MPlayer source, and used by default. -What about subtitles? Can MPlayer display them? +What about subtitles? Can MPlayer display them? Yes. See the DVD chapter. @@ -1070,8 +1073,9 @@ Where can I get libdvdread and libdvdcss packages? You don't need to. Use libmpdvdkit2, which is -present in the MPlayer source, and used by default. You can get the mentioned -packages from the Ogle site. +present in the MPlayer source, and used by default. +You can get the mentioned packages from the +Ogle site. @@ -1100,8 +1104,9 @@ in the CD chapter). Feature requests -If MPlayer is paused and I try to seek or press any key at all, MPlayer -ceases to be paused. I would like to be able to seek in the paused movie. +If MPlayer is paused and I try to seek or press any key at all, +MPlayer ceases to be paused. I would like to be able +to seek in the paused movie. This is very tricky to implement without losing A/V synchronization. @@ -1121,7 +1126,8 @@ Feel free to implement it, and send a patch. Don't ask for it. -How can I make MPlayer remember the options I use for this particular file? +How can I make MPlayer remember the options I use +for this particular file? Create a file named movie.avi.conf with the file-specific @@ -1138,7 +1144,8 @@ in the same directory as the file. How can I encode? -Read the MEncoder section. +Read the MEncoder +section. @@ -1249,7 +1256,7 @@ How can I put subtitles in the output file? Just pass the (or , -, respectively) option to MEncoder. +, respectively) option to MEncoder. diff --git a/DOCS/xml/en/formats.xml b/DOCS/xml/en/formats.xml index 4dab6be07e..315674bc03 100644 --- a/DOCS/xml/en/formats.xml +++ b/DOCS/xml/en/formats.xml @@ -25,7 +25,7 @@ players will not play it, since they expect MPEG1 video and MP2 audio (unlike does not have the necessary fields to describe its video and audio streams). Or you might put MPEG1 video into an AVI file. FFmpeg and -MEncoder can create these files. +MEncoder can create these files. @@ -155,8 +155,8 @@ supported by most players. The file format makes it possible to use VBR audio, but most players expect CBR audio, thus they fail with VBR. VBR is uncommon and Microsoft's AVI specs only describe CBR audio. I also noticed that most AVI encoders/multiplexers create bad files when using VBR audio. -There are only two known exceptions: -NanDub and MEncoder. +There are only two known exceptions: NanDub and +MEncoder. @@ -337,8 +337,8 @@ The PVA specifications can be downloaded from the following address: The GIF format is a common format for web graphics. There are two versions of the GIF spec, GIF87a and GIF89a. The -main difference is that GIF89a allows for animation. MPlayer supports both -formats through use of libungif or +main difference is that GIF89a allows for animation. MPlayer +supports both formats through use of libungif or another libgif-compatible library. Non-animated GIFs will be displayed as single frame videos. (Use the and options to display these longer.) diff --git a/DOCS/xml/en/history.xml b/DOCS/xml/en/history.xml index f93e0d9563..2b624920e3 100644 --- a/DOCS/xml/en/history.xml +++ b/DOCS/xml/en/history.xml @@ -6,104 +6,109 @@
This began a year ago... I have tried lots of players under linux -(mtv, xmps, dvdview, livid/oms, videolan, xine, xanim, avifile, xmmp) but -they all have some problem. Mostly with special files or with audio/video -sync. Most of them are unable to play both MPEG1, MPEG2 and AVI (DivX) -files. Many players have image quality or speed problems too. So I've -decided to write/modify one... +(mtv, xmps, +dvdview, livid/oms, +videolan, xine, +xanim, avifile, +xmmp) but they all have some problem. Mostly with +special files or with audio/video sync. Most of them are unable to play both +MPEG1, MPEG2 and AVI (DivX) files. Many players have image quality or speed +problems too. So I've decided to write/modify one...
A'rpi, 2001 - mpg12play v0.1-v0.3: Sep 22-25, 2000 + mpg12play v0.1-v0.3: Sep 22-25, 2000 The first try, hacked together in a half hour! I've used libmpeg3 from up to the version 0.3, but there were image quality and speed problems with it. - mpg12play v0.5-v0.87: Sep 28-Oct 20, 2000 + mpg12play v0.5-v0.87: Sep 28-Oct 20, 2000 Mpeg codec replaced with DVDview by Dirk Farin, it was a great stuff, but it was slow and was written in C++ (A'rpi hates C++!!!) - mpg12play v0.9-v0.95pre5: Oct 21-Nov 2, 2000 + mpg12play v0.9-v0.95pre5: Oct 21-Nov 2, 2000 Mpeg codec was libmpeg2 (mpeg2dec) by Aaron Holtzman and Michel Lespinasse. It's great, optimized very fast C code with perfect image quality and 100% MPEG standard conformance. - MPlayer v0.3-v0.9: Nov 18-Dec 4, 2000 + MPlayer v0.3-v0.9: Nov 18-Dec 4, 2000 It was a pack of two programs: mpg12play v0.95pre6 and my new simple AVI player 'avip' based on avifile's Win32 DLL loader. - MPlayer v0.10: Jan 1, 2001 + MPlayer v0.10: Jan 1, 2001 The MPEG and AVI player in a single binary! - MPlayer v0.11pre series: - Some new developers joined and since 0.11 the MPlayer project - is a team-work! Added ASF file support, and OpenDivX + MPlayer v0.11pre series: + Some new developers joined and since 0.11 the MPlayer + project is a team-work! Added ASF file support, and OpenDivX (see ) en/decoding. - MPlayer v0.17a "The IdegCounter" Apr 27, 2001 + MPlayer v0.17a "The IdegCounter" Apr 27, 2001 The release version of the 0.11pre after 4 months of heavy development! Try it, and be amazed! Thousands of new features added... and of course old code was improved too, bugs removed etc. - MPlayer 0.18 "The BugCounter" Jul 9, 2001 + MPlayer 0.18 "The BugCounter" Jul 9, 2001 2 months since 0.17 and here's a new release.. Completed ASF support, more subtitle formats, introduced libao (similar to libvo but to audio), even more stable than ever, and so on. It's a MUST! - MPlayer 0.50 "The Faszom(C)ounter" Oct 8, 2001 + MPlayer 0.50 "The Faszom(C)ounter" Oct 8, 2001 Hmm. Release again. Tons of new features, beta GUI version, bugs fixed, new vo and ao drivers, ported to many systems, including opensource DivX codecs and much more. Try it! - MPlayer 0.60 "The RTFMCounter" Jan 3, 2002 + MPlayer 0.60 "The RTFMCounter" Jan 3, 2002 MOV/VIVO/RM/FLI/NUV fileformats support, native CRAM, Cinepak, ADPCM codecs, and support for XAnim's binary codecs; DVD subtitles support, - first release of MEncoder, TV grabbing, cache, liba52, countless fixes. + first release of MEncoder, TV grabbing, cache, + liba52, countless fixes. - MPlayer 0.90pre10 "The BirthdayCounter" Nov 11, 2002 + MPlayer 0.90pre10 "The BirthdayCounter" Nov 11, 2002 Although this is not a release, I am going to mention it because it - came out 2 years after MPlayer v0.01. Happy birthday, MPlayer! + came out 2 years after MPlayer v0.01. + Happy birthday, MPlayer! - MPlayer 0.90rc1 "The CodecCounter" Dec 7, 2002 + MPlayer 0.90rc1 "The CodecCounter" Dec 7, 2002 Again not a release, but after adding Sorenson 3 (QuickTime) - and Windows Media 9 support, MPlayer is the world's first movie player with - support for all known video formats! + and Windows Media 9 support, MPlayer is the + world's first movie player with support for all known video formats! - MPlayer 0.90 "The CounterCounter" Apr 6, 2003 + MPlayer 0.90 "The CounterCounter" Apr 6, 2003 After more than 1 year, we finally concluded that the code was indeed stable again, and ready to be published as a release. Unfortunately we forgot even to increase the version number, and other annoying bugs went in, so get ready for... - MPlayer 0.91 Aug 13, 2003 + MPlayer 0.91 Aug 13, 2003 The above mentioned and lot of other bugs have been fixed. This is the latest stable version. - MPlayer 1.0pre1 "Development on the beach" Sep 1, 2003 + MPlayer 1.0pre1 "Development on the beach" Sep 1, 2003 Although this is not a stable release, I am going to mention - it because it is the first pre version of the 1.0 series of MPlayer and - it is intended to help the big bug hunting party. + it because it is the first pre version of the 1.0 series of MPlayer + and it is intended to help the big bug hunting party. This is a huge step forward! - MPlayer 1.0 date yet unknown + MPlayer 1.0 date yet unknown diff --git a/DOCS/xml/en/install.xml b/DOCS/xml/en/install.xml index 5268b77d3e..9cf5ff3eca 100644 --- a/DOCS/xml/en/install.xml +++ b/DOCS/xml/en/install.xml @@ -187,7 +187,8 @@ You need a fairly recent system. On Linux, 2.4.x kernels are recommended. and encoding. Features: - 1 pass or 2 pass encoding with MEncoder + 1 pass or 2 pass encoding with + MEncoder can play old DivX3 movies much faster than @@ -203,7 +204,8 @@ You need a fairly recent system. On Linux, 2.4.x kernels are recommended. Divx4Linux. Features: - 1 pass or 2 pass encoding with MEncoder + 1 pass or 2 pass encoding with + MEncoder it's open-source, so it's multiplatform. @@ -426,7 +428,8 @@ it works with the following drivers: If you want to install MEncoder (our great - all-purpose encoder), see the MEncoder section. + all-purpose encoder), see the + MEncoder section. If you have a V4L compatible TV tuner card, @@ -463,9 +466,9 @@ copy of it. Check if you have Note that if you have a codecs.conf in ~/.mplayer/, the builtin and system codecs.conf will be ignored completely. -Do not do this unless you want to fiddle with MPlayer internals as this can -can cause many problems. If you want to change the codecs search order, use -the , , , +Do not do this unless you want to fiddle with MPlayer +internals as this can can cause many problems. If you want to change the codecs +search order, use the , , , or options either on the command line or in your config file (see the manual page). @@ -494,8 +497,8 @@ header files (usually the -dev packages) and their version matches. The Though not mandatory, the fonts should be installed in order to gain OSD, and subtitle functionality. The recommended method is installing a TTF -font file and telling MPlayer to use it. See the Subtitles -and OSD section for details. +font file and telling MPlayer to use it. +See the Subtitles and OSD section for details. @@ -543,8 +546,8 @@ directory. Subtitles and OSD -MPlayer can display subtitles along with movie files. Currently the -following formats are supported: +MPlayer can display subtitles along with movie files. +Currently the following formats are supported: VobSub OGM @@ -563,7 +566,7 @@ following formats are supported: -MPlayer can dump the previously listed subtitle formats +MPlayer can dump the previously listed subtitle formats (except the three first) into the following destination formats, with the given options: @@ -576,7 +579,8 @@ destination formats, with the given options: -MEncoder can dump DVD subtitles into VobSub format. +MEncoder can dump DVD subtitles into +VobSub format. @@ -644,7 +648,8 @@ format uses absolute frame numbers for its timing, and therefore the MPlayer has no way to guess the frame rate of the subtitle file, you have to manually convert the frame rate. There is a little perl script in the contrib -directory of the MPlayer FTP site to do this conversion for you. +directory of the MPlayer FTP site to do this +conversion for you. @@ -653,7 +658,7 @@ About DVD subtitles, read the DVD section. -MPlayer's own subtitle format (MPsub) +<application>MPlayer's</application> own subtitle format (MPsub) MPlayer introduces a new subtitle format called @@ -701,8 +706,8 @@ seek bar etc. Installing OSD and subtitles -You need an MPlayer font package to be able to use OSD/SUB feature. -There are many ways to get it: +You need an MPlayer font package to be able to use +OSD/SUB feature. There are many ways to get it: @@ -720,10 +725,10 @@ library. Version 2.0.9 or greater is mandatory! Then you have two methods: - Download ready-to-use font packages from MPlayer site. Note: currently - available fonts are limited for ISO 8859-1/2 support, but there are some - other (including Korean, Russian, ISO 8859-8 etc) fonts at contrib/font - section of FTP, made by users. + Download ready-to-use font packages from MPlayer + site. Note: currently available fonts are limited for ISO 8859-1/2 support, + but there are some other (including Korean, Russian, ISO 8859-8 etc) fonts at + contrib/font section of FTP, made by users. Font should have appropriate font.desc file which @@ -824,7 +829,7 @@ variable in config file, or the command line option. OSD menu -MPlayer has a completely user definiable OSD Menu interface. +MPlayer has a completely user definiable OSD Menu interface. @@ -871,7 +876,7 @@ the Preferences menu is currently UNIMPLEMENTED! RTC -There are three timing methods in MPlayer. +There are three timing methods in MPlayer. diff --git a/DOCS/xml/en/mail-lists.xml b/DOCS/xml/en/mail-lists.xml index 230e9502c7..619d4cdb0e 100644 --- a/DOCS/xml/en/mail-lists.xml +++ b/DOCS/xml/en/mail-lists.xml @@ -14,27 +14,28 @@ mails a lot easier. If you do not know them please read are in a hurry) Quoting HOWTO. -MPlayer announce list: +MPlayer announce list: -List for MPlayer announcements. Subscribe here if you want to get -announcements about new features. +List for MPlayer announcements. +Subscribe here if you want to get announcements about new features. -MPlayer developers list: +MPlayer developers list: -This list is about MPlayer development! Talking about interface/API changes, -new libraries, code optimization, configure changes is ontopic here. Send patches -but not bug reports, user questions, feature requests or flames here to keep the -list traffic low. +This list is about MPlayer development! +Talking about interface/API changes, new libraries, code optimization, +configure changes is ontopic here. Send patches but not bug reports, +user questions, feature requests or flames here to keep the list traffic low. -MPlayer DOCS list: +MPlayer DOCS list: -This list is about MPlayer documentation and translation discussions. +This list is about MPlayer documentation +and translation discussions. Documentation and homepage related CVS logs are also sent here. -MPlayer users list: +MPlayer users list: @@ -52,7 +53,7 @@ MPlayer users list: -MPlayer Hungarian users list: +MPlayer Hungarian users list: @@ -64,7 +65,7 @@ MPlayer Hungarian users list: -MPlayer & Matrox G200/G400/G450/G550 users: +MPlayer & Matrox G200/G400/G450/G550 users: Matrox related questions like @@ -80,30 +81,30 @@ Matrox related questions like -MPlayer & DVB card users: +MPlayer & DVB card users: Things related to the hardware decoder card called DVB (not DXR3!). -MPlayer CVS-log: +MPlayer CVS-log: -All changes in MPlayer code are automatically sent to this list. Only -questions about these changes belong here (if you do not understand why a -change is required or you have a better fix or you have noticed a possible -bug/problem in the commit). +All changes in MPlayer code are automatically +sent to this list. Only questions about these changes belong here +(if you do not understand why a change is required or you have a better +fix or you have noticed a possible bug/problem in the commit). -MPlayer Cygwin-porting list: +MPlayer Cygwin-porting list: -List for discussion about MPlayer's Cygwin port. +List for discussion about MPlayer's Cygwin port. -MPlayer OS/2-porting list: +MPlayer OS/2-porting list: -List for discussion about MPlayer's OS/2 port. +List for discussion about MPlayer's OS/2 port. -MPlayer Weekly News' editors and translators list: +MPlayer Weekly News' editors and translators list: List for discussion about the Weekly News releases. diff --git a/DOCS/xml/en/mencoder.xml b/DOCS/xml/en/mencoder.xml index ad1235e7b5..5209d13456 100644 --- a/DOCS/xml/en/mencoder.xml +++ b/DOCS/xml/en/mencoder.xml @@ -1,7 +1,7 @@ -Encoding with MEncoder +Encoding with <application>MEncoder</application> For the complete list of available MEncoder options @@ -76,7 +76,7 @@ once, unlike in 2-pass mode. The schematics: mencoder file/DVD -oac copy -ovc lavc -lavcopts vcodec=mpeg4:vpass=1:vbitrate=bitrate This is the first pass of video encoding. Optionally specify the video -bitrate MEncoder printed at the end of the previous pass. +bitrate MEncoder printed at the end of the previous pass. Third pass: @@ -118,12 +118,13 @@ audio streams in MPEG files. this feature is not very useful right now, aside that it probably has many bugs, -but the more importantly because MEncoder currently cannot encode MPEG1 layer 2 -(MP2) audio, which all other players expect in MPEG files. +but the more importantly because MEncoder currently +cannot encode MPEG1 layer 2 (MP2) audio, which all other players expect in MPEG files. -To change MEncoder's output file format, use the option. +To change MEncoder's output file format, +use the option. @@ -215,8 +216,8 @@ mencoder -idx input.avi -ovc copy -oac copy -o Appending multiple AVI files -As a side-effect, the broken AVI fixer function enables MEncoder to append -2 (or more) AVI files: +As a side-effect, the broken AVI fixer function enables MEncoder +to append 2 (or more) AVI files: diff --git a/DOCS/xml/en/ports.xml b/DOCS/xml/en/ports.xml index 776b015a63..6b807dc3f4 100644 --- a/DOCS/xml/en/ports.xml +++ b/DOCS/xml/en/ports.xml @@ -8,24 +8,25 @@ The main development platform is Linux on x86, although MPlayer works on many other Linux ports. -Binary packages of MPlayer are available from several sources. However, -none of these packages are supported. +Binary packages of MPlayer are available from several +sources. However, none of these packages are supported. Report problems to the authors, not to us. Debian packaging -To build a Debian package, run the following command in the MPlayer -source directory: +To build a Debian package, run the following command in the +MPlayer source directory: fakeroot debian/rules binary As root you can then install the .deb package as usual: dpkg -i ../mplayer_version.deb -Christian Marillat has been making unofficial Debian MPlayer, MEncoder and font -packages for a while, you can (apt-)get them from his +Christian Marillat has been making unofficial Debian +MPlayer, MEncoder and +font packages for a while, you can (apt-)get them from his homepage. @@ -40,24 +41,25 @@ Dominik Mierzejewski created and maintains official Red Hat RPM packages of Mandrake RPM packages are available from the P.L.F.. -SuSE used to include a crippled version of MPlayer in their distribution. -They have removed it in their latest releases. You can get working RPMs -from links2linux.de. +SuSE used to include a crippled version of MPlayer +in their distribution. They have removed it in their latest releases. You can +get working RPMs from +links2linux.de. ARM -MPlayer works on Linux PDAs with ARM CPU e.g. Sharp Zaurus, Compaq Ipaq. The -easiest way to obtain MPlayer is to get it from one of the -OpenZaurus package feeds. If +MPlayer works on Linux PDAs with ARM CPU e.g. Sharp Zaurus, +Compaq Ipaq. The easiest way to obtain MPlayer is to get it +from one of theOpenZaurus package feeds. If you want to compile it yourself, you should look at the MPlayer and the libavcodec directory in the OpenZaurus distribution buildroot. These always have the latest -Makefile and patches used for building a CVS MPlayer with libavcodec. +Makefile and patches used for building a CVS MPlayer with libavcodec. If you need a GUI frontend, you can use xmms-embedded. @@ -67,24 +69,25 @@ If you need a GUI frontend, you can use xmms-embedded. *BSD MPlayer runs on FreeBSD, OpenBSD, NetBSD, -BSD/OS and Darwin. There are ports/pkgsrc/fink/etc versions of MPlayer +BSD/OS and Darwin. There are ports/pkgsrc/fink/etc versions of MPlayer available that are probably easier to use than our raw sources. -To build MPlayer you will need GNU make (gmake - native BSD make -will not work) and a recent version of binutils. +To build MPlayer you will need GNU make +(gmake - native BSD make will not work) and a recent version of binutils. -If MPlayer complains about not finding /dev/cdrom or -/dev/dvd, create an appropriate symbolic link: +If MPlayer complains about not finding /dev/cdrom +or /dev/dvd, create an appropriate symbolic link: ln -s /dev/your_cdrom_device /dev/cdrom -To use Win32 DLLs with MPlayer you will need to re-compile the kernel with -"option USER_LDT" (unless you run FreeBSD-CURRENT, +To use Win32 DLLs with MPlayer you will need to +re-compile the kernel with "option USER_LDT" +(unless you run FreeBSD-CURRENT, where this is the default). @@ -123,10 +126,10 @@ See the Mac OS section. -On UltraSPARCs, MPlayer takes advantage of their -VIS extensions (equivalent to MMX), currently -only in libmpeg2, libvo and -libavcodec, but not in mp3lib. You can watch a VOB file +On UltraSPARCs, MPlayer +takes advantage of their VIS extensions +(equivalent to MMX), currently only in libmpeg2, libvo +and libavcodec, but not in mp3lib. You can watch a VOB file on a 400MHz CPU. You'll need mLib installed. @@ -212,7 +215,7 @@ The hsfs problem can be fixed by installing patch 109764-04 (sparc) / 109765-04 On Solaris with an UltraSPARC CPU, you can get some extra speed by using the CPU's VIS instructions for certain time consuming operations. VIS acceleration -can be used in MPlayer by calling functions in Sun's +can be used in MPlayer by calling functions in Sun's mediaLib. @@ -245,7 +248,7 @@ to: $(INSTALL) -m 644 codecs.conf $(CONFDIR)/ -And then do (from within the MPlayer source dir): +And then do (from within the MPlayer source dir): cp DOCS/mplayer.1 . ; cp etc/codecs.conf . and then go on with building and installing. @@ -268,9 +271,9 @@ since QNX has only X emulation which is VERY slow. Use SDL. Windows -Yes, MPlayer runs on Windows under - Cygwin and - MinGW. +Yes, MPlayer runs on Windows under + Cygwin and + MinGW. It does not have a GUI yet, but the command line version is almost completely functional. Patches are always welcome. You should check out the @@ -290,16 +293,18 @@ since QNX has only X emulation which is VERY slow. Use SDL. You can use Win32 codecs and Real Win32 codecs (not Real Linux codecs) if you want to. Put the codecs somewhere in your path or pass (alternatively - only on Cygwin) to - configure. We have had some reports that Real DLLs need - to be writable by the user running MPlayer, but only on some systems. Try - making them writable if you have problems. QuickTime DLLs also work, but you - will have to put them in your Windows system directory + only on + Cygwin) to configure. We + have had some reports that Real DLLs need to be writable by the user running + MPlayer, but only on some systems. Try making + them writable if you have problems. QuickTime DLLs also work, but you will + have to put them in your Windows system directory (C:\Windows\system\ or similar). -The Cygwin/MinGW console is rather slow. Redirecting output or using - the option has been reported to improve performance - on some systems. Direct rendering () may also help. +The Cygwin/MinGW + console is rather slow. Redirecting output or using the + option has been reported to improve performance on + some systems. Direct rendering () may also help. You can prevent OSD flicker through double buffering with the option. If playback is jerky, try . If some of these options help you, you @@ -311,7 +316,7 @@ since QNX has only X emulation which is VERY slow. Use SDL. our projects page. -Cygwin +<application>Cygwin</application> Cygwin versions prior to 1.5.0 do not include inttypes.h. Put this @@ -322,7 +327,8 @@ since QNX has only X emulation which is VERY slow. Use SDL. DirectX header files need to be extracted to /usr/include/ or /usr/local/include/. -Instructions and files for making SDL run under Cygwin can be found on the +Instructions and files for making SDL run under + Cygwin can be found on the libsdl site. You can play VCDs by playing the .DAT or .MPG files @@ -342,21 +348,22 @@ since QNX has only X emulation which is VERY slow. Use SDL. -MinGW +<application>MinGW</application> -Installing a version of MinGW that could compile MPlayer used to be quite - tricky, but it works out of the box now. Just install MinGW 3.1.0 or later - and MSYS 1.0.9 or later and tell the MSYS postinstall that MinGW is - installed. +Installing a version of MinGW that could + compile MPlayer used to be quite tricky, but it + works out of the box now. Just install MinGW + 3.1.0 or later and MSYS 1.0.9 or later and tell the MSYS postinstall that + MinGW is installed. -If you use a version of MinGW before 3.1.0, you need to replace - /mingw/include/sys/types.h with this +If you use a version of MinGW before 3.1.0, + you need to replace /mingw/include/sys/types.h with this types.h. Extract DirectX header files to /mingw/include/. -VCDs and DVDs work almost like Cygwin (adjust for the drive letter of your - CD-ROM/DVD-ROM): +VCDs and DVDs work almost like Cygwin (adjust + for the drive letter of your CD-ROM/DVD-ROM): mplayer d:/mpegav/avseq01.dat diff --git a/DOCS/xml/en/skin.xml b/DOCS/xml/en/skin.xml index ae6063e312..28e2714dcc 100644 --- a/DOCS/xml/en/skin.xml +++ b/DOCS/xml/en/skin.xml @@ -1,10 +1,11 @@ -MPlayer skin format +<application>MPlayer</application> skin format -The purpose of this document is to describe the MPlayer skin format. -The information contained here might be wrong, for +The purpose of this document is to describe the +MPlayer skin format. The information contained here +might be wrong, for It is not me who wrote the GUI. The GUI is not finished. @@ -21,9 +22,9 @@ So do not be surprised if something does not work as described here. Overview It does not really have anything to do with the skin format, but you should -know that MPlayer has no builtin skin, so -at least one skin must be installed in order to be able -to use the GUI. +know that MPlayer has no +builtin skin, so at least one skin must be installed +in order to be able to use the GUI. @@ -44,9 +45,9 @@ The directories searched for skins are (in order): -Note that the first path may vary according to the way MPlayer was configured -(see the and arguments of -the configure script). +Note that the first path may vary according to the way MPlayer +was configured (see the and +arguments of the configure script). @@ -62,8 +63,8 @@ listed above, for example: In the main window and in the playbar (see below) you can use images with `transparency': Regions filled with the color #FF00FF (magenta) are fully -transparent when viewed by MPlayer. This means that you can even have shaped -windows if your X server has the XShape extension. +transparent when viewed by MPlayer. This means +that you can even have shaped windows if your X server has the XShape e