Nota: L'originale è più recente di questa traduzione.

Usare il CVS

CVS è un programma che aiuta molte persone a lavorare sullo stesso materiale allo stesso tempo. Ogni utente si crea una copia locale dell'originale. La copia locale può essere sulla stessa macchina o sparsa per il mondo. Gli utenti possono quindi modificare la copia locale fino ad avere un materiale completo per essere usato. Allora possono portare tutte le loro modifiche sull'originale (commit.)

CVS non permette di definire una modifica sull'originale se nel frattempo altri l'hanno già cambiato. Questo di norma non è un grosso problema poiché si può sempre aggiornare la copia locale. Se invece le modifiche erano su avvenute su varie parti non toccate da te allora queste avverranno senza problemi. Se le modifiche hanno a che fare con la stessa parte sulla quale stai lavorando allora sarai avvisato del conflitto e dovrai modificare i file prima di poter fare il commit.

Per quanto segue l'accesso anonimo verrà usato come esempio. Se hai accesso ad un altro account che permette l'accesso in scrittura allora dovresti usare quell'account. Se pensi di apportare delle modifiche allora dovresti procurarti un account con i diritti di scrittura prima di continuare poiché l'account anonimo non permette la modifica. Vedi la sezione sull'accesso in scrittura per maggiori informazioni.

Per cominciare ad usare CVS devi prima effettuare il login sul server CVS

   cvs -d :pserver:anonymous@cvs.debian.org:/cvs/webwml login
(puoi semplicemente premere return quando ti sarà chiesta la password)

Per ottenere una copia dei file wml sulla tua macchina locale, devi fare così

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

Puoi ottenere un sottoinsieme delle pagine facendo così:

   cvs -d :pserver:anonymous@cvs.debian.org:/cvs/webwml checkout -l \
          webwml webwml/<language>
   cvs -d :pserver:anonymous@cvs.debian.org:/cvs/webwml checkout \
          webwml/Perl webwml/english/template webwml/<language>/Pics
   cvs -d :pserver:anonymous@cvs.debian.org:/cvs/webwml checkout \
	  webwml/<language>/<path to desired files>
.

Fai ciò per tutte le sottodirectory o file che ti servono. La seconda riga include tutti i file che ti serviranno se desidererai creare le pagine HTML dai file WML. I checkout parziali come questi non sono ancora del tutto supportati, pertanto le istruzioni sopra riportate potrebbero non funzionare sempre.

Se ti è già stato assegnato uno username con una password, inserisci quello al posto di anonymous

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

Da questo momento in poi non avrai bisogno di inserire la parte '-d :pserver:...'. Ogni due--tre giorni esegui il comando

   cvs update -d

per avere la nuova versione dei file cambiati sull'originale. Il parametro -d permette di aggiungere le nuove directory automaticamente. Tu potresti voler creare un file ~/.cvsrc in modo da non dover inserire le opzioni ogni volta. Per esempio potrebbe contenere:

cvs -z9
update -d -P
diff -u

La parte seguente è per chi ha accesso in scrittura sull'originale. Quando hai finito con una pagina, puoi copiare le tue modifiche sull'originale tramite

   cvs commit <file>.wml

o

   cvs commit <dir>   (per tutte le modifiche in <dir>)

o

   cvs commit          (per tutte le modifiche dalla directory corrente in poi)

Se sei il primo che traduce una pagina devi anche eseguire

   cvs add <file>.wml

prima che tu possa farne il commit. Nota che cvs add non è ricorsivo e quindi devi farlo per ogni singola directory che devi aggiungere e per il suo contenuto.

Per maggiorni informazioni su CVS, dai il comando info cvs.

Accesso in scrittura al CVS

Per istruzioni su come ottenere l'accesso in scrittura al CVS si veda http://people.debian.org/~joey/misc/webwml.html.