changeset 7015:72059027f953

Applied patch by Andras Mohari <mayday at varoshaza nagyatad hu> in a slightly modified form. This puts some warnings into blockquote tags, adds a few links, removes some UPPERCASE words and fixes a few wording and spelling errors.
author diego
date Thu, 15 Aug 2002 12:42:52 +0000
parents f5c4083616fd
children 44ce5a673be2
files DOCS/documentation.html DOCS/faq.html DOCS/video.html
diffstat 3 files changed, 54 insertions(+), 36 deletions(-) [+]
line wrap: on
line diff
--- a/DOCS/documentation.html	Thu Aug 15 11:09:35 2002 +0000
+++ b/DOCS/documentation.html	Thu Aug 15 12:42:52 2002 +0000
@@ -307,16 +307,20 @@
 
 <P>If you are a first-time installer: be sure to read everything from here to
   the end of the Installation section, and follow the links you will find. If
-  you have any other questions, return to the TOC (Table of Contents) and
-  search for the topic, read the FAQ, or try grepping though the files.</P>
+  you have any other questions, return to the Table of Contents and
+  search for the topic, read the <A HREF="faq.html">FAQ</A>, or try grepping
+  through the files.</P>
 
 <P>The main rule of this documentation: if it's not documented, it
   <U>does not exist</U>. If I don't say you encode audio from TV tuner, you
   can't. A healthy quantity of combining ability is welcomed, though.
   Good luck. You'll need it :) And for another good advice, let me quote
-  Chris Phillips from the <B>mplayer-users</B> mailing list:</P>
-
-<P><I>"I said a while ago that there is such a difference between a newbie and
+  Chris Phillips from the
+  <A HREF="http://mplayerhq.hu/pipermail/mplayer-users/">mplayer-users</A>
+  mailing list:</P>
+
+<BLOCKQUOTE>
+  I said a while ago that there is such a difference between a newbie and
   a dumbass. No matter what you actually know about a system (linux, cars,
   girls :D) you should ALWAYS be able to take a step back and be objective,
   otherwise, you're just dumb IMHO. A girl i live with assumed the vacuum
@@ -325,7 +329,8 @@
   case of simply not knowing what to do... Simply not being that familiar with
   your surroundings is no excuse for a) laziness and b) ignorance. So many
   people seem to see the word "error" and then stop...  few seem to actually
-  read the words on the OTHER side of the colon."</I></P>
+  read the words on the OTHER side of the colon.
+</BLOCKQUOTE>
 
 
 
@@ -558,10 +563,10 @@
     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
+    speedup. It is important to do these steps <B>before</B> 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
+    HREF="video.html#tv-out_voodoo">3dfx TV-out section</A>. If you use X, use
+    <B>at least 4.2.0</B>, as the 3dfx Xv driver was broken in 4.1.0 and earlier
     releases.</LI>
   <LI><B>ATI cards</B>: <A HREF="video.html#vidix">Vidix driver</A> is
     provided for the following cards:
@@ -732,8 +737,11 @@
     and call <CODE>gmplayer</CODE> instead.</LI>
   </UL>
 
-<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>
+<BLOCKQUOTE>
+  <B>Hint</B><BR>
+  Press the middle button (on 2 button mice press left and right
+  simultaneously) to open a GTK menu with a DVD playing option.
+</BLOCKQUOTE>
 
 <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
@@ -1844,8 +1852,11 @@
 
 <P><B><A NAME="authors">Appendix A - Authors</A></B></P>
 
-<P>NOTE: Do <B>not</B> send bug reports, help &amp; feature requests directly to
-  the authors!</P>
+<BLOCKQUOTE>
+  <B>Important</B><BR>
+  Do <B>not</B> send bug reports, help &amp; feature requests directly to
+  the authors!
+</BLOCKQUOTE>
 
 <P>Read <A HREF="bugreports.html">Appendix C</A> and subscribe to mplayer-users mailing lists.</P>
 
--- a/DOCS/faq.html	Thu Aug 15 11:09:35 2002 +0000
+++ b/DOCS/faq.html	Thu Aug 15 12:42:52 2002 +0000
@@ -227,13 +227,13 @@
 
   <DT>Q: The <CODE>-xy</CODE> or <CODE>-fs</CODE> option doesn't work with the
     x11 driver (<CODE>-vo x11</CODE>) ...</DT>
-  <DD>A: It does, but you have to explicitly specify software scaling (it's
-    SLOW!) with the <CODE>-zoom</CODE> option. You better use XF86VidMode
+  <DD>A: It does, but you have to explicitly specify software scaling (very
+    slow) with the <CODE>-zoom</CODE> option. You better use XF86VidMode
     support: You must specify the <CODE>-vm</CODE> and the <CODE>-fs</CODE>
     switch, and you're done. Make sure you have the right modelines in your
     XF86Config file, and try to make the <A HREF="video.html#dga">DGA driver</A>
     and <A HREF="video.html#sdl">SDL's DGA driver</A> work for you.
-    It's much faster. If SDL's DGA works, use that, it'll be EVEN faster!</DD>
+    It's much faster. If SDL's DGA works, use that, it'll be even faster.</DD>
   <DD>&nbsp;</DD>
 
   <DT>Q: What is the meaning of the numbers on the status line?</DT>
