/******************************************************************* * aboutbugreportingdialog.cpp * Copyright 2009 Dario Andres Rodriguez * Copyright 2009 A. L. Spehr * * This program is free software; you can redistribute it and/or * modify it under the terms of the GNU General Public License as * published by the Free Software Foundation; either version 2 of * the License, or (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program. If not, see . * ******************************************************************/ #include "aboutbugreportingdialog.h" #include #include #include #include #include #include #include "drkonqi_globals.h" AboutBugReportingDialog::AboutBugReportingDialog(QWidget * parent): KDialog(parent) { setAttribute(Qt::WA_DeleteOnClose, true); setWindowIcon(KIcon("help-hint")); setCaption(i18nc("@title title of the dialog", "About Bug Reporting - Help")); setButtons(KDialog::Close); setDefaultButton(KDialog::Close); m_textBrowser = new KTextBrowser(this); m_textBrowser->setMinimumSize(QSize(600, 300)); m_textBrowser->setNotifyClick(true); connect(m_textBrowser, SIGNAL(urlClick(QString)), this, SLOT(handleInternalLinks(QString))); QString text = //Introduction QString("

%2

").arg(QLatin1String(PAGE_HELP_BEGIN_ID), i18nc("@title","Information about bug reporting")) + QString("

%1

%2

%3

").arg( i18nc("@info/rich", "You can help us improve this software by filing a bug report."), i18nc("@info/rich","It is safe to close this dialog. If you do not " "want to, you do not have to file a bug report."), i18nc("@info/rich","In order to generate a useful bug report we need some " "information about both the crash and your system. (You may also " "need to install some debug packages.)")) + //Sub-introduction QString("

%1

").arg(i18nc("@title","Bug Reporting Assistant Guide")) + QString("

%1

").arg( i18nc("@info/rich","This assistant will guide you through the crash " "reporting process for the KDE bug tracking system. All the " "information you enter on the bug report must be written " "in English, if possible, as KDE is formed internationally.")) + //Bug Awareness Page QString("

%2

").arg(QLatin1String(PAGE_AWARENESS_ID), i18nc("@title","What do you know about the crash?")) + QString("

%1

%2

  • %3
  • %4
  • %5
  • %6
  • %7
  • %8
    • " "
%9

").arg( i18nc("@info/rich","In this page you need to describe how much do you know about " "the desktop and the application state before it crashed."), i18nc("@info/rich","If you can, describe in as much detail as possible the crash " "circumstances, and what you were doing when the application crashed " "(this information is going to be requested later.) You can mention: "), i18nc("@info/rich crash situation example","actions you were taking inside or outside " "the application"), i18nc("@info/rich crash situation example","documents or images that you were using " "and their type/format (later if you go to look at the report in the " "bug tracking system, you can attach a file to the report)"), i18nc("@info/rich crash situation example","widgets that you were running"), i18nc("@info/rich crash situation example","the URL of a web site you were browsing"), i18nc("@info/rich crash situation example","configuration details of the application"), i18nc("@info/rich crash situation example","or other strange things you notice before " "or after the crash. "), i18nc("@info/rich","Screenshots can be very helpful sometimes. You can attach them to " "the bug report after it is posted to the bug tracking system.")) + //Crash Information Page QString("

%2

").arg(QLatin1String(PAGE_CRASHINFORMATION_ID), i18nc("@title","Crash Information (backtrace)")) + QString("

%1

%2

%3

%4

").arg( i18nc("@info/rich","This page will generate a \"backtrace\" of the crash. This " "is information that tells the developers where the application " "crashed."), i18nc("@info/rich", "If the crash information is not detailed enough, you may " "need to install some debug packages and reload it (if the " "Install Debug Symbols button is available you " "can use it to automatically install the missing information.)"), i18nc("@info/rich", "You can find more information about backtraces, what they mean, " "and how they are useful at %1",QString(TECHBASE_HOWTO_DOC) ), i18nc("@info/rich","Once you get a useful backtrace (or if you do not want to " "install the missing debugging packages) you can continue.")) + //Conclusions Page QString("

%2

").arg(QLatin1String(PAGE_CONCLUSIONS_ID), i18nc("@title","Conclusions")) + QString("

%1

%2

%3

").arg( i18nc("@info/rich","Using the quality of the crash information gathered, " "and your answers on the previous page, the assistant will " "tell you if the crash is worth reporting or not."), i18nc("@info/rich","If the crash is worth reporting but the application " "is not supported in the KDE bug tracking system, you " "will need to directly contact the maintainer of the application."), i18nc("@info/rich","If the crash is listed as being not worth reporting, " "and you think the assistant has made a mistake, " "you can still manually report the bug by logging into the " "bug tracking system. You can also go back and change information " "and download debug packages.")) + //Bugzilla Login Page QString("

