"There are some updates and new file inside an attachment."

git-svn-id: svn://svn.mplayerhq.hu/mplayer/trunk@4778 b3059339-0415-0410-9bf9-f77b7e298cf2

4 files changed, 133 insertions, 138 deletions

diff --git a/DOCS/Polish/DXR3 b/DOCS/Polish/DXR3
index 4b239d403f..1dabae24fe 100644
--- a/DOCS/Polish/DXR3
+++ b/DOCS/Polish/DXR3
@@ -1,115 +1,87 @@
-DXR3/H+ video/audio output plugins manual by David Holm
-=======================================================
-
-2001-12-28: There is a whole bunch of updates since the
-            last time. For one thing, digital audio now
-	    works thanks to Steven Brookes.
-	    This is the first version to exclusively
-	    use the dxr3's hardware sync. It seems as if
-	    there are some bugs in the driver, so bugreports
-	    will be appreciated.
-	    Also, you will need to get the em8300 drivers
-	    from cvs unless a version newer than 0.9.0 has
-	    been released.
-	    Note1: Seeking won't work with -vc mpegpes!
-	    Note2: You now MUST use -ao dxr3 for proper
-	    a/v sync!
-	    
-2001-12-04: Thanks to Inaki Garci'a Etxebarria of
-	    zapping.sourceforge.net we have now
-	    abandoned rte since it caused problems for
-	    users who didn't rtfm and compiled it with
-	    ffmpeg support. Instead we are now using
-	    libmp1e which is a modified version of mp1e.
-	    
-2001-11-29: Thanks to Felix Buenemann I managed to
-	    optimize the odivx playback as well as add
-	    support for the rest of the codecs!
-	    
-1. Introduction
-
-The DXR3 and Hollywood+ are two not too different mpeg-(1/2) and ac3
-hardware playback cards that came at about the same time as the first
-dvd-rom drives hit the market. At that time most computers weren't
-powerful enough for synced software dvd playback. And even the faster
-(intel-based) computers had troubles with artifacts.
-Sigma Designs came up with the great idea to create a hardware
-mpeg-(1/2), ac3 decoder. Sigma Designs are known for their realmagic
-hardware (or they bought the company who came up with the first
-realmagic boards, I don't know which).
-Later Creative Labs thought, hey, we also wan't this product, and to
-distribute it with our dvd-drives (the DVD Encore packages if I recall
-correctly). So they bought the designs for the Hollywood plus and
-replaced the circuit used to produce a proper video feed for tv's
-called adv7170 or adv7175a depending on which h+ board you own with
-a bt865. The reason for this is beyond my understanding as this seems
-complete illogical to me, but I have had great experiences with
-bt(brooktree) circuits in the past, so I don't mind.
-Well, nowadays most people have no use for a mpeg-(1/2) or ac3
-hardware decoder since most computers these days have no problem doing
-this in software and have cycles left for posprocessing (removing of
-artefacts and other garbage produced by compression).
-These days, you have two uses for this card:
-1. You have a slow computer which you use for vcd/dvd playback
-2. You discover what I have done with the implementation of this as
-   an audio/video output device for mplayer (read on and you'll find
-   out).
-
-
-
-2. Requirements
-
- * First of all you will need the DXR3/H+ drivers properly installed.
-   Version 0.9.0 or later
-
- * Run <mplayerdir>/configure and make sure that DXR3/H+ support = yes
-   
- From here on compilation (of at least my code ;) should go without any
- problems.
-
-
-
-3. Usage
-
-After installation you will have two new outdevices in mplayer:
-    -vo dxr3	For video output
-    -ao dxr3	For audio output 
-
-MPEG-1, MPEG-2, VCD and DVD Notes
-There are some notes to take into account here for optimum playback.
-When playing any mpeg-(1/2) file, this including usage of the "-dvd"
-and "-vcd" options you must either add the "-vc mpegpes" or edit
-codecs.conf and make sure videocodec mpegpes is listed above mpeg12.
-If you fail to do this you will only get software playback which kinda
-spoils most of the useful features of this card except for tv-out ;).
-Remember that if you edit the codecs.conf file and move the mpegpes
-section will have to specify "-vc mpeg12" if you want to playback
-any of these video types _without_ "-vo dxr3"!
-Use -ac hwac3 if you want AC3 audio to be handled by hardware (please
-send some feedback on this).
+Jak używać Sigma Designs Hollywood Plus i/lub Creative DXR3 autorstwa Davida
+============================================================================
+Holma
+=====
 