@@ -453,8 +453,8 @@
     <CODE>DEMUXER: Too many (945 in 8390980 bytes) video packets in the buffer!</CODE></DT>
   <DD>A: This can have multiple reasons.
     <UL>
-      <LI>Your CPU <B>and/or</B> video card <B>and/or</B> bus is too SLOW.
-        <B>MPlayer</B>displays a message if this is the case (and the dropped
+      <LI>Your CPU <B>and/or</B> video card <B>and/or</B> bus is too slow.
+        <B>MPlayer</B> displays a message if this is the case (and the dropped
         frames counter goes up fast).</LI>
       <LI>If it is an AVI, maybe it has bad interleaving. Try the
         <CODE>-ni</CODE> option.</LI>
@@ -547,15 +547,18 @@
   <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
-    <B>NOT RECOMMENDED!</B><BR>
+    <B>not recommended!</B><BR>
     &nbsp;&nbsp;&nbsp;&nbsp;<CODE>chown root /usr/local/bin/mplayer</CODE><BR>
     &nbsp;&nbsp;&nbsp;&nbsp;<CODE>chmod 755 /usr/local/bin/mplayer</CODE><BR>
     &nbsp;&nbsp;&nbsp;&nbsp;<CODE>chmod +s /usr/local/bin/mplayer</CODE><BR>
-    <B>!!!! BUT STAY TUNED !!!!</B><BR>
-    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!!!<BR>
-    <B>!!!! SO YOU HAVE BEEN WARNED ... !!!!</B></DD>
+    <BLOCKQUOTE>
+      <B>Warning: security risk</B><BR>
+      This is a <B>big</B> security risk! <B>Never</B> 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 <B>MPlayer</B>. <B>You have been
+      warned.</B>
+    </BLOCKQUOTE>
+  </DD>
   <DD>&nbsp;</DD>
 
   <DT>Q: When using Xvideo, my Voodoo 3/Banshee says:<BR>
--- a/DOCS/video.html	Thu Aug 15 11:09:35 2002 +0000
+++ b/DOCS/video.html	Thu Aug 15 12:42:52 2002 +0000
@@ -230,8 +230,8 @@
   Technically spoken this happens by mapping the framebuffer memory into
   the memory range of your process. This is allowed by the kernel only
   if you have superuser privileges. You can get these either by logging in
-  as root or by setting the SUID bit on the <B>MPlayer</B> executable (NOT
-  recommended!).</P>
+  as root or by setting the SUID bit on the <B>MPlayer</B> executable (<B>not
+  recommended</B>).</P>
 
 <P>There are two versions of DGA: DGA1 is used by XFree 3.x.x and DGA2 was
   introduced with XFree 4.0.1.</P>
@@ -264,7 +264,7 @@
   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>
 
-<P>Become ROOT. DGA needs root access to be able to write directly video
+<P>Become root. DGA needs root access to be able to write directly to video
   memory. If you want to run it as user, then install <B>MPlayer</B> SUID
   root:</P>
 
@@ -275,11 +275,12 @@
 
 <P>Now it works as a simple user, too.</P>
 
-<P><B>!!!! BUT STAY TUNED !!!!</B><BR>
-  This is a <B>BIG</B> security risk! Never do this on a server or on a
-  computer can be accessed by more people than only you because they can gain
-  root privileges through SUID root <B>MPlayer</B>.<BR>
-  <B>!!!! SO YOU HAVE BEEN WARNED ... !!!!</B></P>
+<BLOCKQUOTE>
+  <B>Warning: security risk</B><BR>
+  This is a <B>big</B> security risk! <B>Never</B> do this on a server or on
+  a computer that can be accessed by other people because they can gain root
+  privileges through SUID root <B>MPlayer</B>.
+</BLOCKQUOTE>
 
 <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
@@ -850,7 +851,7 @@
     requires X server and can work only under X server.</LI>
   <LI>You can use VIDIX subdevice which was applied to several video output
     drivers, such as:<BR>
-    <CODE>-vo vesa:vidix</CODE> (<B>LINUX ONLY</B>) and <CODE>-vo fbdev:vidix</CODE></LI>
+    <CODE>-vo vesa:vidix</CODE> (<B>Linux only</B>) and <CODE>-vo fbdev:vidix</CODE></LI>
 </UL>
 
 Indeed it doesn't matter which video output driver is used with <B>VIDIX</B>.
@@ -902,9 +903,12 @@
   it (mainly libdha). But there is hope that it will work on those systems
   where X11 does.</P>
 
-<P>And the last <B>WARNING</B>: (un)fortunately you <B>MUST</B> have
-  <B>ROOT</B> privileges to use VIDIX due to direct hardware access. At least
-  set the <B>SUID</B> bit on the <B>MPlayer</B> executable.</P>
+<BLOCKQUOTE>
+  <B>Warning: security risk</B><BR>
+  Unfortunately you <B>must</B> have <B>root</B> privileges to use VIDIX
+  due to direct hardware access. At least the <B>SUID</B> bit on the
+  <B>MPlayer</B> executable must be set.
+</BLOCKQUOTE>
 
 <P><B>VIDEO EQUALIZER</B></P>