Subversion tutorial

Creare un repository

Creiamo¹ un nuovo repository:

$ svnadmin create /Users/tizio/myrep

/Users/user/myrep è un esempio di percorso che punta ad una directory chiamata myrep².

Creare un progetto all'interno del repository

Creiamo un progetto (prog) importando la directory esistente /User/tizio/test nel repository:

$ svn import prog /User/tizio/test -m "Commento arbitrario"

Tutto il contenuto della cartella verrà copiato ricorsivamente nell'URL del repository. Verranno create, se necessarie, anche delle directory intermedie.

Cominciare a lavorare al progetto recuperandone l'ultima revisione

Supponiamo di voler cominciare a lavorare al progetto prog nella nuova directory Documents/working³:

$ svn checkout file:///Users/tizio/myrep/prog Documents/working

Verrà creata la directory working all'interno di Documents su cui noi lavoreremo normalmente per quanto riguarda:

• modifica dei file; (basta usare il proprio editor preferito)

Mentre non si lavorerà normalmente per quanto riguarda:

• creazione di file o directory, (=> add)
• copia di file o directory, (=> copy, cp)
• rinominazione o spostamento di files o directory, (=> move, mv, rename, ren)
• eliminazione di files o directory, (=> delete, del, remove, rm)

per le cui operazioni dovremo invece utilizzare comandi specifici di Subversion.

Effettuare modifiche al progetto (lavorare)

Aggiungere un file o una cartella (add)

$ svn add esempio.txt
$ svn add cartellalocale svn://dominio/cartellaremota

Copiare un file o una cartella (copy, cp)

$ svn copy file1 file2
$ svn copy file1 cartella/file1

Rinominare/spostare un file (move, mv, rename, ren)

$ svn move oldfilename newfilename

Eliminare un file (delete, del, remove, rm)

$ svn delete esempio.txt

Registrare le modifiche effettuate come revisione (commit, ci)

Per rendere queste modifiche "effettive" ovvero per registrarle come revisioni occorre usare il comando committ (ci):

$ svn commit -m "Commento alla modfica"

Aggiornare la propria copia di lavoro (update, up)

$ svn update

Tabellina dei comandi svn

comando	descrizione
status	mostra le differenze tra il repository e la tua copia
log	mostra una lista di tutte le revisioni del repository
diff -r 1	differenze con la revisione 1

Bibliography

1. Subversion with Mac OS X

Footnotes

1. Per cancellarlo basta eliminare la directory in cui è contenuto.

2. La directory deve essere vuota o non esistente (nel qual caso verrà creata).

3. Evidentemente un percorso relativo.