[MPlayer-dev-eng] [PATCH] Docs fixes
Andras Mohari
mayday at varoshaza.nagyatad.hu
Wed Aug 14 12:01:09 CEST 2002
Hi,
Here's a patch to fix some things in the documentation:
* Reduces the number of '!' chars...
* Removes unnecessary spaces before ':' and '!' chars.
* Changes the title of Appendix X to 'MPlayer skin format'.
* Improves(?) wording in some cases.
* Adds CODE tags around some options and filenames.
I hope it's OK...
--
Andras Mohari
mayday at mail.nagyatad.hu
-------------- next part --------------
diff -Naur DOCS.old/codecs.html DOCS/codecs.html
--- DOCS.old/codecs.html Wed Aug 14 09:34:50 2002
+++ DOCS/codecs.html Wed Aug 14 09:52:23 2002
@@ -16,7 +16,7 @@
<P><B><A NAME="video_codecs">2.2.1 Video codecs</A></B></P>
<P>See the <A HREF="http://www.mplayerhq.hu/DOCS/codecs-status.html">codec status table</A>
- for the complete, daily generated list!!!</P>
+ for the complete, daily generated list.</P>
<P>The most important ones above all:</P>
<UL>
@@ -39,7 +39,7 @@
<P>If you have a Win32 codec not listed here which is not supported yet, please
read the <A HREF="#importing">codec importing HOWTO</A> and help us add support
- for it!</P>
+ for it.</P>
<P><B><A NAME="divx">2.2.1.1 DivX4/DivX5</A></B></P>
@@ -77,7 +77,7 @@
<TR><TD> </TD><TD VALIGN=top><CODE>-vc odivx</CODE></TD><TD> </TD>
<TD>Uses the codec in OpenDivX fashion. In this case it
produces YV12 images in its own buffer, and <B>MPlayer</B> does colorspace
- conversion via libvo. (<B>FAST, RECOMMENDED!</B>)</TD></TR>
+ conversion via libvo. (<B>Fast, recommended!</B>)</TD></TR>
<TR><TD></TD><TD VALIGN=top><CODE>-vc divx4</CODE></TD><TD></TD>
<TD>Uses the colorspace conversion of the codec.
In this mode you can use YUY2/UYVY, too. (<B>SLOW</B>)</TD></TR>
@@ -117,12 +117,12 @@
<LI>Move the <CODE>libavcodec</CODE> directory from the FFmpeg sources to the
root of the <B>MPlayer</B> CVS tree. It should look like this:
<P> <CODE>main/libavcodec</CODE></P>
- Symlinking is <B>not</B> enough, you have to copy/move it!!!</LI>
+ Symlinking is <B>not</B> enough, you have to copy or move it!</LI>
<LI>Compile. Configure should detect problems before compilation.</LI>
</OL>
<P><B>Note:</B> MPlayer from CVS does contain a libavcodec
- subdirectory, but it does NOT contain the source for libavcodec!
+ subdirectory, but it <B>does not</B> contain the source for libavcodec!
You must follow the steps above to obtain the source for this library.</P>
<P>With FFmpeg and my Matrox G400, I can view even the highest resolution DivX
@@ -217,7 +217,7 @@
<CODE>--with-reallibdir</CODE> switch.</P>
<P><B>Note:</B> RealPlayer libraries currently <B>only work with Linux, FreeBSD,
- NetBSD and Cygwin on the x86 platform</B>!</P>
+ NetBSD and Cygwin on the x86 platform.</B></P>
<P><B>Note2:</B> We cannot distribute the RealPlayer libraries, the license does
not allow this. You have to get them yourself.</P>
@@ -336,7 +336,7 @@
driver must properly support the AFMT_AC3 format (C-Media does). Connect
your AC3 decoder to the SP/DIF output, and use the <CODE>-ac hwac3</CODE>
option. It is experimental but known to work with C-Media cards and
- Soundblaster Live! + ALSA (but not OSS) drivers.</P>
+ Soundblaster Live! using ALSA (but not OSS) drivers.</P>
<P><B><A NAME="libmad">2.2.2.3 libmad support</A></B></P>
diff -Naur DOCS.old/documentation.html DOCS/documentation.html
--- DOCS.old/documentation.html Wed Aug 14 09:34:55 2002
+++ DOCS/documentation.html Wed Aug 14 11:48:38 2002
@@ -286,7 +286,7 @@
</UL>
</LI>
<LI><A HREF="#known_bugs">Appendix D - Known bugs</A></LI>
- <LI><A HREF="skin-en.html">Appendix X - How to become a famous skin maker in 5 minutes!</A></LI>
+ <LI><A HREF="skin-en.html">Appendix X - MPlayer skin format</A></LI>
</UL>
<HR>
@@ -341,7 +341,7 @@
Win32 DLL codecs. You can watch <B>VideoCD</B>, <B>SVCD</B>, <B>DVD</B>,
<B>3ivx</B>, <B>RealMedia</B>, and <B>DivX</B> movies too (and you don't need
the avifile
- library at all!). The another big feature of mplayer is the wide range of
+ library at all!). Another big feature of <B>MPlayer</B> is the wide range of
supported output drivers. It works with X11, Xv, DGA, OpenGL, SVGAlib, fbdev,
AAlib, DirectFB, but you can use GGI and SDL (and this way all their drivers)
and some lowlevel card-specific drivers (for Matrox, 3Dfx and Radeon,
@@ -349,8 +349,8 @@
of them supports software or hardware scaling, so you can enjoy movies in
fullscreen. <B>MPlayer</B> supports displaying through some hardware MPEG
decoder boards, such as the <B><A HREF="video.html#dvb">DVB</A></B> and
- <B><A HREF="video.html#dxr3">DXR3/Hollywood+</A></B>! And what about the nice big antialiased
- shaded subtitles (<B>10 supported types!!!</B>) with european/ISO 8859-1,2
+ <B><A HREF="video.html#dxr3">DXR3/Hollywood+</A></B>. And what about the nice big antialiased
+ shaded subtitles (<B>10 supported types</B>) with European/ISO 8859-1,2
(Hungarian, English, Czech, etc), Cyrillic, Korean fonts, and the onscreen
display (OSD)?</P>
@@ -431,7 +431,7 @@
<LI><B>binutils</B> - suggested version is <B>2.11.x</B> . This program is
responsible for generating MMX/3DNow!/etc instructions, thus very important.</LI>
<LI><B>gcc</B> - suggested versions are: <B>2.95.3</B>, <B>2.95.4</B> and <B>3.1</B>.
- <B>NEVER</B> use 2.96 or 3.0.x !!! They generate faulty code for MPlayer.
+ <B>NEVER</B> use 2.96 or 3.0.x! They generate faulty code for MPlayer.
If you decide to change gcc from 2.96, then don't decide in favor of 3.0.x
just because it's newer! Early releases of 3.0.x were even more buggy than
2.96. So downgrade to 2.95.x (downgrade libstdc++ too, other programs may
@@ -483,9 +483,9 @@
architecture, you will possibly need them. Download and unzip w32codecs.zip
to /usr/lib/win32 <B>BEFORE</B> compiling <B>MPlayer</B>, otherwise no Win32
support will be compiled!<BR>
- <B>Note</B>: the avifile project has similar codecs package, but it differs
- from ours, so if you want to use all supported codecs, then use our package!
- However, you can use our codecs package with avifile. Features:<BR>
+ <B>Note</B>: the avifile project has a similar codecs package, but it differs
+ from ours. If you want to use all supported codecs, then install our package
+ (do not worry, avifile works with it without problems). Features:<BR>
<UL>
<LI>you need this if you want to play or encode for example movies recorded
with various hardware compressors, like tuner cards, digital cameras
@@ -532,7 +532,7 @@
<LI><B>MPlayer</B> can use the libraries of RealPlayer 8 or RealONE to play
files with <B>RealVideo 2.0 and 3.0</B> video, and Sipro/Cook audio. See
<A HREF="formats.html#real">RealMedia file format</A> section for
- installation instructions and more information!</LI>
+ installation instructions and more information.</LI>
</UL>
<P><B>VIDEO CARDS</B></P>
@@ -543,8 +543,8 @@
<P><B>YUV cards</B></P>
<P>They can display and scale (zoom) the picture to any size that fits in
- their memory, with <B>small CPU usage</B> (zooming doesn't increase it!), thus
- you get a nice and very fast fullscreen playing.</P>
+ their memory, with <B>small CPU usage</B> (even when zooming), thus
+ fullscreen playing is nice and very fast.</P>
<UL>
<LI><B>Matrox G200/G400/G450/G550 cards</B>: although a
@@ -554,15 +554,15 @@
installation and usage. It is important to do these steps <I>before</I>
compiling <B>MPlayer</B>, otherwise no mga_vid support will be built. Also
check out the <A HREF="video.html#tv-out_matrox">Matrox TV-out</A> section.
- <U><B>If you are non-Linux user</B></U>, your only possibility is the Vidix
- driver: read <A HREF="video.html#vidix">VIDIX</A> documentation!</LI>
+ <U><B>If you don't use Linux</B></U>, your only possibility is the Vidix
+ driver: read the <A HREF="video.html#vidix">VIDIX</A> section.</LI>
<LI><B>3Dfx Voodoo3/Banshee cards</B>: please see the
<A HREF="video.html#tdfxfb">tdfxfb</A> section in order to gain big
speedup. It is important to do these steps <I>before</I> compiling
<B>MPlayer</B>, otherwise no 3Dfx support will be built. Also see the <A
HREF="video.html#tv-out_voodoo">3dfx TV-out section</A>. If you use X, use at
least 4.2.0, as 3dfx Xv driver was broken in 4.1.0, and earlier
- releases!</LI>
+ releases.</LI>
<LI><B>ATI cards</B>: <A HREF="video.html#vidix">Vidix driver</A> is
provided for the following cards:
<B>Radeon</B>, <B>Rage128</B>, <B>Mach64</B> (Rage XL/Mobility, Xpert98).
@@ -574,45 +574,45 @@
have problems with YV12 display, see <A HREF="video.html#xv_s3">S3 Xv
section</A> for details. Older, Trio cards have no, or slow hardware
support.</LI>
- <LI><B>nVidia cards</B>: very bad choice for video playing (nVidia has
- <A HREF="users_against_developers.html#nvidia">different opinion</A>!).
- nVidia's cards have very cheap and bad quality chips. Moreover, <U>the
- built-in nVidia driver in XFree86 doesn't contain support for hardware YUV
- acceleration for all nVidia cards!</U> You have to download nVidia's
- closed-source drivers from nVidia.com. See details in <A
- HREF="video.html#xv_nvidia">nVidia Xv driver</A> section.</LI>
+ <LI><B>nVidia cards</B>: very bad choice for video playing (nVidia
+ <A HREF="users_against_developers.html#nvidia">does not think so</A>).
+ nVidia's cards have very cheap and bad quality chips. Moreover, <B>the
+ built-in nVidia driver in XFree86 does not support hardware YUV
+ acceleration on all nVidia cards.</B> You have to download nVidia's
+ closed-source drivers from nVidia.com. See the <A
+ HREF="video.html#xv_nvidia">nVidia Xv driver</A> section for details.</LI>
<LI><B>3DLabs GLINT R3 and Permedia3</B>: a VIDIX driver is provided
- (pm3_vid). Please see the <A HREF="video.html#vidix">VIDIX
- instructions</A>.</LI>
- <LI><B>other cards</B>: none of the above?
+ (pm3_vid). Please see the <A HREF="video.html#vidix">VIDIX</A> section for
+ details.</LI>
+ <LI><B>Other cards</B>: None of the above?
<UL>
<LI>Try if the XFree86 driver (and your card) supports hardware
acceleration. See the <A HREF="video.html#xv">Xv section</A> for
details.</LI>
<LI>If it doesn't, then your card's video features aren't supported under
- your OS :(<BR>
- If it does hardware scaling under Windows, it doesn't mean it will do the
- same under Linux or other OS, it depends on the drivers! Most
- manufacturers don't make Linux drivers nor release chip specs - so you're
- unlucky using their cards. See the next section:</LI>
+ your operating system. :(<BR>
+ If hardware scaling works under Windows, it doesn't mean it will work
+ under Linux or other operating systems: it depends on the drivers. Most
+ manufacturers neither make Linux drivers nor release specifications
+ for their chips, so you are unlucky using their cards.
+ See 'Non-YUV cards'.</LI>
</UL>
</LI>
</UL>
<P><B>Non-YUV cards</B></P>
-<P>Fullscreen playing can be achieved by either zooming <B>by software</B> (use
- the option <CODE>-zoom</CODE> or <A HREF="#2.6.11"><CODE>-vop
- scale</CODE></A>, but I warn you: this is SLOW!), or changing to a smaller
- video mode, for example to 352x288. If you don't have YUV acceleration, this
- latter method is the recommended one. Throughout <B>MPlayer</B>, <U>this
- behavior can be switched on by using the <CODE>-vm</CODE> option</U> and with
- the following drivers:</P>
+<P>Fullscreen playing can be achieved by either enabling <B>software scaling</B>
+ (use the <CODE>-zoom</CODE> or <A HREF="#2.6.11"><CODE>-vop scale</CODE></A>
+ option, but I warn you: this is slow), or switching to a small resolution
+ video mode, for example 352x288. If you don't have YUV acceleration, the
+ latter method is recommended. Video mode switching can be enabled by
+ using the <CODE>-vm</CODE> option and it works with the following drivers:</P>
<UL>
- <LI><B>using</B> XFree86: see details in
+ <LI><B>using</B> XFree86: see the
<A HREF="video.html#dga">DGA driver</A> and
- <A HREF="video.html#x11">X11 driver</A> sections. DGA is
+ <A HREF="video.html#x11">X11 driver</A> sections for details. DGA is
recommended! Also try DGA via SDL, sometimes it's better.</LI>
<LI><B>not using</B> XFree86: try the drivers in the following order:
<A HREF="video.html#vesa">vesa</A>,
@@ -655,11 +655,11 @@
<LI><B>Soundblaster Live!</B>: with this card you can use 4 or 6 (<B>5.1</B>)
channels AC3 decoding instead of 2. Read the
<A HREF="codecs.html#software_ac3">Software AC3 decoding</A> section.
- For hardware AC3 passthrough you MUST use ALSA 0.9 oss emulation!</LI>
+ For hardware AC3 passthrough you <B>must</B> use ALSA 0.9 with OSS emulation!</LI>
<LI><B>C-Media with SP/DIF out</B>: hardware AC3 passthrough is possible
with these cards, see
<A HREF="codecs.html#hardware_ac3">Hardware AC3 decoding</A> section.</LI>
- <LI><B>other cards'</B> features aren't supported by <B>MPlayer</B>.
+ <LI>Features of <B>other cards</B> aren't supported by <B>MPlayer</B>.
<U>It's very recommended to read the <A HREF="sound.html">sound card
section</A>!</U></LI>
</UL>
@@ -687,16 +687,16 @@
<P>At this point, <B>MPlayer</B> is ready to use. The directory
<CODE>$PREFIX/share/mplayer</CODE> contains the <CODE>codecs.conf</CODE>
file, which is used to tell the program all the codecs and their
- capabilities. This file should always be kept uptodate together with the
- main binary!<BR> Check if you have codecs.conf in your home directory
- (~/.mplayer/codecs.conf) left from old MPlayer versions, and remove it!</P>
+ capabilities. This file should always be kept up to date together with the
+ main binary.<BR> Check if you have <CODE>codecs.conf</CODE> in your home directory
+ (<CODE>~/.mplayer/codecs.conf</CODE>) left from old MPlayer versions, and remove it.</P>
-<P><B>Debian users</B> can build a .deb package for themselves, it's very
+<P><B>Debian users</B> can build a <CODE>.deb</CODE> package for themselves, it's very
simple. Just exec <CODE>fakeroot debian/rules binary</CODE> in
- <B>MPlayer</B>'s root dir. Detailed instructions can be found
+ <B>MPlayer</B>'s root directory. Detailed instructions can be found
<A HREF="documentation.html#debian">here</A>.</P>
-<P><B>ALWAYS browse the output of <CODE>./configure</CODE></B>, and the
+<P><B>Always browse the output of <CODE>./configure</CODE></B>, and the
<CODE>configure.log</CODE> file, they contain information about what will be
built, and what will not. You may also want to view <CODE>config.h</CODE> and
<CODE>config.mak</CODE> files.<BR>
@@ -731,8 +731,8 @@
and call <CODE>gmplayer</CODE> instead.</LI>
</UL>
-<P>HINT: use the middle button (on 2 button mice press left and right
- simultaneously) for a popup GTK menu, with DVD playing option!</P>
+<P>HINT: Press the middle button (on 2 button mice press left and right
+ simultaneously) to open a GTK menu with DVD playing option!</P>
<P>As <B>MPlayer</B> doesn't have a skin included, you have to download them if
you want to use the GUI. See the
@@ -1556,7 +1556,7 @@
<P><B><A NAME="lirc">3.2.3 Control from LIRC</A></B></P>
<P>Linux Infrared Remote Control - use an easy to build home-brewn IR-receiver,
- an (almost) arbitrary remote control and control your linux box with it!
+ an (almost) arbitrary remote control and control your Linux box with it!
More about it at <A HREF="http://www.lirc.org">www.lirc.org</A>.</P>
<P>If you have installed the lirc-package, configure will autodetect it. If
@@ -1758,19 +1758,19 @@
<P>For DVD support you must have the patched libcss installed. Patch:
<A HREF="http://www.tools.de/solaris/mplayer/">http://www.tools.de/solaris/mplayer/</A>.</P>
-<P>Due to two bugs in Solaris 8 x86, you cannot reliably play DVDs using a
- capacity >4GB:</P>
+<P>Due to two bugs in Solaris 8 x86, you cannot reliably play DVD discs larger
+ than 4 GB:</P>
<UL>
<LI>The sd(7D) driver on Solaris 8 x86 driver has bug when accessing a disk
- block >4GB on a device using a logical blocksize != DEV_BSIZE (i.e. CD-ROM
- and DVD media). Due to a 32bit int overflow, a disk address modulo 4GB is
+ block >4 GB on a device using a logical blocksize != DEV_BSIZE (i.e. CD-ROM
+ and DVD media). Due to a 32-bit int overflow, a disk address modulo 4 GB is
accessed.
(<A HREF="http://groups.yahoo.com/group/solarisonintel/message/22516">http://groups.yahoo.com/group/solarisonintel/message/22516</A>)
</LI>
- <LI>The similar bug is present in the hsfs(7FS) filesystem code (aka
- ISO9660), hsfs currently does not support partitions/disks >4GB, all data
- is accessed modulo 4GB
+ <LI>A similar bug is present in the hsfs(7FS) filesystem code (aka
+ ISO9660), hsfs currently does not support partitions/disks larger than 4 GB, all data
+ is accessed modulo 4 GB.
(<A HREF="http://groups.yahoo.com/group/solarisonintel/message/22592">http://groups.yahoo.com/group/solarisonintel/message/22592</A>)
</LI>
</UL>
@@ -1843,7 +1843,7 @@
<P><B><A NAME="authors">Appendix A - Authors</A></B></P>
-<P>NOTE: Do *NOT* send bug reports, help & feature requests directly to the authors!</P>
+<P>NOTE: Do <B>not</B> send bug reports, help & feature requests directly to the authors!</P>
<P>Read <A HREF="bugreports.html">Appendix C</A> and subscribe to mplayer-users mailing lists.</P>
@@ -2503,8 +2503,8 @@
reads this list!</LI>
</UL>
-<P><B>Note:</B> The Languages of above lists are ENGLISH, unless explicitly
- stated otherwise. Please do not send messages using another language!</P>
+<P><B>Note:</B> The language of the above lists is English, unless explicitly
+ stated otherwise. Please do not send messages in other languages!</P>
<P><B>Note:</B> You can reach the searchable mailing list archives
<A HREF="http://www.mplayerhq.hu/cgi-bin/htsearch">here</A>.
diff -Naur DOCS.old/encoding.html DOCS/encoding.html
--- DOCS.old/encoding.html Wed Aug 14 09:34:56 2002
+++ DOCS/encoding.html Wed Aug 14 10:42:58 2002
@@ -211,8 +211,8 @@
<UL>
<LI><B>Video stream</B> (option <CODE>-ovc copy</CODE>): nice stuff can be
done :)<BR>
- Like, putting (not converting!) FLI or VIVO or MPEG1 video into
- an AVI file! Of course only <B>MPlayer</B> can play such files :) And it
+ Like, putting (not converting) FLI or VIVO or MPEG1 video into
+ an AVI file. Of course only <B>MPlayer</B> can play such files :) And it
probably has no real life value at all. Rationally: video stream copying
can be useful for example when only the audio stream has to be encoded
(like, uncompressed PCM to MP3).</LI>
@@ -350,10 +350,10 @@
<P><B><A NAME="options">2.4.5 Available options</A></B></P>
-<P>NOTE: for all available options, <B>read the man page!</B></P>
+<P>NOTE: for all available options, <B>read the man page.</B></P>
<P>As <B>MEncoder</B> is built on the same codebase as <B>MPlayer</B>, there
- are many <B>MPlayer</B> options that have function in <B>MEncoder</B> too!
+ are many <B>MPlayer</B> options that have function in <B>MEncoder</B> too.
See, you can use <CODE>-sid</CODE> to rip a DVD with subtitles, or
<CODE>-noidx</CODE> to disregard buggy index of input AVI. <B>Be smart!</B></P>
@@ -365,7 +365,7 @@
</TR>
<TR>
<TD><CODE>-endpos</CODE> time</TD>
- <TD>stop encoding at the given time. See the man page for examples!
+ <TD>stop encoding at the given time. See the man page for examples.
</TD>
</TR>
<TR>
@@ -417,7 +417,7 @@
<TD><CODE>-divx4opts</CODE></TD>
<TD>If encoding to DivX4, you can specify its parameters here, like:<BR>
<CODE>-divx4opts br=1800:deinterlace:key=250</CODE><BR>
- Common options: <B>(for full list, check the man page!)</B><BR>
+ Common options: <B>(for full list, check the man page)</B><BR>
<B>help</B> - get help<BR>
<B>br</B>=<value> - specify bitrate in kbit <4-16000>
or bit <16001-24000000><BR>
@@ -429,7 +429,7 @@
<TD><CODE>-lavcopts</CODE></TD>
<TD>If encoding with libavcodec, you can specify its parameters here, like:<BR>
<CODE>-lavcopts vcodec=msmpeg4:vbitrate=1800:vhq:keyint=250</CODE><BR>
- Common options: <B>(for full list, check the man page!)</B><BR>
+ Common options: <B>(for full list, check the man page)</B><BR>
<B>help</B> - get help<BR>
<B>vcodec</B>=<value> - select videocodec (for the full list, see the libavcodec section above)<BR>
<B>vbitrate</B>=<value> - specify bitrate in kbit <4-16000> or bit <16001-24000000><BR>
@@ -442,7 +442,7 @@
<TD>If encoding to MP3 with libmp3lame, you can specify its parameters here, like:<BR>
<CODE>-lameopts q=3</CODE><BR>
<CODE>-lameopts br=192:cbr</CODE><BR>
- Common options: <B>(for full list, check the man page!)</B><BR>
+ Common options: <B>(for full list, check the man page)</B><BR>
<B>help</B> - get help<BR>
<B>cbr</B> - select <B>CBR</B> MP3 (default is <B>VBR</B>)<BR>
<B>br</B>=<value> - specify bitrate in kbit <0-1024> (this is for <B>CBR</B> only!)<BR>
@@ -488,10 +488,10 @@
<P>Encoding multiple *.vob files:<BR>
<CODE> cat *.vob | mencoder <options> -</CODE></P>
-<P>Encoding from tuner (for tuner options <A HREF="documentation.html#tv">see the TV input section!</A>):<BR>
+<P>Encoding from tuner (see the <A HREF="documentation.html#tv">TV input</A> section for tuner options):<BR>
<CODE> mencoder -tv on:driver=v4l:width=640:height=480 <options></CODE></P>
-<P>For all available options, <B>check the MEncoder man page!</B></P>
+<P>For all available options, <B>check the MEncoder man page.</B></P>
</BODY>
</HTML>
diff -Naur DOCS.old/faq.html DOCS/faq.html
--- DOCS.old/faq.html Wed Aug 14 09:34:58 2002
+++ DOCS/faq.html Wed Aug 14 11:51:01 2002
@@ -58,7 +58,7 @@
<DD> </DD>
<DT>Q: What's the problem with gcc 2.96?</DT>
- <DD>A: <B>We strongly discourage the use of gcc 2.96!!!</B><BR>
+ <DD>A: <B>We strongly discourage the use of gcc 2.96!</B><BR>
Read <A HREF="users_against_developers.html#gcc">this</A> document for
details about why Red Hat released gcc 2.96 and what the problems are all
about. If you still really really want to use it, be sure to get the latest
@@ -68,7 +68,7 @@
<B>not</B> provide any support in case you run into problems.</DD>
<DD> </DD>
- <DT>Q: Great, I have gcc 3.0.1 from Red Hat/Mandrake, then I'm fine--!</DT>
+ <DT>Q: Great, I have gcc 3.0.1 from Red Hat/Mandrake, then I'm fine!</DT>
<DD>A: No, since there have been/are issues with these compilers as well.
To check the status of current compilers' MPlayer support, see the
<A HREF="documentation.html#installation">Installation</A> section.</DD>
@@ -93,7 +93,7 @@
<DD>A: Upgrade your glibc to the latest release. On Mandrake, use 2.2.4-8mdk.</DD>
<DD> </DD>
- <DT>Q: ... gcc 2.96 ... (Yes, some people are STILL flaming about gcc 2.96!!)</DT>
+ <DT>Q: ... gcc 2.96 ... (Yes, some people are STILL flaming about gcc 2.96!)</DT>
<DD>A: Quoted from a
<A HREF="http://www.mplayerhq.hu/pipermail/mplayer-users/2001-October/005351.html">mail</A>
A'rpi sent to the
@@ -201,7 +201,7 @@
Upgrade your kernel, modutils and <B>MPlayer</B>.</DD>
<DD> </DD>
- <DT>Q: When compiling <B>MEncoder</B>, it segfaults at linking!!!</DT>
+ <DT>Q: When compiling <B>MEncoder</B>, it segfaults at linking!</DT>
<DD>A: This is a linker problem. Upgrading binutils should help (2.11.92.*
or newer should be good). Since it is not our fault, please do <B>not</B>
report!</DD>
@@ -280,12 +280,12 @@
<DD> </DD>
<DT>Q: Are there any mailing lists on MPlayer?</DT>
- <DD>A: Yes! See the bottom of the info page on
+ <DD>A: Yes. See the bottom of the info page on
<A HREF="http://www.mplayerhq.hu/homepage/info.html">our homepage</A> to
- subscribe!</DD>
+ subscribe.</DD>
<DD> </DD>
- <DT>Q: I've found a nasty bug when I tried to play my favorite video!!
+ <DT>Q: I've found a nasty bug when I tried to play my favorite video!
Who should I inform?</DT>
<DD>A: Please read the <A HREF="bugreports.html">bug reporting guidelines</A>
and follow the instructions.</DD>
@@ -319,8 +319,8 @@
<DD> </DD>
<DT>Q: Subtitles are very nice, the most beautiful I've ever seen, but they
- slow down playing! I know it's unlikely ...</DT>
- <DD>A: After running <CODE>./configure</CODE> , edit <CODE>config.h</CODE> and
+ slow down playing! I know it's unlikely...</DT>
+ <DD>A: After running <CODE>./configure</CODE>, edit <CODE>config.h</CODE> and
replace <CODE>#undef FAST_OSD</CODE> with <CODE>#define FAST_OSD</CODE>.
Then recompile.</DD>
<DD> </DD>
@@ -376,7 +376,7 @@
<DD> </DD>
<DT>Q: ... works with avifile/aviplay but doesn't with MPlayer.</DT>
- <DD>A: <B>MPlayer</B> != avifile.
+ <DD>A: <B>MPlayer</B> is not avifile.
The only common thing between these players is the Win32 DLL loader.
The codecs (DLL) set, synchronization, demultiplexing etc is totally
different and shouldn't be compared.
@@ -534,7 +534,7 @@
<B>MPlayer</B> use arts.</DD>
<DD> </DD>
- <DT>Q: What about the DGA driver? I can't find it!!!</DT>
+ <DT>Q: What about the DGA driver? I can't find it!</DT>
<DD>A: <CODE>./configure</CODE> autodetects your DGA driver. If
<CODE>-vo help</CODE> doesn't show DGA, then there's a problem with your X
installation. Try <CODE>./configure --enable-dga</CODE> and read the
@@ -543,7 +543,7 @@
<DD> </DD>
<DT>Q: OK, <CODE>-vo help</CODE> shows DGA driver, but it complains about
- permissions! Help me!</DT>
+ permissions. Help me!</DT>
<DD>A: It works only if running as root! It's a DGA limitation.
You should become root (<CODE>su -</CODE>), and try again.
Another solution is making <B>MPlayer</B> SUID root, but it's
@@ -634,7 +634,7 @@
<DD> </DD>
<DT>Q: What about subtitles? Can MPlayer display them?</DT>
- <DD>A: Yes! See the <A HREF="cd-dvd.html#dvd">DVD chapter</A> of the
+ <DD>A: Yes. See the <A HREF="cd-dvd.html#dvd">DVD chapter</A> of the
documentation.</DD>
<DD> </DD>
diff -Naur DOCS.old/sound.html DOCS/sound.html
--- DOCS.old/sound.html Wed Aug 14 09:35:01 2002
+++ DOCS/sound.html Wed Aug 14 10:49:43 2002
@@ -127,7 +127,7 @@
<LI>Sharing your sound card with another application like XMMS is <B>strongly
discouraged</B>! If the other sound application is using ESD, start
<B>MPlayer</B> with the <CODE>-vo sdl:esd</CODE> option to combine both
- sound streams! In fact, the option <CODE>-vo sdl:esd</CODE> could be used
+ sound streams. In fact, the option <CODE>-vo sdl:esd</CODE> could be used
with ESD even when playing <B>Mplayer</B> alone.</LI>
<LI>Feedback to this document is welcome. Please tell us how <B>MPlayer</B>
and your sound card(s) worked together.</LI>
diff -Naur DOCS.old/video.html DOCS/video.html
--- DOCS.old/video.html Wed Aug 14 09:35:07 2002
+++ DOCS/video.html Wed Aug 14 11:01:12 2002
@@ -91,7 +91,7 @@
<P>in /var/log/XFree86.0.log</P>
<P>NOTE: this loads only the XFree86's extension. In a good install, this
- is always loaded, and doesn't mean that the _card's_ XVideo support is
+ is always loaded, and doesn't mean that the <EM>card's</EM> XVideo support is
loaded!</P>
</LI>
<LI>Your card has Xv support under Linux. To check, try 'xvinfo', it is the
@@ -135,12 +135,12 @@
<P>Older 3dfx drivers were known to have problems with XVideo acceleration, it
didn't support either YUY2 or YV12, and so. Verify that you have XFree86
version 4.2.0 or greater, it works OK with YV12 and YUY2. Previous versions,
- including 4.1.0 <B>crashes with YV12</B>! If you experience strange effects
+ including 4.1.0, <B>crash with YV12</B>. If you experience strange effects
using -vo xv, try SDL (it has XVideo too) and see if it helps. Check the
<A HREF="#sdl">SDL section</A> for details.</P>
<P><B>OR</B>, try the NEW -vo tdfxfb driver! See the
- <A HREF="#tdfxfb">tdfxfb</A> section!</P>
+ <A HREF="#tdfxfb">tdfxfb</A> section.</P>
<P><B><A NAME="xv_s3">2.3.1.2.2 S3 cards</A></B></P>
@@ -262,7 +262,7 @@
<P>If the driver couldn't switch to a smaller resolution, experiment with
switches -vm (only with X 3.3.x), -fs, -bpp, -zoom to find a video mode that
- the movie fits in. There is no converter right now.. :(</P>
+ the movie fits in. There is no converter right now. :(</P>
<P>Become ROOT. DGA needs root access to be able to write directly video
memory. If you want to run it as user, then install <B>MPlayer</B> SUID
@@ -281,9 +281,9 @@
root privileges through SUID root <B>MPlayer</B>.<BR>
<B>!!!! SO YOU HAVE BEEN WARNED ... !!!!</B></P>
-<P>Now use '-vo dga' option, and there you go! (hope so:)
- You should also try if the '-vo sdl:dga' option works for you! It's much
- faster!!!</P>
+<P>Now use the <CODE>-vo dga</CODE> option, and there you go (hope so :))!
+ You should also try if the <CODE>-vo sdl:dga</CODE> option works for you. It's much
+ faster.</P>
<P><B><A NAME="dga_resolution">2.3.1.3.4 Resolution switching</A></B></P>
@@ -523,7 +523,7 @@
<P>Whether to build the FBdev target is autodetected during ./configure .
Read the framebuffer documentation in the kernel sources
- (Documentation/fb/*) for info on how to enable it, etc..!</P>
+ (Documentation/fb/*) for more information.</P>
<P>If your card doesn't support VBE 2.0 standard (older ISA/PCI
cards, such as S3 Trio64), only VBE 1.2 (or older?):
@@ -574,7 +574,7 @@
framebuffer console and under X.</P>
<P><B>WARNING</B>: on non-Linux systems, use <A HREF="#vidix">VIDIX</A> for
- mga_vid !!!</P>
+ mga_vid!</P>
<P>To use it, you first have to compile mga_vid.o:</P>
@@ -694,8 +694,8 @@
render all frames!</P>
<P>Playing on terminal you'll get better speed and quality using the Linux
- driver, not curses (-aadriver linux). But therefore you need write access on
- /dev/vcsa<terminal>! That isn't autodetected by aalib, but vo_aa tries
+ driver, not curses (<CODE>-aadriver linux</CODE>). But therefore you need write access on
+ <CODE>/dev/vcsa<terminal></CODE>. That isn't autodetected by aalib, but vo_aa tries
to find the best mode. See
<A HREF="http://aa-project.sourceforge.net/tune/">http://aa-project.sourceforge.net/tune/</A>
for further tuning issues.</P>
@@ -728,8 +728,8 @@
(I guess that TV-out frequently is standalone head or standalone output
at least.)</P>
-<P><B>What are pluses:</B><BR>
- - You have chances to watch movies <B>if Linux even doesn't know</B> your
+<P><B>Advantages:</B><BR>
+ - You have chances to watch movies <B>even if Linux doesn't know</B> your
video hardware.<BR>
- You don't need to have installed any graphics' related things on your Linux
(like X11 (aka XFree86), fbdev and so on). This driver can be run from
@@ -742,9 +742,9 @@
- You can use Vidix with it, thus getting accelerated video display
<B>AND</B> TV output at the same time! (recommended for ATI cards)</P>
-<P><B>What are minuses:</B><BR>
+<P><B>Disadvantages:</B><BR>
- It works only on <B>x86 systems</B>.<BR>
- - It can be used only by <B>ROOT</B>.<BR>
+ - It can be used only by <B>root</B>.<BR>
- Currently it's available only for <B>Linux</B>.</P>
<P>Don't use this driver with <B>GCC 2.96</B>! It won't work!</P>
@@ -1151,7 +1151,7 @@
<P>Under Linux you have 2 methods to get G400 TV out working:</P>
-<P><B>IMPORTANT:</B> Only Matrox G400DH/G400MAX has TV-out support under Linux, others (G450, G550) has <B>NOT!</B></P>
+<P><B>IMPORTANT:</B> Only Matrox G400DH/G400MAX has TV-out support under Linux, others (G450, G550) has <B>not!</B></P>
<UL>
<LI><B>XFree86</B>: using the driver and the HAL module, available from
@@ -1187,7 +1187,7 @@
to a very simple menu. Press <B>2</B> and <B>ENTER</B>. Now you should
have the same picture on your monitor, and TV. The <B>3.</B> option
will turn on independent display, but then you <B>can't use X</B>! If
- the TV (PAL!) picture has some weird stripes on it, the script wasn't able to
+ the TV (PAL) picture has some weird stripes on it, the script wasn't able to
set the resolution correctly (to 640x512 by default). Use other menu
items randomly and it'll be OK :)</LI>
</UL>
@@ -1205,7 +1205,7 @@
<P>Yeah kewl. Start movie playing with <CODE>mplayer -vo mga -fs -screenw 640
-screenh 512 <filename></CODE><BR>
(if you use X, now change to matroxfb with for example CTRL-ALT-F1!)<BR>
- Change 640x512 if you set the resolution to other..<BR>
+ Change 640x512 if you set the resolution to other.<BR>
<B>Enjoy the ultra-fast ultra-featured Matrox TV output (better than Xv)!</B></P>
</LI>
</UL>
More information about the MPlayer-dev-eng
mailing list