-DIVX Notes
-When playing divx's add "-vc odivx" for maximum performance.
-I've switched to mp1e from ffmpeg so it should be lightning fast now.
-libmp1e currently does not work on nonx86 processor and nonmmx processors.
-I'm in the process of fixing this.
+Podziękowania dla Daniela Bella za podarowanie całkowicie nowego 20GB dysku IBM.
 
-Other codecs:
-No "-vc <codec>" switches should be required as mplayer will autodetect.
-If you find an unsupported codec please contact me!
-
-* Avoid running mplayer as root or setuid root as rtc timing seems to
-  slow down playback on the dxr3 for some users. I will look into this
-  at a later point as this hardly qualifies as a severe bug *
-
-
- 
-4. Contacting me
-
-You can contact me either by e-mailing me, <dholm@iname.com> or by using
-icq: 798427
-Feedback, bugreports and general suggestions are appreciated (preferably
-by e-mail). My name is David Holm for those of you who are incapable of 
-reading a heading. ;)
+1. Wymagania
 
+ * Przede wszystkim potrzebne ci będą właściwie zainstalowane sterowniki
+   DXR3/H+.
+   Versja 0.10.0 albo późniejsza. Znajdziesz to na:
+   http://dxr3.sourceforge.net/
 
+ * Uruchom <mplayerdir>/configure i upewnij się, że: 
+   DXR3/H+ support = yes
+   jeśli chcesz odgrywać pliki inne niż mpeg, równiez to powinno być: 
+   libmp1e = yes 
+   
+ Teraz już kompilacja (przynajmniej mojego kodu ;) powninna pójść bez
+ problemów.
+
+
+
+
+2. Używanie
+
+     -vo dxr3:<devicenum>		Dla wyjścia wideo: <devicenum> nie jest
+	potrzebne, o ile masz nie więcej niż jedno urządzenie em8300 w swoim
+	komputerze.
+     -vo dxr3:noprebuf			Wyłącza prebuffering. To jest potrzebne
+	tylko wtedy, gdy masz problemy z synchronizacją w normalnym odgrywaniu,
+	wówczas zmniejszy się gładkość odtwarzania i nie będzie używana cała
+	dostępna moc procesora podczas odgrywania zawartości nie mpeg.  Uwaga:
+	z prebufferingiem A-V: powinno być negatywne, jeśli nie jest negatywne,
+	twój komputer jest zbyt wolny, aby właściwie odtwarzać wideo i
+	powinieneś wyłączyć prebuffering, jesli masz problemy z synchronizacją.
+	Bez prebufferingu ta wartość powinna być bliska 0 za każdym razem.
+	Uwaga2: pewne bardzo szybkie komputery zdają się mieć problemy z
+	prebufferingiem. Należy winić za to Sigma ;). Możesz bezpiecznie
+	używać: noprebuf jeśli twoja maszyna jest wystarczająco szybka, aby w
+	gładki sposób odgrywać wideo. 
+     -ao oss:<devicefile>		Dla wyjścia dźwięku.
+     -ac hwac3				Dla cyfrowego wyjścia dźwięku zamiast
+   	analogowego.
+     -vc mpegpes			Dla odgrywania mpeg
+     -aop list=resample:fout=48000	Jeśli częstotliwość próbkowania jest
+     	mniejsza, niż 44100Hz. To nie działa przy cyfrowym wyjściu dźwięku 
+    	(-ac hwac3).
+     <devicenum>			Ilość urządzeń do urzycia podczas
+	odtwarzania (jeśli masz kilka kart). To może zazwyczaj być pominięte
+	(-vo dxr3). Mandrake 8.1 używa domyślnie devfs. Jeśli używasz mandrake
+	8.1, zastosuj -vo dxr3:0
+     <devicefile>			Normalnie /dev/em8300_ma albo
+	/dev/em8300_ma-<devicenum> (-ao dxr3:/dev/em8300_ma). Jeśli pominiemy
+	tą opcję, domyślne używane będzie urządzenie oss (normalnie karta
+	dźwiękowa).
+
+
+Uwagi do MPEG-1, MPEG-2, VCD i DVD 
+
+Jest kilka ważnych spraw, które warto tu wziąć pod uwagę, dla uzyskania
+optymalnego odgrywania. MPlayer obecnie nie wykrywa automatycznie, że dxr3 może
+odgrywać mpegi. Tak więc dla plików mpeg, dvd i vcd musisz dodać opcję -vc
+mpegpes, aby powiedzieć Mplayerowi, że używasz akceleracji sprzętowej. W
+przeciwnym razie Mplayer będzie dekodował film programowo, co jest znacznie
+wolniejsze.  Zauważ, że nie możesz używać opcji -vc mpegpes z filmami, które
+nie są mpeg 1 lub 2, dostaniesz bowiem komunikat o błędzie takiej oto treści:
+"Can't find codec for video format..." ("Nie można znaleźć kodeka dla formatu
+wideo").
+
+* Jeśli uruchamiasz Mplayera jako root, albo set userid root, do synchronizacji
+  używany będzie wewnętrzny realtime clockgenerator twojego komputera. 
+  (jeśli twoje jądro ma wkompilowaną obsługę tego - jest to umieszczone 
+  w sekcji character devices i nazywa się "Enhanced realtime clock support").
+  Niektórzy mówią, że to daje poprawę odgrywania (tak też powinno  być), ale
+  inni mieli z tym problemy. Będziesz musiał sam poeksperymentować, aby 
+  ustalić optymalne ustawienia dla siebie.
+
+
+
+3. Kontakt ze mną
+
+Możesz się ze mną skontaktować albo pisząc e-mail do mnie: <dholm@iname.com>,
+albo używając icq: 798427.
+Odzew od użytkowników, raporty o błędach i ogólne sugestie są mile widziane
+(najchętniej przez e-mail).
diff --git a/DOCS/Polish/codecs.html b/DOCS/Polish/codecs.html
index e83c5e7b92..10963092c7 100644
--- a/DOCS/Polish/codecs.html
+++ b/DOCS/Polish/codecs.html
@@ -42,10 +42,11 @@ MPEG1/2. Teraz już stosujemy własny.</P>
 
 <P>Nowa generacja tych kodeków potrafi nawet dekodować filmy zrobione z użyciem
 niesławnych kodeków DivX! Ale to jeszcze nie wszystko! Są one DUŻO szybsze, niż
-tradycyjne DLLe Win32 DivX. Zobacz poniżej opis konfiguracji. Jedyną wadą tych
-kodeków jest fakt, że aktualnie są one closed-source. :(</P>
+tradycyjne DLLe Win32 DivX (zauważ, że dekoder libavcodec jest JESZCZE SZYBSZY
+:). Zobacz poniżej opis konfiguracji. Jedyną wadą tych kodeków jest fakt, że
+aktualnie są one closed-source. :(</P>
 
-<P>Kodeki można ściągnąć z następującego URL:</P>
+<P>Kodek można ściągnąć z następującego URL:</P>
 
 <P>&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="http://avifile.sourceforge.net">http://avifile.sourceforge.net</A></P>
 
@@ -55,7 +56,7 @@ kodeków jest fakt, że aktualnie są one closed-source. :(</P>
 
 <P>Rozpakuj je i uruchom, jako root, polecenie: <CODE>./install.sh</CODE> .</P>
 
-<P>Uwaga: NIE zapomnij dodać /usr/local/lib do /etc/ld.so.conf !</P>
+<P>Uwaga: NIE zapomnij dodać <CODE>/usr/local/lib</CODE> do <CODE>/etc/ld.so.conf</CODE> i uruchomić <CODE>ldconfig</CODE>!</P>
 
 <P><B>MPlayer</B> automatycznie wykrywa czy DivX4 jest (właściwie)
 zainstalowany, wystarczy go, tak jak zawsze, skompilować. Jeśli mplayer nie
@@ -88,8 +89,8 @@ pasma przenoszenia na szynie. W trybie spakowanego YUV (YUY2, UYVY) stosuj
 metodę 'divx4'. W trybie RGB możesz dowolnie wybierać, ponieważ prędkości ich
 są takie same, różnią się być może tylko w odniesieniu do aktualnego bpp.</P>
 
-<P>Uwaga: ten kodek wspiera również postprocessing, ale zakres wartości jest
-dziwny: (UAKTUALNIĆ)</P>
+<P>Uwaga: ten kodek wspiera również postprocessing (użyj opcji
+<CODE>-oldpp</CODE>, aby to włączyć), ale zakres wartości jest dziwny: </P>
 
 <P><TABLE BORDER=0>
 <TD>&nbsp;&nbsp;</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>0</TD><TD>&nbsp;&nbsp;</TD>
@@ -163,7 +164,9 @@ Włączenie ich jest bardzo proste:</P>
 
   <LI>Użyj opcji <CODE>--with-xanimlibdir</CODE>, aby podać dla configure,
 gdzie znajdują się kodeki xanim. Domyślnie są one szukane w katalogu
-<CODE>/</CODE> (...) .</LI>
+<CODE>/</CODE> (...). 
+  Alternatywą jest ustawienie w zmiennej środowiskowej <I>XANIM_MOD_DIR</I>
+  ścieżki do katalogu z kodekami XAnim.</LI>
 
   <LI>Zmień nazwy plików, obcinając część dotyczącą architektury tak, aby
 wyglądały one następująco: <CODE>vid_cvid.xa, vid_h263.xa, vid_iv50.xa</CODE>
@@ -262,7 +265,8 @@ prawy, lewy-tylny, prawy-tylny, centralny oraz LFE.</P>
 posiadać sterownik dla karty dźwiękowej, który obsługuje odpowiednią liczbę
 kanałów wyjściowych przez SNDCTL_DSP_CHANNELS ioctl. Na przykład wersja
 sterownika emu10k1 (używanego z kartami SB Live), nowsza niż z sierpnia 2001,
-powinna być odpowiednia.</P>
+powinna być odpowiednia (słyszałem, że najnowszy ALSA CVS obsługuje to także)
+.</P>
 
 <P>Miksowanie na wyjściu więcej niż dwóch kanałów powinno być traktowane jako
 eksperymentalne.</P>
@@ -271,9 +275,10 @@ eksperymentalne.</P>
 
 <P>Potrzebna ci będzie karta dźwiękowa, zdolna do obsługi AC3, z cyfrowym
 wyjściem (SP/DIF). Sterownik karty dźwiękowej musi obsługiwać format AFMT_AC3
-(tak, jak to jest w SB Live!). Połącz swój dekoder AC3 do wyjścia SP/DIF oraz
-użyj opcji '-ac hwac3'. To może zadziałać, bądź nie (status eksperymentalny -
-najprawdopodobniej nie zadziała).</P>
+(tak, jak to robi SB Live, albo C-Media!). Połącz swój dekoder AC3 do wyjścia
+SP/DIF oraz użyj opcji '-ac hwac3'. To może zadziałać, bądź nie (status
+eksperymentalny - najprawdopodobniej aktualnie będzie działać tylko z kartami
+C-Media, masz wolną rękę w naprawieniu tego dla SB Live).</P>
 
 
 <P><B><A NAME=2.2.2.3>2.2.2.3. Obsługa libmad</A></B></P>
diff --git a/DOCS/Polish/documentation.html b/DOCS/Polish/documentation.html
index 5931a4001f..1baf733ef2 100644
--- a/DOCS/Polish/documentation.html
+++ b/DOCS/Polish/documentation.html
@@ -276,16 +276,16 @@ jest aktualnie niemożliwe, zarówno ze względów <B>technicznych</B>, jak i
 zalecane, w drugiej części <A HREF="users_against_developers.html#binary">tego
 pliku</A>.</P>
 
-<P>Nie napisałem żadnych kodeków, tylko kilka odgrywarek. Spędziłem wiele
-czasu poszukując najlepszego sposobu, aby rozkodować złe, uszkodzone pliki
-wejściowe (zarówno MPEG jak i AVI) oraz by zrobić perfekcyjną synchronizację
-A-V z możliwością przeszukiwania. Moja odgrywarka jest wybitnie dobra w
-odgrywaniu uszkodzonych plików MPEG (co jest użyteczne w pewnych VCD), a także
-odgrywa złe pliki AVI, których nie potrafi odtworzyć słynny windows media
-player. Nawet pliki AVI bez indeksowania są odgrywane i możesz dodatkowo
-przebudować ich indeksowanie za pomocą opcji -idx, co umożlliwia przeszukiwanie.
-Jak widzisz, stabilność i jakość, to rzeczy dla mnie najważniejsze, ale
-prędkość jest również zadziwiająca.</P>
+<P>Nie napisałem żadnych kodeków, tylko kilka odgrywarek. Spędziłem wiele czasu
+poszukując najlepszego sposobu, aby rozkodować złe, uszkodzone pliki wejściowe
+(zarówno MPEG jak i AVI) oraz by zrobić perfekcyjną synchronizację A-V z
+możliwością przeszukiwania. Moja odgrywarka jest wybitnie dobra w odgrywaniu
+uszkodzonych plików MPEG (co jest użyteczne w pewnych VCD), a także odgrywa złe
+pliki AVI, których nie potrafi odtworzyć słynny windows media player. Nawet
+pliki AVI bez indeksowania są odgrywane i możesz tymczasowo przebudować ich
+indeksy za pomocą opcji -idx, albo na stałe, za pomocą <B>MEncoder</B>, co
+umożlliwia przeszukiwanie.  Jak widzisz, stabilność i jakość, to rzeczy dla
+mnie najważniejsze, ale prędkość jest również zadziwiająca.</P>
 
 <P><B><A NAME=1.2>1.2. Historia</A></B></P>
 
@@ -457,7 +457,8 @@ zwieksza go!), dzięki czemu masz bardzo szybkie pełnoekranowe odtwarzanie.</P>
 zwiększenia prędkości, zobacz sekcję <A HREF="video.html#2.3.1.7">mga_vid</A>.
 Ważne jest, aby wykonać te kroki <I>zanim</I> skompilujesz <B>MPlayera</B>, w
 przeciwnym razie żadne specjalne wsparcie dla Matroxa nie zostanie zbudowane.
-Zobacz również sekcję <A HREF="video.html#2.3.1.A.1">Matrox TV-out</A>.</LI>
+Zobacz również sekcję <A HREF="video.html#2.3.1.A.1">Matrox TV-out</A>.
+<U><B>Jeżeli nie jesteś użytkownikiem Linuksa</B></U>, przeczytaj dokumentację <A HREF="video.html#2.3.1.15">Vidix</A>!</LI>
 
 <LI><B>Karty 3Dfx Voodoo3/Banshee</B>: w celu uzyskania dużego zwiększenia
 prędkości, zobacz sekcję <A HREF="video.html#2.3.1.9">2.3.1.9</A>. Ważne jest,
@@ -470,6 +471,8 @@ ATI</A> z dokukmentacji TV-out, aby się dowiedzieć, jakie właściwości twojej
 karty są obsługiwane pod Linuksem/MPlayerem. Jeżeli masz kartę <B>Radeon</B>
 lub <B>Rage128</B>, mamy dla ciebie sterownik <B>XXX_vid</B>, z wyjściem TV!
 Sprawdź <A HREF="video.html#2.3.1.14">tą</A> sekcję!</LI>
+<U><B>Jeżeli nie jesteś użytkownikiem Linuksa</B></U>, przeczytaj dokumentację
+<A HREF="video.html#2.3.1.15">Vidix</A>!</LI>
 
 <LI><B>Karty S3</B>: chipy Savage posiadają akcelerację sprzętową. Używaj tak
 nowej wersji XFree86, jak to tylko możliwe. Starsze sterowniki zawierają błędy.
@@ -815,7 +818,7 @@ zastosuj opcję <CODE>-vo sdl</CODE>). Możesz to wyspecyfikować za pomocą opcji
   <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>w jakim
   formacie wyjściowym tuner powinien przetransportować obrazy do nas
   (<B>rgb32</B>, <B>rgb24</B>, <B>yv12</B>, <B>uyvy</B>, <B>i420</B> (dla i420
-  musisz podać opcję <CODE>-vc i420</CODE>, z powodu konfliktu fourcc))</TD>
+  musisz podać opcję <CODE>-vc rawi420</CODE>, z powodu konfliktu fourcc))</TD>
 </TR>
 <TR>
   <TD>&nbsp;&nbsp;</TD>
