mpv/DOCS/xml/cs/bugreports.xml

348 lines
13 KiB
XML
Raw Normal View History

<?xml version="1.0" encoding="iso-8859-2"?>
<!-- Synced with: 1.11 -->
<appendix id="bugreports">
<title>Jak hl<68>sit chyby</title>
<para>
Dobr<EFBFBD> hl<68><6C>en<65> chyb jsou velmi cenn<6E>m p<><70>sp<73>vkem do v<>voje jak<61>hokoli
softwarov<EFBFBD>ho projektu. Ale je to s nimi jako se psan<61>m dobr<62>ho
programu, seps<70>n<EFBFBD> dobr<62>ho hl<68><6C>en<65> probl<62>mu vy<76>aduje trochu pr<70>ce.
Pros<EFBFBD>m berte na v<>dom<6F>, <20>e v<>t<EFBFBD>ina v<>voj<6F><6A><EFBFBD> je velmi zanepr<70>zdn<64>na a
dost<EFBFBD>v<EFBFBD> kvanta e-mail<69>. Tak<61>e a<>koli je va<76>e zp<7A>tn<74> vazba kritick<63> pro
vylep<EFBFBD>ov<EFBFBD>n<EFBFBD> <application>MPlayer</application>u a velmi cen<65>n<EFBFBD>, pros<6F>me
pochopte, <20>e mus<75>te poskytnout <emphasis role="bold">ve<EFBFBD>ker<EFBFBD></emphasis>
informace kter<65> po<70>adujeme a postupovat p<>esn<73> podle instrukc<6B> v tomto
dokumentu.
</para>
<sect1 id="bugreports_fix">
<title>Jak napravovat chyby</title>
<para>
Pokud si mysl<73>te, <20>e m<>te pot<6F>ebn<62> schopnosti, pak v<>s vyb<79>z<EFBFBD>me abyste
opravil(a) chybu samostatn<74>. Nebo jste to ji<6A> ud<75>lal(a)? P<>e<EFBFBD>t<EFBFBD>te si pros<6F>m
<ulink url="../../tech/patches.txt">tento kr<6B>tk<74> dokument</ulink>, abyste se
dozv<EFBFBD>d<EFBFBD>li jak zahrnout v<><76> k<>d do <application>MPlayer</application>u.
Lid<EFBFBD> z konference
<ulink url="http://mplayerhq.hu/mailman/listinfo/mplayer-dev-eng">MPlayer-dev-eng</ulink>
v<EFBFBD>m pomohou, pokud budete m<>t ot<6F>zky.
</para>
</sect1>
<sect1 id="bugreports_report">
<title>Jak oznamovat chyby</title>
<para>
Nejprve, pros<6F>m, vyzkou<6F>ejte posledn<64> CVS verzi
<application>MPlayer</application>u, jeliko<6B> va<76>e chyba ji<6A> mohla b<>t
odstran<EFBFBD>na. V<>voj je velmi rychl<68>, v<>t<EFBFBD>ina chyb v ofici<63>ln<6C>ch bal<61><6C>c<EFBFBD>ch je
nahl<EFBFBD><EFBFBD>ena b<>hem n<>kolika dn<64>, nebo dokonce hodin, tak<61>e pros<6F>m pou<6F><75>vejte
<emphasis role="bold">pouze CVS</emphasis> pro hl<68><6C>en<65> chyb. To zahrnuje bin<69>rn<72>
bal<EFBFBD><EFBFBD>ky <application>MPlayer</application>u. CVS instrukce naleznete na konci
<ulink url="http://www.mplayerhq.hu/homepage/dload.html">t<EFBFBD>to str<74>nky</ulink>,
nebo v souboru README. Pokud to nepom<6F><6D>e, prostudujte si pros<6F>m seznam
<link linkend="bugs">zn<EFBFBD>m<EFBFBD>ch chyb</link> a zbytek dokumentace. Pokud je v<><76>
probl<EFBFBD>m nezn<7A>m<EFBFBD> nebo jej nelze <20>e<EFBFBD>it pomoc<6F> na<6E>ich instrukc<6B> pak jej nahlaste
jako chybu.
</para>
<para>
Pros<EFBFBD>me, nepos<6F>lejte hl<68><6C>en<65> chyb soukrom<6F> jednotliv<69>m v<>voj<6F><6A><EFBFBD>m. Toto je t<>mov<6F>
pr<EFBFBD>ce a proto se o n<> m<><6D>e zaj<61>mat v<>ce lid<69>. <20>as od <20>asu m<>li ostatn<74> u<>ivatel<65>
stejn<EFBFBD> probl<62>m a v<>d<EFBFBD> jak jej obej<65>t, dokonce i kdy<64> se jedn<64> o chybu v k<>du
<application>MPlayer</application>u.
</para>
<para>
Pros<EFBFBD>me popi<70>te sv<73>j probl<62>m tak podrobn<62>, jak je to jen mo<6D>n<EFBFBD>. Prove<76>te mal<61>
p<EFBFBD>tr<EFBFBD>n<EFBFBD> po okolnostech za kter<65>ch probl<62>m nast<73>v<EFBFBD>. Projevuje se ta chyba jen
v ur<75>it<69>ch situac<61>ch? Je vlastn<74> ur<75>it<69>m soubor<6F>m nebo typ<79>m soubor<6F>? St<53>v<EFBFBD> se
pouze s jedn<64>m kodekem, nebo je nez<65>visl<73> na pou<6F>it<69>m kodeku? Dok<6F><6B>ete ji
zopakovat se v<>emi v<>stupn<70>mi rozhran<61>mi nebo ovlada<64>i?
<EFBFBD><EFBFBD>m v<>ce n<>m poskytnete informac<61>, t<>m je v<>t<EFBFBD><74> <20>ance na odstran<61>n<EFBFBD> probl<62>mu.
Nezapome<EFBFBD>te tak<61> p<>ipojit hodnotn<74> informace po<70>adovan<61> n<><6E>e, jinak nebudeme
schopni stanovit p<><70><EFBFBD>inu probl<62>mu.
</para>
<para>
Skv<EFBFBD>l<EFBFBD>, dob<6F>e napsan<61> p<><70>ru<72>ka jak se pt<70>t ve ve<76>ejn<6A>ch konferenc<6E>ch je
<ulink url="http://www.catb.org/~esr/faqs/smart-questions.html">How To Ask
Questions The Smart Way</ulink> od
<ulink url="http://www.catb.org/~esr/">Erica S. Raymonda</ulink>.
Dal<EFBFBD><EFBFBD> p<><70>ru<72>ka je
<ulink url="http://www.chiark.greenend.org.uk/~sgtatham/bugs.html">How to Report
Bugs Effectively</ulink> od
<ulink url="http://www.chiark.greenend.org.uk/~sgtatham/">Simona Tathama</ulink>.
Pokud budete postupovat podle t<>chto rad, jist<73> se v<>m dostane pomoci. Pochopte
v<EFBFBD>ak, <20>e my v<>ichni sledujeme konference dobrovoln<6C> ve sv<73>m voln<6C>m <20>ase. M<>me
mnoho pr<70>ce a nem<65><6D>eme v<>m zaru<72>it <20>e vy<76>e<EFBFBD><65>me v<><76> probl<62>m nebo <20>e v<>bec
dostanete odpov<6F><76>.
</para>
</sect1>
<sect1 id="bugreports_where">
<title>Kam hl<68>sit chyby</title>
<para>
P<EFBFBD>ihlaste se do e-mailov<6F> konference MPlayer-users:
<ulink url="http://mplayerhq.hu/mailman/listinfo/mplayer-users"/>
a po<70>lete sv<73> hl<68><6C>en<65> o chyb<79>ch na adresu
<ulink url="mailto:mplayer-users@mplayerhq.hu"/> kde o tom m<><6D>eme diskutovat.
</para>
<para>
Pokud chcete, m<><6D>ete m<>sto toho pou<6F><75>t zbrusu novou
<ulink url="http://bugzilla.mplayerhq.hu/">Bugzillu</ulink>.
</para>
<para>
Jazykem konference je <emphasis role="bold">Angli<EFBFBD>tina</emphasis>. Zachov<6F>vejte
pros<EFBFBD>m
<ulink url="http://www.ietf.org/rfc/rfc1855.txt">Pravidla Netikety</ulink> a
<emphasis role="bold">nepos<EFBFBD>lejte HTML mail</emphasis> do <20><>dn<64> z na<6E>ich
konferenc<EFBFBD>. Jinak m<><6D>ete b<>t ignorov<6F>ni nebo vyhozeni. Pokud nev<65>te co je to
HTML mail, nebo pro<72> je tak zatracov<6F>n, p<>e<EFBFBD>t<EFBFBD>te si tento
<ulink url="http://expita.com/nomime.html">v<EFBFBD>born<EFBFBD> dokument</ulink>. Zde se
dov<EFBFBD>te detaily v<>etn<74> instrukc<6B> pro vypnut<75> HTML. Poznamenejme t<><74>, <20>e nebudeme
individu<EFBFBD>ln<EFBFBD> d<>lat CC (kopie) lidem, tak<61>e je dobr<62> se p<>ihl<68>sit, abyste
obdr<EFBFBD>eli svou odpov<6F><76>.
</para>
</sect1>
<sect1 id="bugreports_what">
<title>Co nahl<68>sit</title>
<para>
Bude pot<6F>eba p<>ipojit log, konfiguraci nebo vzorky soubor<6F> ke sv<73>mu hl<68><6C>en<65> chyb.
Pokud jsou n<>kter<65> z nich opravdu velk<6C>, pak je rad<61>ji nahrajte na n<><6E>
<ulink url="ftp://mplayerhq.hu/MPlayer/incoming/">FTP server</ulink>
v komprimovan<61>m form<72>tu (preferujeme gzip a bzip2) a do zpr<70>vy zahr<68>te pouze
cestu a n<>zev souboru. Na<4E>e konference maj<61> limit velikosti zpr<70>vy 80k, pokud
m<EFBFBD>te n<>co v<>t<EFBFBD><74>ho, mus<75>te to zkomprimovat a nahr<68>t na FTP.
</para>
<sect2 id="bugreports_system">
<title>Syst<EFBFBD>mov<EFBFBD> informace</title>
<para>
<itemizedlist>
<listitem><para>
Va<EFBFBD>e Linuxov<6F> distribuce nebo opera<72>n<EFBFBD> syst<73>m a jeho verze jako:
<itemizedlist>
<listitem><para>Red Hat 7.1</para></listitem>
<listitem><para>Slackware 7.0 + devel packs from 7.1 ...</para></listitem>
</itemizedlist>
</para></listitem>
<listitem><para>
verze j<>dra:
<screen>uname -a</screen>
</para></listitem>
<listitem><para>
verze libc:
<screen>ls -l /lib/libc[.-]*</screen>
</para></listitem>
<listitem><para>
verze gcc a ld:
<screen>
gcc -v
ld -v
</screen>
</para></listitem>
<listitem><para>
verze binutils:
<screen>
as --version
</screen>
</para></listitem>
<listitem><para>
Pokud m<>te probl<62>my s celoobrazovkov<6F>m re<72>imem:
<itemizedlist>
<listitem><para>Druh Window manageru a jeho verze</para></listitem>
</itemizedlist>
</para></listitem>
<listitem><para>
Pokud m<>te probl<62>my s XVIDIX:
<itemizedlist>
<listitem><para>Hloubka barev v X:
<screen>xdpyinfo | grep &quot;depth of root&quot;</screen>
</para></listitem>
</itemizedlist>
</para></listitem>
<listitem><para>
Pokud je chybn<62> pouze GUI:
<itemizedlist>
<listitem><para>verze GTK</para></listitem>
<listitem><para>verze GLIB</para></listitem>
<listitem><para>verze libpng</para></listitem>
<listitem><para>GUI situace kdy se chyba projevila</para></listitem>
</itemizedlist>
</para></listitem>
</itemizedlist>
</para>
</sect2>
<sect2 id="bugreports_hardware">
<title>Hardware a rozhran<61> (ovlada<64>e)</title>
<para>
<itemizedlist>
<listitem><para>
CPU info (to funguje pouze v Linuxu):
<screen>cat /proc/cpuinfo</screen>
</para></listitem>
<listitem><para>
V<EFBFBD>robce a model videokarty, nap<61>:
<itemizedlist>
<listitem><para>ASUS V3800U chip: nVidia TNT2 Ultra pro 32MB SDRAM</para></listitem>
<listitem><para>Matrox G400 DH 32MB SGRAM</para></listitem>
</itemizedlist>
</para></listitem>
<listitem><para>
Video driver type &amp; version, e.g.:
<itemizedlist>
<listitem><para>X built-in driver</para></listitem>
<listitem><para>nVidia 0.9.623</para></listitem>
<listitem><para>Utah-GLX CVS 2001-02-17</para></listitem>
<listitem><para>DRI from X 4.0.3</para></listitem>
</itemizedlist>
</para></listitem>
<listitem><para>
Sound card type &amp; driver, e.g.:
<itemizedlist>
<listitem><para>Creative SBLive! Gold with OSS driver from oss.creative.com</para></listitem>
<listitem><para>Creative SB16 with kernel OSS drivers</para></listitem>
<listitem><para>GUS PnP with ALSA OSS emulation</para></listitem>
</itemizedlist>
</para></listitem>
<listitem><para>
Pokud si nejste jisti, p<>idejte v<>stup z <command>lspci -vv</command>
na syst<73>mech Linux.
</para></listitem>
</itemizedlist>
</para>
</sect2>
<sect2 id="bugreports_configure">
<title>Probl<EFBFBD>my s konfigurac<61></title>
<para>
Pokud nastanou chyby b<>hem b<>hu <command>./configure</command>, nebo sel<65>e
autodetekce n<><6E>eho, prostudujte <filename>configure.log</filename>. Mo<4D>n<EFBFBD>
naleznete odpov<6F><76> zde. Nap<61><70>klad n<>kolik verz<72> stejn<6A> knihovny v syst<73>mu, nebo
jste zapomn<6D>li nainstalovat v<>vojov<6F> (devel) bal<61><6C>ek (to jsou ty s koncovkou
-dev). Pokud si mysl<73>te, <20>e je zde chyba, p<>idejte
<filename>configure.log</filename> do sv<73>ho hl<68><6C>en<65>.
</para>
</sect2>
<sect2 id="bugreports_conpilation">
<title>Probl<EFBFBD>my s kompilac<61></title>
<para>
Zahr<EFBFBD>te pros<6F>m tyto soubory:
<itemizedlist>
<listitem><para>config.h</para></listitem>
<listitem><para>config.mak</para></listitem>
</itemizedlist>
Pouze pokud sel<65>e kompilace pod jedn<64>m z t<>chto adres<65><73><EFBFBD>, zahr<68>te tyto soubory:
<itemizedlist>
<listitem><para>Gui/config.mak</para></listitem>
<listitem><para>libvo/config.mak</para></listitem>
<listitem><para>libao2/config.mak</para></listitem>
</itemizedlist>
</para>
</sect2>
<sect2 id="bugreports_playback">
<title>Probl<EFBFBD>my s p<>ehr<68>v<EFBFBD>n<EFBFBD>m</title>
<para>
Zahr<EFBFBD>te pros<6F>me v<>stup <application>MPlayer</application>u v upov<6F>dan<61>m re<72>imu
<EFBFBD>rovn<EFBFBD> 1 ale dejte pozor, abyste jej <emphasis role="bold">nezkr<EFBFBD>tili</emphasis>
p<EFBFBD>i kop<6F>rov<6F>n<EFBFBD> do mailu. V<>voj<6F><6A>i pot<6F>ebuj<75> v<>echny zpr<70>vy pro dobrou diagn<67>zu
probl<EFBFBD>mu. Takto m<><6D>ete p<>esm<73>rovat v<>stup do souboru:
<screen>mplayer -v <replaceable>volby</replaceable> <replaceable>film</replaceable> &gt; mplayer.log 2&gt;&amp;1</screen>
</para>
<para>
Pokud se probl<62>m vztahuje k jednomu nebo v<>ce soubor<6F>m, pak pros<6F>m nahrajte
pot<EFBFBD><EFBFBD>isty na:
<ulink url="ftp://mplayerhq.hu/MPlayer/incoming/"/>
</para>
<para>
Rovn<EFBFBD><EFBFBD> zde nahrajte mal<61> textov<6F> soubor se stejn<6A>m z<>kladn<64>m jm<6A>nem a p<><70>ponou
.txt. Popi<70>te probl<62>m kter<65> m<>te s dan<61>m souborem a p<>ipojte sv<73>j e-mail a tak<61>
v<EFBFBD>stup <application>MPlayer</application>u v upov<6F>dan<61>m re<72>imu <20>rovn<76> 1.
Pro reprodukci probl<62>mu sta<74><61> obvykle prvn<76>ch 1-5 MB souboru, ale pro jistotu
v<EFBFBD>s <20><>d<EFBFBD>me o:
<screen>dd if=<replaceable>v<EFBFBD><EFBFBD>_soubor</replaceable> of=<replaceable>mal<EFBFBD>_soubor</replaceable> bs=1024k count=5</screen>
To vezme prvn<76>ch p<>t megabajt<6A> '<emphasis role="bold">va<EFBFBD>eho_souboru</emphasis>'
a zap<61><70>e je do '<emphasis role="bold">mal<EFBFBD>ho_souboru</emphasis>'. Pak znovu
zkuste tento mal<61> vzorek a pokud se na n<>m chyba projev<65>, pak je tento vzorek
pro n<>s dostate<74>n<EFBFBD>.
Pros<EFBFBD>me <emphasis role="bold">nikdy</emphasis> nepos<6F>lejte tyto soubory e-mailem!
Nahrajte je na FTP a po<70>lete pouze cestu/n<>zev_souboru dan<61>ho souboru na FTP
serveru. Pokud je soubor p<><70>stupn<70> na internetu, pak sta<74><61> poslat
<emphasis role="bold">p<EFBFBD>esnou</emphasis> adresu URL.
</para>
</sect2>
<sect2 id="bugreports_crash">
<title>P<EFBFBD>dy</title>
<para>
Mus<EFBFBD>te spustit <application>MPlayer</application> z <command>gdb</command>
a poslat n<>m <20>pln<6C> v<>stup nebo pokud m<>te <filename>core</filename> dump
z p<>du, m<><6D>ete n<>m vyextrahovat u<>ite<74>n<EFBFBD> informace ze souboru Core.
Jak to ud<75>lat:
</para>
<sect3 id="bugreports_debug">
<title>Jak uchovat informace o zopakovateln<6C>m p<>du</title>
<para>
P<EFBFBD>ekompilujte <application>MPlayer</application> se zapnut<75>m debugovac<61>m k<>dem:
<screen>
./configure --enable-debug=3
make
</screen>
a spus<75>te <application>MPlayer</application> z gdb pomoc<6F>:
<screen>gdb ./mplayer</screen>
Nyn<EFBFBD> jste v gdb. Zadejte:
<screen>run -v <replaceable>volby-pro-mplayer</replaceable> <replaceable>soubor</replaceable></screen>
a zopakujte p<>d. Jakmile to dok<6F><6B>ete, vr<76>t<EFBFBD> se gdb do re<72>imu p<><70>kazov<6F>ho <20><>dku,
kde mus<75>te zadat
<screen>
bt
disass $pc-32 $pc+32
info all-registers
</screen>
</para>
</sect3>
<sect3 id="bugreports_core">
<title>Jak z<>skat smyslupln<6C> informace z core dump</title>
<para>
Vytvo<EFBFBD>te n<>sleduj<75>c<EFBFBD> p<><70>kazov<6F> <20><>dek:
<screen>
bt
disass $pc-32 $pc+32
info all-registers
</screen>
Pak jednodu<64>e spus<75>te tento p<><70>kaz:
<screen>gdb mplayer --core=core -batch --command=<replaceable>p<EFBFBD><EFBFBD>kazov<EFBFBD>_soubor</replaceable> &gt; mplayer.bug</screen>
</para>
</sect3>
</sect2>
</sect1>
<sect1 id="bugreports_advusers">
<title>V<EFBFBD>m co d<>l<EFBFBD>m...</title>
<para>
Pokud jste vytvo<76>ili p<><70>kladn<64> hl<68><6C>en<65> chyby pomoc<6F> v<><76>euveden<65>ch krok<6F> a jste
si jisti, <20>e chyba je v <application>MPlayer</application>u, nikoli chyba
kompil<EFBFBD>toru nebo po<70>kozen<65> soubor, ji<6A> jste si p<>e<EFBFBD>etli dokumentaci ale nenalezli
<EFBFBD>e<EFBFBD>en<EFBFBD>, va<76>e ovlada<64>e zvuku jsou OK, pak byste se m<>li p<>ihl<68>sit do konference
MPlayer-advusers a poslat hl<68><6C>en<65> chyb zde, abyste dostali lep<65><70> a rychlej<65><6A>
odpov<EFBFBD><EFBFBD>.
</para>
<para>
M<EFBFBD>jte na pam<61>ti, <20>e pokud zde po<70>lete nov<6F><76>kovsk<73> ot<6F>zky nebo ot<6F>zky zodpov<6F>zen<65>
v manu<6E>lu, budete ignorov<6F>ni nebo vyhozeni, m<>sto abyste dostali vhodnou odpov<6F><76>.
Tak<EFBFBD>e n<>m nenad<61>vejte a p<>ihlaste se do -advusers pouze pokud opravdu v<>te co
d<EFBFBD>l<EFBFBD>te a c<>t<EFBFBD>te se b<>t pokro<72>il<69>m u<>ivatelem <application>MPlayer</application>u,
nebo v<>voj<6F><6A>em. Pokud spl<70>ujete tato krit<69>ria, nebude pro v<>s t<><74>k<EFBFBD> se
p<EFBFBD>ihl<EFBFBD>sit...
</para>
</sect1>
</appendix>