# El manual del &kdesvn;

## Introducció

El &kdesvn; és un client de Subversion pel &kde;.

Haureu de tenir algun coneixement sobre el Subversion, però esperem que la majoria dels elements s'expliquin per si mateix.

Podeu enviar informes d'error i desitjos a través del sistema de seguidor d'errors del &kde;.

### Termes

Si esteu familiaritzat amb els sistemes per al control de revisions podeu ometre això -o llegir i corregir a l'autor- ;)

Repositori

- És el magatzem central de les dades. Aquest pot ser una base de dades o un sistema de fitxers pla. Sense clients especials, no sereu capaç de llegir-hi les dades. Per als repositoris de Subversion, el &kdesvn; treballa com un client.

Còpia de treball

- Una còpia plana d'un repositori en el sistema de fitxers local. Aquesta s'utilitza amb qualsevol gestor de fitxers normal, edició dels fitxers, &etc; La informació RCS -sistema de control de revisions- es pot llegir amb clients com el &kdesvn;.

  Recordeu que el Subversion no sap res sobre el KIO, de manera que la còpia de treball haurà de residir en una àrea on es pugui arribar sense cap protocol específic, &pex; fish:// o potser no serà possible.

WebDav

- El WebDav és un protocol que permet modificar els fitxers en un servidor web remot. El Subversion és un tipus especial de WebDav quan s'accedeix als repositoris a través d'un servidor web. L'ús normal d'aquest és de només lectura. Amb configuracions especials, podreu activar-hi la lectura-escriptura amb un navegador especialitzat. El &kdesvn; no és un client de WebDav, sí el &konqueror; a través del protocol webdav://. Però amb el &kdesvn; podreu navegar a través de l'arbre de versions d'un repositori (mitjançant http://).

## Ús del &kdesvn;

### Característiques del &kdesvn;

El &kdesvn; entén els següents protocols per a la navegació en els repositoris:

http

- Protocol del navegador web estàndard.

https

- Protocol encriptat del navegador web estàndard.

(k)svn+http

- Protocol del navegador web estàndard. Es pot utilitzar per a permetre que el &konqueror; cridi automàticament al &kdesvn;.

(k)svn+https

- Protocol encriptat del navegador web estàndard. Es pot utilitzar per a permetre que el &konqueror; cridi automàticament al &kdesvn;.

(k)svn+file

- Protocol del repositori local. Es pot utilitzar per a permetre que el &konqueror; cridi automàticament al &kdesvn;.

(k)svn

- Protocol del servidor propi de Subversion.

(k)svn+ssh

- Subversion sobre ssh.

file

- Accés directe al repositori. El &kdesvn; comprovarà si un camí donat és un repositori o una còpia de treball, i l'obrirà en el mode correcte. Per al Subversion, `file:///dir` i `/dir` no són el mateix!

Aquesta llista també es pot emprar per als &URL; indicats a la línia d'ordres.

### Començant amb Subversion i el &kdesvn;

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-).

#### Crear una còpia de treball

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 fer-ho, seleccioneu Subversion General Descarrega un repositori . Dins el següent diàleg s'ha de seleccionar l'&URL; del repositori que voleu utilitzar, &pex;, quelcom com `http://màquina_local/repos/meu_projecte`. També estan disponibles les subcarpetes d'un repositori, &pex;, `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 descarregar. Majoritàriament aquesta seria HEAD. Això assegura que l'última versió emmagatzemada és la versió de referència.

Després feu clic a D'acord, 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 Subversion Repositori Descarrega des del camí del repositori actual i ompliu els diàlegs com s'ha descrit anteriorment. Només llavors es descarregarà el camí marcat.

#### Publicar els canvis locals

Marqueu l'entrada o entrades que voleu enviar i seleccioneu &Ctrl;# Subversion Còpia de treball Publica

Si intenteu publicar sense seleccionar cap element, el &kdesvn; utilitzarà l'element de nivell més superior obert a la còpia de treball, &ead;, 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 publicar-los, 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, &ead;, de forma no recursiva. O podeu seleccionar els elements sense versió per afegir i publicar (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 del que enviareu i premeu el botó D'acord per iniciar la transferència.

#### Actualitzar una còpia de treball

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 Subversion Còpia de treball Actualitza a HEAD . Això actualitzarà a la versió més recent. Per obtenir una revisió específica, seleccioneu Subversion Còpia de treball Actualitza a la revisió 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.

#### Afegir i eliminar de la còpia de treball

Ambdues operacions requereixen dos passos: El primer és afegir o eliminar per a després publicar els canvis al repositori. Abans de publicar podreu desfer les ordres afegeix o elimina.

##### Afegir elements

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 Subversion Còpia de treball Afegeix els fitxers/directoris seleccionats . Quan vulgueu afegir carpetes noves amb tots els subelements, seleccioneu &Ctrl;Inser Subversion Còpia de treball Afegeix els fitxers/directoris seleccionats recursivament .

Comprovar i afegir de forma recursiva

- Podeu comprovar si hi ha algun element sense versió a la còpia de treball. Després seleccioneu Subversion Còpia de treball Comprova per a elements sense versió , apareixerà un diàleg on es llistaran tots els elements sense versió. Premeu el botó D'acord per 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

- Marqueu en el &konqueror; o qualsevol altra gestor 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.

##### Suprimir elements de la còpia de treball i manllevar la versió

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ú Subversion General Suprimeix els fitxers/directoris seleccionats . Als elements se'ls manllevarà la versió i seran suprimits del disc.

#### Mostrar els registres

La pantalla del registre pot iniciar-se amb &Ctrl;L quan un o cap element està marcat en el resum. Depenent dels vostres ajustaments (vegeu subversion-settings), el &kdesvn; recuperarà algunes entrades del registre que comencin amb HEAD i les mostrarà.

##### El diàleg que mostra el registre

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 dels vostres ajustaments.

Amb els botons de dalt podreu seleccionar un altre interval pels registres a mostrar.

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 Diff anterior, 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 Diff de les revisions.

