Development/FAQs/General FAQ/nl

Ik wil beginnen aan een nieuw programma. Wat raad je aan?

We zijn het er allemaal over eens dat er heel veel KDE-programma's zijn die geschreven moeten worden. Maar er zijn ook veel bestaande KDE-programma's die je hulp nodig hebben.

Om te zien waar hulp nodig is, kun je deze pagina bekijken.

Voordat je een nieuwe applicatie start, is het altijd een goed idee om te kijken op KDE-Apps.org voor bestaande programma's, en op de kde-devel-maillijst te vragen of er nog niemand aan een soortgelijk project is begonnen.

Ik ben een ontwikkelaar; hoe kan ik bijdragen aan KDE-software?

Alhoewel Calligra en KDevelop zeer geliefd zijn, hebben ze maar weinig ontwikkelaars; je kunt daar eens kijken. Je hoeft geen ontwikkelaar van de KDE-werkruimte of het KDE-platform te zijn om mee te helpen. KDE-software is erg modulair, dus je kunt makkelijk één gebied verbeteren zonder te weten hoe de andere werken.

Je kunt ook vragen op kde-devel of iemand je hulp nodig heeft. Gebruik de nieuwste versie van je favoriete KDE-programma, en kijk waar er dingen nog ontbreken. Een themagenerator? Een Konsole-schemabewerker? Een spel dat verbeterd moet worden? Er is altijd wel iets wat beter kan. Implementeer dat!

Ben je bekend met een specifiek vakgebied? Kijk dan of er een gerelateerde applicatie is die je hulp kan gebruiken. Of schrijf er zelf een. KDE verwelkomt vooral wat meer applicaties die niet zijn gericht op experts.

Ik ben geen ontwikkelaar; hoe kan ik meehelpen?

Er zijn heel veel taken waarvoor geen ontwikkel-vaardigheden nodig zijn. Schrijf recenties van applicaties om publiciteit voor KDE te genereren (zie de maillijst kde-promo), help het documentatieteam (zie i18n.kde.org/doc), help de vertalers (zie i18n.kde.org), of help met het sorteren van de binnenkomende bug-rapporten (zie bugs.kde.org).

Waar kan ik afbeeldingen van het draakje Konqi vinden?

Een SDK voor Konqi is te vinden op ftp.kde.org/pub/kde/devel/konqi_sdk.tar.bz2
Deze stond eerst op artist.kde.org, maar deze site werd niet langer bijgehouden.

Meer afbeeldingen zijn te vinden op KDE-plaatjes.

Wat is het vereiste niveau om bij te dragen aan KDE? Wat moet ik leren? Wat moet ik lezen?

You need to know C++. Read the Qt tutorials and browse the Qt docs to get familiar with what's available with Qt. Then read the KDE tutorials and browse architecture and documentation. You can also read the KDE Book, it can not harm. But you don't have to be familiar with the whole KDE architecture to become a kde developer. Using kde's technologies is quite easy, so concentrate on what you really need, you can learn the other bits later on. KDE TechBase and doc.qt.nokia.com (also in your $QTDIR/doc/html) are invaluable resources, take advantage of them. Then, browse the source, look for the examples directories, see how the other did code their applications. Reading and writing code is the best way to learn.

How do I get KDE software from the KDE git or SVN repositories?

See the "Building and Running KDE Software From Source" section on the Getting_Started page.

Can I access KDE source code online?

Yes

• Browse http://websvn.kde.org/ and https://projects.kde.org/
• Search the source code at http://lxr.kde.org/search
• Browse API docs generated from the source code at http://api.kde.org/

What should I put in my .subversion/config?

[miscellany]
global-ignores = *.moc *.moc.cc *.moc.cpp config.log config.status \
config.cache *.gmo .deps .libs SunWS_cache *.lo *.la *.rpo *.la.closure \
*_la_closure.cpp *_la_closure.cc *_la_closure.cxx *.all_cc.cc *.all_cpp.cpp \
*.all_C.C *.all_cxx.cxx *_meta_unload.cc *_meta_unload.h *_meta_unload.cpp \
*_meta_unload.C *_meta_unload.cxx index.cache.bz2 .memdump Makefile.rules.in \
Makefile.calls.in Makefile.rules Makefile.calls autom4te.cache *.kidl \
*.o *.lo *.la #*# .*.rej *.rej *.pyc

