You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
93 lines
3.3 KiB
93 lines
3.3 KiB
<sect1 id="howto-bug-reporting">
|
|
<title>Reporting bugs</title>
|
|
|
|
<sect2 id="howto-bug-reporting-duplicates">
|
|
<title>Checking for duplicate bugs</title>
|
|
|
|
<para>Before you report a bug, please first make sure the bug has not been
|
|
reported yet. Look through the list of <ulink
|
|
url="http://cvs.sourceforge.net/viewcvs.py/kplayer/kplayer/BUGS?rev=HEAD">known
|
|
issues</ulink>, then in the <ulink
|
|
url="http://sourceforge.net/tracker/?atid=532182&group_id=71710">bug
|
|
tracking system</ulink>. Also look in <ulink
|
|
url="http://sourceforge.net/tracker/?atid=532183&group_id=71710">support
|
|
requests</ulink>, <ulink
|
|
url="http://sourceforge.net/tracker/?atid=532185&group_id=71710">feature
|
|
requests</ulink> and the <ulink
|
|
url="http://sourceforge.net/forum/forum.php?forum_id=244388">user
|
|
forum</ulink>.</para>
|
|
|
|
</sect2>
|
|
|
|
<sect2 id="howto-bug-reporting-submitting">
|
|
<title>Submitting a bug</title>
|
|
|
|
<para>Please report bugs through the <ulink
|
|
url="http://sourceforge.net/tracker/?group_id=71710&atid=532182">&kplayer;
|
|
bug tracking system</ulink>. Using SourceForge is much preferable over private
|
|
e-mail, for it helps prevent duplicate requests.</para>
|
|
|
|
<para>When you <ulink
|
|
url="http://sourceforge.net/account/login.php?return_to=%2Ftracker%3Ffunc%3Dadd%26group_id%3D71710%26atid%3D532182">submit
|
|
a bug</ulink>, please include all of the following information.</para>
|
|
|
|
<itemizedlist>
|
|
|
|
<listitem><para>The versions of all relevant programs you are using:
|
|
|
|
<itemizedlist>
|
|
|
|
<listitem><para>&kplayer;,</para></listitem>
|
|
|
|
<listitem><para>&mplayer;,</para></listitem>
|
|
|
|
<listitem><para>&kde;,</para></listitem>
|
|
|
|
<listitem><para>Qt,</para></listitem>
|
|
|
|
<listitem><para>XFree,</para></listitem>
|
|
|
|
<listitem><para>the window manager, normally &twin;.</para></listitem>
|
|
|
|
</itemizedlist>
|
|
|
|
</para></listitem>
|
|
|
|
<listitem><para>&kplayer; debug log.</para>
|
|
|
|
<para>Make sure your console history size is unlimited, for example in &konsole;
|
|
go to <menuchoice><guimenu>Preferences</guimenu>
|
|
<guimenuitem>History</guimenuitem></menuchoice> and set the
|
|
<guilabel>Unlimited</guilabel> option.</para>
|
|
|
|
<para>Run &kplayer; from the console. If the bug is in &kplayer;'s KPart, run
|
|
the program that uses the KPart instead.</para>
|
|
|
|
<para>Reproduce the bug.</para>
|
|
|
|
<para>Then post on SourceForge whatever shows up on the console, clearly marking
|
|
the point where the problem occurs.</para>
|
|
|
|
<para>If the problem happened only once and you cannot reproduce it, you can
|
|
look in the <filename>~/.xsession-errors</filename> file to see if it recorded
|
|
the &kplayer; output when the problem occurred.</para>
|
|
|
|
<para>If you are not getting any console output from &kplayer;, you may need
|
|
to recompile &kplayer; with debug information. Follow the instructions in the
|
|
<link linkend="howto-compilation">Compilation micro-HOWTO</link> and give an
|
|
additional <option>--enable-debug=yes</option> option to the
|
|
<command>configure</command> script.</para>
|
|
|
|
<para>The &kplayer; debug output includes &mplayer; messages. To make &mplayer;
|
|
more verbose put a <option>-v</option> option in the <guilabel>Additional
|
|
command line arguments</guilabel> field on the
|
|
<link linkend="settings-advanced">Advanced page</link> in <guilabel>&kplayer;
|
|
Settings</guilabel>. You can repeat the option up to three times, separated
|
|
by spaces, to get even more &mplayer; output.</para></listitem>
|
|
|
|
</itemizedlist>
|
|
|
|
</sect2>
|
|
|
|
</sect1>
|