Projects/KDE on Windows/How to Help: Difference between revisions

From KDE TechBase
Line 1: Line 1:
==Testing==
==Testing==
'''More you use the software, more issues and wishes you can find.''' Do not keep this knowledge for you - file a bug on http://bugs.kde.org, the KDE Bug Tracking System (Bugzilla).
'''The more you use the software, the more issues and wishes you can find.''' Do not keep this knowledge to yourself - file a bug at http://bugs.kde.org, the KDE Bug Tracking System (Bugzilla).


===Querying existing reports===
===Querying existing reports===
[[Image:Kde-windows-bugzilla.png|thumb|250px|right|Bugzilla's Query form with ''installer'' product and ''buildsystem'' component selected (click to enlarge)]]
[[Image:Kde-windows-bugzilla.png|thumb|250px|right|Bugzilla's Query form with ''installer'' product and ''buildsystem'' component selected (click to enlarge)]]
To find a report use the [http://bugs.kde.org/query.cgi Query Reports] form, where you can specify product, component, version, installation type and operating system, and a few more. To find Windows-related reports, select one or more parameters of your search (what can make your result set more or less limited):
To find a report use the [http://bugs.kde.org/query.cgi Query Reports] form, where you can specify product, component, version, installation type and operating system, and a few other things. To find Windows-related reports, select one or more parameters of your search (which can make your result set more or less limited):
*Product: for installer select ''kde-windows''; for applications, find appropriate name, e.g. ''amarok''
*Product: for installer select ''kde-windows''; for applications, find appropriate name, e.g. ''amarok''
*Component: options depend here on the selected product; e.g. for installer there are the following components:
*Component: the options here depend on the selected product; e.g. for installer there are the following components:
**buildsystem - The build system for KDE on Windows: plain cmake and [[Getting_Started/Build/KDE4/Windows/emerge|emerge]]
**buildsystem - The build system for KDE on Windows: plain cmake and [[Getting_Started/Build/KDE4/Windows/emerge|emerge]]
**gui - GUI-related issues for KDE on Windows
**gui - GUI-related issues for KDE on Windows
Line 15: Line 15:
*Installed from:
*Installed from:
**MS Windows - means that the source was the installer for Windows
**MS Windows - means that the source was the installer for Windows
**Compiled Sources - means you have compiled your binaries using ''emerge'' facility
**Compiled Sources - means you have compiled your binaries using the ''emerge'' facility
*Operating system: MS Windows
*Operating system: MS Windows


You can click with Ctrl key pressed to make multiple choices in a list.
You can click with the Ctrl key pressed to make multiple choices in a list.


===Sending a new report===
===Sending a new report===
To send a new report:
To send a new report:
#[https://bugs.kde.org/createaccount.cgi Create new account] (if you do not have one yet); note than your account will be assigned to your email address, which will then be available in the public.
#[https://bugs.kde.org/createaccount.cgi Create new account] (if you do not have one yet); note that your account will be assigned to your email address, which will then be publically available.
#[https://bugs.kde.org/query.cgi?GoAheadAndLogIn=1 Login].
#[https://bugs.kde.org/query.cgi?GoAheadAndLogIn=1 Login].
#Go to the [https://bugs.kde.org/wizard.cgi KDE Bug Report Wizard] and read information provided here if you are new to the bug tracking system.
#Go to the [https://bugs.kde.org/wizard.cgi KDE Bug Report Wizard] and read the information provided here if you are new to the bug tracking system.
#Click "Continue" button and select the KDE Version (most probably 4.x) and the Distribution Method - "MS Windows Binaries", the very last item on the list.
#Click the "Continue" button and select the KDE Version (most probably 4.x) and the Distribution Method - "MS Windows Binaries", the very last item on the list.
#Click "Continue" button and enter a component name (e.g. ''installer'' or ''amarok'') into the ''Find'' field, press Search button and select one of the items from the Application list. "Application" means "Product" here.
#Click the "Continue" button and enter a component name (e.g. ''installer'' or ''amarok'') into the ''Find'' field, press Search button and select one of the items from the Application list. "Application" means "Product" here.
#Fill the "Application Version" field and click "Continue".
#Fill the "Application Version" field and click "Continue".
#Enter the summary, select "MS Windows" as the operating system.
#Enter the summary, select "MS Windows" as the operating system.
#"Check for Duplicate Bug Reports" page appears; you have a chance to find already reported similar bugs; press "Continue" button if there is no similar report.
#When the "Check for Duplicate Bug Reports" page appears; you have a chance to find similar bugs that have already been reported; press the "Continue" button if there is no similar report.
#Fill "Severity" field and provide appropriate amount of information in the "Bug Description" box, then click "Finish".
#Fill "Severity" field and provide an appropriate amount of information in the "Bug Description" box, then click "Finish".


'''Notes'''
'''Notes'''
*Before reporting '''make sure''' that you are not going to duplicate already existing report.
*Before reporting '''make sure''' that you are not going to duplicate an already existing report.
*Each report has its own unique number and web page. You can correct the information you have provided in the report afterwards, e.g. fill in a product version.
*Each report has its own unique number and web page. You can correct the information you have provided in the report afterwards, e.g. fill in a product version.
*If you discover that a bug or a wish is not directly related to MS Windows (e.g. a bug can be reproduced on more or all operating systems), set the "operating system" field to "All" and the "platform" field to "unspecified".
*If you discover that a bug or a wish is not directly related to MS Windows (e.g. a bug can be reproduced in several or all operating systems), set the "operating system" field to "All" and the "platform" field to "unspecified".
*'''Do not use this [[Projects/KDE_on_Windows|KDE TechBase]] wiki site to report bugs. Use bugs.kde.org.'''
*'''Do not use this [[Projects/KDE_on_Windows|KDE TechBase]] wiki site to report bugs. Use bugs.kde.org.'''



Revision as of 17:01, 20 February 2008

Testing

The more you use the software, the more issues and wishes you can find. Do not keep this knowledge to yourself - file a bug at http://bugs.kde.org, the KDE Bug Tracking System (Bugzilla).

Querying existing reports

Bugzilla's Query form with installer product and buildsystem component selected (click to enlarge)

To find a report use the Query Reports form, where you can specify product, component, version, installation type and operating system, and a few other things. To find Windows-related reports, select one or more parameters of your search (which can make your result set more or less limited):

  • Product: for installer select kde-windows; for applications, find appropriate name, e.g. amarok
  • Component: the options here depend on the selected product; e.g. for installer there are the following components:
    • buildsystem - The build system for KDE on Windows: plain cmake and emerge
    • gui - GUI-related issues for KDE on Windows
    • installer - A graphical Installer for binary KDE packages (components and applications)
    • network&files - Network and file-handling -related issues for KDE on Windows
    • other - Other issues for KDE on Windows
  • Version: depends on the selected product; for installer it can be 4.0.0, etc. (you can check version in the "Help->About" dialog window of any application)
  • Installed from:
    • MS Windows - means that the source was the installer for Windows
    • Compiled Sources - means you have compiled your binaries using the emerge facility
  • Operating system: MS Windows

You can click with the Ctrl key pressed to make multiple choices in a list.

Sending a new report

To send a new report:

  1. Create new account (if you do not have one yet); note that your account will be assigned to your email address, which will then be publically available.
  2. Login.
  3. Go to the KDE Bug Report Wizard and read the information provided here if you are new to the bug tracking system.
  4. Click the "Continue" button and select the KDE Version (most probably 4.x) and the Distribution Method - "MS Windows Binaries", the very last item on the list.
  5. Click the "Continue" button and enter a component name (e.g. installer or amarok) into the Find field, press Search button and select one of the items from the Application list. "Application" means "Product" here.
  6. Fill the "Application Version" field and click "Continue".
  7. Enter the summary, select "MS Windows" as the operating system.
  8. When the "Check for Duplicate Bug Reports" page appears; you have a chance to find similar bugs that have already been reported; press the "Continue" button if there is no similar report.
  9. Fill "Severity" field and provide an appropriate amount of information in the "Bug Description" box, then click "Finish".

Notes

  • Before reporting make sure that you are not going to duplicate an already existing report.
  • Each report has its own unique number and web page. You can correct the information you have provided in the report afterwards, e.g. fill in a product version.
  • If you discover that a bug or a wish is not directly related to MS Windows (e.g. a bug can be reproduced in several or all operating systems), set the "operating system" field to "All" and the "platform" field to "unspecified".
  • Do not use this KDE TechBase wiki site to report bugs. Use bugs.kde.org.

Development

You can join the development team!

See also

FAQs
KDE Development FAQs
Bugsquad
The Bugsquad Team tries to keep track of bugs in KDE software and make sure that valid bugs are noticed by developers.
KDE Quality Team
The task of the KDE Quality Team is to detect the loose ends in an application, and try to tie them together.