En verder, om svn diff witruimte te laten negeren en functienamen te laten weergeven:

[helpers]
diff-cmd = /usr/local/bin/_svndiff

met het volgende in /usr/local/bin/_svndiff:

#!/bin/sh
exec /usr/bin/diff -b -u -p "$@"

Vergeet niet om /usr/local/bin/_svndiff uitvoerbaar te maken.

Ik wil mijn applicatie graag in KDE hebben...

Daar zijn drie vereisten voor:

• je programma moet compileren met de recentste KDE-versie (git master of SVN trunk);
• je programma moet stabiel zijn;
• je programma moet onderhouden worden. Je krijgt waarschijnlijk een berg aan bug-rapporten en wensen. Mensen verwachten dat je de bugs oplost en de (nuttige) wensen inbouwt.

Zie ook de volgende vraag.

Kun je beter binnen of buiten KDE ontwikkelen?

Eén van de hoofd-ontwikkelaars, Waldo Bastian, legt uit in een gecopyrighte mail (vertaald uit het Engels):

Onderdeel uitmaken van KDE betekent dat je zult moeten samenwerken met anderen. Zulke samenwerking brengt voordelen, maar ook verantwoordelijkheden met zich mee.

Enkele van deze voordelen zijn: je code belandt in alle distributies, mensen gaan misschien jouw bugs oplossen, je krijgt vanzelf vertalingen en documentatie, en je krijgt ladingen aan bug-rapporten.

Aan de andere kant zijn er nadelen en verantwoordelijkheden: je zult moeten communiceren met andere ontwikkelaars over je werk, andere mensen kunnen jouw code aanpassen, je moet *freezes* voor releases respecteren, je krijgt ladingen aan bug-rapporten en mensen verwachten ook nog eens dat je die oplost (wat zijn die aan het roken?), en mensen verwachten dat je je code onderhoudt.

Je kunt niet kiezen voor de voordelen, en de verantwoordelijkheden die erbij horen negeren; het is een compleet pakket; het is beide of niets.

In het algemeen zou het de auteur van een stuk software moeten zijn die kiest om zijn applicatie in KDE's repository's op te nemen. Meestal zetten we geen software in KDE tenzij de auteur dat graag wil. Aan de andere kant, als de auteur graag ergens anders werkt aan zijn applicatie, dan heeft hij dat recht. Tenzij er een splitsing is in de groep mensen die werkt aan de applicatie, heeft het geen zin om de ontwikkeling van een applicatie te forken om die reden.

MAAR... door je code onder een open-source-licentie te plaatsen, en het in een KDE-repository te plaatsen, geef je de hele wereld, en daarmee ook KDE in het bijzonder, het niet meer in te trekken recht om je code te gebruiken. En KDE zal dat recht, als dat nodig is, ook gebruiken om de belangen van KDE te beschermen, zelfs als dat dan tegen de wensen van de auteur ingaat.

Dat is belangrijk om te weten, maar wees niet bang. Meestal werkt het allemaal heel goed. In 5 jaar is het maar één keer voorgekomen dat werk van een ontwikkelaar in KDE gebleven is, terwijl deze ontwikkelaar het wilde verwijderen.

How do I get write access to KDE repositories?

See full article at Contribute > Get a KDE Contributor Account.

Go to [KDE Identity] , fill out the form and describe why you need write access. Make sure to specify your full name and e-mail address.

Please also include the name of your bugs.kde.org account, if non-existent please create one so that it can be given usual developer rights. Closing bugs.kde.org reports with keywords in commit comments only works if the email address of your KDE Identity and bugs.kde.org accounts match. You can change your bugs.kde.org address in the Bugzilla user settings.

Git requires use of an ssh key, and new accounts for SVN must also choose the svn+ssh protocol. Send a public ssh key (e.g. ~/.ssh/id_dsa.pub)

See also #How do I create a SSH key?

If you are contributing to an application that is not yours, it is a good idea to first submitting your coding as patches to the author and let him apply them. If the author is not maintaining his application, you might become the new maintainer...

Although there are few restrictions on repository commit rights, we expect you not to disrupt other developers' code without their consent. You must also respect the feature freezes of the release schedule (published on developer.kde.org)

A detailed list of rules you should follow when committing to KDE repositories are listed in the KDE Commit Policy.

My app is not stable but I would like to have it in KDE

