Importer votre projet dans KDE CVS

Votre programme intéresse les autres, vous sentez que vous avez du temps pour travailler dessus, vous avez besoin de plus de retour et d'aide pour l'améliorer. Vous acceptez le fait de le passer en licence GPL ou équivalent. Vous pouvez demander un compte CVS pour l'importer dans kdeonbeta. Le module kdeonbeta est assez volumineux et et n'est pas distribué avec la version officielle de KDE. Il n'est ni packagé ni traduit et le gel des fonctionnalités de s'applique pas à kdeonbeta. Son but est de permettre aux autres développeurs de travailler sur votre application et de la tester. Bien sûr il vous faudra qt-copy, arts et kdelibs de CVS HEAD au moins. Consultez à ce sujet le tutoriel ici traitant de la compilation KDE depuis CVS.

Pour obtenir un compt CVS, suivez les instructions suivantes. Envoyez un mail à sysadmin (at) office (dot) kde (dot) org pour argumenter votre accès à cvs. Expliquez ce qu'apporterea votre application au module kdenonbeta. Assurez vous de spécifier correctement votre nom complet et votre e mail, si le champ expéditeur du mail ne le précise pas. Vous pouvez également choisir un surnom ou un login. Vous avez le choix actuellement entre le protocole CVS standard non crypté (pserver) ou par le protocle SSH. Si vous choisissez pserver, envoyez aussi un mot de passe crypté (en utilisant useradd dummy ; passwd dummy ; grep dummy /etc/passwd /etc/shadow). Si vous choisissez la solution SSH, envoyez une clé publique SSG. (e.g. ~/.ssh/id_dsa.pub).

Attendez ensuite la réponse de l'administrateur KDE sysadmin. Wait for the answer from a KDE sysadmin.

Une fois que vous avez compilé au moins qt-copy, arts, et kdelibs, vous devrez récupérer les fichiers (kdenonbeta). Connectez vous au server CVS avec votre login et votre mot de passe.

    $ cvs co -l kdenonbeta
    $ cd kdenonbeta
    $ cvs co admin  (or ln -s ../kde-common/admin .admin)

Vous copiez le répertoire principal de votre projet en totalité dans kdenonbeta, et à la racine de votre projet, vous terminez par

    $ make disclean

Tous les fichiers .o doivent disparaitre. Vous pouvez également supprimer à la main tous les Makefile, Makefile.in (mais pas Makefile.am) et tous les fichiers de kdeveloop. Supprimez les dossiers admin, autom4te.cache, debug, doc, po and templates. Vous devez simplement garder quelques fichiers et le sous répertoire src. Ensuite, retourner dans kdenonbeta par cd .. et saisissez :

    $ make -f Makefile.cvs
    $ ./configure --prefix=$KDEDIR
    $ cd your_project_name
    $ make
    $ su -c 'make install'

Toutes ces étapes se passent normalement bien. Si toutefois vous recontrez des erreurs, vous devriez pouvoir les corriger en lisant attentivement le message d'erreur. Si vous être vraiment bloqué, demander sur IRC #kde ou #kde-devel, on vous aidera.

puis dans le répertoire kdenonbeta :

    $ cvs add your_project_name
    $ cvs add your_project_name/*
    $ cvs add your_project_name/src
    $ cvs add your_project_name/src/*
    $ cvs commit

Vous obtenez la fenêtre (éditeur vi par défaut) où vous pouvez marquer votre message. Il est pratique de noter ce que votre modification fait. Dans votre cas, vous marqueriez (aec un i avant si vous utilisez vi pour passer en mode édition) :

Premier import de votre_application qui fait tel et tel chose.

Vérifiez que tous les fichiers ont été ajoutés correctement. Sinon, utilisez cvs add filename et cvs commit.

Chaque fois que vous souhaitez travailler sur votre projet, n'oubliez pas de l'inscrire dans le server kde avec votre login et mot de passe et faites :

    $ cvs up

pour vous assurer que vous avez la dernière version.