Contribuer à &arts;
Comment nous aider
Le projet &arts; peut profiter de l'aide de développeurs pour rendre les applications multimédia existantes compatibles avec &arts;, pour écrire de nouvelles applications multimédia, et pour améliorer les fonctionnalités de &arts;. Cependant, vous pouvez contribuer sans être développeur. Nous avons besoin de l'aide de testeurs qui nous soumettent des rapports de bogue, de traducteurs pour l'application et la documentation dans d'autres langues, d'artistes pour réaliser les graphismes (particulièrement pour les modules de artsbuilder), de musiciens pour créer de nouveaux modules pour &arts;, et de rédacteurs pour écrire ou améliorer la documentation.
Listes de discussion
Les discussions relatives au développement de &arts; ont lieu sur deux listes de discussions. Nous y parlons des nouvelles idées de caractéristiques et d'implantations, et nous y résolvons un certain nombre de problèmes.
La liste de discussion &kde; Multimedia concerne les problèmes multimédia de &kde; en général, y compris &arts; et les applications multimédia comme &noatun; et &aktion;. Vous pouvez vous y inscrire depuis la page web à http://www.kde.org/mailinglists.html ou envoyer un message électronique dont le sujet est subscribevotre adresse électronique à kde-multimedia-request@kde.org. Cette liste est aussi archivée à http://lists.kde.org.
La liste de discussion de &arts; est spécifique à &arts;, y compris les utilisations de &arts; indépendamment de &kde;. Pour vous inscrire, envoyez un message électronique avec le message subscribe votre adresse électronique à arts-request@space.twc.de La liste est archivée à http://space.twc.de/~stefan/arts-archive.
Style de programmation
Pour obtenir un code source homogène, il est important de garder un style de programmation dans tous les sources de &arts;. Même si vous écrivez simplement un module, essayez d'écrire et formater votre source en conséquence, de façon à faciliter le travail de différentes personnes dans la gestion des sources, et faciliter la copie de morceaux de codes d'un source vers un autre.
Nom des fonctions membres
Style &Qt;/&Java;, ce qui signifie une majuscule au début de chaque mot, et la première lettre toujours en minuscule ; aucun caractère de soulignement.
Ceci signifie par exemple :
createStructureDesc()
updateWidget();
start();
Membres de classes
Les membres de classes s'écrivent en minuscule, comme par exemple menubar ou button.
Lorsqu'il y a des fonctions d'accès, le standard devrait être celui de &MCOP;, c'est-à-dire lorsque vous avez un membre foo de type long, qui ne doit pas être visible directement, vous créez les fonctions :
foo(long new_value);
long foo();
pour récupérer et envoyer les valeurs. Dans ce cas, la valeur réelle de foo devrait être stockée dans _foo.
Nom des classes
Toutes les classes doivent s'écrire avec une majuscule au début de chaque mot, par exemple ModuleView, SynthModule. Les classes qui appartiennent aux librairies doivent utiliser les espaces de noms de &arts;, comme Arts::Soundserver.
Les implantations des classes &MCOP; doivent être appelées Class_impl, comme par exemple SoundServer_impl.
Paramètres
Les paramètres sont toujours en minuscule.
Variables locales
Les variables locales sont toujours en minuscule, et ont des noms comme i, p, x, &etc;
Largeur de tabulation (largeur du décalage)
Une tabulation correspond à 4 espaces.
Espaces dans les expressions
Vous n'avez normalement pas à utiliser d'espaces dans les expressions. Vous pouvez cependant les utiliser entre les opérateurs et leurs opérandes. Si vous placez un espace avant un opérateur (&pex; +), vous devez alors en placer un après l'opérateur. La seule exception correspond aux expressions de type liste (avec une virgule), où ou ne devez placer un espace qu'après la virgule, mais pas avant. Vous pouvez également ommettre la virgule ici.
Les exemples suivants montrent une bonne utilisation des espaces :
{
int a,b;
int c, d, e;
int f = 4;
a=b=c=d+e+f;
a = b = c = d + e + f;
if(a == 4) {
a = b = c = (d+e)/2;
}
while(b<3)
c--;
arts_debug("%d\n", c);
}
Les exemples suivants montrent comment ne pas utiliser les espaces. Pour les appels de fonction, après if, while, for, switch &etc;, on ne met pas d'espace.
{
// MAUVAIS : si vous écrivez une liste, écrivez les espces uniquement après la virgule
int a , b , c , d , e , f;
// MAUVAIS : utilisation non symétrique des lesapces pour l'opérateur =
a= 5;
// MAUVAIS : si considéré comme fonction, et n'est pas suivi par un espace
if (a == 5) {
}
// MAUVAIS : n'écrivez pas d'espace après un while
while (a--)
b++;
// MAUVAIS : les noms de fonctions ne sont pas suivis par un espace
arts_debug ("%d\n", c);
// MAUVAIS : ni les noms de membres
Arts::Object o = Arts::Object::null ();
}
Noms des fichiers sources
Les fichiers sources sont en minuscule. Ils doivent porter le nom de la classe lorsqu'ils implantent une classe unique. Leur extension est .cc s'ils contiennent du code indépendant de &Qt;/&GUI;, et ..cpp s'ils contiennent du code dépendant de &Qt;/&GUI;. Les fichiers d'implantation pour les interfaces doivent être appelés foo_impl, si Foo est le nom de l'interface.
Les fichiers &IDL; doivent être appelés de manière descriptive pour l'ensemble des interfaces qu'ils contiennent, aussi tout en minuscule. En particulier, il est déconseillé de donner à un fichier &IDL; le nom de la classe elle-même, car le sélecteur de fichiers .mcopclass (.mcopclass trader) et les informations de type entreront en conflit.