Kdenlive/Manual/BugReporting: Difference between revisions

From KDE UserBase Wiki
mNo edit summary
(Marked this version for translation)
Line 1: Line 1:
<languages/>
<languages/>
<translate>
<translate>
== Bug reports ==
== Bug reports == <!--T:1-->


<!--T:2-->
Bug reports are handled by [http://www.kdenlive.org/mantis/ Mantis bug tracker].
Bug reports are handled by [http://www.kdenlive.org/mantis/ Mantis bug tracker].


<!--T:3-->
If you have a crash at '''Kdenlive''' startup or when trying to play a video file, please follow these steps (and read the rest of the page too).
If you have a crash at '''Kdenlive''' startup or when trying to play a video file, please follow these steps (and read the rest of the page too).


<!--T:4-->
If you compiled '''Kdenlive''' / '''MLT''' yourself, make sure you followed all steps described in our instructions
If you compiled '''Kdenlive''' / '''MLT''' yourself, make sure you followed all steps described in our instructions


<!--T:5-->
*Check that you don't have several versions of '''MLT''' installed
*Check that you don't have several versions of '''MLT''' installed


<!--T:6-->
*Try playing your video file with FFmpeg's player. From a terminal:  <code>ffplay myvideo.mpg </code>
*Try playing your video file with FFmpeg's player. From a terminal:  <code>ffplay myvideo.mpg </code>


<!--T:7-->
*Try playing your video file with MLT's player. From a terminal:  <code>melt myvideo.mpg </code>
*Try playing your video file with MLT's player. From a terminal:  <code>melt myvideo.mpg </code>


<!--T:8-->
*Download this simple project file (containing color clips): [http://kdenlive.org/mantis/file_download.php?file_id=467&type=bug test_file.kdenlive] and play it with MLT's player:  
*Download this simple project file (containing color clips): [http://kdenlive.org/mantis/file_download.php?file_id=467&type=bug test_file.kdenlive] and play it with MLT's player:  
   
   
{{Input|1=melt test_file.kdenlive}}
{{Input|1=melt test_file.kdenlive}}


<!--T:9-->
Include the results of the 4 above steps in your bug report, and always tell us which '''Kdenlive''' and '''MLT''' version you have!
Include the results of the 4 above steps in your bug report, and always tell us which '''Kdenlive''' and '''MLT''' version you have!


=== Step 1: Upgrade to Kdenlive latest release ===
=== Step 1: Upgrade to Kdenlive latest release === <!--T:10-->


<!--T:11-->
Please upgrade to the latest released versions of '''Kdenlive''' and '''MLT'''. We not not answer bug reports for old '''Kdenlive''' versions (unless they are still reproducible in latest version).
Please upgrade to the latest released versions of '''Kdenlive''' and '''MLT'''. We not not answer bug reports for old '''Kdenlive''' versions (unless they are still reproducible in latest version).


<!--T:12-->
If your distribution does not offer packages of the latest '''Kdenlive''' and '''MLT''' versions, please check our [[Special:myLanguage/Kdenlive/Manual/Installation|installation]]  page for tips about upgrading.
If your distribution does not offer packages of the latest '''Kdenlive''' and '''MLT''' versions, please check our [[Special:myLanguage/Kdenlive/Manual/Installation|installation]]  page for tips about upgrading.


=== Step 2: Query open issues ===
=== Step 2: Query open issues === <!--T:13-->


<!--T:14-->
Query open issues on [http://www.kdenlive.org/mantis/ Mantis bug tracker].
Query open issues on [http://www.kdenlive.org/mantis/ Mantis bug tracker].


<!--T:15-->
Reading the bug page:
Reading the bug page:


     New or Feedback is a reported bug, which needs more feedback.
     <!--T:16-->
New or Feedback is a reported bug, which needs more feedback.
     Acknowledged means that the bug is reported by several users or by core members.
     Acknowledged means that the bug is reported by several users or by core members.
     Confirmed means that the bug is reproducible.
     Confirmed means that the bug is reproducible.
Line 39: Line 52:
     Fixed means that the bug was fixed in development version.
     Fixed means that the bug was fixed in development version.


=== Step 3: Report a bug ===
=== Step 3: Report a bug === <!--T:17-->


<!--T:18-->
Before reporting bugs, read the user manual and search the forums for answers. Do not report bugs on the '''Kdenlive''' forum.
Before reporting bugs, read the user manual and search the forums for answers. Do not report bugs on the '''Kdenlive''' forum.


<!--T:19-->
If you are not running the latest development release, check recently solved issues, as your problem might already be fixed in the development version.
If you are not running the latest development release, check recently solved issues, as your problem might already be fixed in the development version.


<!--T:20-->
To report a bug [http://www.kdenlive.org/mantis/signup_page.php create an account] on [http://www.kdenlive.org/mantis/ Mantis bug tracker]. Log in and submit an issue.
To report a bug [http://www.kdenlive.org/mantis/signup_page.php create an account] on [http://www.kdenlive.org/mantis/ Mantis bug tracker]. Log in and submit an issue.


<!--T:21-->
For the bug report to be useful, please try to provide the following information:
For the bug report to be useful, please try to provide the following information:


<!--T:22-->
*Precise steps to reproduce the bug
*Precise steps to reproduce the bug


<!--T:23-->
*If the bug crashes '''Kdenlive''', provide a backtrace.  
*If the bug crashes '''Kdenlive''', provide a backtrace.  




==== How to get useful crash information (backtrace) ====
==== How to get useful crash information (backtrace) ==== <!--T:24-->




<!--T:25-->
Please install the following packages: gdb, kdenlive-dbg, libmlt-dbg (package names may slightly change depending on your distro).
Please install the following packages: gdb, kdenlive-dbg, libmlt-dbg (package names may slightly change depending on your distro).


<!--T:26-->
When '''Kdenlive''' crashes, if the KDE crash handler dialog pops up, you can copy the data it provides.
When '''Kdenlive''' crashes, if the KDE crash handler dialog pops up, you can copy the data it provides.


<!--T:27-->
Otherwise, from a terminal, type:
Otherwise, from a terminal, type:
{{Input|1=gdb kdenlive
{{Input|1=gdb kdenlive
run}}
run}}


<!--T:28-->
'''Kdenlive''' will start, then you can trigger the bug. When Kdenlive crashes, go to your terminal window and type:
'''Kdenlive''' will start, then you can trigger the bug. When Kdenlive crashes, go to your terminal window and type:


<!--T:29-->
{{Input|1=thread apply all bt}}
{{Input|1=thread apply all bt}}


<!--T:30-->
Then press <keycap>Enter</keycap> until you see the full data. Copy the log to a file and attach it to the bug report.
Then press <keycap>Enter</keycap> until you see the full data. Copy the log to a file and attach it to the bug report.


=== Step 4: Upload some sample RAW footage ===
=== Step 4: Upload some sample RAW footage === <!--T:31-->


<!--T:32-->
For any Mpeg2/Mpeg4 and H264 this is important that you upload RAW footage (coming directly from camcorder) somewhere on Internet. This will allow users to benchmark their computer using this file and also help us understand some bugs. A 5 seconds footage is enough. Do not upload large files of more than 20 MB.
For any Mpeg2/Mpeg4 and H264 this is important that you upload RAW footage (coming directly from camcorder) somewhere on Internet. This will allow users to benchmark their computer using this file and also help us understand some bugs. A 5 seconds footage is enough. Do not upload large files of more than 20 MB.


<!--T:33-->
As regards audio synchronization, video rendering and other issues, we will not answer support request unless minimum footage is available somewhere to reproduce bugs.
As regards audio synchronization, video rendering and other issues, we will not answer support request unless minimum footage is available somewhere to reproduce bugs.


=== MLT bug reports ===
=== MLT bug reports === <!--T:34-->


<!--T:35-->
Bugs in the MLT part of the system can be reported  [http://sourceforge.net/p/mlt/bugs/?source=navbar here] (Kdenlive is a front end to the Media Loving Toolkit (MLT))
Bugs in the MLT part of the system can be reported  [http://sourceforge.net/p/mlt/bugs/?source=navbar here] (Kdenlive is a front end to the Media Loving Toolkit (MLT))


<!--T:36-->
{{Prevnext2
{{Prevnext2
| prevpage=Special:MyLanguage/Kdenlive/Manual/Useful_Information/Useful_Resources | nextpage=Special:MyLanguage/Kdenlive/Manual/Credits_and_License
| prevpage=Special:MyLanguage/Kdenlive/Manual/Useful_Information/Useful_Resources | nextpage=Special:MyLanguage/Kdenlive/Manual/Credits_and_License
Line 87: Line 116:
}}
}}


<!--T:37-->
[[Category:Kdenlive]]
[[Category:Kdenlive]]
[[Category:Multimedia]]
[[Category:Multimedia]]
</translate>
</translate>

Revision as of 16:18, 3 April 2014

Bug reports

Bug reports are handled by Mantis bug tracker.

If you have a crash at Kdenlive startup or when trying to play a video file, please follow these steps (and read the rest of the page too).

If you compiled Kdenlive / MLT yourself, make sure you followed all steps described in our instructions

  • Check that you don't have several versions of MLT installed
  • Try playing your video file with FFmpeg's player. From a terminal: ffplay myvideo.mpg
  • Try playing your video file with MLT's player. From a terminal: melt myvideo.mpg
  • Download this simple project file (containing color clips): test_file.kdenlive and play it with MLT's player:
melt test_file.kdenlive

Include the results of the 4 above steps in your bug report, and always tell us which Kdenlive and MLT version you have!

Step 1: Upgrade to Kdenlive latest release

Please upgrade to the latest released versions of Kdenlive and MLT. We not not answer bug reports for old Kdenlive versions (unless they are still reproducible in latest version).

If your distribution does not offer packages of the latest Kdenlive and MLT versions, please check our installation page for tips about upgrading.

Step 2: Query open issues

Query open issues on Mantis bug tracker.

Reading the bug page:

   New or Feedback is a reported bug, which needs more feedback.
   Acknowledged means that the bug is reported by several users or by core members.
   Confirmed means that the bug is reproducible.
   Assigned means that a developer is handling the bug.
   Fixed means that the bug was fixed in development version.

Step 3: Report a bug

Before reporting bugs, read the user manual and search the forums for answers. Do not report bugs on the Kdenlive forum.

If you are not running the latest development release, check recently solved issues, as your problem might already be fixed in the development version.

To report a bug create an account on Mantis bug tracker. Log in and submit an issue.

For the bug report to be useful, please try to provide the following information:

  • Precise steps to reproduce the bug
  • If the bug crashes Kdenlive, provide a backtrace.


How to get useful crash information (backtrace)

Please install the following packages: gdb, kdenlive-dbg, libmlt-dbg (package names may slightly change depending on your distro).

When Kdenlive crashes, if the KDE crash handler dialog pops up, you can copy the data it provides.

Otherwise, from a terminal, type:

gdb kdenlive
run

Kdenlive will start, then you can trigger the bug. When Kdenlive crashes, go to your terminal window and type:

thread apply all bt

Then press Enter until you see the full data. Copy the log to a file and attach it to the bug report.

Step 4: Upload some sample RAW footage

For any Mpeg2/Mpeg4 and H264 this is important that you upload RAW footage (coming directly from camcorder) somewhere on Internet. This will allow users to benchmark their computer using this file and also help us understand some bugs. A 5 seconds footage is enough. Do not upload large files of more than 20 MB.

As regards audio synchronization, video rendering and other issues, we will not answer support request unless minimum footage is available somewhere to reproduce bugs.

MLT bug reports

Bugs in the MLT part of the system can be reported here (Kdenlive is a front end to the Media Loving Toolkit (MLT))