%2

").arg(QLatin1String(PAGE_BZLOGIN_ID), i18nc("@title","Login into the bug tracking system")) + QString("

%1

%2

%3

").arg( i18nc("@info/rich","We may need to contact you in the future to ask for " "further information. As we need to keep track of the bug reports, " "you " "need to have an account on the KDE bug tracking system. If you do " "not have one, you can create one here: %1", QString(KDE_BUGZILLA_CREATE_ACCOUNT_URL)), i18nc("@info/rich","Then, enter your username and password and " "press the Login button. You can use this login to directly access the " "KDE bug tracking system later."), i18nc("@info/rich","The KWallet dialog may appear when pressing Login to " "save your password in the KWallet password system. Also, it will " "prompt you for the KWallet password upon loading to autocomplete " "the login fields if you use this assistant again.")) + //Bugzilla Duplicates Page QString("

%2

").arg(QLatin1String(PAGE_BZDUPLICATES_ID), i18nc("@title","List of possible duplicate reports")) + QString("

%1

%2

%3

%4

%5

").arg( //needs some more string cleanup below i18nc("@info/rich","This page will search the bug report system for " "similar crashes which are possible duplicates of your bug. If " "there are similar bug reports found, you can double click on them " "to see details. Then, read the current bug report information so " "you can check to see if they are similar. "), i18nc("@info/rich","If you are very sure your bug is the same as another that is " "previously reported, you can set your information to be attached to " "the existing report."), i18nc("@info/rich","If you are unsure whether your report is the same, follow the main " "options to tentatively mark your crash as a duplicate of that " "report. This is usually the safest thing to do. We cannot " "uncombine bug reports, but we can easily merge them."), i18nc("@info/rich","If not enough possible duplicates are found, or you " "did not find a similar report, then you can force it to search " "for more bug reports (only if the date range limit is not reached.)"), i18nc("@info/rich","If you do not find any related reports, your crash information " "is not useful enough, and you really cannot give additional " "information about the crash context, then it is better to " "not file the bug report, thereby closing the assistant.")) + //Bugzilla Crash Information - Details Page QString("

%2

").arg(QLatin1String(PAGE_BZDETAILS_ID), i18nc("@title","Details of the bug report and your system")) + QString("

%1%3

%4

%5

").arg( i18nc("@info/rich","In this case you need to write a title and description " "of the crash. Explain as best you can. "), QLatin1String(PAGE_AWARENESS_ID), i18nc("@title","What do you know about the crash?"), i18nc("@info/rich", "You can also specify your distribution method (GNU/Linux " "distribution or packaging system) or if you compiled the KDE " "Platform from sources."), i18nc("@info/rich", "You should write those information in English.")) + //Bugzilla Send Page QString("

%2

").arg(QLatin1String(PAGE_BZSEND_ID), i18nc("@title","Sending the Crash Report")) + QString("

%1

%2

").arg( i18nc("@info/rich","The last page will send the bug report to the bug tracking " "system and will notify you when it is done. It will then show " "the web address of the bug report in the KDE bug tracking system, " "so that you can look at the report later."), i18nc("@info/rich","If the process fails, you can click " "Retry to try sending the bug report again. " "If the report cannot be sent because the bug tracking system has a " "problem, you can save it to a file to manually report later.")) + QString("

%1

%2

").arg( i18nc("@info/rich", "Thank you for being part of KDE!"), i18nc("@info/rich", "If you are interested in helping us to keep the KDE bug tracker system " "clean and useful, which allows the developers to be more focused on " "fixing the real issues, you are welcome to " "join the BugSquad team.")); m_textBrowser->setText(text); setMainWidget(m_textBrowser); KConfigGroup config(KGlobal::config(), "AboutBugReportingDialog"); restoreDialogSize(config); } AboutBugReportingDialog::~AboutBugReportingDialog( ) { KConfigGroup config(KGlobal::config(), "AboutBugReportingDialog"); saveDialogSize(config); } void AboutBugReportingDialog::handleInternalLinks(const QString& url) { if (!url.isEmpty()) { if (url.startsWith('#')) { showSection(url.mid(1,url.length())); } else { KToolInvocation::invokeBrowser(url); } } } void AboutBugReportingDialog::showSection(const QString& anchor) { m_textBrowser->scrollToAnchor(anchor); }