@@ -1627,6 +1630,11 @@ użytkowników Mplayera</P>
 <UL>
   <LI>Dekoder open source QT RPZA</LI>
 </UL></LI>  
+<LI><B><A HREF="mailto:wojtekka@bydg.pdi.net">Wojtek Kaniewski</A></B>
+<UL>
+  <LI>Obsługa kółka myszki</LI>
+</UL></LI>
+
 </UL></P>
 
 <P>Główni testerzy:</P>
@@ -1671,7 +1679,8 @@ uzyskanie YUV za pomocą VfW...
 <UL><LI>autorzy kodeków OpenDivX</LI></UL>
 
 </LI><LI>Michael Hipp:
-<UL><LI>autor mpglib  [nie jest uzywany wprost, ael w pewnych częściach w mp3lib]
+<UL><LI>autor mpglib  [nie jest używany wprost, ale w pewnych częściach w
+mp3lib]
 </LI></UL>
 
 </LI><LI>Mark Podlipec:
@@ -1684,8 +1693,8 @@ uzyskanie YUV za pomocą VfW...
 </LI></UL>
 </LI></UL></P>
 
-<P>Ich kod nie jest używany w obecnej wersji odgrywarki, ale otrzymuję pewne pomysły
-i techniczne wsparcie z ich strony: </P>
+<P>Ich kod nie jest używany w obecnej wersji odgrywarki, ale otrzymuję pewne
+pomysły i techniczne wsparcie z ich strony: </P>
 
 <P><UL>
 <LI>John F. McGowan   http://www.jmcgowan.com/
