Questa sezione è principalmente rivolta ai principianti che non sono pratici di subversion; spiega come funzionano subversion e i sistemi di controllo delle versioni (RCS, Revision Control Systems).
Attenzione
Le copie di lavoro DEVONO essere accessibili localmente. Subversion non conosce pseudo file system come smb://
o fish://
. kdesvn se possibile ne interpreta alcuni (come system:/home
), ma questo non è possibile in una rete.
Prima di tutto devi creare una copia di lavoro del tuo deposito. Per questo seleziona → → . In questa finestra devi selezionare l'URL del deposito che vuoi usare, ad es., qualcosa come http://localhost/repos/myproject
. Sono permesse anche le sottocartelle, ad es., http://localhost/repos/myproject/trunk
o simili.
Seleziona o crea la cartella locale in cui dovrebbe risiedere la copia di lavoro.
Ultimo, ma non per importanza, la revisione da controllare, che nella maggior parte dei casi dovrebbe essere «HEAD». Questo assicura che l'ultima versione immagazzinata sia quella referenziata.
Dopo aver fatto clic su kdesvn creerà la tua nuova copia di lavoro e, se la relativa casella è stata spuntata, la aprirà.
Quando apri un deposito per sfogliarlo puoi contrassegnare una cartella, e quindi selezionare → → e compilare le finestre come descritto in precedenza. A questo punto verrà controllato solo il percorso selezionato.
Segna la voce o le voci che vuoi inviare, quindi seleziona → → (Ctrl+#)
Se tenti di inviare senza selezionare alcun elemento, kdesvn prende l'elemento più in alto nella copia di lavoro aperta, cioè il percorso della copia di lavoro stessa.
Questa operazione è sempre ricorsiva, cioè, se selezioni una cartella, kdesvn spedirà sempre tutti gli elementi modificati al di sotto di essa. Quando imposti che vuoi revisionare tutti gli elementi prima dell'invio, kdesvn elenca nella finestra successiva tutti gli elementi che dovrebbe spedire. In questo caso il programma invia tutti gli elementi non ricorsivamente, diversamente potresti selezionare per l'aggiunta e l'invio gli elementi fuori dal controllo di revisione (se non sono marcati per essere ignorati). In questo modo puoi vedere se ci sono elementi più nuovi di cui ti sei dimenticato.
Inserisci un messaggio di log riguardo a quello che stai inviando, premi ed il trasferimento ha inizio.
Questo mantiene la copia di lavoro sincronizzata con il deposito. Puoi impostare che kdesvn controlli una copia di lavoro all'apertura, alla ricerca degli elementi nuovi o di quelli modificati nel depositato. Questo avviene in background, e nel frattempo puoi lavorare con kdesvn; alla fine verranno segnati gli elementi con versioni più nuove o le cartelle che li contengono.
Per recuperare le modifiche, seleziona → → , e aggiornerai alla versione più recente. Se invece vuoi una revisione specifica, seleziona → → e seleziona quella desiderata nella finestra successiva.
Se non ci sono elementi selezionati allora verranno aggiornate tutte le copie di lavoro, diversamente l'aggiornamento sarà ricorsivo solo sugli elementi selezionati.
Entrambe le operazioni richiedono due passi: prima aggiunta o eliminazione, poi invio delle modifiche al deposito. Prima dell'invio puoi annullare queste operazioni.
L'aggiunta di elementi nella copia di lavoro può essere fatta in tre modi:
- Seleziona gli elementi fuori dal controllo di revisione e aggiungili
Copia con Konqueror o con qualsiasi altro strumento nell'area della copia di lavoro. Vai nell'elenco, segnali e seleziona → → (Inserisci). Seleziona → → (Inserisci) se vuoi aggiungere delle nuove cartelle con tutti i sotto-elementi.
- Controllo e aggiunta ricorsivi
Puoi controllare se nella copia di lavoro ci sono degli elementi fuori dal controllo di revisione: dopo aver selezionato → → si aprirà una finestra che li elencherà. Premendo su verranno aggiunti alla copia di lavoro tutti gli elementi selezionati; deseleziona prima quelli che vuoi che rimangano senza questo controllo.
- Trascinamento
Segna in Konqueror o in un qualsiasi gestore di file compatibile gli elementi che vuoi aggiungere, e trascinali in kdesvn. Puoi rilasciarli in cartelle all'interno della copia di lavoro aperta: in questo modo kdesvn copia qui gli elementi trascinati ed li aggiunge.
L'eliminazione è sempre ricorsiva: per esempio, quando elimini una cartella vengono eliminati anche i sotto-elementi. Segna quello che vuoi, e seleziona l'elemento del menu → → : gli elementi verranno rimossi dal controllo di versione ed eliminati dal disco.
La visualizzazione del log può iniziare con Ctrl+L quando uno o nessun elemento è marcato nella panoramica. A seconda delle tue impostazioni (vedi Tabella 5.1, «Subversion») kdesvn recupera alcune voci del registro che cominciano da «HEAD» e le visualizza.
Nella parte sinistra puoi vedere l'elenco delle voci del registro che kdesvn ha recuperato; sono in formato adattato, cioè ridotto ad una riga, mentre il messaggio completo appare nella finestra in alto a destra, non appena selezioni una voce. Nella parte in basso a destra vedrai l'elenco dei file modificati. Queste finestre appaiono solo se viene prelevato questo elenco, a seconda delle tue impostazioni.
Con i pulsanti in alto puoi selezionare un altro intervallo per i log da visualizzare.
Importante
Questo intervallo viene chiamato senza nessun limite preimpostato; stai quindi attento a quello che stai per fare, specialmente nei grandi depositi.
I pulsanti in basso funzionano sempre sull'elemento selezionato per visualizzarne i log, non su quello selezionato nell'elenco dei file modificati. Quindi, quando selezioni vengono generate le differenze con tutti gli elementi modificati in questa revisione o precedenti la voce di subversion selezionata in precedenza per recuperare i log. Lo stesso per .
Naturalmente funziona solo se l'elemento da registrare è un file.
Su tutte le voci delle liste (di entrambe le liste) c'è un menu contestuale con alcune operazioni aggiuntive: nella lista di sinistra questa è (cioè l'inizio della revisione) e (cioè la fine o l'obiettivo di diff, nel formato unificato la parte segnata con +++
). Se selezioni queste revisioni, esse sono marcate da alcune piccole frecce.