[MPlayer-dev-eng] [PATCH] Fix HTML errors in docs

Andras Mohari mayday at varoshaza.nagyatad.hu
Fri Aug 23 11:05:05 CEST 2002


Hi,

Before even trying to get those changes from the XML docs, here is a
patch to fix HTML errors in the docs (thanks to the weblint program):

* Fixed <> chars (or replaced them with something else, where it was
  trivial).
* weblint complained about <A HREF="...">here</A> being a bad form, so I
  replaced them with more descriptive text.
* Fixed empty <A NAME="..."> tags.
* <H4> were used after <H2> tags (bad style, according to weblint).
  Replaced them with <H3>.

-- 
Andras Mohari
mayday at mail.nagyatad.hu
-------------- next part --------------
diff -Naur DOCS.old/cd-dvd.html DOCS/cd-dvd.html
--- DOCS.old/cd-dvd.html	Wed Aug 21 09:21:58 2002
+++ DOCS/cd-dvd.html	Fri Aug 23 09:36:21 2002
@@ -35,11 +35,11 @@
 
 <P>You can also try</P>
 
-<P>&nbsp;&nbsp;&nbsp;&nbsp;<CODE>echo current_speed:4 >/proc/ide/[cdrom device]/settings</CODE></P>
+<P>&nbsp;&nbsp;&nbsp;&nbsp;<CODE>echo current_speed:4 &gt;/proc/ide/[cdrom device]/settings</CODE></P>
 
 <P>but you will need root privileges. The following command may also help:</P>
 
-<P>&nbsp;&nbsp;&nbsp;&nbsp;<CODE>echo file_readahead:2000000 >/proc/ide/[cdrom device]/settings</CODE></P>
+<P>&nbsp;&nbsp;&nbsp;&nbsp;<CODE>echo file_readahead:2000000 &gt;/proc/ide/[cdrom device]/settings</CODE></P>
 
 <P>This sets prefetched file reading to 2MB, which helps with scratched CD-ROMs.
   It is recommended that you also tune your CD-ROM drive with hdparm:</P>
@@ -72,7 +72,7 @@
 <P>Support for DVD navigation via <CODE>dvdnav</CODE> is being worked on, but
   not finished yet.</P>
 