@@ -1829,7 +1838,7 @@ HREF="http://mplayerhq.hu/mailman/listinfo/mplayer-users">http://mplayerhq.hu/ma
 <LI>raporty o błędach (ale po przeczytaniu sekcji <A HREF="#D">Znane błędy</A>
 i Dodatku <A HREF="#C">C</A>)</LI>
 <LI>żądania na przyszłość (po przeczytaniu CAŁEJ tej dokumentacji)</LI>
-<LI>własne pytania (po przeczytaniu całej tej dokumentacji)</LI>
+<LI>własne pytania (po przeczytaniu CAŁEJ tej dokumentacji)</LI>
 </UL></P>
 
 </LI><LI>Węgierska lista użytkowników MPlayera:<BR>
diff --git a/DOCS/Polish/gcc-2.96-3.0.html b/DOCS/Polish/gcc-2.96-3.0.html
index 64fb88e096..e607256126 100644
--- a/DOCS/Polish/gcc-2.96-3.0.html
+++ b/DOCS/Polish/gcc-2.96-3.0.html
@@ -21,6 +21,15 @@ GCC.</A>
 <B>Odpowiedź:</B>
 </P>
 
+<P>Przeczytaj w dokumentacji MySQL:</P>
+<P><I> Wskazówki do kompilatora: Kilku z naszych użytkowników zgłosiło losowe
+zwisy i uszkodzenie tablicy w binariach MySQL, kompilowanych z gcc
+dwa-kropka-dziewięć-sześć na platformie x86 Linux. Chociaż nie byliśmy w stanie
+zduplikować tego problemu sami, albo zrozumieć jego właściwej przyczyny,
+podejrzewamy, że, z dużym stopniem prawdopodobieństwa, można powiązać ten
+problem z kompilatorem. Zamieniając błędne binaria na nasze własne, zawsze
+eliminowaliśmy ten problem.  </I></P>
+
 <P>
 A dla ludzi, którzy regularnie pytają, jakie są dokładnie problemy z gcc 2.96,
 moja odpowiedź brzmi: <I>nie wiemy dokładnie.</I> Są różne problemy i coraz