# Att bidra till &arts;

## Hur du kan hjälpa till

&arts;-projektet behöver hjälp från utvecklare att att lägga till stöd för &arts; i befintliga multimediaprogram, skriva nya multimediaprogram och förbättra &arts; möjligheter. Du behöver dock inte vara en utvecklare för att bidra. Vi behöver också hjälp från testare för att skicka in felrapporter, översättare för att översätta programtexten och dokumentationen till andra språk, grafiker för att skapa ikoner (särskilt för artsbuilder moduler), musiker för att skapa &arts;-modulexempel, och författare för att skriva eller granska dokumentation.

## E-postlistor

De flesta utvecklingsdiskussioner om &arts; äger rum via två e-postlistor. Det här är stället att diskutera nya funktioner och implementeringsidéer och att fråga efter hjälp med problem.

&kde;:s multimedia e-postlista är till för generella &kde; multimediafrågor inklusive &arts; samt multimediaprogram som &noatun; och &aktion;. Du kan prenumerera från webbsidan på http://www.kde.org/mailinglists.html eller skicka e-post med rubriken `subscribe din-e-postadress` till kde-multimedia-request@kde.org. Listan finns också arkiverad på http://lists.kde.org.

E-postlistan för &arts; är till för frågor som enbart rör &arts;, inklusive användning av &arts; utanför &kde;. För att prenumerera, skicka e-post till arts-request@space.twc.de med meddelandetexten `subscribe din-epostadress`. Listan arkiveras på http://space.twc.de/~stefan/arts-archive.

## Kodningsstandarder

För att åstadkomma en konsekvent läsning av all källkod, är det viktigt att hålla kodningsstilen likadan i hela &arts; källkod. Var snäll och försök skriva/formattera din källkod i enlighet med detta, även om du bara skriver en modul, eftersom det gör det enklare för olika personer att underhålla källkodsträdet, och lättare att kopiera delar av källkoden från en fil till en annan.

Namngivning av medlemsfunktioner

  &Qt;/&Java;-stil. Det här betyder att stora bokstäver används för att markera nya ord, och att första bokstaven alltid är liten. Inga understreck.

  Det här betyder till exempel:

      createStructureDesc()
         updateWidget();
         start();

Klassmedlemmar

  Klassmedlemmar har inte stora bokstäver, som till exempel menubar eller button.

  När det finns funktioner som används för åtkomst, ska standarden som används vara enligt &MCOP;-sättet, dvs. om det finns en "long" medlem `foo`, som inte ska vara synlig, så skapas:

      foo(long new_value);
         long foo();

  funktioner för att hämta eller sätta ett värde. I detta fall, ska det riktiga värdet för `foo` lagras i &lowbar;foo.

Klassnamn

  Alla klasser ska ha stora bokstäver för varje ord, vilket betyder `ModuleView`, `SynthModule`. Alla klasser som hör till biblioteken ska använda &arts;-namnrymden, som `Arts::Soundserver`.

  Implementeringar av &MCOP;-klasser ska döpas `Class&lowbar;impl`, som till exempel `SoundServer&lowbar;impl`.

Parametrar

  Parametrar har alltid små bokstäver.

Lokala variabler

  Lokala variabler har alltid små bokstäver, och kan ha namn som `i`, `p`, `x` etc. om det passar.

Tabulatorbredd (skiftbredd)

  Ett tabulatortecken är lika mycket som fyra blanktecken.

Mellanslag i uttryck

  Normalt behöver du inte använda mellanslag i uttryck. Du kan i alla fall använda dem mellan operatorer och deras operander. Om du skriver ett mellanslag före en operator (t.ex. +), måste du också skriva ett mellanslag efter operatorn. Det enda undantaget från detta är uttryck som liknar listor (med ,), där du bara ska använda ett mellanslag efter ",", men inte före. Det är också ok att utelämna mellanslag här.

  Följande exempel demonstrerar bra användning av mellanslag:

      {
          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);
      }

  Följande exempel demonstrerar hur man inte ska använda mellanslag. För funktionsanrop, efter if, while, for, switch och så vidare, skrivs inget mellanslag.

      {
          // DÅLIGT: Om du skriver en lista, skriv bara mellanslag efter ","
          int a , b , c , d , e , f;

          // DÅLIGT: inte symmetrisk användning av mellanslag för = operatorn
          a= 5;

          // DÅLIGT: Om det anses vara en funktion, och inte följs av ett mellanslag
          if (a == 5) {
          }

          // DÅLIGT: skriv inte ett mellanslag efter while
          while (a--)
              b++;

          // DÅLIGT: Funktionsnamn följs inte av ett mellanslag
          arts_debug ("%d\n", c);

          // DÅLIGT: inte heller medlemsnamn
          Arts::Object o = Arts::Object::null ();
      }

Namngivning av källkodsfiler

  Källkodsfiler ska inte ha några stora bokstäver i namnet. De ska ha samma namn som klassen om de implementerar en enda klass. Deras filändelse ska vara `.cc` om de innehåller &Qt;- och grafikoberoende kod, och `.cpp` om de innehåller &Qt;- och grafikberoende kod. Implementeringsfiler för gränssnitt ska benämnas `foo_impl`, om Foo är gränssnittets namn.

  &IDL;-filer ska benämnas på ett beskrivande sätt med tanke på den samling gränssnitt de innehåller, också helt med små bokstäver. I synnerhet är det inte bra att benämna en &IDL;-fil som klassen själv, eftersom .mcopclass-handlaren och typinfoposterna då kommer att kollidera.