Brug af CVS

CVS er et program som hjælper med at holde styr på mange mennesker, der på samme tid arbejder på det samme materiale. Alle brugere opretter en lokal kopi af hovedarkivet. De lokale kopier kan være på den samme maskine eller på den anden side af kloden. Brugerne kan på den måde redigere i den lokale kopi som de ønsker, og når redigeringen er færdig commit'e ændringerne til hovedarkivet.

Hvad angår læseadgang, er det muligt at anvende web-grænsefladen. Der er også mange grafiske CVS-klienter, så som KDE's cervisia. Dette dokument beskriver arbejdsgangen med kommandolinjeprogrammet cvs, andre klienter har tilsvarende funktionalitet.

CVS giver dig ikke lov til at commit'e en fil hvis kopien i hovedarkivet er blevet ændret siden din seneste opdatering. Det er normalt ikke et problem da du stadig kan opdatere din lokale kopi. Hvis ændringerne er i andre dele end den du arbejdede på, indflettes ændringerne uden videre. Hvis ændringerne påvirker det samme område som du arbejdede på, vil du få en advarsel om at der er opstået en konflikt og at du er nødt til at ændre i filen for at rette problemet, før den kan commit'es (indsendes).

I det efterfølgende anvendes anonym adgang som eksempel. Hvis du har adgang til en konto som giver dig skriverettigheder til arkivet, skal du i stedet anvende denne konto. Hvis du planlægger at foretage ændringer skal du først have en konto, da anonyme brugere ikke kan commit'e ændringer. Se afsnittet om afsnittet om skriveadgang for flere oplysninger.

For at kunne bruge CVS skal du først logge på CVS-serveren

   cvs -d :pserver:anonymous@cvs.debian.org:/cvs/webwml login

(bare tryk på enter når der bliver bedt om adgangskode)

For at hente ("check out") en kopi af wml-filerne til din lokale maskine skal du bruge

   cvs -d :pserver:anonymous@cvs.debian.org:/cvs/webwml checkout webwml

Du kan hente ("check out") en delmænge af siderne på følgende måde:

   cvs -d :pserver:anonymous@cvs.debian.org:/cvs/webwml checkout -l \
          webwml webwml/<sprog>
   cvs -d :pserver:anonymous@cvs.debian.org:/cvs/webwml checkout \
          webwml/Perl webwml/english/template webwml/<sprog>/Pics
   cvs -d :pserver:anonymous@cvs.debian.org:/cvs/webwml checkout \
          webwml/<sprog>/<sti til ønskede filer>

Gentag det for alle undermapper eller filer som du har brug for. Den anden linie inkluderer alle filer du har brug for, hvis du ønsker at lave HTML-filer ud fra WML-filerne. Delvise hentninger ("check out") som disse understøttes dog egentlig ikke, så vejledningen ovenfor virker måske ikke altid.

Hvis du har fået et brugernavn med en tilhørende adgangskode, så brug det i stedet for "anonymous":

   cvs -d :pserver:brugernavn@cvs.debian.org:/cvs/webwml checkout webwml/english/doc

Fra nu af behøver du ikke '-d :pserver:...'-delen. Hver gang der er gået nogle dage skal du udføre

   cvs update -d

for at hente alle filer fra arkivet som er blevet ændret. Parameteret -d til "update"-funktionen tilføjer automatisk nye mapper. Det kan være en god idé at oprette en ~/.cvsrc-fil så du ikke behøver at skrive alle parametrene hver gang. Filen kan foreksempel indeholde:

cvs -z9
update -d -P
diff -u

Følgende er til folk som har skriverettigheder til arkivet. Når du er færdig med en side kan du commit'e dine ændringer til arkivet med

   cvs commit <file>.wml

eller

   cvs commit <dir>    (for at commit'e alle ændringer i <dir>)

eller

   cvs commit   (commit'e alle ændringer fra aktuelt mappe og underliggende)

Hvis du er den første som oversætter en side, skal du også udføre

   cvs add <fil>.wml

før du kan commit'e den. Bemærk at cvs add ikke er rekursiv, hvorfor du er nødt til at tilføje mappen før du kan tilføje dens indhold.

Brug info cvs for flere oplysninger om CVS.

Skriveadgang til CVS

For oplysninger om hvordan man får skriveadgang til CVS, se http://people.debian.org/~joey/misc/webwml.html.