Aquesta secció és sobretot per als principiants que no estan familiaritzats amb el Subversion, i explica com treballen els sistemes per al control de revisions (revision control system -RCS-).
Atenció
Les còpies de treball HAN de ser accessibles a través de camins locals. El Subversion no coneix res sobre els pseudo sistemes de fitxers com smb://
o fish://
. El kdesvn en tradueix alguns si és possible (com system:/home
), però a través d'una xarxa, això no és possible.
Primer de tot, haureu de crear una còpia de treball del repositori. Per a fer-ho, seleccioneu → → . Dins el següent diàleg s'ha de seleccionar l'URL del repositori que voleu utilitzar, p. ex., quelcom com http://màquina_local/repos/meu_projecte
. També estan disponibles les subcarpetes d'un repositori, p. ex., http://màquina_local/repos/meu_projecte/trunk
o similar.
Seleccioneu i/o creeu una carpeta local, on residirà la còpia de treball.
Finalment, però no menys important, la revisió a extreure. Majoritàriament aquesta seria «HEAD». Això assegura que l'última versió emmagatzemada és la versió de referència.
Després feu clic a , el kdesvn crearà la vostra còpia de treball i l'obrirà (si el quadre estava marcat).
Quan obriu un repositori per a la navegació, podeu marcar una carpeta i després seleccionar → → i ompliu els diàlegs com s'ha descrit anteriorment. Només llavors s'extraurà el camí marcat.
Marqueu l'entrada o entrades que voleu enviar i seleccioneu → → (Ctrl+#)
Si intenteu cometre sense seleccionar cap element, el kdesvn utilitzarà l'element de nivell superior obert a la còpia de treball, és a dir, el mateix camí de la còpia de treball.
Aquesta operació sempre serà recursiva, vol dir que, si se selecciona una carpeta, el kdesvn sempre enviarà tots els elements modificats per sota seu. Quan amb la configuració vulgueu revisar tots els elements abans de cometre'ls, el següent diàleg llistarà tots els elements que enviarà el kdesvn. És possible desmarcar els elements que no voleu enviar. En aquest cas, el kdesvn enviarà tots els elements ell sol, és a dir, de forma no recursiva. O podeu seleccionar els elements sense versió per a afegir i cometre (si no estan marcats per a ser ignorats). De manera que podreu veure si hi ha elements nous que esteu oblidant.
Introduïu un missatge de registre que enviareu i premeu el botó i la transferència s'iniciarà.
Això farà que la còpia de treball local estigui en sincronia amb el repositori. Podeu configurar el kdesvn per a comprovar-ho en obrir una còpia de treball per als elements nous/modificats que hi hagi al repositori. Això s'executarà en segon pla i podreu seguir treballant amb el kdesvn. Quan hagi finalitzat, es marcaran els elements amb les versions més recents o les carpetes amb elements on els elements nous estiguin per sota.
Per a rebre els canvis, seleccioneu → → . Això actualitzarà a la versió més recent. Per a obtenir una revisió específica, seleccioneu → → i seleccioneu la revisió que vulgueu en el següent quadre.
Si no se selecciona cap element, l'actualització es farà sobre tota la còpia de treball oberta, en cas contrari només serà recursiva sobre els elements seleccionats.
Ambdues operacions requereixen dos passos: El primer és afegir o eliminar per a després cometre els canvis al repositori. Abans de cometre podreu desfer les ordres afegeix o elimina.
Afegir elements en una còpia de treball pot fer-se de tres maneres:
- Seleccionar elements sense versió i afegir-los
Copieu amb el Konqueror o qualsevol altra eina dins de l'àrea de la còpia de treball. Aneu a través de la llista, marqueu-los i seleccioneu → → (Inser). Quan vulgueu afegir carpetes noves amb tots els subelements, seleccioneu → → (Ctrl+Inser).
- Comprovar i afegir de forma recursiva
Podeu comprovar si hi ha algun element sense versió a la còpia de treball. Després seleccioneu → → , apareixerà un diàleg on es llistaran tots els elements sense versió. Premeu el botó per a afegir tots els elements marcats a la còpia de treball, els elements que no vulgueu amb versió hauran d'estar desmarcats.
- Arrossegar i deixar anar
Marqueu en el Konqueror o qualsevol altre navegador de fitxers compatible, els elements que voleu afegir i arrossegar al kdesvn. És possible deixar-los anar en carpetes dins de la còpia de treball oberta, i després, el kdesvn copiarà els elements deixats anar a la mateixa i hi afegirà els elements.
La supressió d'elements sempre serà recursiva. Per exemple, quan s'elimina una carpeta també se suprimiran tots els elements secundaris. Marqueu el que voleu i seleccioneu l'element de menú → → . Als elements se'ls manllevarà la versió i seran suprimits del disc.
La pantalla del registre pot iniciar-se amb Ctrl+L quan un o cap element està marcat en el resum. Depenent de les vostres opcions de configuració (vegeu Taula 5.1, «Subversion»), el kdesvn recuperarà algunes entrades del registre que comencin amb «HEAD» i les mostrarà.
Al costat esquerre veureu la llista d'entrades del registre recuperada pel kdesvn. El missatge del registre serà retallat a la següent línia fins que encaixi. El missatge del registre complet apareixerà a la part superior dreta de la finestra quan marqueu una entrada. A la part inferior dreta de la finestra veureu la llista de fitxers canviats. Aquestes finestres només apareixeran si aquesta llista és obtinguda, depenent de les vostres opcions de configuració.
Amb els botons de dalt podreu seleccionar un altre interval pels registres a mostrar.
Important
Aquest interval es crida sense cap límit preestablert, així que tingueu cura quan feu servir aquesta característica en repositoris grans.
Els botons a la part inferior del diàleg sempre treballaran en el registre sobre l'element seleccionat, no sobre l'element seleccionat a la llista de fitxers canviats. Així que quan seleccioneu , aquest ho farà sobre tots els elements modificats en aquesta revisió, si són equivalents o estan per sota de l'entrada de Subversion seleccionada per a recuperar els registres anteriors. El mateix per a .
, per descomptat, només funciona si l'element al registre és un fitxer.
En totes les entrades de llista (ambdues llistes) teniu activat el menú contextual per algunes operacions addicionals. A la llista de l'esquerra hi ha (és a dir, revisió d'inici) i (és a dir, propòsit o destinació de les diferències, en unificar la part marcada amb un +++
). Si heu seleccionat aquestes revisions, apareixeran marcades amb algunes petites fletxes.