Project:KDE

In addition to its primary goal of support for all packages produced by the KDE Community, the Gentoo KDE Project maintains a variety of other KDE-based applications and underlying support packages in order to provide a first-class KDE experience.

Supported areas
Our primary focus is the same as upstream - the latest generation of KDE software:


 * KDE Frameworks (kde-frameworks/*)
 * KDE Plasma (kde-plasma/*)
 * KDE Applications (kde-apps/*)

We have a secondary focus on:
 * Other KDE-produced software (such as and )
 * Miscellaneous KDE-specific software (kde-misc/*)
 * Popular KDE-based software not already maintained (such as and )
 * Tools that support all of the above (such as and )

Legacy areas such as Plasma 4 are retained for now, but only receive minimal maintenance and are no longer supported by upstream.

Support and assistance
There are several ways to get support with KDE related issues:


 * To install KDE on Gentoo, use the KDE Guide. This guide covers the installation of Plasma 5 and the various KDE applications.
 * You can join #gentoo-kde on the Freenode IRC network. You'll find some of the team members there most of the time.
 * You can address your concerns in the Gentoo Forums. Not all of us are avid forums users but many experienced users and some developers are likely to be able to help you.
 * The gentoo-desktop and gentoo-user mailing lists can be used to discuss problems and announce various things (like meetings or important changes). It's necessary to subscribe before posting.
 * Of course, you can also file a bug report. Please read How to report bugs before.

Contributing
There's lots of ways to contribute to KDE on Gentoo, even if you are new or not familiar with ebuilds.

Supporting the community
You can help answer questions and participate in discussions over various mediums:


 * Gentoo Forums, usually the Desktop Environments forum.
 * IRC channels such as, , and
 * Mailing lists such as gentoo-user and gentoo-desktop.

Improving documentation
You are welcome to add and edit wiki articles - be bold:


 * Start a new wiki article to document a new subject, knowledge or package.
 * Improve existing documentation by clicking Edit at the top right of an article.
 * Translate documentation for foreign readers.

Reporting bugs
Bugs can usually be usually be classified as either an upstream or a downstream bug.

Issues such as build failure, missing dependencies, or features not working in Gentoo (but work in other distros) are usually downstream bugs and should be reported on Gentoo's bugzilla.

Runtime issues such as crashes or incorrect package behaviour are usually upstream bugs and should be reported on the KDE Bugtracking System. If there is a fix available that needs backporting or some other reason we need to track the bug, feel free to file a Gentoo bug about the issue too.

If in doubt, please file a Gentoo bug and we can advise you how to proceed.

In either case, please check troubleshooting, search for existing reports, and try with the latest package version before reporting.

Resolving bugs
You can help to review and resolve existing bugs:


 * Try to reproduce the issue and report your findings
 * Check to see if others are having the same problem - often further information or solutions can be found on the forums, other distributions' bugtrackers, Google...


 * If you want to contribute code, please fork the kde overlay github mirror and send pull requests
 * Please read the coding style guide first
 * Once your pull request is merged/rebased you will get an entry in CONTRIBUTORS hall of fame

Finally, it would be great to chat to you on IRC, too - this is how we normally get to know each other. Please drop into #gentoo-kde and chat with us. If you have any problems or questions, feel free to /query individual team members or ask in #gentoo-kde, #gentoo-desktop or #gentoo.

Development information
We provide a number of documents to support working with KDE-related ebuilds and eclasses in Gentoo:


 * /Coding style/
 * /Ongoing tasks/
 * Miscellaneous stuff