-<H4>Old-style DVD support - OPTIONAL</H4>
+<H3>Old-style DVD support - OPTIONAL</H3>
 
 <P>Useful if you want to play encoded VOBs from hard disk. Compile and
   install <B>libcss</B> 0.0.1 (not newer) for this (If <B>MPlayer</B> fails to
diff -Naur DOCS.old/codecs.html DOCS/codecs.html
--- DOCS.old/codecs.html	Wed Aug 21 09:21:59 2002
+++ DOCS/codecs.html	Fri Aug 23 10:45:52 2002
@@ -167,9 +167,9 @@
 <P><B>MPlayer</B> can play Vivo (1.0 and 2.0) videos. The most suitable codec
   for 1.0 files is FFmpeg's H263 decoder, you can use it with the <CODE>-vc
   ffh263</CODE> option (default) (requires up-to-date libavcodec). For 2.0
-  files, use the <CODE>ivvideo.dll</CODE> Win32 DLL file (from
-  <A HREF="http://www.mplayerhq.hu/MPlayer/samples/drivers32/ivvideo.dll">here</A>),
-  and install it under <CODE>/usr/lib/win32</CODE> or wherever you store the
+  files, use the
+  <A HREF="http://www.mplayerhq.hu/MPlayer/samples/drivers32/ivvideo.dll">ivvideo.dll</A>
+  Win32 DLL file, and install it under <CODE>/usr/lib/win32</CODE> or wherever you store the
   Win32 codecs. This latter codec does not support YV12 nor YUY2 only BGR
   modes, restricting it to the X11 and OpenGL outputs. Hopefully ffh263 will
   support VIVO 2.0 files in the future.</P>
@@ -358,8 +358,8 @@
 <P>The audio codec used in VIVO files depends on whether it is a VIVO/1.0 or
   VIVO/2.0 file. VIVO/1.0 files have <B>g.723</B> audio, and VIVO/2.0 files
   have <B>Vivo Siren</B> audio. Both are supported. You can grab the
-  g.723/Siren Win32 DLL from
-  <A HREF="http://www.mplayerhq.hu/MPlayer/samples/drivers32/vivog723.acm">here</A>,
+  <A HREF="http://www.mplayerhq.hu/MPlayer/samples/drivers32/vivog723.acm">g.723/Siren</A>
+  Win32 DLL from the MPlayer site,
   then copy it into the <CODE>/usr/lib/win32</CODE> directory.</P>
 
 
diff -Naur DOCS.old/documentation.html DOCS/documentation.html
--- DOCS.old/documentation.html	Thu Aug 22 09:00:25 2002
+++ DOCS/documentation.html	Fri Aug 23 10:54:17 2002
@@ -11,8 +11,7 @@
 
 <H1 ALIGN="center">MPlayer - The Movie Player for LINUX</H1>
 
-<H2 ALIGN="center">
-  &copy; 2000-2002 Arpad Gereoffy (A'rpi/ESP-team)<BR>
+<H2 ALIGN="center">&copy; 2000-2002 Arpad Gereoffy (A'rpi/ESP-team)<BR>
   <A HREF="http://www.mplayerhq.hu">http://www.mplayerhq.hu</A></H2>
 
 <P ALIGN="center">[ English ]
@@ -423,7 +422,7 @@
 
 <P>You need a fairly recent system. On Linux, 2.4.x kernels are recommended.</P>
 
-<H4>SOFTWARE REQUIREMENTS</H4>
+<H3>SOFTWARE REQUIREMENTS</H3>
 
 <UL>
   <LI><B>binutils</B> - suggested version is <B>2.11.x</B> . This program is
@@ -436,9 +435,9 @@
     need it) or don't up/downgrade at all (but in this case, be prepared for
     runtime problems). If you vote for 3.x.x, try to use the latest version,
     early releases had various bugs, so be sure you use at least 3.1, it's
-    tested and working. Detailed information about gcc 2.96's bugs (that are
-    still NOT fixed, they have been WORKED AROUND in <B>MPlayer</B>!) can be
-    found <A HREF="users_against_developers.html">here</A> and in the
+    tested and working. For detailed information about gcc 2.96's bugs (that are
+    still NOT fixed, they have been WORKED AROUND in <B>MPlayer</B>!), see
+    <A HREF="users_against_developers.html#gcc">GCC 2.96 series</A> and the
     <A HREF="faq.html">FAQ</A>.</LI>
   <LI><B>XFree86</B> - suggested version is <B>always the newest (4.2.0)</B>.
     Normally, everyone wants this, as starting with XFree86 4.0.2, it contains
@@ -469,7 +468,7 @@
   <LI><B>libavcodec</B>: This codec package is capable of decoding
     H263/MJPEG/RV10/DivX3/DivX4/DivX5/MP41/MP42/WMV1 encoded video streams, on
     multiple platforms. It is also known to be the fastest for this task.
-    Details can be found <A HREF="codecs.html#libavcodec">here</A>. Features:<BR>
+    See the <A HREF="codecs.html#libavcodec">libavcodec</A> section for details. Features:<BR>
     <UL>
       <LI>gain decoding of videos mentioned above, on non-x86 machines</LI>
       <LI>encoding with most of the mentioned codecs</LI>
@@ -692,8 +691,8 @@
 
 <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 directory. Detailed instructions can be found
-  <A HREF="documentation.html#debian">here</A>.</P>
+  <B>MPlayer</B>'s root directory. See
+  <A HREF="documentation.html#debian">Debian packaging</A> for detailed instructions.</P>
 
 <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
