[Mplayer-cvslog] CVS: main/DOCS faq.html,1.101,1.102 documentation.html,1.285,1.286
Diego Biurrun CVS
diego at mplayerhq.hu
Sun Aug 11 17:50:02 CEST 2002
Update of /cvsroot/mplayer/main/DOCS
In directory mail:/var/tmp.root/cvs-serv28761
Modified Files:
faq.html documentation.html
Log Message:
Created RTC section and moved RTC explanation there.
Closed some tags and fixed a few typos (hungarian -> Hungarian).
Reorganized the mailing list section.
Index: faq.html
===================================================================
RCS file: /cvsroot/mplayer/main/DOCS/faq.html,v
retrieving revision 1.101
retrieving revision 1.102
diff -u -r1.101 -r1.102
--- faq.html 4 Aug 2002 22:26:35 -0000 1.101
+++ faq.html 11 Aug 2002 15:49:41 -0000 1.102
@@ -446,7 +446,7 @@
<CODE>Linux RTC init: ioctl (rtc_pie_on): Permission denied</CODE>
</B></TD><TR><TD></TD><TD VALIGN=top>A:</TD><TD>You need root privileges or a
specially set up kernel to use the new timing code. For details see the
-<A HREF="documentation.html#installation">installation section</A> of the documentation.
+<A HREF="documentation.html#rtc">RTC section</A> of the documentation.
</TD><TR><TD COLSPAN=3> </TD><TR>
<TD></TD><TD VALIGN=top>Q:</TD><TD WIDTH="100%"><B>I have A/V sync problems. Some of my AVIs play fine, but some play with
Index: documentation.html
===================================================================
RCS file: /cvsroot/mplayer/main/DOCS/documentation.html,v
retrieving revision 1.285
retrieving revision 1.286
diff -u -r1.285 -r1.286
--- documentation.html 10 Aug 2002 20:26:43 -0000 1.285
+++ documentation.html 11 Aug 2002 15:49:42 -0000 1.286
@@ -34,6 +34,7 @@
<LI><A HREF="#installation">1.3 Installation</A></LI>
<LI><A HREF="#gui">1.4 What about the GUI?</A></LI>
<LI><A HREF="#subtitles_osd">1.5 Subtitles and OSD</A></LI>
+ <LI><A HREF="#rtc">1.6 RTC</A></LI>
</UL>
</LI>
<LI><A HREF="#features">2. Features</A>
@@ -691,53 +692,8 @@
and encode movies with <B>MPlayer</B>, read the <A HREF="#tv">TV input</A>
section.</LI>
-<LI>There are three timing methods in <B>MPlayer</B>.
- <UL>
- <LI><B>To use the old method</B>, you don't have to do anything. It uses
- <CODE>usleep()</CODE> to tune A/V sync, with +/- 10ms accuracy. However
- sometimes the sync has to be tuned even finer.</LI>
- <LI><B>The new timer</B> code uses PC's RTC (Real Time Clock) for this task,
- because it has precise 1ms timers. It is automagically enabled when
- available, but requires root privileges, a <I>setuid root</I>
- <B>MPlayer</B> binary or a properly set up kernel.
- <BR>
- If you are running kernel 2.4.19pre8 or later you can adjust the maximum
- 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>
- </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
- section that reads
- <PRE>
- * We don't really want Joe User enabling more
- * than 64Hz of interrupts on a multi-user machine.
- */
- if ((rtc_freq > 64) && (!capable(CAP_SYS_RESOURCE)))
- </PRE>
- and change the 64 to 1024. You should really know what you are doing, though.
- <BR>
- You can see the new timer's efficiency in the status line.
- <BR>
- The power management functions of some notebook BIOSes with speedstep CPUs
- interact badly with RTC. Audio and video may get out of sync. Plugging the
- external power connector in before you power up your notebook seems to help.
- You can always turn off RTC support with the <CODE>-nortc</CODE> switch.
- In some hardware combinations (confirmed during usage of non-DMA DVD
- drive on an ALi1541 board) usage of the RTC timer causes skippy playback.
-
- It's recommended to use the following method in these cases.</LI>
- <LI><B>The third timer code</B> is turned on with the <CODE>-softsleep</CODE>
- option. It has the efficiency of the RTC, but it doesn't use RTC. On the other
- hand, it requires more CPU.</LI>
- </UL>
-</LI>
</UL>
-Note: <B>NEVER install a setuid root MPlayer binary on a multiuser system!</B>
-It's a clear way for everyone to gain root.
-
<P>Then build <B>MPlayer</B>:</P>
<PRE>
@@ -919,9 +875,9 @@
programs.<BR>
Some URLs:
<UL>
- <LI><A HREF="ftp://ftp.mplayerhq.hu/MPlayer/releases/">ftp://ftp.mplayerhq.hu/MPlayer/releases/</A> - ISO fonts
- <LI><A HREF="ftp://ftp.mplayerhq.hu/MPlayer/contrib/fonts/">ftp://ftp.mplayerhq.hu/MPlayer/contrib/fonts/</A> - various fonts by users
- <LI><A HREF="http://realtime.ssu.ac.kr/~lethean/mplayer">http://realtime.ssu.ac.kr/~lethean/mplayer</A> - Korean fonts & RAW plugin
+ <LI><A HREF="ftp://ftp.mplayerhq.hu/MPlayer/releases/">ftp://ftp.mplayerhq.hu/MPlayer/releases/</A> - ISO fonts</LI>
+ <LI><A HREF="ftp://ftp.mplayerhq.hu/MPlayer/contrib/fonts/">ftp://ftp.mplayerhq.hu/MPlayer/contrib/fonts/</A> - various fonts by users</LI>
+ <LI><A HREF="http://realtime.ssu.ac.kr/~lethean/mplayer">http://realtime.ssu.ac.kr/~lethean/mplayer</A> - Korean fonts & RAW plugin</LI>
</UL>
</LI>
@@ -950,6 +906,52 @@
<P>You can change default behaviour by setting <CODE>osdlevel=</CODE> variable
in config file.</P>
+<P><B><A NAME="rtc">1.6 RTC</A></B></P>
+
+There are three timing methods in <B>MPlayer</B>.
+<UL>
+ <LI><B>To use the old method</B>, you don't have to do anything. It uses
+ <CODE>usleep()</CODE> to tune A/V sync, with +/- 10ms accuracy. However
+ sometimes the sync has to be tuned even finer.</LI>
+ <LI><B>The new timer</B> code uses PC's RTC (Real Time Clock) for this task,
+ because it has precise 1ms timers. It is automagically enabled when
+ available, but requires root privileges, a <I>setuid root</I>
+ <B>MPlayer</B> binary or a properly set up kernel.
+ <BR>
+ If you are running kernel 2.4.19pre8 or later you can adjust the maximum
+ 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>
+ </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
+ section that reads
+ <PRE>
+ * We don't really want Joe User enabling more
+ * than 64Hz of interrupts on a multi-user machine.
+ */
+ if ((rtc_freq > 64) && (!capable(CAP_SYS_RESOURCE)))
+ </PRE>
+ and change the 64 to 1024. You should really know what you are doing, though.
+ <BR>
+ You can see the new timer's efficiency in the status line.
+ <BR>
+ The power management functions of some notebook BIOSes with speedstep CPUs
+ interact badly with RTC. Audio and video may get out of sync. Plugging the
+ external power connector in before you power up your notebook seems to help.
+ You can always turn off RTC support with the <CODE>-nortc</CODE> switch.
+ In some hardware combinations (confirmed during usage of non-DMA DVD
+ drive on an ALi1541 board) usage of the RTC timer causes skippy playback.
+ It's recommended to use the third method in these cases.</LI>
+ <LI><B>The third timer code</B> is turned on with the <CODE>-softsleep</CODE>
+ option. It has the efficiency of the RTC, but it doesn't use RTC. On the other
+ hand, it requires more CPU.</LI>
+</UL>
+
+<B>Note:</B> <B>NEVER install a setuid root MPlayer binary on a multiuser system!</B>
+It's a clear way for everyone to become root.
+
<P><B><A NAME="features">2. Features</A></B></P>
@@ -1925,7 +1927,7 @@
<LI><B><A HREF="mailto:gabucino at mplayerhq.hu">Gábor Bérczi (Gabucino)</A></B>
<UL>
<LI>documentation writer & maintainer</LI>
- <LI>hungarian translation of documentation, homepage, and help output</LI>
+ <LI>Hungarian translation of documentation, homepage, and help output</LI>
<LI>second homepage design&gfx</LI>
<LI>homepage maintainer</LI>
<LI>testing, codecs quality & speed comparisons</LI>
@@ -2540,25 +2542,25 @@
achieved on the following addresses:</P>
<UL>
-<LI>MPlayer developers list:<BR>
-<A HREF="http://mplayerhq.hu/mailman/listinfo/mplayer-dev-eng">http://mplayerhq.hu/mailman/listinfo/mplayer-dev-eng</A>
-<P>This list is about mplayer development! Talking about interface/API changes,
+<LI>MPlayer developers list:
+<A HREF="http://mplayerhq.hu/mailman/listinfo/mplayer-dev-eng">http://mplayerhq.hu/mailman/listinfo/mplayer-dev-eng</A><BR>
+This list is about mplayer development! Talking about interface/API changes,
new libraries, code optimization, configure changes, and send patches here.
-Do NOT send bugreports, user questions, feature requests, flame here!
-This list should be kept low-traffic.</P>
+Do NOT send bug reports, user questions, feature requests or flames here!
+This list should be kept low-traffic.
</LI>
-<LI>MPlayer users list:<BR>
+<LI>MPlayer users list:
<A HREF="http://mplayerhq.hu/mailman/listinfo/mplayer-users">http://mplayerhq.hu/mailman/listinfo/mplayer-users</A>
<UL>
-<LI>send bugreports here (after reading <A HREF="#known_bugs">Known Bugs</A> section, and <A HREF="bugreports.html">Appendix C</A>)</LI>
-<LI>send feature requests here (after reading the WHOLE documentation)</LI>
-<LI>send user questions here (after reading the WHOLE documentation)</LI>
+<LI>Send bug reports here (after reading the <A HREF="#known_bugs">Known Bugs</A> section, and <A HREF="bugreports.html">Appendix C</A>).</LI>
+<LI>Send feature requests here (after reading the WHOLE documentation).</LI>
+<LI>Send user questions here (after reading the WHOLE documentation).</LI>
</UL>
</LI>
-<LI>MPlayer hungarian users list:<BR>
+<LI>MPlayer Hungarian users list:
<A HREF="http://mplayerhq.hu/mailman/listinfo/mplayer-felhasznalok">http://mplayerhq.hu/mailman/listinfo/mplayer-felhasznalok</A>
-<P><UL>
-<LI>hungarian language list</LI>
+<UL>
+<LI>Hungarian language list</LI>
<LI>topic? We'll see about it... mostly flame and RTFM questions up to now :(</LI>
</UL>
</LI>
@@ -2571,24 +2573,23 @@
<LI>and about matroxfb-TVout stuff.</LI>
</UL>
</LI>
-<LI>MPlayer & DVB card users:<BR>
-<A HREF="http://mplayerhq.hu/mailman/listinfo/mplayer-dvb">http://mplayerhq.hu/mailman/listinfo/mplayer-dvb</A>
-<P>Things related to the hardware decoder card called DVB. (NOT dxr3!)</P>
+<LI>MPlayer & DVB card users:
+<A HREF="http://mplayerhq.hu/mailman/listinfo/mplayer-dvb">http://mplayerhq.hu/mailman/listinfo/mplayer-dvb</A><BR>
+Things related to the hardware decoder card called DVB (NOT DXR3!).
</LI>
-<LI>MPlayer CVS-log: <BR>
-<A HREF="http://mplayerhq.hu/mailman/listinfo/mplayer-cvslog">http://mplayerhq.hu/mailman/listinfo/mplayer-cvslog</A>
-<P>Send only questions about CVS changes here.
-(if you don't understand why a change is required or you've better fix or you've
-noticed possible bug/problem in the committed patch)
-Be sure in that your target developer reads this list!</P>
+<LI>MPlayer CVS-log:
+<A HREF="http://mplayerhq.hu/mailman/listinfo/mplayer-cvslog">http://mplayerhq.hu/mailman/listinfo/mplayer-cvslog</A><BR>
+Send only questions about CVS changes 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 committed patch). Be sure in that your target developer reads this list!
</LI>
</UL>
-<P>NOTE: language of above lists are ENGLISH, unless explicitly stated
-otherwise. Please do not send messages using other language!</P>
+<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>NOTE: 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
+ <A HREF="http://www.mplayerhq.hu/cgi-bin/htsearch">here</A>.
<P><B><A NAME="bug_reports"></A><A HREF="bugreports.html">Appendix C</A> - How to report bugs</B></P>
More information about the MPlayer-cvslog
mailing list