Il CVS

Letteralmente significa Concurrent Version System ed è il più utilizzato applicativo del suo genere. Permette ad un gruppo di persone di
lavorare simultaneamente sullo stesso file tenendo traccia dell'evoluzione e di tutte le modifiche.Per fare questo, il CVS mantiene un
deposito centrale (repository)remoto dal quale gli utenti possono ottenere una copia del lavoro. Questi copiano in locale i moduli del
progetto sul quale intendono intervenire, modificano i file della loro copia di lavoro e sottopongono le loro modifiche al sistema CVS che
le integra e le mette a disposizione degli altri.

Dunque attraverso il CVS e' possibile mantenere sempre aggiornato un progetto ed e' il motivo per il quale abbiamo deciso di utilizzarlo
anche per BeWos.

Per poter usufruire del CVS e' necessario avere un client cvs. Nella maggior parte delle distribuzioni linux (se non tutte) e' gia' presente
tale client che si chiama proprio "cvs" e lo si invoca dalla shell.

Siccome le operazioni da eseguire per gli "utenti" e per "gli sviluppatori" sono leggermente diverse dividero' questa piccola guida nelle
aree citate.

For Linux

Per gli Utenti:

Se l' utente vuole vedere il codice sorgente di BeWos attraverso un browser basta andare al seguente indirizzo: 
http://bewos.cvs.sourceforge.net/bewos

Se vuole scaricarlo deve utilizzare il client CVS e loggarsi al server come "anonimo":

cvs -d:pserver:anonymous@bewos.cvs.sourceforge.net:/cvsroot/bewos login
 
Quando vi verra' chiesto la password non digitate niente e premete semplicemente "Invio"


dopodiche' posizionatevi nella directory dove desiderate che la cartella remota "bewos_src"(contenente il codice sorgente di BeWos)
venga scaricato ed eseguite il seguente comando:

cvs -z3 -d:pserver:anonymous@bewos.cvs.sourceforge.net:/cvsroot/bewos co -P bewos_src


Per le successive operazioni di aggiornamento del codice(per avere sempre una copia locale aggiornata) bisogna posizionarsi nella
directory dove avete scaricato la cartella "bewos_src"(contente il codice sorgente di BeWos) e digitare:

cvs -z3 -d:pserver:anonymous@bewos.cvs.sourceforge.net:/cvsroot/bewos update -P


Tali operazioni possono essere semplificate impostando opportunamente una variabili d' ambiente nel seguente modo:

export CVSROOT=:pserver:anonymous@bewos.cvs.sourceforge.net:/cvsroot/bewos

per il login basta eseguire il seguente comando: cvs login (alla richiesta della password premete invio)

per il checkout(per lo scaricamento del codice sorgente di bewos): cvs co -P bewos_src

per l' aggiornamento del codice locale: cvs update -P


"cvs login" metterà l'equivalente di un cookie in un file della nostra homedir. È necessario eseguire questa operazione soltanto una volta
e il login rimarrà valido anche dopo un reboot, fino a che non sarà eseguito il comando: "cvs logout"


Per gli sviluppatori:

In qualita' di sviluppatori non dovrei dirvi niente.... evvabbe' non fate quella faccia :) !

Innazitutto e' da dire che SourceForge da' la possibile di modificare il codice solo se si accede tramite SSH.

Quindi impostiamo opportunamente alcune variabili d' ambiente:

export CVS_RSH=ssh
export CVSROOT=:ext:nome_utente@bewos.cvs.sourceforge.net:/cvsroot/bewos

una volta fatto cio' non c' e' bisogno di fare il login perche' per ogni operazione che faremo ci chiedera' la password

posizionatevi nella cartella dove volete scaricare la direcotory remota "bewos_src":

per il checkout(per lo scaricamento del codice sorgente di bewos) digitare: cvs co -P bewos_src

per l' aggiornamento del codice locale: cvs update -P


Confermare le modifiche

Una volta modificati i file, controllato eventuali cambiamenti e risolto eventuali conflitti, si devono confermare i cambiamenti al repository:

cvs commit -m "brevissima descrizione dei cambiamenti"

dopo questo comando le modifiche apportate ai file saranno disponibili per chiunque.


Aggiungere un file al progetto

Nel caso fosse necessario aggiungere un file al progetto:

cvs add nome_file

Il file che si vuole aggiungere deve essere già presente all'interno della cartella in cui si digita il comando. Successivamente è
necessario eseguire un commit per confermare l'aggiunta al repository.


Aggiungere un file binario al progetto

Nel caso fosse necessario aggiungere un file binario (immagini, file compilati, eseguibili, doc o pdf, etc) al progetto:

cvs add -kb nome_file

Il file che si vuole aggiungere deve essere già presente all'interno della cartella in cui si digita il comando. Successivamente è
necessario eseguire un commit per confermare l'aggiunta al repository.


Rimuovere un file dal progetto

Per rimuovere un file da CVS è necessario prima cancellare fisicamente il file, successivamente lanciare il seguente comando:

cvs remove nome_file

Successivamente è necessario eseguire un commit per confermare la rimozione dal repository.


Aggiungere una directory al progetto

Per aggiungere una directory al repository, la procedura è identica a quella dei file.