@@ -832,7 +831,7 @@
   Display</B>.  OSD is used to display current time, volume bar, seek bar
   etc.</P>
 
-<H4>INSTALLING OSD and SUB</H4>
+<H3>INSTALLING OSD and SUB</H3>
 
 <P>You need an <B>MPlayer</B> font package to be able to use OSD/SUB feature.
   There are many ways to get it:</P>
@@ -899,7 +898,7 @@
     RTC frequency for normal users through the <CODE>/proc</CODE> filesystem.
     Use this command to enable RTC for normal users:
     <P>
-      <CODE>echo 1024 > /proc/sys/dev/rtc/max-user-freq</CODE>
+      <CODE>echo 1024 &gt; /proc/sys/dev/rtc/max-user-freq</CODE>
     </P>
     If you do not have such a new kernel, you can also change one line in
     <CODE>drivers/char/rtc.c</CODE> and recompile your kernel. Find the
@@ -908,7 +907,7 @@
        * We don't really want Joe User enabling more
        * than 64Hz of interrupts on a multi-user machine.
        */
-      if ((rtc_freq > 64) &amp;&amp; (!capable(CAP_SYS_RESOURCE)))
+      if ((rtc_freq &gt; 64) &amp;&amp; (!capable(CAP_SYS_RESOURCE)))
     </PRE>
     and change the 64 to 1024. You should really know what you are doing, though.
     <BR>
@@ -1111,7 +1110,7 @@
 <P>This sets up a filter pipeline (you can use any number of filters). Their
   parameters are optional and if omitted, some of them are set to default
   values, e.g. <CODE>x</CODE> and <CODE>y</CODE> are both set to the center of
-  the screen and <CODE>width</CODE> and <CODE>height</CODE>> will be set to
+  the screen and <CODE>width</CODE> and <CODE>height</CODE> will be set to
   the width and height of the movie.</P>
 
 <P>Filters are queued starting from libvo, so <CODE>filter1</CODE> will be the
@@ -1423,8 +1422,8 @@
 - audio_delay 0.100
 + audio_delay -0.100
 q quit
-> pt_step 1
-< pt_step -1
+&gt; pt_step 1
+&lt; pt_step -1
 ENTER pt_step 1 1
 </PRE>
 
@@ -1517,7 +1516,7 @@
     <P>Adjust the subtitles delay of +/- val seconds or set it to val seconds
     when abs is non zero.</P></LI>
   <LI><B>osd</B> [(int) level=-1]
-    <P>Toggle osd mode or set it to level when level > 0.</P></LI>
+    <P>Toggle osd mode or set it to level when level &gt; 0.</P></LI>
   <LI><B>volume</B> (int) dir
     <P>Increase/decrease volume</P></LI>
   <LI><B>contrast</B> (int) val [(int) abs=0]</LI>
@@ -1627,11 +1626,11 @@
 
 
 
-<H1><A NAME="faq"></A>4. <A HREF="faq.html">FAQ section</A></H1>
+<H1><A NAME="faq">4.</A> <A HREF="faq.html">FAQ section</A></H1>
 
 
 
-<H1><A NAME="cd/dvd"></A>5. <A HREF="cd-dvd.html">CD/DVD section</A></H1>
+<H1><A NAME="cd/dvd">5.</A> <A HREF="cd-dvd.html">CD/DVD section</A></H1>
 
 
 
@@ -1759,7 +1758,7 @@
 
 <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