As a first step, we can put it in playground, which is essentially "kde-alpha". Develop it there and when it is ready, request that your app to be moved to the appropriate KDE package or the extragear module.

I don't want to lose my SVN history.

This is no longer possible with Subversion. Maybe in the future, if the server is upgraded and allows that. Note that for git this is not an issue.

What is kdebindings?

It contains Qt bindings for Ruby, PHP, C# to use Qt classes with those langages, KDE bindings for Ruby, C#, python to use KDE classes with those langages, and XParts to embed non-KDE apps as a KPart. Check the binding page of TechBase.

Does the feature freeze apply to playground?

No, playground are not a released packages. The same is true for kdereview and extragear: they are not frozen and released. But if you want your app to move to a package, ask for it before the beta-release.

Can I have a stable and an unstable KDE on the same computer?

Yes, check the Building 2 Versions documentation.

How do I know which version of Qt/KDE I am using?

kde-config and all kde programs accept --version as argument.

Qt-copy or Qt from qt.nokia.com : if one were doing a clean build of trunk, which would be preferable?

You can use either. They are binary compatible (forward and backward). There can be, however, a few bugfixes in qt-copy over the most recent Qt release. Especially if building from qt-copy, pay attention to the apply-patches script.

How can I checkout a single directory from a SVN module?

Checkout the top-level dir with 'svn co -N /modulename', 'cd modulename', 'svn up admin' to get the admin/ dir and then finally checkout the dir you want with 'svn up subdir'

For instance, to get only reaktivate from playground/utils: svn co -N /playground/utils; svn up reaktivate Then compile as usual.

The same answer applies to the question "How do I get a single language out of kde-i18n?".

If you don't know the name of the directory you want to check out, you can browse websvn.kde.org to find it.

How can I get one of the KDE application as a standalone tarball?

kdesdk/scripts/svn2dist is a script to extract an application from the KDE source tree and package it as a standalone application.

How do I close my own bug reports?

If you reported a bug that is fixed in a new release of KDE but is still reported as open, you can close it. It might happen because your bug is the same as another one, or simply because the developer fixed something without noticing that it would correct your bug.

You can do that from your Subversion commit. To do so, append to your commit message a line like this:

BUG: XXXXX where XXXXX is the bug report you want to close. If the report you're closing is adding a new feature, you can use FEATURE instead of BUG.

Managing a bug list is a huge task for the developers and they usually have a lot of bugs listed, some being fixed already without their knowledge, some being unreproducible, some without enough information to be corrected, etc. If you can help by managing and updating the list of outstanding bugs, you will be gladly welcome. And you will receive an even happier welcome if you provide a patch.

How do I create a SSH key?

SSH makes use of two keys: a private key and a public key. You should keep the private key secret at all times and only place it on machines over which you have direct control. Public, shared, and community machines are not suitable environments to store SSH private keys. Take action to help prevent theft of your SSH private key data. Setting a password on your SSH private key will help reduce the risks involved with private key theft.

Generate a key pair for each major location you work from. This helps to reduce the impact when your key gets stolen. When someone obtains access to your private key, your key can be abused in attempts to compromise KDE servers. Well known open source projects have been compromised this way in the past, YOU must help us to make sure that this doesn't happen with KDE servers as well. For that reason it is important to notify sysadmin (at) kde (dot) org immediately when you notice that someone may have had access to your private key for example when a computer on which it was stored has been hacked or infected with a virus, worm or trojan.

If you choose to make a backup of your SSH private key data, please ensure that any such backup is stored in a secure manner as well.

For the practical part, the following command can be used to generate a SSH private/public key pair with ssh-keygen -t dsa This will create a private key as ~/.ssh/id_dsa and a public key as ~/.ssh/id_dsa.pub.

There are times when you may want to use a key of a different name to the default, perhaps to use separate keys for different projects. To let SSH know which key you want to use for KDE.org, you can keep a list of servers and their corresponding keys in ~/.ssh/config. For example,

Host svn.kde.org 
IdentityFile ~/.ssh/id_dsa_kde

In order to use SSH to access KDE servers you need to send your public key to sysadmin (at) kde (dot) org.

How can I monitor changes made by others?

The kde-commits mailinglist carries automatic notifications for all changes made in the KDE repositories. The KDE-Commits mailinglist is very high traffic. An alternative is CommitFilter which allows you to get notification for only those areas that interest you.