mpv/DOCS/pl/bugreports.html

293 lines
12 KiB
HTML
Raw Normal View History

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML>
<HEAD>
<TITLE>Zg<EFBFBD>aszanie b<><62>d<EFBFBD>w - MPlayer - Odtwarzacz Film<6C>w dla Linuksa</TITLE>
<LINK REL="stylesheet" TYPE="text/css" HREF="../default.css">
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-2">
</HEAD>
<BODY>
<H1><A NAME="appendix_b">Dodatek B - Jak zg<7A>asza<7A> b<><62>dy</A></H1>
<P>Dobry raport o b<><62>dzie jest bardzo warto<74>ciowym wk<77>adem w rozw<7A>j ka<6B>dego
z projekt<6B>w oprogramowania. Ale tak jak pisanie dobrego oprogramowania, tak
dobry raport problemu wymaga troch<63> pracy. Prosimy, o zrozumienie, <20>e wi<77>kszo<7A><6F>
programist<73>w to ludzie ekstremalnie zaj<61>ci i otrzymuj<75> nieprzyzwit<69> ilo<6C>c e-maili.
Wi<57>c, dop<6F>ki twoja reakcja jest decyduj<75>ca w poprawianiu MPlayera i bardzo doceniana,
prosimy zrozum, <20>e musisz dostarczy<7A> <B>wszystki</B> informacje kt<6B>rych wymagamy
i wykonyea<65> wszystkie polecenia zaarte w tym dokumencie.</P>
<H2><A NAME="fix">B.1 Jak naprawia<69> b<><62>dy</A></H2>
<P>Je<EFBFBD>eli czyjesz, <20>e masz wystarczaj<61>ce umiej<65>tno<6E>ci, jeste<74> zaproszony do
naprawienia b<><62>du w<>asnor<6F>cznie. Mo<4D>e ju<6A> to zrobi<62>e<EFBFBD>? Prosimy, przeczytaj
<A HREF="../tech/patches.txt">ten kr<6B>tki dokument</A> by dowiedzie<69> sie, jak
doda<64> tw<74>j kod do MPlayera. Ludzie na grupie duskusyjnej
<A HREF="http://mplayerhq.hu/mailman/listinfo/mplayer-dev-eng">mplayer-dev-eng</A>
pomog<6F> ci, je<6A>eli b<>dziesz mia<69> jakie<69> pytania.</P>
<H2><A NAME="report">B.2 Jak zg<7A>asza<7A> b<><62>dy</A></H2>
<P>Po pierwsze, wypr<70>buj najnowszej wersji MPlayera z CVSa, mo<6D>liwe <20>e tw<74>j
b<><62>d zosta<74> ju<6A> tam naprawiony. Programi<6D>ci poruszaj<61> si<73> naprawd<77> szybko,
wi<77>kszo<7A><6F> problem<65>w z oficjalnego wydania jest raportowane w przeci<63>gu dni
lub nawet godzin, wi<77>c prosimy o u<>ywanie <B>tylko CVS</B> do raportowania
b<><62>d<EFBFBD>w. Dotyczy to tak<61>e pakiet<65>w binarnych MPlayera. Prosimy o nieraportowanie
b<><62>d<EFBFBD>w z r<><72>nych pakiet<65>w RPM lub Debiana. Instrukcj<63> do CVS mo<6D>na znale<6C><65> na dole
<A HREF="http://www.mplayerhq.hu/homepage/dload.html">tej strony</A> lub w
README. Je<4A>eli to nie pomog<6F>o, przeczytaj
<A HREF="documentation.html#known_bugs">list<EFBFBD> znanych b<><62>d<EFBFBD>w</A> i pozosta<74><61>
cz<63><7A><EFBFBD> dokumentacji. Je<4A>li tw<74>j problem nie jest znany lub nasze instrukcje
nie rozwi<77>zuj<75> problemu, wtedy prze<7A>lij raport o b<><62>dzie.</P>
<P>prosimy o nie przesy<73>anie raport<72>w o b<>edach bezpo<70>rednio do programistow.
Pracujemy zbiorowo, tak wi<77>c wielu u<>ytkownik<69>w mo<6D>e si<73> zainteresowa<77> tym problemem.
Czasami inni u<>ytkownicy, maj<61>cy do<64>wiadczenie z twoim k<>opotem, wiedz<64> jak
omin<69><6E> problem, nawet je<6A>eli jest to b<><62>d w kodzie MPlayera.</P>
<P>Prosimy, opisz sw<73>j problem mo<6D>liwie najdok<6F>adniej. Wykonaj ma<6D>e dochodzenie
by znale<6C><65> okoliczno<6E>ci, w kt<6B>rych problem si<73> pojawia. Mo<4D>e b<><62>d pojawia si<73>
tylko w oktre<72>lonych sytuacjach? Wyst<73>puje ze pojedy<64>czym plikiem lub typem
plik<69>w? Wyst<73>puje tylko z jednym kodekiem lub niezale<6C>nie od kodeka? Mo<4D>esz
powt<77>rzy<7A> b<><62>d ze wszystkimi sterownikami wyj<79>cia? Im wi<77>cej informacji dostarczysz,
tym wi<77>ksze szanse na naprawienie twojego problemu. Prosimy, nie zapomnij umie<69>ci<63>
wymaganych cennych inforamcji (patrz ni<6E>ej), w przeciwnym wypadku, nie b<>dziemy
w stanie porawnie zdiagnowzowa<77> twojego problemu.</P>
<P><EFBFBD>wietne i dobrze napisany poradnik zadawania pyta<74> w publicznych forach dyskusyjnych to
<A HREF="http://www.catb.org/~esr/faqs/smart-questions.html">How To Ask Questions The Smart Way</A>
(Jak Zadawa<77> Pytania W M<>dry Spos<6F>b) autorstwa <A HREF="http://www.catb.org/~esr/">Eric S. Raymond</A>.
Jest te<74> inny nazwany
<A HREF="http://www.chiark.greenend.org.uk/~sgtatham/bugs.html">How to Report Bugs Effectively</A>
(Jak Efektywnie Raportowa<77> B<><42>dy) autorstwa <A HREF="http://www.chiark.greenend.org.uk/~sgtatham/">Simon Tatham</A>.
artyku<6B> w j<>zyku polskim to
<A HREF="http://rtfm.bsdzine.org/">Jak m<>drze zadawa<77> pytania</A>
Je<4A>eli b<>dziesz post<73>powa<77> zgodnie z tymi przewodnikami powiniene<6E> uzyska<6B> pomoc.
Ale zrozum, <20>e my wszyscy odpowiadamy na grupie dyskusyjnej w formie wolontariatu
po<70>wi<77>caj<61>c nasz wolny czas. Jeste<74>my bardzo zaj<61>ci i nie mo<6D>emy gwarantowa<77>, <20>e
rozwi<77><69>emy tw<74>j proble, lub nawet odpowiemy na tw<74>j list.</P>
<H2><A NAME="where">B.3 Gdzie zg<7A>asza<7A> b<><62>dy</A></H2>
<P>Zapisz si<73> na grup<75> dyskusyjn<6A> mplayer-users:<BR>
&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="http://mplayerhq.hu/mailman/listinfo/mplayer-users">http://mplayerhq.hu/mailman/listinfo/mplayer-users</A><BR>
i wy<77>lij sw<73>j raport o b<><62>dzie do:<BR>
&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="mailto:mplayer-users@mplayerhq.hu">mplayer-users@mplayerhq.hu</A></P>
<P>J<EFBFBD>zykiem grupy jest <B>Angielski</B>. Prosimy o dostosowanie sie do standardu
<A HREF="http://www.ietf.org/rfc/rfc1855.txt">Netiquette Guidelines</A> i
<B>nie wysy<73>a<EFBFBD> e-maili w HTML</B> do kt<6B>rej kolwiek z naszy<7A> grup dyskusyjnych.
Zostaniesz po prostu zignorowany lub zbanowany. Je<4A>li nie wiesz co to jest e-mail
w HTML lub dlaczego jest z<>y, przeczytaj ten <A HREF="http://expita.com/nomime.html"><EFBFBD>wietny dokument</A>.
Wyja<6A>nia wszystkie detale i daje instrukcje, jak wy<77><79>czy<7A> HTML. Ponad to zauwa<77>,
<20>e nie b<>dziemy odpowiada<64> indywiduaknie CC (carbon-copy), tak wi<77>c jest dobrym pomys<79>em
zasubskrybowa<77> grup<75>, by odebra<72> odpowied<65> na sw<73>j list.</P>
<H2><A NAME="what">B.4 Co raportowa<77></A></H2>
<P>By<EFBFBD> mo<6D>e, <20>e b<>dziesz musia<69> za<7A><61>czy<7A> plik log, konfiguracj<63> lub pr<70>bk<62> pliku
w swoim raporcie o b<><62>dzie. Je<4A>eli b<>dzie on do<64>c spory, wtedy lepiej b<>dzie,
gdy prze<7A>lesz go na nasz <A HREF="ftp://mplayerhq.hu/MPlayer/incoming/">serwer FTP</A>
w skompresowanym formacie (preferowany gzip i bzip2) i do<64><6F>cz tylko <20>cie<69>k<EFBFBD> i nazw<7A>
pliku do twojego raportu o b<><62>dzie. Nasze grupa dyskusyjna ma ograniczeni rozmiaru
wiadomo<6D>ci na 80k, je<6A>eli masz co<63> wi<77>kszego, musisz to skompresowa<77> lub wys<79>a<EFBFBD> na
serwer.</P>
<H3><A NAME="system">B.4.1 Informacje o systemie</A></H3>
<UL>
<LI>Twoja dystrybcje Linuksa lub system operacyjny i wersja np.:
<UL>
<LI>Red Hat 7.1</LI>
<LI>Slackware 7.0 + devel packs from 7.1 ...</LI>
</UL>
</LI>
<LI>wersja kernela:<BR>
<CODE>uname -a</CODE></LI>
<LI>wersja libc:<BR>
<CODE>ls -l /lib/libc[.-]*</CODE></LI>
<LI>wersja X:<BR>
<CODE>X -version</CODE></LI>
<LI>wersje gcc i ld:<BR>
<CODE>gcc -v<BR>
ld -v</CODE></LI>
<LI>wersja binutils:<BR>
<CODE>as --version</CODE></LI>
<LI>Je<EFBFBD>li masz problemy z trybem pe<70>noekranowym:
<UL>
<LI>Typ i wersja menad<61>era okien</LI>
</UL>
</LI>
<LI>Je<EFBFBD>li masz problemy z XVIDIX:
<UL>
<LI>g<EFBFBD>ebia kolor<6F>w w X:<BR>
<CODE>xdpyinfo | grep "depth of root"</CODE></LI>
</UL>
</LI>
<LI>Je<EFBFBD>eli tylko GUI jest z b<><62>dem:
<UL>
<LI>wersja GTK</LI>
<LI>wersja GLIB</LI>
<LI>wersja libpng</LI>
<LI>sytuacja GUI, w kt<6B>rej b<><62>d wyst<73>pi<70></LI>
</UL>
</LI>
</UL>
<H3><A NAME="hardware">B.4.2 Sprz<72>t i sterowniki</A></H3>
<UL>
<LI>Informacja o CPU (dzia<69>a tylko z Linuksem):<BR>
<CODE>cat /proc/cpuinfo</CODE></LI>
<LI>Producent i model karty graficznej, np.:
<UL>
<LI>ASUS V3800U chip: nVidia TNT2 Ultra pro 32MB SDRAM</LI>
<LI>Matrox G400 DH 32MB SGRAM</LI>
</UL>
</LI>
<LI>Typ sterownika wideo &amp; wersja, np.:
<UL>
<LI>wbudowany sterownik X</LI>
<LI>nVidia 0.9.623</LI>
<LI>Utah-GLX CVS 2001-02-17</LI>
<LI>DRI z X 4.0.3</LI>
</UL>
</LI>
<LI>Typ karty d<>wi<77>kowej &amp; sterownik, np.:
<UL>
<LI>Creative SBLive! Gold ze sterownikiem OSS z oss.creative.com</LI>
<LI>Creative SB16 ze sterownikiem OSS z kernela</LI>
<LI>GUS PnP z emulacj<63> OSSw ALSA</LI>
</UL>
</LI>
<LI>W razie w<>tpliwo<77>ci do<64><6F>cz wyj<79>cie z <CODE>lspci -vv</CODE> w systemie Linux.</LI>
</UL>
<H3><A NAME="configure">B.4.3 Configure problems</A></H3>
<P>Je<EFBFBD>eli do<64>wiadczysz b<><62>d<EFBFBD>w podczas uruchamiania <CODE>./configure</CODE> lub autodetekcja
czego<67> nie wykryje, przeczytaj <CODE>configure.log</CODE>. Mo<4D>e znajdziesz tam odpowied<65>,
dla przyk<79>adu, kilka wersji tej samej biblioteki wymiesza<7A>o si<73> w twoim systemie,
lub zapomnia<69>e<EFBFBD> zainstalowa<77> pakiety deweloperskie (kt<6B>re maj<61> przyrostek -dev). Je<4A>eli s<>dzisz,
<20>e to b<><62>d, do<64><6F>cz <CODE>configure.log</CODE> do twojego raportu o b<><62>dzie.</P>
<H3><A NAME="compilation">B.4.4 Problemy z kompilacj<63></A></H3>
Prosimy o do<64><6F>czenie tych plik<69>w:
<UL>
<LI><CODE>config.h</CODE></LI>
<LI><CODE>config.mak</CODE></LI>
</UL>
Tylko je<6A>eli kompilacja nie powodzi si<73> w jednym z tych katalog<6F>w, do<64><6F>cz te pliki:
<UL>
<LI><CODE>Gui/config.mak</CODE></LI>
<LI><CODE>libvo/config.mak</CODE></LI>
<LI><CODE>libao2/config.mak</CODE></LI>
</UL>
<H3><A NAME="playback">B.4.5 Problemy z odtwarzaniem</A></H3>
<P>Prosimy, do<64><6F>cz wyj<79>cie MPlayera za 1 poziomie gadatliowo<77>ci, ale pami<6D>taj
<B>nie przycinaj wyj<79>cia</B> podczas wlejania go do twojego listu.
Programi<6D>ci potrzebuj<75> wszystkich komunikat<61>w by poprawnie zdiagnozowa<77> problem.
Mo<4D>esz przekierowa<77> wyj<79>cie do pliku komend<6E> podobn<62> do:</P>
<P><CODE>&nbsp;&nbsp;&nbsp;&nbsp;mplayer -v [opcje] [nazwa_pliku] &gt; mplayer.log 2&gt;&amp;1</CODE></P>
<P>Je<EFBFBD>eli tw<74>j proble jest specyficzny dla jednego lub wi<77>cej plik<69>w, wtedy
prze<7A>lij go (je) na:</P>
<P>&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="ftp://mplayerhq.hu/MPlayer/incoming/">ftp://mplayerhq.hu/MPlayer/incoming/</A></P>
<P>Ponad to prze<7A>lij ma<6D>y plik tekstowy zawieraj<61>cy t<> sam<61> nazw<7A> podstawow<6F> co tw<74>j plik,
tyle <20>e z rozszerzeniem .txt. Opisz problem kt<6B>ry wyst<73>puje z danym plikiem
i do<64><6F>cz tw<74>j adres e-mail i najlepiej jeszcze wyj<79>cie MPlayera na 1 poziomie
gadatliwo<77>ci. Zazwyczaj pierwsze 1-5 MB pliku wystarcza na odtworzenie problemu,
ale dla pewno<6E>ci prosimy ci<63> o:</P>
<P><CODE>&nbsp;&nbsp;&nbsp;&nbsp;dd if=tw<74>j_plik of=ma<6D>y_plik bs=1024k count=5</CODE></P>
<P>Wytnie to pierwsze pi<70><69> megabajt<6A>w z <STRONG>'tw<74>j_plik'</STRONG> i zapisze
to do <STRONG>'ma<6D>y_plik'</STRONG>. Potem wypr<70>buj ma<6D>y plik, je<6A>eli b<><62>d
dalej si<73> pojawia, pr<70>bka jest dla nas wystarczaj<61>ca. Prosimy,
<STRONG>nigdy</STRONG> nie wysy<73>aj takich plik<69>w przez e-mail! Wy<57>lij na serwer,
i podaj tylko <20>cie<69>k<EFBFBD>/nazw<7A> pliku na serwerze FTP. Je<4A>li plik jest dost<73>pny przez
Internet, wys<79>any <STRONG>dok<EFBFBD>adny</STRONG> URL jest wystarczaj<61>cy.</P>
<H3><A NAME="crash">B.4.6 Wywalenie si<73> programu (ang. crashe)</A></H3>
<P>Musisz uruchomi<6D> MPlayera wewn<77>trz <CODE>gdb</CODE> i wys<79>a<EFBFBD> nam kompletne
wyj<79>cie lub je<6A>eli masz zrzut rdzenia (ang. core dump) po wywaleniu si<73>, mo<6D>esz wyci<63>gn<67><6E> u<>yteczne
informacje z pliku <CODE>Core</CODE>. Poni<6E>ej pokazano jak:</P>
<H4><A NAME="debug">B.4.6.1 Jak przechowa<77> informacje powtarzalnym wywaleniu si<73></A></H4>
Przekompiluj MPlayera z w<><77>czon<6F> obs<62>ug<75> debugowania:
<P><CODE>&nbsp;&nbsp;&nbsp;&nbsp;./configure --enable-debug=3<BR>
&nbsp;&nbsp;&nbsp;&nbsp;make</CODE></P>
i uruchom MPlayer wewn<77>trz db u<>ywaj<61>c:
<P><CODE>&nbsp;&nbsp;&nbsp;&nbsp;gdb ./mplayer</CODE></P>
Jeste<EFBFBD> teraz w gdb. Wpisz:
<P><CODE>&nbsp;&nbsp;&nbsp;&nbsp;run -v [opcje_dla_MPlayera] nazwa_pliku</code></P>
i powt<77>rz "wywa<77>k<EFBFBD>". Wkr<6B>tce po tymm ajk to zrobisz, gdb zwr<77>ci
ci dost<73>p do lini komend gdzie musisz wprowadzi<7A>
<P><CODE>&nbsp;&nbsp;&nbsp;&nbsp;bt<BR>
&nbsp;&nbsp;&nbsp;&nbsp;disass $pc-32 $pc+32<BR>
&nbsp;&nbsp;&nbsp;&nbsp;info all-registers</CODE></P>
<H4><A NAME="core">B.4.6.2 Jak wydoby<62> sensowne informacje z zrzutu rdzenia (ang. core dump)</A></H4>
<P>Prosimy, stw<74>rz podany plik rozkazowy (skrypt):</P>
<P><CODE>bt<BR>
disass $pc-32 $pc+32<BR>
info all-registers</CODE></P>
<P>Potem po prostu uruchom podan<61> komend<6E>:</P>
<P>&nbsp;&nbsp;&nbsp;&nbsp;<CODE>gdb mplayer --core=core -batch --command=command_file &gt; mplayer.bug</CODE></P>
<H2><A NAME="advusers">B.5 Wiem co robie...</A></H2>
<P>Je<EFBFBD>li stworzy<7A>e<EFBFBD> poprawny raport o b<><62>dzie, post<73>puj<75>c zgodnie z podanymi
wskaz<61>wkami oraz jeste<74> pewien, <20>e to b<><62>d mplayera, nie kompilatora, czy
zepsutego pliku, przeczyta<74>e<EFBFBD> dokumentacj<63> i nadal nie znalaz<61>e<EFBFBD> rozwi<77>zania,
a twoje sterowniki karty d<>wi<77>kowej s<> w porz<72>dku, w<>wczas mo<6D>esz zasubskrybowa<77>
list<73> dyskusyjn<6A> mplayer-advusers i wys<79>a<EFBFBD> sw<73>j raport, aby dosta<74> szybsz<73>
i lepsz<73> odpowied<65>.<BR><BR>
Prosimy o rozwag<61>. bo je<6A>eli wy<77>lesz pytanie w stylu pocz<63>tkuj<75>cego lub
pytanie na kt<6B>re jest odpowied<65> w manualu, wtedy zostaniesz zignorowany
lub obra<72>ony zamiast otrzymania w<>a<EFBFBD>ciwej odpowiedzi.<BR>
Wi<57>c nie obra<72>aj nas i zasubskrybuj -advusers tylko je<6A>eli naprawd<77> wiesz
co robisz i czyjesz si<73> jakby<62> by<62> zaawansowanym u<>ytkownikiem MPlayera lub
programist<73>. Je<4A>eli spe<70>niasz te kryteria, nie powinno by<62> dla ciebie k<>opotem
znalezienie sposobu, jak si<73> zasubskrybowa<77>..</P>
</BODY>
</HTML>