annotate DOCS/Polish/BUGREPORTS @ 3357:1fa5d7dda911

libmp3lame optional

Jak zgłaszać błędy ? 
~~~~~~~~~~~~~~~~~~~~~~ 
Po pierwsze przeczytaj DOCS/BUGS i inne dokumenty. Jeżeli twój problem nie jest
znany lub nie rozwiązują go nasze instrukcje, wtedy zgłoś błąd : 
 
Gdzie? 
====== 
Zapisz się na listę użytkowników mplayera : 

	http://lists.Sourceforge.Net/lists/listinfo/mplayer-users

oraz wyślij swój raport do: 

	[e-mail]

Nie odpiszemy bezpośrednio więc pamiętaj, aby najpierw zasubskrybować listę.
 
Nie wysyłaj raportów o błędach prywatnie, bezpośrednio na adres autora!!!
Pracujemy wspólnie nad kodem, więc wszyscy są zainteresowani.
Swoją drogą, często inni użytkownicy znają rozwiązanie (problemy z konfiguracją
systemu, złe sterowniki itd.), nawet kiedy my myślimy, że to błąd w kodzie.
Językiem tej listy jest ANGIELSKI!
 
Proszę, opisz twój problem ze szczegółami, podaj przykłady itd. i nie zapomnij
dołączyć:

CO?
===

1. Informacja o systemie.

- dystrybucja linuxa
np.:
    RedHat 7.1, Slackware 7.0 + pakiety developerskie z 7.1 ...
- wersja jądra
	uname -a
- wersje bibliotek 
	ls -l /lib/libc[.-]*
- wesja X-ów
	X -version
- wersja gcc i ld
	gcc -v
	ld -v
- wersja binutils
	as --version

2 . Sprzęt i sterowniki : 
- informacja o procesorze
	cat /proc/cpuinfo 
- producent i model karty video
np. : 
	Asus V3800U chip : nVidia TNT2 Ultra pro 32MB SDRAM 
	Matrox G400 DH 32MB SGRAM 
- typ i wersja sterownika video
np.:	
	X wbudowany sterownik 
	nvidia 0.9.623 
	Utah Glx Cvs 2001-02-17 
	DRI z X 4.0.3
- typ i sterownik karty dźwiękowej
np.:	
	Creative SBLive! Gold ze sterownikiem OSS z oss.creative.com
	Creative SB16 ze sterownikami OSS z jądra
	GUS PnP z emulacja OSS ALSA
	
- jeśli nie jesteś pewien, dołącz wynik wykonania lspci -v 

Problemy z kompilacją:
~~~~~~~~~~~~~~~~~~~~~~ 
3 . Wyjście configure/make : 
	make distclean 
	. /configure &>config.log
	. /make &>make.log
4. oraz te pliki:
	config.h
	config.mak
	libvo/config.mak
 
Problemy z odgrywaniem: 
~~~~~~~~~~~~~~~~~~~~~~ 
3 . Wyjscie mplayera z opcją -v
	mplayer -v [opcje] nazwa.pliku &> mplayer.log
 
4 . Jeżeli problem jest specyficzny dla jednego lub kilku plików, prześlij te
pliki na adres:
	ftp://mplayer.dev.hu/MPlayer/incoming
Zwykle pierwsze 1-5 Mb wystarczy do powielenia problemu ale najpierw
powinieneś to sprawdzić:
	dd if=twój.plik of=maly.plik bs=1k count=1024 
( wytnie to pierwszy megabajt z twój.plik i zapisze do maly.plik )
Spróbuj jeszcze raz na tym małym pliku i jeśli problem ponownie wystąpi, to
znaczy że wystarczy wysłać mały plik.
NIGDY nie wysyłaj takich plików pocztą! Załaduj go przez ftp a na liste wyślij
tylko ścieżkę/nazwę pliku. Jeżeli plik jest dostępny przez sieć, wyślij
_dokładny_ URL do niego.
   
5. W przypadku przerwań w działaniu programu ( segfault, SIGILL, sygnał 4
itd.): 
    
Jeżeli masz coredump po tym zdarzeniu, patrz 5.a, jeśli nie patrz 5.b: 
     
5.a  Wydrukuj nam coredump ( jeżeli został stworzony ). 

Utwórz następujący skrypt:
      
disass $eip-32 $eip+32
printf "eax=%08lX\n",$eax
printf "ebx=%08lX\n",$ebx
printf "ecx=%08lX\n",$ecx
printf "edx=%08lX\n",$edx
printf "esp=%08lX\n",$esp
printf "ebp=%08lX\n",$ebp
printf "edi=%08lX\n",$edi
printf "esi=%08lX\n",$esi


Później po prostu wykonaj następujące polecenie:
	gdb mplayer --core=core -batch --command=command_file >mplayer.bug
        
5.b.: Uruchom MPlayera w gdb:
[ w shellu roota/użytkownika: ] 
# gdb mplayer 
[ prompt gdb : ] 
	> run -v [options-to-mplayer] filename
	. ( czekaj aż huknie ) 
	> bt 
	> disass $eip-32 $eip+32 
I wyślij nam wyjście z tego co powyższe!
	 
Ogólnie:
~~~~~~~~
Jeśli coś jest duże (logi itd.), wtedy lepiej załadować to przez ftp
(zgzipowane), oraz dołączyć jedynie ścieżkę/nazwę pliku w raporcie!

(poprawione przez nell)