KonsoleDevelopment: Difference between revisions

From KDE UserBase Wiki
(Marked this version for translation)
m (kde-baseapps->applications)
 
(9 intermediate revisions by 5 users not shown)
Line 18: Line 18:


<!--T:6-->
<!--T:6-->
* Git: In Feb, 2011, konsole now has its own [https://projects.kde.org/projects/kde/kdebase/konsole/repository repository].  It is now much easier to download and look at the code.  
* Git: In Feb, 2011, konsole now has its own [https://projects.kde.org/projects/kde/applications/konsole/repository repository].  It is now much easier to download and look at the code.  


<!--T:7-->
<!--T:7-->
Line 26: Line 26:


<!--T:9-->
<!--T:9-->
* Confirm bug reports - search for [https://bugs.kde.org/buglist.cgi?query_format=advanced&short_desc_type=allwordssubstr&short_desc=&product=konsole&long_desc_type=substring&long_desc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&keywords_type=allwords&keywords=&bug_status=UNCONFIRMED&bug_severity=critical&bug_severity=grave&bug_severity=major&bug_severity=crash&bug_severity=normal&bug_severity=minor&emailassigned_to1=1&emailtype1=substring&email1=&emailassigned_to2=1&emailreporter2=1&emailcc2=1&emailtype2=substring&email2=&bugidtype=include&bug_id=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&cmdtype=doit&order=Importance&field0-0-0=noop&type0-0-0=noop&value0-0-0 unconfirmed bugs] and test them on your system. If you can duplicate the bug, mark it as 'New' and/or leave a comment with your findings.
* Confirm bug reports - search for [https://bugs.kde.org/buglist.cgi?query_format=advanced&short_desc_type=allwordssubstr&short_desc=&product=konsole&long_desc_type=substring&long_desc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&keywords_type=allwords&keywords=&bug_status=UNCONFIRMED&bug_severity=critical&bug_severity=grave&bug_severity=major&bug_severity=crash&bug_severity=normal&bug_severity=minor&emailassigned_to1=1&emailtype1=substring&email1=&emailassigned_to2=1&emailreporter2=1&emailcc2=1&emailtype2=substring&email2=&bugidtype=include&bug_id=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&cmdtype=doit&order=Importance&field0-0-0=noop&type0-0-0=noop&value0-0-0 unconfirmed bugs] and test them on your system. If you can reproduce a bug, mark it as 'New'(if you have a account with enough permission on bugs.kde.org) and/or leave a comment with your findings.


<!--T:10-->
<!--T:10-->
Line 32: Line 32:


<!--T:11-->
<!--T:11-->
* Narrow down the steps  required to display a bug or crash - Often times, the bug reporter may not fully explain or understand how they got the bug or crash.  It is extremely helpful when tracking down issues if there is a step by step process that triggers the issue everytime.  If you can reproduce the issue repeatedly, comment on the bug report the exact steps required to trigger it.
* Narrow down the steps  required to reproduce a bug or crash - Often times, the bug reporter may not fully explain or understand how they got the bug or crash.  It is extremely helpful when tracking down issues if there is a step by step process which triggers the issue everytime.  If you can reproduce the issue repeatedly, comment on the bug report with the exact steps required to trigger it.
 


=== Handbook === <!--T:12-->
=== Handbook === <!--T:12-->
Line 45: Line 44:


<!--T:15-->
<!--T:15-->
* Verify the [[Konsole|Konsole]] site has the correct info.
* Verify the [[Special:myLanguage/Konsole|Konsole]] site has the correct info.
* Expanding the site with more tips and documentation.
* Expanding the site with more tips and documentation.
=== Coding === <!--T:18-->
<!--T:19-->
* There are a multitude of ways to start coding.  You'll need to be able to compile KDE.  [http://techbase.kde.org/Getting_Started Getting started] is a good place to start.  You don't need to have both KDE 4.6 and trunk installed.  If you are currently running the latest KDE 4.6.x, you should be able to checkout Konsole and get it to compile.  I highly suggest using [http://kdesrc-build.kde.org kdesrc-build] to download and compile the KDE source files.  Regardless if you are using KDE 4.6 or trunk, any type of patch can be attached to a bug report, sent to git.reviewboard.kde.org or the Konsole mailing-list.
<!--T:20-->
Since 4.6, Konsole has its own git repository [https://projects.kde.org/projects/kde/applications/konsole].  From there, you can view the branches and latest commits.
<!--T:21-->
* Once you can build Konsole, find some area you are interested in and try to work on it. 
<!--T:22-->
** [https://bugs.kde.org/buglist.cgi?query_format=advanced&short_desc_type=allwordssubstr&short_desc=&product=konsole&component=general&long_desc_type=allwordssubstr&long_desc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&keywords_type=allwords&keywords=&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&bug_severity=wishlist&emailassigned_to1=1&emailtype1=substring&email1=&emailassigned_to2=1&emailreporter2=1&emailcc2=1&emailtype2=substring&email2=&bugidtype=include&bug_id=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&cmdtype=doit&order=Reuse+same+sort+as+last+time&field0-0-0=noop&type0-0-0=noop&value0-0-0= Wishlists] - A very long list of features users have asked for
<!--T:23-->
** [https://bugs.kde.org/buglist.cgi?query_format=advanced&short_desc_type=allwordssubstr&short_desc=&product=konsole&long_desc_type=substring&long_desc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&keywords_type=allwords&keywords=junior-jobs&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&emailassigned_to1=1&emailtype1=substring&email1=&emailassigned_to2=1&emailreporter2=1&emailcc2=1&emailtype2=substring&email2=&bugidtype=include&bug_id=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&cmdtype=doit&order=Reuse+same+sort+as+last+time&field0-0-0=noop&type0-0-0=noop&value0-0-0= Junior Jobs] - Some 'easy' reports to work on.
<!--T:24-->
** [https://bugs.kde.org/buglist.cgi?query_format=advanced&short_desc_type=allwordssubstr&short_desc=&product=konsole&long_desc_type=allwordssubstr&long_desc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&keywords_type=allwords&keywords=&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&bug_severity=normal&emailassigned_to1=1&emailtype1=substring&email1=&emailassigned_to2=1&emailreporter2=1&emailcc2=1&emailtype2=substring&email2=&bugidtype=include&bug_id=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&cmdtype=doit&order=Reuse+same+sort+as+last+time&field0-0-0=noop&type0-0-0=noop&value0-0-0= Bugs] - Reports of things wrong and need fixed
<!--T:25-->
* Notes
** Before spending a lot of time working on a bug or feature,  please send an email to the Konsole mailing list and/or comment on the bug report that you are working on it.
**  New features and such things as string changes can only go into trunk (master), not to point releases (eg 4.6.2).
=== Questions? === <!--T:26-->
Feel free to let me know of any questions or any suggestions on how to make this page better.




Line 56: Line 85:
[[Category:Desktop]]
[[Category:Desktop]]
[[Category:System]]
[[Category:System]]
[[Category:Advanced Users]]
[[Category:Development]]
</translate>
</translate>

Latest revision as of 07:43, 16 March 2013

General Information

Anyone can help if they have the time. There is no requirements to know programming languages or install special software. If you are running KDE, you can help. It will be more helpful if you can run the latest KDE versions. This is often in distribution's "unstable" or "bleeding-edge" repositories. Also, installing KDE with debugging symbols will help with crashes, although your system will be much slower.

For some of the categories below, you don't need the KDE source installed on your system.

Check out the general KDE contribute page.

  • KDE versions: It would be best to have KDE 4.6.x installed. You can use KDE 4.5.4; however, KDE 4.4.x is too old and has too many bugs that have been fixed.
  • Git: In Feb, 2011, konsole now has its own repository. It is now much easier to download and look at the code.

To keep up with bug reports and general info join the Konsole mailing list. You can reach me at kurt dot hindenburg at gmail.com, as well as on IRC #kde-devel as khindenburg.

Bug Reports

  • Confirm bug reports - search for unconfirmed bugs and test them on your system. If you can reproduce a bug, mark it as 'New'(if you have a account with enough permission on bugs.kde.org) and/or leave a comment with your findings.
  • Find duplicate reports - search all of Konsole's bugs and wishlist reports for duplicates. If you find a possible duplicate, leave a comment on the bug such as "possible duplicate of bug #####'.
  • Narrow down the steps required to reproduce a bug or crash - Often times, the bug reporter may not fully explain or understand how they got the bug or crash. It is extremely helpful when tracking down issues if there is a step by step process which triggers the issue everytime. If you can reproduce the issue repeatedly, comment on the bug report with the exact steps required to trigger it.

Handbook

  • Verify the menus and their shortcuts are valid.
  • Verify all the other information is valid.
  • Read through it for areas that need clarified or expanded on.

Userbase Site

  • Verify the Konsole site has the correct info.
  • Expanding the site with more tips and documentation.

Coding

  • There are a multitude of ways to start coding. You'll need to be able to compile KDE. Getting started is a good place to start. You don't need to have both KDE 4.6 and trunk installed. If you are currently running the latest KDE 4.6.x, you should be able to checkout Konsole and get it to compile. I highly suggest using kdesrc-build to download and compile the KDE source files. Regardless if you are using KDE 4.6 or trunk, any type of patch can be attached to a bug report, sent to git.reviewboard.kde.org or the Konsole mailing-list.

Since 4.6, Konsole has its own git repository [1]. From there, you can view the branches and latest commits.

  • Once you can build Konsole, find some area you are interested in and try to work on it.
    • Wishlists - A very long list of features users have asked for
    • Bugs - Reports of things wrong and need fixed


  • Notes
    • Before spending a lot of time working on a bug or feature, please send an email to the Konsole mailing list and/or comment on the bug report that you are working on it.
    • New features and such things as string changes can only go into trunk (master), not to point releases (eg 4.6.2).

Questions?

Feel free to let me know of any questions or any suggestions on how to make this page better.


More to follow