+    block &gt;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
     accessed.
     (<A HREF="http://groups.yahoo.com/group/solarisonintel/message/22516">http://groups.yahoo.com/group/solarisonintel/message/22516</A>)
@@ -1987,7 +1986,7 @@
   <LI><B><A HREF="mailto:hoffmajs at gmx.de">Jens Hoffmann</A></B>
     <UL>
       <LI>Additional YUV formats support</LI>
-      <LI>found the big BITMAPINFOHEADER problem -> solved ASV2 pixelization</LI>
+      <LI>found the big BITMAPINFOHEADER problem -&gt; solved ASV2 pixelization</LI>
     </UL>
   </LI>
   <LI><B><A HREF="mailto:nickols_k at mail.ru">Nick Kurshev</A></B>
@@ -2509,12 +2508,12 @@
 <P><B>Note:</B> Unless explicitly stated otherwise the language of the above
   lists is <B>English</B>. 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>.
+<P><B>Note:</B> You can reach the searchable mailing list archives at
+  <A HREF="http://www.mplayerhq.hu/cgi-bin/htsearch">http://www.mplayerhq.hu/cgi-bin/htsearch</A>.
 
 
 
-<H1><A NAME="bug_reports"></A><A HREF="bugreports.html">Appendix C</A> - How to report bugs</H1>
+<H1><A NAME="bug_reports">Appendix C</A> - <A HREF="bugreports.html">How to report bugs</A></H1>
 
 
 
diff -Naur DOCS.old/faq.html DOCS/faq.html
--- DOCS.old/faq.html	Thu Aug 22 09:00:32 2002
+++ DOCS/faq.html	Fri Aug 23 10:11:21 2002
@@ -42,8 +42,8 @@
     </PRE>
   </DT>
   <DD>A: This is a known problem of gcc 3.0.4, upgrade to 3.1 to solve the
-    problem. How to install gcc is described
-    <A HREF="users_against_developers.html#gcc">here</A>.</DD>
+    problem. How to install gcc is described in the
+    <A HREF="users_against_developers.html#gcc">GCC 2.96 series</A> section.</DD>
   <DD>&nbsp;</DD>
 
   <DT>Q: Configure ends with this text, and MPlayer won't compile!<BR>
@@ -378,7 +378,7 @@
   </DT>
   <DD>A: Probably the audio uses a codec not natively supported by
     <B>MPlayer</B>. Install the Win32 codec package as described in the README
-    or <A HREF="documentation.html#installation">here</A>.</DD>
+    or <A HREF="documentation.html#installation">Installation</A>.</DD>
   <DD>&nbsp;</DD>
 
   <DT>Q: ... works with avifile/aviplay but doesn't with MPlayer.</DT>
@@ -397,9 +397,9 @@
 
   <DT>Q: MPlayer exits with some error when using l3codeca.acm.</DT>
   <DD>A: Check <CODE>ldd /usr/local/bin/mplayer</CODE> output. If it contains<BR>
-    &nbsp;&nbsp;&nbsp;&nbsp;<CODE>libc.so.6 => /lib/libc.so.6 (0x4???????)</CODE><BR>
+    &nbsp;&nbsp;&nbsp;&nbsp;<CODE>libc.so.6 =&gt; /lib/libc.so.6 (0x4???????)</CODE><BR>
     where "?" is any number then it's OK, the error is not here. If it is:<BR>
-    &nbsp;&nbsp;&nbsp;&nbsp;<CODE>libc.so.6 => /lib/libc.so.6 (0x00??????)</CODE><BR>
+    &nbsp;&nbsp;&nbsp;&nbsp;<CODE>libc.so.6 =&gt; /lib/libc.so.6 (0x00??????)</CODE><BR>
     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.
@@ -530,7 +530,7 @@
     <PRE>
     AO: [oss] 44100Hz 2ch Signed 16-bit (Little-Endian)
     audio_setup: Can't open audio device /dev/dsp: Device or resource busy
-    couldn't open/init audio device -> NOSOUND
+    couldn't open/init audio device -&gt; NOSOUND
     Audio: no sound!!!
     Start playing...
     </PRE>
@@ -629,7 +629,7 @@
 
   <DT>Q: While playing a DVD, I encountered this error:<BR>
     <CODE>mplayer: ifo_read.c:1143: ifoRead_C_ADT_internal: Assertion
-    nfo_length / sizeof(cell_adr_t) >= c_adt->nr_of_vobs' failed.</CODE></DT>
+    nfo_length / sizeof(cell_adr_t) &gt;= c_adt-&gt;nr_of_vobs' failed.</CODE></DT>
   <DD>A: This is a known libdvdread 0.9.1/0.9.2 bug. Use <B>libmpdvdkit</B>,
     which is present in MPlayer source, and used by default.</DD>
   <DD>&nbsp;</DD>
diff -Naur DOCS.old/sound.html DOCS/sound.html
--- DOCS.old/sound.html	Wed Aug 21 09:22:04 2002
+++ DOCS/sound.html	Fri Aug 23 10:34:43 2002
@@ -54,7 +54,7 @@
 
 <TABLE BORDER=0 WIDTH="100%">
   <TR><TD COLSPAN=3><B>VIA onboard chipset (via82cxxx) 48kHz only</B></TD></TR>
-  <TR><TD></TD><TD>Driver:</TD><TD> from <A HREF="http://sourceforge.net/project/showfiles.php?group_id=3242&amp;release_id=59602">here</A></TD></TR>
+  <TR><TD></TD><TD>Driver:</TD><TD> from <A HREF="http://sourceforge.net/project/showfiles.php?group_id=3242&amp;release_id=59602">sourceforge.net</A></TD></TR>
 
   <TR><TD COLSPAN=3><B>Aureal Vortex 2</B></TD></TR>
   <TR><TD>&nbsp;&nbsp;&nbsp;&nbsp;</TD><TD>OSS:</TD><TD>no driver</TD></TR>
@@ -62,7 +62,7 @@
   <TR><TD></TD><TD>ALSA:</TD><TD>no driver</TD></TR>
   <TR><TD></TD><TD>Max kHz:</TD><TD>48</TD></TR>
   <TR><TD></TD><TD>Driver:</TD><TD><A HREF="http://aureal.sourceforge.net">aureal.sourceforge.net</A></TD></TR>
-  <TR><TD></TD><TD>Driver2:</TD><TD> from <A HREF="http://makacs.poliod.hu/~pontscho/aureal/au88xx-1.1.3.tar.bz2">here</A><BR>
+  <TR><TD></TD><TD>Driver2:</TD><TD> from <A HREF="http://makacs.poliod.hu/~pontscho/aureal/au88xx-1.1.3.tar.bz2">Pontscho's page</A><BR>
     (<I>buffer size increased to 32k</I>)</TD></TR>
 
   <TR><TD COLSPAN=3><B>GUS PnP</B></TD></TR>
diff -Naur DOCS.old/users_against_developers.html DOCS/users_against_developers.html
--- DOCS.old/users_against_developers.html	Wed Aug 21 09:22:05 2002
+++ DOCS/users_against_developers.html	Fri Aug 23 10:20:20 2002
@@ -49,7 +49,7 @@
   bugs, especially since some workarounds may imply a performance penalty.</P>
 
 <P>You can read about the other side of the story
-  <A HREF="http://www.bero.org/gcc296.html">here</A>.
+  <A HREF="http://www.bero.org/gcc296.html">at this site</A>.
   GCC 2.96 does not allow | (pipe) characters in assembler comments
   because it supports Intel as well as AT&amp;T Syntax and the | character is a
   symbol in the Intel variant. The problem is that it <B>silently</B> ignores the
@@ -67,9 +67,9 @@
 
 <P>If you have problems with GCC 2.96, you can get 2.96-85 packages from the
   Red Hat <A HREF="ftp://updates.redhat.com">ftp server</A>, or just go for the
-  3.0.4 packages offered for version 7.2 and later. You can also get gcc-3.1
-  packages (unofficial, but working fine)
-  <A HREF="ftp://people.redhat.com/jakub/gcc3/3.1-1/">here</A> and you can
+  3.0.4 packages offered for version 7.2 and later. You can also get
+  <A HREF="ftp://people.redhat.com/jakub/gcc3/3.1-1/">gcc-3.1 packages</A>
+  (unofficial, but working fine) and you can
   install them along the gcc-2.96 you already have. MPlayer will detect it and
   use 3.1 instead of 2.96. If you do not want to or cannot use the binary
   packages, here is how you can compile GCC 3.1 from source:</P>
diff -Naur DOCS.old/video.html DOCS/video.html
--- DOCS.old/video.html	Thu Aug 22 09:00:48 2002
+++ DOCS/video.html	Fri Aug 23 09:52:27 2002
@@ -150,7 +150,7 @@
   xv support, but the card itself is very slow, so you better sell it.</P>
 
 <P><B>NOTE</B>: Savage cards have a slow YV12 image displaying capability (it
-  needs to do YV12->YUY2 conversion, because the Savage hardware can't display
+  needs to do YV12 to YUY2 conversion, because the Savage hardware can't display
   YV12). So when this documentation says at some point "this has YV12 output
   use this, it's faster", it's not sure. Try
   <A HREF="http://www.mplayerhq.hu/MPlayer/contrib/Savage-driver/savage_drv.o.mmx2.bz2">this
@@ -619,12 +619,12 @@
 
 <P>The <CODE>/dev/mga_vid</CODE> device file can be read (for example by
   <CODE>cat /dev/mga_vid</CODE>) for some info, and written for brightness
-  change: <CODE>echo "brightness=120" > /dev/mga_vid</CODE></P>
+  change: <CODE>echo "brightness=120" &gt; /dev/mga_vid</CODE></P>
 
 
 <H4><A NAME="sis_vid">2.3.1.8 SiS 6326 framebuffer (sis_vid)</A></H4>
 
-<P>SiS 6326 YUV Framebuffer driver -> sis_vid kernel driver</P>
+<P>SiS 6326 YUV Framebuffer driver -&gt; sis_vid kernel driver</P>
 
 <P>Its interface should be compatible with the mga_vid, but the driver was not
   updated after the mga_vid changes, so it's outdated now.  Volunteers
@@ -650,8 +650,8 @@
   <A HREF="http://utah-glx.sourceforge.net">http://utah-glx.sourceforge.net</A>
   for details about how to install it.</P>
 
-<P>XFree86(DRI) >= 4.0.3 supports OpenGL with Matrox and Radeon cards, >= 4.2
-  supports Rage128. See
+<P>XFree86(DRI) 4.0.3 or later supports OpenGL with Matrox and Radeon cards,
+  4.2.0 or later  supports Rage128. See
   <A HREF="http://dri.sourceforge.net">http://dri.sourceforge.net</A>
   for download and installation instructions.</P>
 
@@ -783,7 +783,7 @@
     driver from text-mode then after terminating <B>MPlayer</B> you will have
     <B>ROM font</B> loaded instead of national. You can load national font again
     by using <B><I>setsysfont</I></B> utility from the Mandrake distribution
-    for example.</BR>
+    for example.<BR>
     (<B>Hint:</B> The same utility is used for the localization of fbdev).</LI>
   <LI>Some <B>Linux graphics drivers</B> don't update active <B>BIOS mode</B> in
     DOS memory. So if you have such problem - always use VESA driver only from
@@ -1065,7 +1065,7 @@
   <CODE>expand=w:h:x:y:1</CODE> (the 5th parameter <CODE>:1</CODE> at the end
   will enable OSD rendering). You may want to move the image up a bit to get a
   bigger black zone for subtitles. You may also want to move subtitles up, if
-  they are outside your TV screen, use the <CODE>-subpos <0-100></CODE> switch
+  they are outside your TV screen, use the <CODE>-subpos &lt;0-100&gt;</CODE> switch
   to adjust this (<CODE>-subpos 80</CODE> is a good choice).</P>
 
 <P>In order to play non-25fps movies on a PAL TV or with a slow CPU, add the


More information about the MPlayer-dev-eng mailing list