cvs add nome_dir

La directory che si vuole aggiungere deve essere già presente all'interno della cartella in cui si digita il comando. Al contrario di quanto
accade per i file, non è necessario eseguire un commit per confermare l'aggiunta al repository.


Rimuovere una directory dal progetto

Per rimuovere una directory dal repository, per prima cosa bisogna rimuovere tutti i file al suo interno sia fisicamente che da CVS (è
importante ricordarsi di effettuare il commit) dopodichè bisogna utilizzare il seguente comando:

cvs update -P

Il -P specifica all'update di eliminare tutte le directory vuote presenti.

Esempio:

cd cartella
del file1.html
del file2.html
cvs remove file1.html file2.html
cvs commit -m "tolti i file"
cvs update -P


Rinominare un file o una directory

Per rinominare un file o una directory eseguire in sequenza le operazioni di rimozione e aggiunta file o directory.


Controllare la versione esistente di un file

Per controllare la versione esistente sul repository e la propria, è necessario utilizzare il seguente comando:

cvs status nome_file

questo comando, se eseguito senza specificare il nome del file, ritorna lo stato di tutti i file nella cartella corrente e di quelli nelle
sottodirectory.


Controllare la storia delle versioni di uno o più file

In caso fosse necessario controllare la storia delle versioni e relative modifiche di uno o più file, è necessario utilizzare il seguente
comando:

cvs log nome_file

questo comando, se eseguito senza specificare il nome del file, ritorna i log di tutti i file nella cartella corrente e di quelli nelle
sottodirectory.


Aggiungere un'etichetta a un file o un gruppo di file

Per aggiungere un'etichetta che funga da identificativo per un file o più file si usa il seguente comando:

cvs tag nome_tag

L'utilità di questo programma si capisce quando diventa necessario definire revisioni di un progetto in corso. Grazie al comando tag è
possibile definire e recuperare un intero progetto in un determinato punto del suo sviluppo. Inoltre risulta utile per la creazione di
"branches".

Ad esempio, fosse necessario recuperare una vecchia versione di un progetto:

cvs checkout -r nome_tag nome_progetto

Esempio:

cvs tag beta1
cd ..
cvs checkout -r beta1 mioprogetto

N.B. Se si esegue il comando all'interno di una sottodirectory, esso verrà applicato ai file e alle sottodirectory della directory dove ci si
trova, e non a tutto il progetto.



For Windows

Installazione e configurazione
 
E' possibile utilizzare questo script automatico; e' semplicissimo basta scompattare il file e avviare
cvsbewos.cmd, si aprira' una console, scriveremo la directory dove vogliamo che i source vengano scaricati e il resto sara'
automatico.

Alternativamente si puo' configurare manualmente:

Prima di tutto scarichiamo una versione stabile del cvs dal sito del cvs; consiglio di scaricare l'unica versione stabile, vale a dire cvs-1-11-20.zip


Successivamente si estrae l'eseguibile del cvs dentro la cartella di windows ( %windir%system32 in winNT e %windir% in win9x ) in
modo da poterlo usare sempre nella console.

Adesso andiamo su "esegui" del menu' avvio e avviamo la console: "cmd" nel caso di winNT, e "command" nel caso di win9x.
quindi digitiamo "cd " dove  e' la directory dove si vuole che i source del cvs vengano copiati, quindi
configuriamo il cvs:
-1 digiatiamo "set cvsroot=:pserver:anonymous@cvs.sourceforge.net:/cvsroot/bewos"
-2 facciamo in modo che la variabile d'ambiente si carichi ad ogni riavvio, questa procedura si differenzia dalla versione di windows:
sotto winXP clicchiamo su risorse del computer con il destro -> proprieta'->avanzate->variabili d'ambiente-> qui premiamo "nuovo"
sotto la finestra di nome "variabili d'ambiente per l'utente XXX" e scriviamo: nome variabile CVSROOT e valore variabile
:pserver:anonymous@cvs.sourceforge.net:/cvsroot/bewos
sotto win9x: andiamo su esegui dal menu avvio e scriviamo "notepad c:autoexec.bat", si aprira' un editor di testo, aggiungiamo la riga 
set cvsroot=:pserver:anonymous@cvs.sourceforge.net:/cvsroot/bewos e salviamo.
-3 digitiamo "cvs login", ci logghiamo come utenti anonimi nel server cvs, ci vera' chiesta la password, premiamo enter.
-4 digitiamo "cvs checkout bewos_src", i source verranno automaticamente scaricati.
-5 digitiamo "cvs logout", facciamo il logout dal server.
 

note:
    Per aggiornare i source bastera' loggarsi con "cvs login" e poi fare "cvs update".
    Se si usa lo script automatico la variabile CVSROOT necessaria per usare cvs sara' effettiva solo dopo il riavvio dell' os.

Alcune parti del testo sono presenti sul sito: http://www.mibmagazine.it/article.php?id=48 che consiglio tutti di leggere oltre a:

http://openskills.info/infobox.php?ID=879

http://www.ferrara.linux.it/Members/pioppo/cvs-howto/view

BeWos Project

Copyright © by Black & White operating system Tutti i diritti riservati.

Pubblicato su: 2005-06-22 (3101 letture)