User:DarioAndres/Basic Guide about Crash Reporting

< User:DarioAndres
Revision as of 21:54, 31 December 2009 by DarioAndres (Talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

Contents

Introduction

This document describes how to create useful bug reports for crashes of KDE applications.

How to create useful crash reports

A good crash report consists of two parts: a description of how to reproduce the crash and a backtrace of the crash. With any of those elements missing, it is very hard (if not impossible) for developers to tackle the problem.

Description

A description should describe everything that you were doing prior to the crash. It should not just say "it crashed". Did you click on a button, did you open a particular website or file which caused problems? These little details, which may look useless to you, may be useful for the developers, so just write them down.

  • The KDE version is an important detail that is often missing in bug reports.

If you do not know what KDE version are you using, you can get it by selecting the "About KDE" option in the Help menu of every KDE application, or by running the command kde4-config --version in Konsole. You will get an output like this:

Qt: 4.5.3
KDE: 4.3.2 (KDE 4.3.2)
kde4-config: 1.0
noframe
 
Note
The crash reporting assistant integrated in KDE 4.3 and later automatically includes the KDE version in your report.

A more insightful article on how to write good bug descriptions is available at this link, please read that before reporting bugs.

Application specific details

For several applications it can be useful to have specific details inside the bug reports:

  • Plasma Desktop: Plasmoids you have in your desktop (both official and unofficial), desktop settings (wallpaper plugin, themes), activities and dashboard configuration.
  • KWin (the windows manager): state of compositing(desktop effects): enabled / suspended / disabled, kind of effects enabled, window decoration.
  • Konqueror: Sites you were visiting, number of opened tabs, plugins you have installed, non-default settings.
  • Dolphin: file view mode, grouping and sorting settings, preview settings, directory you were browsing.
  • Kopete: IM protocols you use, plugins you use.
  • KMail: Mail protocols and account-types you use.
  • KWrite/Kate/KOffice: Type of the document you were editing.
  • Juk/Dragon/Amarok (multimedia players): Type of media (extension and format) you were watching and/or listening to.

KDE® and the K Desktop Environment® logo are registered trademarks of KDE e.V.Legal