| 1 |
/**************************************************************************** |
| 2 |
** |
| 3 |
** Copyright (C) 2012 Nokia Corporation and/or its subsidiary(-ies). |
| 4 |
** All rights reserved. |
| 5 |
** Contact: Nokia Corporation (qt-info@nokia.com) |
| 6 |
** |
| 7 |
** This file is part of the documentation of the Qt Toolkit. |
| 8 |
** |
| 9 |
** $QT_BEGIN_LICENSE:FDL$ |
| 10 |
** GNU Free Documentation License |
| 11 |
** Alternatively, this file may be used under the terms of the GNU Free |
| 12 |
** Documentation License version 1.3 as published by the Free Software |
| 13 |
** Foundation and appearing in the file included in the packaging of |
| 14 |
** this file. |
| 15 |
** |
| 16 |
** Other Usage |
| 17 |
** Alternatively, this file may be used in accordance with the terms |
| 18 |
** and conditions contained in a signed written agreement between you |
| 19 |
** and Nokia. |
| 20 |
** |
| 21 |
** |
| 22 |
** |
| 23 |
** |
| 24 |
** $QT_END_LICENSE$ |
| 25 |
** |
| 26 |
****************************************************************************/ |
| 27 |
|
| 28 |
/*! |
| 29 |
\page bughowto.html |
| 30 |
\title How to Report a Bug |
| 31 |
\brief Information about ways to report bugs in Qt. |
| 32 |
|
| 33 |
If you think you have found a bug in Qt, we would like to hear |
| 34 |
about it so that we can fix it. |
| 35 |
|
| 36 |
Before reporting a bug, please check the \l{FAQs}, \l{Platform |
| 37 |
and Compiler Notes}, and the \l{Qt Bug Tracker} on the Qt website to see |
| 38 |
if the issue is already known. |
| 39 |
|
| 40 |
The first thing you should do is to sign up for an account for |
| 41 |
the \l{Qt Bug Tracker}, if you do not already have one. Once you |
| 42 |
have done that you can submit and track your bug reports and they |
| 43 |
will be publicly available from the moment you submit them. |
| 44 |
|
| 45 |
Always include the following information in your bug report: |
| 46 |
|
| 47 |
\list 1 |
| 48 |
\o The name and version number of your compiler |
| 49 |
\o The name and version number of your operating system |
| 50 |
\o The version of Qt you are using, and what configure options it was |
| 51 |
compiled with |
| 52 |
\o Reliable and clear description on how to reproduce the problem |
| 53 |
\endlist |
| 54 |
|
| 55 |
If possible, please provide a test written using the QtTest module |
| 56 |
as this will improve the procedure of reproducing your problem and |
| 57 |
allow the developers to address the issue in a more efficient way. |
| 58 |
|
| 59 |
Otherwise, if the problem you are reporting is only visible at run-time, |
| 60 |
try to create a small test program that shows the problem when run. |
| 61 |
Often, such a program can be created with some minor changes to one of |
| 62 |
the many example programs in Qt's examples directory. |
| 63 |
|
| 64 |
If you have implemented a bug fix and want to contribute your fix |
| 65 |
directly, then you can do so through the \l{Public Qt Repository}. |
| 66 |
*/ |