Anota, 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 Indica la versió al costat esquerre de les diferències (&ead;, revisió d'inici) i Indica la versió al costat dret de les diferències (&ead;, 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.

### Treballar en els repositoris

La navegació senzilla del repositori pot fer-se dins del &konqueror;, &dolphin; o un gestor de fixers similar: Obriu un URL amb el protocol descrit a kdesvn-features (les variants que comencen amb k) i es mostrarà el contingut. Per tant, les operacions senzilles com copiar, moure i eliminar poden funcionar. En annexar una consulta com ?rev=`xxx`, la llista provindrà d'una revisió específica. El format de consulta de la revisió es descriu a revision-syntax, alguna informació més sobre el KIO::ksvn es troba al kdesvn-kio

Funciona tot, excepte Copia que només pot fer-se quan es navega per la revisió HEAD.

#### Restaurar els elements suprimits

Al Subversion, la restauració dels elements suprimits és una operació de còpia de l'element a una revisió específica. Per això, planegeu restaurar la vista del repositori a una revisió anterior que quan es va suprimir l'element. Seleccioneu Subversion Repositori Tria la revisió del navegador i introduïu la revisió desitjada. Ara, el &kdesvn; mostrarà el contingut en aquest terme. Marqueu l'entrada que voleu restaurar, seleccioneu &Ctrl;C Subversion General Copia . Dins del següent diàleg, l'objectiu sempre estarà a la revisió HEAD, l'origen estarà a la revisió seleccionada per a la navegació. Ompliu el camí, feu clic a D'acord i s'iniciarà la còpia. Un cop feta la còpia amb èxit, navegueu a la revisió HEAD i hauria d'aparèixer l'element restaurat.

#### Importar les carpetes

A causa de les restriccions del mateix Subversion, només es poden importar les carpetes, no els fitxers individuals.

##### Amb arrossega i deixa

Marqueu en qualsevol gestor de fitxers compatible la carpeta que voleu importar i arrossegueu-la a l'entrada de la carpeta al &kdesvn; en la qual voleu importar-la.

##### Seleccionar la carpeta per importar amb el gestor de fitxers

Marqueu la carpeta en la qual voleu importar una carpeta nova. A continuació, seleccioneu Subversion General Importa les carpetes cap a l'actual i seleccioneu la carpeta desitjada.

### Altres operacions

#### Fusionar

Obriu un repositori o còpia de treball, marqueu l'element que voleu fusionar i seleccioneu Subversion General Fusiona . Introduïu en el següent diàleg els valors desitjats. Si s'obre des del repositori, l'origen 1 i l'origen 2 s'ompliran, quan s'obre des d'una còpia de treball, l'origen s'omplirà amb l'element seleccionat. El maneig d'aquest paràmetre és una mica diferent d'emprar la vista de diferències interna de Subversion o un programa de fusionat extern com el &kdiff3;. L'origen haurà d'estar SEMPRE en una carpeta o fitxer local. Podeu canviar entre fusionat extern o intern amb la casella de selecció Usa un fusionat extern.

##### Fusionat intern

El significat és exactament igual que des de dins de la mateixa eina de línia d'ordres de Subversion. Quan origen 1 i origen 2 són iguals, la revisió d'inici i final hauran de ser diferents. Si no són iguals, la revisió d'inici s'assignarà a origen 1 i la revisió final a origen 2. La destinació HAURÀ de ser una còpia de treball, en cas contrari, el Subversion enviarà un missatge d'error.

Les caselles de selecció tenen els següents significats:

Recursiu

- Fa totes les operacions recursives quan es treballa amb carpetes.

Gestiona els elements sense relacionar com a relacionats

- Si s'estableix, els elements no relacionats seran diferenciats com si estiguessin relacionats. En cas contrari, el Subversion els eliminarà d'una banda i els afegirà a l'altra.

Força la supressió dels elements modificats/sense versió

- Si no s'estableix i el fusionat requereix l'eliminació d'un element modificat o sense versió, fallarà el fusionat de Subversion. Altrament s'esborraran aquests elements.

Simplement executa sense modificar

- Si s'estableix, el Subversion només enviarà les notificacions del que faria, però no modificarà la còpia de treball.

##### Usar un programa extern per a fusionar

Vegeu diffmerge-settings per obtenir més detalls sobre com configurar l'eina de fusionat externa. El &kdesvn; generarà la línia d'ordres com es descriu allà. Abans, feu el següent:

1. Assigneu la revisió d'inici com la revisió a origen 1 i la revisió final a origen 2. A continuació, marqueu si són diferents (camí i/o revisió). Si és així, es realitzarà una fusió a tres bandes; en cas contrari serà un fusionat senzill entre l'origen i la destinació. Si es deixa en blanc origen 2, també serà un fusionat senzill.

2. Creeu una exportació a una carpeta temporal. Si es tracta d'un fusionat senzill d'origen 1 amb la revisió final, en cas contrari s'utilitzaran els dos orígens amb les seves revisions. Si l'element és un fitxer i no una carpeta, a continuació, obtindrà el contingut d'una revisió específica.

3. Genereu la crida al vostre programa de fusionat extern tal com l'heu establert a l'Arranjament. La sortida d'error es mostrarà a la finestra del registre, de manera que pugueu veure el que està malament (si quelcom va malament).

A diferència de l'ús d'una destinació de fusionat interna, pot ser una carpeta/fitxer pla que no estigui sota el control de versions, perquè les eines externes podrien estar realitzant les accions sense preocupar-se'n.

Si no s'estableix com a recursiva, l'exportació es realitzarà com una exportació plana. Aneu amb compte: quan es fa amb còpies de treball externes, no s'exportarà.

#### Resoldre els conflictes

El &kdesvn; en si, no té un mòdul per a la resolució de conflictes, però pot utilitzar programari extern des de dins. A extern-resolve-setup trobareu una descripció sobre com configurar aquesta aplicació.

En marcar un element amb l'estat establert a conflicte (veureu una creu vermella a la vista de llista) podreu seleccionar Subversion Còpia de treball Resol el conflicte . O des del menú contextual amb Resol el conflicte (només sobre els elements en conflicte) i el &kdesvn; engegarà el programa establert (o el predeterminat). Després d'acabar aquesta tasca, haureu de marcar aquest element com a resolt (Subversion Còpia de treball Marca com a resolt) en cas contrari no podreu publicar els vostres canvis.

### Propietats emprades per a la configuració del &kdesvn;

#### Integrar el seguidor d'errors

El projecte TortoiseSVN ha dissenyat un bonic sistema de propietats per integrar el seguidor d'errors (BugTracker) a la IGU de Subversion. La versió actual del &kdesvn; no admet camps addicionals al quadre de publicació (vindrà més endavant) i no ho entén tot, a excepció de les següents propietats:

#### Propietats integrades del seguidor d'errors

Propietat | Descripció | Exemple
`bugtraq:url` | Manté l'&URL; per al seguidor d'errors. Ha de contenir el marcador `%BUGID%`. | https://bugs.kde.org/show_bug.cgi?id=%BUGID%
`bugtraq:logregex` | Conté una o dues expressions regulars, separades per un salt de línia. Si només s'estableix una expressió, llavors l'ID de l'error haurà de concordar amb els grups de la cadena de l'expressió regular. Si s'estableixen dues expressions, llavors la primera expressió s'utilitzarà per trobar una cadena que es relacioni amb l'ID de l'error, però pot contenir més que l'ID de l'error (&pex;, Issue #123 o resolves issue 123). La segona expressió s'utilitza per extreure l'ID real de l'error de la cadena extreta amb la primera expressió. Si us plau, aneu amb compte amb els espais no desitjats després de l'expressió regular i no oblideu els claudàtors a la descripció del número. | Individual (usable amb TRAC):
    #(\d+)
Ara tots els números com `#190` seran analitzats i traduïts a un &URL; a la sortida del registre. Dues expressions:
    [Ii]ssue #?(\d+)(,? ?#(\d+))*
    (\d+)
##### Recordar Preneu cura amb els espais en blanc després de la `(\d+)`! Aquest és un dels errors més comuns que causa que aquestes expressions no concordin!

En els repositoris locals oberts (&ead;, el protocol `file://`) i en còpies de treball, aquestes propietats seran cercades cap amunt des de la carpeta oberta fins que es troba o s'arribi al nivell superior de Subversion. En els repositoris oberts a través de la xarxa (tots excepte el protocol `file://`) només se cerca a la carpeta oberta.

El suport per a múltiples conjunts d'aquestes propietats pot seguir després, (&pex;, valors extra a la subcarpeta per a altres seguidors, &etc;), però en la majoria dels casos, l'avaluació individual dels enllaços del seguidor hauria de ser suficient.

### L'arbre de revisions

L'arbre de revisions pretén mostrar tot l'historial d'un element, de manera que l'usuari pugui obtenir una millor percepció sobre l'historial d'un element. Haureu d'anar a través de tot el registre del repositori, atès que us cal una mica més d'informació que la donada pel Subversion (i crec que no la coneix). Com que això produeix una gran quantitat de trànsit, l'arbre de revisions sempre utilitzarà el cau intern del registre.

#### Requeriments

L'arbre de revisions és generat mitjançant el dot. De manera que perquè funcioni l'arbre de revisions, haurà d'estar instal·lat el paquet graphviz.

### Cau intern del registre

El &kdesvn; pot utilitzar un cau intern del registre per a algunes operacions. Majorment s'utilitza per a l'arbre de revisions, però també per veure el registre simplificat en el mode fora de línia. Els caus estan organitzats com a bases de dades SQLite emmagatzemades a `$HOME/.sqvnqt/logcache`. Cada fitxer numerat és un emmagatzematge per a un repositori diferent.

Les bases de dades poden fer-se grans! Pel que podeu desactivar l'actualització automàtica del cau del registre als ajustaments.

Podeu simplement eliminar una base de dades, llavors el registre al cau serà reiniciat per aquest repositori (i no l'arbre de revisions!), però si es desactiva l'ompliment automàtic del cau, en la propera obertura d'aquest repositori o una còpia de treball associada, el cau serà omplert de nou.

#### Mode desconnectat

El &kdesvn; pot treballar sense accés a la xarxa, &ead;, podeu desconnectar l'accés a la xarxa pel &kdesvn;. Això pot ser útil quan es treballa sense xarxa com en els portàtils. En aquests casos, el &kdesvn; sempre obté els registres del cau intern. Aquest registre està reduït a funcions base, per raons tècniques, de manera que el registre al cau pot (però no té perquè) diferir del registre real. Diferir vol dir que no mostra totes les operacions de la còpia encara que s'estableixi El registre segueix els canvis de node.

#### Cau del registre i l'arbre de revisions

L'arbre de revisions només utilitzarà el cau del registre, d'altra manera s'hauran d'obtenir sempre els registres de nou. No refrescarà el cau del registre (però això pot canviar en versions posteriors).

### Significat de les icones superposades

Les entrades poden estar marcades amb icones superposades quan no es trobin en l'estat normal.

Blocada

- Aquesta entrada està blocada. En l'última columna apareix el propietari del bloqueig. També podeu configurar si el &kdesvn; ha de marcar els elements blocats al repositori. Però aneu amb compte: en funció del tipus de servidor, això pot dur molt de temps!

Cal blocar

- Aquesta entrada s'ha de blocar abans d'editar i publicar. Fins que no s'estableixi un blocat, el Subversion la mantindrà de només lectura.

Actualitzacions

- Aquesta entrada o una entrada de sota -si és una carpeta-, té una versió més recent al repositori.

Modificada

- Aquesta entrada o una entrada de sota -si és una carpeta-, ha estat modificada al disc local.

Afegida superposada

- Aquesta entrada ha estat afegida localment al Subversion, però encara no s'ha publicat.

Suprimida superposada

- Aquesta entrada ha estat suprimida localment de Subversion, però encara no s'ha publicat.

Suprimida superposada

- Aquesta entrada o una entrada de sota -si és una carpeta-, té conflictes per resoldre amb l'última actualització.

### El &kdesvn; i les contrasenyes

El &kdesvn;/Subversion són capaços de desar les contrasenyes. Desar les contrasenyes sempre és un risc per a la seguretat, però permet un frontal més usable.

#### No desar les contrasenyes

La manera més segura, però de vegades maldestre amb les IGU com el &kdesvn;. En particular, els processos en segon pla del &kdesvn; sempre tornaran a demanar una contrasenya en el cas que el repositori hagi restringit l'accés de les operacions com actualització i estat. El mateix per a publica i així successivament. De manera que si no esteu desant les contrasenyes, haureu de desactivar Inicia la comprovació d'actualitzacions en obrir una còpia de treball i així successivament.

#### Desar les contrasenyes al &kwallet5;

L'emmagatzematge de contrasenyes segur utilitzat per una gran quantitat de programes &kde;, com el &kmail; i el &konqueror;. Si esteu desant les contrasenyes i se solen utilitzar amb el &kdesvn;, haureu d'utilitzar això. Tingueu cura que l'emmagatzematge encriptat no és un emmagatzematge d'alta seguretat. Pels detalls, vegeu la documentació del &kwallet5;.

#### Desar-les a l'emmagatzematge de contrasenyes propi de Subversion

Això no és recomanable perquè les contrasenyes s'emmagatzemen com a text clar! No us ho creieu? Doneu una ullada als fitxers a `~/.subversion/auth/svn.simple`. Només haureu d'utilitzar aquesta opció si esteu utilitzant amb freqüència altres clients que el &kdesvn;, com el rapidsvn o el esvn o el client de línia d'ordres original, el svn. Si utilitzeu el client de línia d'ordres, sobretot per a descarregar o actualitzar, aquest no requerirà una contrasenya i el &kdesvn; hauria d'utilitzar el &kwallet5; per a publicar/moure/copiar.

#### Cau de contrasenyes intern

És possible activar un cau de contrasenyes intern, el qual mantindrà les contrasenyes a la memòria sempre que s'estigui executant el &kdesvn;. Pel que no haureu d'introduir una contrasenya dues vegades, encara que no la deseu a la cartera.

#### Cas especial de «svn+ssh»

Quan s'utilitza el Subversion a través de svn+ssh, l'emmagatzematge de la contrasenya es farà a través de ssh i ssh-agent. Per fer això, cal tenir accés a la màquina i repositori remots. Si voleu emmagatzemar quelcom, haureu d'utilitzar l'autenticació de clau pública de ssh, no l'autenticació per contrasenya. (De fet, ssh prefereix l'autenticació per clau pública). Per fer això, cal posar la vostra clau pública ssh en l'objectiu, &pex;, al sistema del repositori. Les contrasenyes ssh mai seran manejades per l'emmagatzematge de contrasenyes de Subversion, el &kwallet5; o el cau intern de contrasenyes.

Si no voleu que se us demani la contrasenya de la vostra clau SSH, podeu utilitzar el ssh-agent, seleccionant el menú Subversion Afegeix les identitats ssh al ssh-agent podreu emmagatzemar la contrasenya de la vostra clau ssh per a la sessió actual, de manera que no l'hàgiu d'introduir més quan sigui necessària.

## &konqueror;, KIO, &kdesvn;

### Descripció

A partir de la versió 0.7.0 del &kdesvn;, aquest tracta amb alguns mòduls que integren algunes ordres directament als menús del &konqueror;.

Protocols KIO

- Implementa gestors per als següents protocols:

  - ksvn+http

  - ksvn+https

  - ksvn+file

  - ksvn+ssh

  - ksvn

  Aquests protocols estan dissenyats només per als repositoris, no per a les còpies de treball. Per exemple, `ksvn+file:///`camí`` haurà d'apuntar al començament d'un repositori diferent de la mateixa aplicació o de la KPart. Es pot navegar per les còpies de treball amb el &konqueror;.

  Per navegar a una revisió específica, podeu annexar la consulta ?rev=`revisió` a l'&URL;.

Menús contextuals

- El &kdesvn; instal·la els menús contextuals del &konqueror;. Es poden veure amb el &BDR; a la finestra del navegador (només en la vista estàndard, no a qualsevol KPart) pel que és possible fer les accions més utilitzades directament des de dins del &konqueror; (o de qualsevol altre gestor de fitxers que llegeixi els menús contextuals del &konqueror;, com el &dolphin;). Això es realitza mitjançant una crida a la variant de la línia d'ordres del &kdesvn;.

#### Ús del KIO fora del &konqueror; -un exemple-

Cada aplicació que empri la biblioteca KIO pot utilitzar aquests protocols. Pel que seria possible recuperar totes les diferències entre dues revisions amb el &kdiff3; sense cap coneixement profund.

##### Recupera les diferències entre les revisions usant el &kdiff3; i el KIO::ksvn

    kdiff3 \
      ksvn://anonsvn.kde.org/home/kde/trunk/KDE/arts?rev=423127 \
      ksvn://anonsvn.kde.org/home/kde/trunk/KDE/arts?rev=455064

Permet al &kdiff3; imprimir totes les diferències entre dues revisions.

L'ús d'aquest amb el &kdesvn; (fent el diff de dues revisions) és molt més ràpid perquè s'utilitzen els mecanismes interns de Subversion.

### Informació a programadors quant al KIO::ksvn

Podeu ometre això si no esteu interessat en la programació dels KIO.

KIO::ksvn::special coneix les següents operacions.

#### Llista d'ordres

#### Resum d'ordres per a `KIO::ksvn::special`

Nom de l'ordre | ID numèric | Llistat dels paràmetres | Implementat a la nova versió?
Checkout | 1 | KURL repository, KURL target, int revnumber, QString revkind L'objectiu no serà modificat, &pex;, però el contingut serà descarregat sense crear una subcarpeta! Per exemple, l'origen pot ser `http://servidor/repositori/projecte/trunk`, l'objectiu `/home/usuari/projecte/` després el contingut de trunk serà copiat a `/home/usuari/projecte/` no a `/home/usuari/projecte/trunk/`! | Sí
Update | 2 | KURL url, int revnum, QString revstring Si «revnum» és < 0, s'analitzarà la «revstring». El format de «revstring» es descriu a l'Apèndix. | Sí
Commit | 3 | KURL::List urls Els URL són una llista dels URL locals per publicar. Demanarà pel missatge de registre. | Sí
Log | 4 | int startrevnumber, QString startrevstring, int endrevnumber, QString endrevstring, KURL::List Empreu-la amb cura -pot produir una gran quantitat de dades-. | Sí
Import | 5 | KURL targetrepository, KURL sourcepath | Sí
Add | 6 | KURL | Sí
Del | 7 | KURL::List | Sí
Revert | 8 | KURL::List Revertir als KIO sempre serà no recursiu, no hi ha preguntes (la crida a l'aplicació ho farà ella mateixa) | Sí
Status | 9 | KURL item, bool checkRepos, bool recurse element - l'element per al qual comprovar la informació, checkRepos - comprova si hi ha versions noves al repositori, recurse - comprova en mode recursiu o no. | Sí
Mkdir | 10 | KURL::List | Sí
Resolve | 11 | KURL, bool recursive | Sí
Switch | 12 | KURL working_copy_path, KURL new_repository_url, bool recursive,int revnumber, QString revkind | Sí
Diff | 13 | URL uri1, KURL uri2, int r1, QString rstring1, int r2, QString rstring 2, bool recursive Per a les diferències entre repositoris locals, utilitzeu el protocol «file:///». Per a les diferències entre còpies locals, definiu els URL sense un protocol! | Sí

#### Valors retornats

Els valors retornats es poden indicar a través de les metadades, Per a més detalls, vegeu la documentació de la API.

#### Contingut de les metadades

Clau | Valor possible
path | Camí de l'element on es va realitzar l'acció, &pex;, l'URL indicat.
action | Tipus d'acció numèric.
kind | Tipus d'element (majoritàriament carpeta o fitxer).
mime_t | Tipus MIME de Subversion de l'element.
content | Estat del contingut (valor de Subversion).
prop | Estat de les propietats (valor de Subversion).
rev | Dóna com a resultat la revisió o la revisió de treball.
string | Missatge en forma intel·ligible definit internament.
loggedaction | Cadena d'acció definida de Subversion sobre l'element (A,M,D).
loggedcopyfrompath | Si copiat de quin camí? (pot estar buida).
loggedcopyfromrevision | Si copiat en quina revisió? (pot ser < 0).
loggedpath | En quin camí únic l'acció registra les entrades i així s'estableixen successivament. (el camí s'estableix a l'URL de crida).
diffresult | Una línia de sortida de la diferència.

## Usar el &kdesvn; a través de la línia d'ordres

### Resum

Algunes operacions de Subversion es poden utilitzar a través de la línia d'ordres, &pex;, com un client de línia d'ordres estàndard, però la interacció de l'usuari es realitza a través de la IU del &kde;. La sintaxi estàndard és `kdesvn exec `ordre` `paràmetre` `URL``.

Si es desitja una única revisió en un únic &URL;, la podeu establir com un paràmetre de l'&URL;

    svn://vostre-servidor/camí-al-repositori/element?rev=<vostra-revisió>

Això solaparà l'opció `-r <revisió>`.

Una revisió es pot indicar com un número, un `HEAD` o `BASE` o com un format de data com {AAAA-MM-DD}.

### Llista d'ordres

Si en el següent resum s'indica com un possible paràmetre `-r `revisió``, aquesta revisió es podrà establir com ``URL`?rev=`la-revisió``.

### Ordres de Subversion

Ordre | Significat | Opcions acceptades
commit (o ci) | Publica els canvis de l'element al repositori. |
log | Mostra el registre de l'element. | -r revisió_inici:revisió_final -l límit_a_mostrar
cat | Mostra el contingut de l'element. | -r revisió
copy (o cp) | Copia un element dins de la còpia de treball o en el repositori. Si no s'indica la destinació, el &kdesvn; us la demanarà. |
move (o mv, rename) | Mou/Reanomena un element dins de la còpia de treball o en el repositori. Si no s'indica la destinació, el &kdesvn; us la demanarà. |
get | Obtén el contingut de l'element i el desa. | -r revision -o <fitxer_sortida> (la sortida és requerida!)
blame (o annotate) | Anota el fitxer. | -r revisió_inici:revisió_final
update | Actualitza l'element a la còpia de treball. | -r revisió
diff | Crea un diff de dues revisions de l'element o el diff de dos elements en una revisió específica. | -r rev_inici:rev_final
info | Informació detallada sobre l'element. | -r revisió
checkout (o co) | Descarrega el camí al repositori en un nou camí de la còpia de treball. Es preguntarà pel camí de la destinació i la revisió d'origen. |
checkoutto (o coto) | Descarrega el camí al repositori en un nou camí de la còpia de treball. Es preguntarà pel camí de l'origen i la revisió d'origen. |
export | Exporta el camí del repositori o còpia de treball dins d'un directori. Es demanarà pel camí de destinació i la revisió de l'origen. |
exportto | Exporta el camí del repositori o còpia de treball dins d'un directori. Es demanarà pel camí de l'origen i la revisió de l'origen. |
delete (del, remove, rm) | Elimina el/s URL del repositori o còpia de treball. |
add | Afegeix l'&URL; de la còpia de treball. L'&URL; haurà de pertànyer a una còpia de treball (no a una importació!) |
revert (o undo) | Desfà els canvis actuals per a la còpia de treball. Només es pot utilitzar en els URL de la còpia de treball! |
checknew (o addnew) | Comprova l'URL indicat per a elements nous, sense versió, i els afegeix a la còpia de treball si ho voleu. |
tree | Mostra un arbre de les revisions de l'element (només el primer argument), si l'&URL; amb el ?rev=`xxx` indicat, aquesta revisió serà la revisió de referència. | -r rev_inici:rev_final
lock | Bloca el/s URL, si s'indica `-f`, llavors els blocatges existents estaran trencats. | -f
unlock | Desbloca el/s URL, si s'ha indicat l'opció `-f` els blocatges establerts pels altres seran cancel·lats o els blocatges inexistents seran ignorats. | -f
help | Mostra aquesta pàgina. |

### Paràmetre per a les ordres de Subversion

Paràmetre | Valors possibles | permès
`-r` | `revision` o `startrev:endrev` | tots excepte «commit»
`-R` | (cap) | tots excepte «commit»
`-o` | `nom_de_fitxer` | get
`-l` | `número` | log
`-f` | (cap) | (un-)lock

#### L'ordre log

L'ordre «log» mostra un diàleg que conté el registre de l'&URL; indicat. Amb el Subversion 1.2 o posterior, aquesta accepta un límit, &ead;, el nombre d'entrades que s'han de mostrar.

Dins d'aquest diàleg podreu seleccionar les entrades de registre i obtenir les diferències entre elles.

##### Visualitza el registre de les últimes 20 publicacions

    kdesvn exec log -l 20 -r HEAD:1 meu_fitxer.c

Compte amb l'ordre de les revisions: Voleu anar des de HEAD al començament cap a l'últim. Per tant, haureu d'indicar la revisió HEAD com a punt de partida, en cas contrari podríeu obtenir les primeres 20 entrades.

#### L'ordre diff

Obtindreu les diferències entre les revisions d'un element o entre dos elements dins de la mateixa còpia de treball o repositori. Quan feu el diff en les revisions d'un element, les revisions es poden indicar com `-r `revisió_inici`:`revisió_final``. Quan feu el diff d'un element dins d'una còpia de treball sense cap revisió, es mostrarà el diff contra el repositori.

##### Mostra la diferència contra el repositori, &ead;, els canvis locals

    kdesvn exec diff meu_fitxer.c

##### Mostra la diferència entre revisions

    kdesvn exec diff -r 21:20 meu_fitxer.c

Quan es diferencien dues revisions dels elements, poden afegir-se a l'&URL; dels elements. &pex;:

    http://servidor.org/camí/element?rev=HEAD

##### Diferencia dues versions etiquetades

    kdesvn exec diff http://www.alwins-world.de/repos/kdesvn/tags/rel_0_6_2 http://www.alwins-world.de/repos/kdesvn/tags/rel_0_6_3

## Arranjament

Els ajustaments es poden canviar des del diàleg de configuració. Estan separats en alguns subdiàlegs.

### General

Mida de les icones per a la vista en llista | Especifica la mida de les icones a la vista en llista principal.
Mostra la informació del fitxer | Si ha d'aparèixer un petit consell d'eina quan es mou el ratolí sobre un element.
Marca l'estat de l'element superposant una icona | Quan un element no està en l'estat normal de Subversion es pot obtenir una superposició. (Vegeu overlay-meaning).
L'ordre dels elements és sensible a majúscules | Si l'ordre de classificació a la finestra principal és o no sensible a majúscules i minúscules, &ead;, si a és igual que A.
Mostra els fitxers ignorats | Mostra els elements marcats al Subversion per a ignorar o no.
Màxim de missatges de registre en l'historial: | Quants missatges de registre haurà de recordar el &kdesvn;.
Mostra les anotacions en color | Utilitza els colors definits al diàleg de configuració per a les anotacions.
Usa el plafó de navegació | Alterna la visualització de la vista en arbre del repositori.

### Ajustaments del Subversion i dels treballs programats

### Subversion

Inicia la comprovació d'actualitzacions en obrir una còpia de treball | Quan s'obre una còpia de treball s'inicia una recerca d'actualitzacions en segon pla.
Inicia l'ompliment del cau de registres en obrir | Si s'estableix, el &kdesvn; tornarà a omplir el cau del registre quan s'obri un repositori o còpia de treball, si l'&URL; no és per a un repositori local (`file://`).
Comprova si els elements tenen establerta la propietat svn:needs-lock | Comprova a les còpies de treball si un element té aquesta propietat establerta i en cas afirmatiu, mostra una icona solapada especial. Establir aquesta opció pot alentir considerablement el llistat dels elements.
Obtén els detalls de fitxer en el llistat remot | Quan està marcada, el &kdesvn; obtindrà informació més detallada sobre els elements en realitzar un llistat sobre repositoris remots. Així podreu veure els blocats remots en el resum. Precaució: Això pot tornar el llistat MOLT lent!
Obtén la informació de l'element recursivament | Quan s'activa, l'ordre `info` sobre les carpetes obtindrà informació sobre tots els elements, pot ser realment lent.
Desa les contrasenyes per a connexions remotes | L'emmagatzematge de les contrasenyes sovint és un problema de seguretat. El Subversion emmagatzema les contrasenyes en un fitxer pla, &ead;, contrasenyes en text pla! Així que aneu amb compte ajustant aquesta opció i vegeu la següent entrada. Aquest element només indica el desament de les contrasenyes és el valor per omissió, ho podreu canviar per a dominis específics dins de diàleg d'inici de sessió.
Desa les contrasenyes a la cartera del KDE | Quan es desen les contrasenyes, el fitxer en text pla de Subversion és un forat de seguretat. El &kdesvn; és capaç de desar-les a la cartera del &kde; encriptada (a partir de la versió 0.12.0). D'altra banda, altres clients de Subversion no són capaços de llegir-les pel que haureu d'introduir-les emprant eines de línia d'ordres com svn o rapidsvn. Mentre el Subversion no encripti l'emmagatzematge de les contrasenyes, us ho haureu de pensar dues vegades.
Usa el cau de contrasenyes intern | Quan no s'emmagatzema una contrasenya, el &kdesvn; serà persistent mantenint-la fins que finalitzi, de manera que no sigui necessari introduir-la de nou en cada operació. Aquest cau mai serà persistent, &ead;, no es desarà més.
El registre segueix els canvis de node | Si se selecciona, el registre seguirà les operacions de còpia.
El registre sempre llegeix la llista de fitxers canviats | L'ordre «log» pot llegir la llista de fitxers canviats en publicar. Això és útil, i en la majoria dels casos no provoca una càrrega significativa sobre el tràfic de dades.
Revisa els elements abans de publicar-los | En fer una publicació, el &kdesvn; pot realitzar una comprovació del que farà. Per exemple, si hi ha elements sense versió que es poden afegir, llista d'elements canviats i operació actual a publicar. Això costarà més o menys depenent de l'arbre.
Oculta els elements nous al quadre de publicació | S'han o no de mostrar els elements sense versió en el diàleg de publicació.
Una actualització modifica en lloc de generar conflictes | Si s'estableix, una addició local al mateix camí que una addició entrant de la mateixa classe de node, resultarà en un node normal amb una possible modificació local, en lloc d'un conflicte a l'arbre.
Una actualització crea els elements pare que falten | Si s'estableix, es crearà qualsevol directori pare no existent comprovant també la profunditat buida.

### Tasques programades

Comprova per a elements modificats cada N segons Comprova per a elements actualitzats cada N segons | Si s'estableix, es comprovarà regularment si hi ha actualitzacions o elements modificats a la còpia de treball, quan la xarxa estigui activa.

### Diff i merge

El «diff» ignora el tipus de contingut

- Només interessant quan el «diff» es fa amb el Subversion. Quan s'estableix, el «diff» de Subversion ignorarà el tipus de contingut de les entrades. Altrament, no farà diferencies sobre els binaris.

El «diff» en l'arbre de revisions serà recursiu

- Quan s'estableix, els «diff» fets des de dins de la vista en arbre de les revisions es realitzaran de forma recursiva, com en tots els altres casos. Altrament, només es mostraran els canvis que pertanyin als elements en aquesta carpeta. Com es farà dependrà de com es generin els «diff» (des de Subversion mateix o des de visors externs).

El «diff» ignora els canvis als espais en blanc

- Ignora els canvis en la quantitat d'espais en blanc (opció `-b` al diff).

El «diff» ignora tots els espais en blanc

- Ignora tots els espais en blanc (opció `-w` al diff).

Prefereix un programa de fusionat extern

- Estableix si es prefereix fusionar amb un programa extern i no amb el Subversion.

Usa el format «diff» de Git

Mostra les còpies com afegits

#### Usa un visor de «diff» extern

Selecciona una aplicació externa per a mostrar les diferències. Per omissió és el &kompare;.

#### Visor extern per a «diff»

Defineix què utilitzarà el &kdesvn; com a visor extern de les diferències i com el cridarà. Hi ha tres maneres:

<programa> <paràmetre>

- La diferència serà generada amb el Subversion i posada directament a l'entrada estàndard del programa extern (&ead;, no caldran fitxers temporals).

<programa> <paràmetre> %f

- El «diff» serà generat amb el Subversion, desat en un fitxer temporal i el paràmetre `%f` serà substituït pel nom del fitxer. Es pot utilitzar, per exemple, amb una crida simple a less o un visor de text.

<programa> <paràmetre> %1 %2

- El &kdesvn; deixarà que el programa extern faci les diferències. %1 i %2 seran substituïts pels valors requerits (noms de fitxer o de carpeta). El &kdesvn; emmagatzemarà el contingut per a comparar en un entorn temporal (quan les carpetes fan una exportació, quan una sola fila, fa un cat) quan sigui necessari i netejarà després de tancar el programa extern o ell.

Prefereix un programa de fusionat extern

- Seleccioneu si al diàleg de fusionat l'opció Usa un fusionat extern hauria o no d'estar marcada per omissió.

#### Programa de fusionat extern

L'ajustament del programa i les opcions a utilitzar quan no es desitja el fusionat intern de Subversion. Per omissió és `kdiff3 %s1 %s2 %t`. L'ordre de les variables de substitució no és important, i només poden aparèixer-hi una vegada, &pex;, com `kdiff3 -o %t %s1 %s2 %t`. Aquest material només ha estat provat amb meld i &kdiff3;. Penseu que els programes externs majoritàriament no saben res sobre el paràmetre `ignore` de Subversion, de manera que poden mostrar molt més del que esperàveu.

##### La substitució de variables per a programes de fusionat externs

%s1

- Substituïda amb l'origen número ú.

%s2

- Substituïda amb dos números d'origen. Si està buit o és igual que l'origen i inici i final de la revisió és el mateix, aquesta variable serà omesa. De manera que tingueu cura en crear línies d'ordres com `xxdiff --title1 %s1 --title2 %s2 %s1 %s2 %t`.

%t

- Substituïda amb l'objectiu.

#### Programa per a la resolució de conflictes

Podeu utilitzar un programa extern com el &kdiff3; per resoldre els conflictes, el valor predeterminat és `kdiff3 %o %m %n -o %t`.

##### La substitució de variables per a resoldre conflictes externs

Entre parèntesis després de cada descripció és un exemple de com el Subversion cridaria als fitxers. Aquestes opcions estan dissenyades per al &kdiff3;, perquè en aquest moment és l'única aplicació que admet tots els paràmetres necessaris per a una bona resolució dels conflictes.

%o o %l

- La versió antiga (local, esquerra). Això significa el número de la revisió menor, &ead;, el punt d'inici dels canvis conflictius. (`foo.cc.r2`)

%m o %w

- La seva versió (de treball) del fitxer, &ead;, el que heu canviat respecte a la versió antiga. (`foo.cc.mine`)

%n o %r

- Versió nova (remota, dreta) del fitxer. Per exemple, la versió que algú altre ha fet. (`foo.cc.r3`)

%t

- Nom de destinació, &pex;, el nom d'origen. Per al &kdiff3; (com a exemple), aquest serà el nom després del paràmetre `-o` (= fitxer de sortida). (`foo.cc`)

### KIO / Línia d'ordres

Mostra el registre després d'executar una ordre

- Si s'obre un diàleg obert amb el registre de l'última ordre de Subversion que s'ha executat a través de la línia d'ordres o el menú d'accions al &konqueror;.

Nombre mínim de línies de registre a mostrar:

- Si s'estableix Mostra el registre..., quin serà el mínim de línies abans que es mostri un diàleg. Pel que podeu establir que aquesta finestra només es mostri quan es generi una sortida interessant (registre de publicacions i així successivament).

No mostrar menús contextuals al &konqueror;

- Si s'estableix, no es crearà cap entrada de menú d'accions del &kdesvn; al &konqueror;.

No mostrar entrades a la part superior del menú «Accions»

- Si s'estableix, el &kdesvn; no mostrarà algunes accions extra dins del menú Accions del &konqueror; o &dolphin;.

Les operacions KIO usen l'estàndard per als missatges de registre

- En realitzar operacions en un repositori a través del protocol KIO del &kdesvn; des de dins del &konqueror; (&ead;, els protocols, ksvn+...) sobre operacions grans com moure o copiar carpetes, el &kdesvn; demanarà un missatge de registre per a cada element. Aquest és un comportament del &konqueror;. Quan s'estableix aquesta opció, la implementació KIO del &kdesvn; no demanarà un missatge de registre, sinó que n'establirà un d'estàndard. Aquesta etiqueta no fa per a les operacions del menú d'accions del &kdesvn; pel &konqueror;, sinó que només copia/mou/creadir/suprimeix amb el &konqueror; o altres gestors de fitxers en un URL en format KIO.

Missatge estàndard

- El missatge que el KIO del &kdesvn; hauria d'establir en les operacions dins del &konqueror; quan s'ha seleccionat l'opció anterior. Per omissió és Revisió feta amb el KIO del &kdesvn;.

KIO pot sobreescriure

- Si s'estableix aquesta etiqueta, tindreu un suport simple d'escriptura per als elements existents. &pex;, podeu obrir fitxers al vostre editor i desar directament sense verificar abans (el &kdesvn; ho farà en segon pla).

  Utilitzeu aquesta opció només si sabeu el que esteu fent.

KIO mostra els missatges de progrés

- Si s'estableix, el KIO mostrarà informació detallada del Plasma del KDE sobre l'operació actual. Els missatges d'error de KIO sempre es mostra i no es poden desactivar.

## Referència d'ordres

### La finestra principal del &kdesvn;

#### El menú Fitxer

&Ctrl;O Fitxer Obre...

- Obre una còpia de treball local o un repositori prèviament descarregat.

Fitxer Els URL oberts recentment

- Es tracta d'una drecera per obrir els repositoris oberts recentment. En fer clic sobre aquest element, s'obrirà una llista al costat del menú amb les diverses còpies de treball o repositoris locals oberts més recentment. En fer clic sobre un element específic, aquest s'obrirà en el &kdesvn;.

&Ctrl;N Fitxer Nou

- Obre una finestra amb una nova sessió del &kdesvn;.

Fitxer Administració de Subversion

- Els elements del menú amb les tasques d'administració pels repositoris de Subversion com:

  - Crea i obre un repositori nou
  - Bolca un repositori a un fitxer
  - Copia un repositori
  - Carrega un bolcat dintre d'un repositori
  Per a més informació, llegiu la sortida de `svnadmin --help`

&Ctrl;W Fitxer Tanca

- Tanca el repositori o còpia de treball oberta.

&Ctrl;Q Fitxer Surt

- Surt del &kdesvn;.

#### El menú Adreces d'interès

Vegeu l'ajuda del &konqueror;.

#### El menú Subversion

#### Accions generals de Subversion

&Ctrl;L Subversion General Historial de l'element

- Mostra el registre de temps per a l'element seleccionat. Aneu amb compte, aquesta llista pot ser molt gran!

&Ctrl; &Maj;L Subversion General Historial de l'element ignorant les còpies...

- Mostra el registre de l'historial de l'element seleccionat sense seguir les còpies.

&Ctrl;I Subversion General Detalls

- Mostra informació detallada quant al/s element/s seleccionat/s.

Subversion General Responsabilitat

- Crea una llista comentada sobre totes les publicacions. Això pot consumir temps!

Subversion General Qui va canviar la línia en l'interval

- Anota un interval de publicacions per a un fitxer.

Subversion General Bolca (cat) el HEAD

- Mostra el contingut de l'última versió publicada d'aquesta entrada. (Pot ser diferent de la versió a la còpia de treball si es treballa en una CT!)

F2 Subversion General Mou

- Mou o canvia el nom de l'element dins de la còpia de treball o en el repositori.

&Ctrl;C Subversion General Copia

- Copia un element dins de la còpia de treball o en el repositori.

Supr Subversion General Suprimeix els fitxers/directoris seleccionats

- Suprimeix les entrades seleccionades. Si treballeu en una còpia de treball, després haureu de publicar les supressions.

Subversion General Carpeta nova

- Crea una carpeta nova.

Subversion General Importa les carpetes cap a l'actual

- Selecciona les carpetes que voleu importar dins del directori seleccionat.

Subversion General Descarrega un repositori

- Crea una còpia de treball nova d'un repositori.

Subversion General Exporta un repositori

- Exporta un repositori al sistema de fitxers, &ead;, crea un arbre de revisions net i sense informació de Subversion.

Subversion General Bloca els elements actuals

- Marcar els elements actuals com a bloquejats. Llegiu el manual de Subversion abans d'utilitzar això!

Subversion General Desbloca els elements actuals

- Elimina els blocatges dels elements actuals. Llegiu el manual de Subversion abans d'utilitzar això!

#### Còpia de treball

Subversion Còpia de treball Actualitza a HEAD

- Actualitza la còpia de treball a HEAD del repositori.

Subversion Còpia de treball Actualitza a la revisió...

- Actualitza la còpia de treball a una revisió específica del repositori.

&Ctrl;núm Subversion Còpia de treball Publica

- Publica els canvis dins de la còpia de treball pels elements seleccionats al repositori.

&Ctrl;D Subversion Còpia de treball Diff dels canvis locals

- Mostra els canvis locals com una sortida del «diff» (sense accés a la xarxa). Aquesta serà només la diferència contra l'últim estat de la còpia de treball que es va actualitzar, no contra la versió al repositori.

&Ctrl;H Subversion Còpia de treball Diff contra HEAD

- Genera les diferències de la còpia de treball contra HEAD del repositori.

&Ctrl;P Subversion Còpia de treball Propietats

- Visualitza/Edita les propietats assignades amb l'entrada actual.

Inser Subversion Còpia de treball Afegeix els fitxers/directoris seleccionats

- Afegeix els fitxers i/o carpetes seleccionades al control de versions.

Subversion Còpia de treball Reverteix els canvis actuals

- Reverteix els canvis realitzats a la còpia de treball i les actualitzacions a l'últim estat actualitzat.

Subversion Còpia de treball Marca com a resolt

- Marca els elements en conflicte com a sense conflicte i elimina els fitxers associats.

Subversion Còpia de treball Fusiona dues revisions

- Fusiona dues revisions de les entrades dins la còpia de treball.

Subversion Còpia de treball Des/ignora l'element actual

- Edita les propietats de la carpeta pare de l'element actual, de manera que es marcarà l'element seleccionat com a ignorat si no s'estableix, en cas contrari s'eliminarà de la llista d'ignorats.

Subversion Còpia de treball Neteja

- Neteja la còpia de treball i elimina els bloqueigs-(publica) si n'hi ha.

Subversion Còpia de treball Canvia al repositori

- Canvia l'arrel de la còpia de treball.

#### Repositori

Subversion Repositori Descarrega des del camí del repositori actual

- Crea una còpia de treball des de l'entrada seleccionada si és un directori.

Subversion Repositori Exporta el camí del repositori actual

- Crea una còpia neta al sistema de fitxers local des de l'entrada seleccionada si és un directori.

#### Accions de la vista

F5 Subversion Visualitza Refresca la vista

- Refresca l'estat actual de tots els elements mostrats. Això llistarà cada element demanant que es mostri amb l'estat actual.

Subversion Visualitza Desplega l'arbre de fitxers / Plega l'arbre de fitxers

- Expandeix o contrau la vista en arbre del repositori.

Subversion Cau del registre Atura l'actualització del cau del registre

- El registre s'emmagatzema al cau i s'utilitza per a visualitzar l'arbre de revisions d'un repositori. Depenent de la connexió a Internet, la mida del repositori de Subversion i la longitud de l'historial pot ser molt gran. Per tant podreu deixar d'actualitzar el cau utilitzant aquesta acció.

Subversion Afegeix les identitats ssh al ssh-agent

- Emmagatzema la contrasenya de la vostra clau SSH per a la sessió actual, de manera que no necessiteu introduir més la contrasenya.

#### El menú Base de dades

Base de dades Mostra el contingut de la base de dades

- Mostra un resum sobre el contingut de la base de dades al cau per als repositoris coneguts i permet suprimir el cau o repositori i accedir als ajustaments del repositori.

Base de dades Ajustaments del repositori actual

- Mostra un diàleg per adaptar els ajustaments del cau, registres i estadístiques.

#### Els menús Arranjament i Ajuda

El &kdesvn; té la configuració comuna al &kde; i els elements del menú Arranjament i Ajuda, per obtenir més informació llegiu les seccions sobre El menú Arranjament i El menú Ajuda dels fonaments del &kde;. Amb aquesta entrada de menú addicional:

Arranjament Opcions ràpides

- A l'inici carrega l'últim URL obert

- Torna a carregar l'últim URL obert si no s'indica a la línia d'ordres.

Els registres segueixen els canvis de node

Mostra els fitxers ignorats

- Mostra els elements marcats al Subversion per a ignorar o no.

Mostra els fitxers desconeguts

- Mostra els fitxers no afegits al repositori de Subversion.

Oculta els fitxers sense canvis

- Utilitzeu aquesta acció per mostrar només els fitxers modificats i proporcionar un resum clar i concís.

Treballa en línia

- Quan es treballa fora de línia, el cau del registre no s'actualitzarà, per tant, el registre del cau podrà diferir del registre real.

## Crèdits i llicència amb els reconeixements

Copyright del programa 2005-2009 &Rajko.Albrecht; &Rajko.Albrecht.mail;

Moltes gràcies als col·laboradors:

- Andreas Richter ar@oszine.de - per l'adaptació a les qt4 del svnqt

- Michael Biebl biebl@teco.edu - per la molta ajuda, idees, implementació i consells.

- Bram Schoenmakers bramschoenmakers@kde.nl - pels consells específics sobre el &kde;, traducció a l'holandès, neteja del meu codi.

I gràcies a tots els altres traductors (mai vaig pensar que obtindria tan ràpidament una quantitat tan gran de traduccions!) i per tota la seva retroalimentació positiva i negativa. M'ha ajudat molt.

Si voleu la vostra pròpia traducció del &kdesvn; i podeu ajudar, si us plau, llegiu la pàgina de localització del &kde; o pregunteu a la llista de correu kde-i18n-doc@kde.org.

Copyright de la documentació 2005-2006 &Rajko.Albrecht; &Rajko.Albrecht.mail;

Traductor de la documentació: &credits.Antoni.Bella;

&underFDL; &underGPL;

## Sintaxi per a les revisions

Les revisions es poden indicar en la mateixa forma que per al client svn estàndard. Això vol dir: número, paraula clau o data.

Número

- Un número més gran o igual que -1. El -1 significa revisió sense especificar, 0 és el començament. Normalment, aquests números no s'han d'utilitzar (la majoria de les operacions fallaran).

Paraula clau

- Un de

  - HEAD

  - BASE

  - COMMITED

  - PREV

  - START

  - WORKING

  Les paraules clau són sensibles a majúscules i minúscules! Per exemple, «head» no és el mateix que «HEAD».

Data

- Data en la forma {AAAA-MM-DD}. Els MM o DD seran reals - &pex; 2005-1-1 s'ha d'escriure com {2005-01-01}-.

En afegir una revisió específica a un &URL; sempre es farà ?rev=`revisió`.

&documentation.index;