En aquesta secció, analitzarem com posar un projecte nou al repositori de CVS. Si només voleu treballar amb el projecte existent que ja es troba en un repositori, podeu saltar-vos aquesta secció.

Hi ha dues maneres de posar un projecte al CVS:

La importació d'un projecte (com un mòdul nou) té alguns avantatges: importareu tots els fitxers i carpetes recursivament, i el mòdul es crearà automàticament. Això simplifica la importació de grans projectes existents en el repositori. No obstant això, hi ha alguns desavantatges: no es pot utilitzar el diàleg d'importació del Cervisia per afegir fitxers als mòduls existents, i podeu importar els fitxers tant de text com binaris. Podeu solucionar aquesta limitació mitjançant la creació d'una carpeta amb els fitxers de només un dels tipus, o informar dels patrons dels fitxers que s'hauran d'ignorar en el procés d'importació.

Per exemple, suposant que el vostre projecte només contingui fitxers de text i algunes imatges PNG (fitxers binaris). Podeu dir-li al CVS que ignori tots els fitxers que continguin el patró *.png mentre importa els altres fitxers com a text, o podeu moure les imatges a una carpeta separada i després importar els fitxers restants (com a fitxers de text). De qualsevol manera haureu de fer un checkout del modul importat recentment a una còpia de treball nova i copiar-ne els fitxers i carpetes restants, afegir i publicar al repositori per a completar el procés d'importació.

Alternativament, podeu afegir els fitxers i les carpetes manualment, creant un modul buit. Per afegir un modul buit a un repositori, simplement heu de crear una carpeta nova a la carpeta arrel del repositori de CVS. El nom d'aquesta carpeta serà el nom del modul. Feu un checkout del nou modul buit. Després copieu els fitxers i carpetes a la còpia de treball, feu afegeix i publica per a pujar-ho tot al repositori de CVS.

Figura 2.2. Una captura de pantalla del diàleg d'importació del Cervisia

A la Figura 2.2, «Una captura de pantalla del diàleg d'importació del Cervisia» podeu veure el diàleg que us ajudarà a importar un projecte com a un modul. Per accedir al diàleg d'importació del Cervisia, escolliu l'element Repositori → Importa... del menú.

Una vegada hageu emplenat aquest formulari i ho hageu confirmat prement D'acord, s'utilitzarà la següent ordre de CVS:

cvs -d ❶repositori import -m "❷" ❸mòdul ❹etiqueta_distribuïdor ❺etiqueta_llançament

Ara que heu definit amb èxit la ubicació del vostre repositori, i importat els fitxers inicials al repositori, és el moment de recuperar el mòdul del repositori de CVS, creant la vostra còpia de treball.

També heu de conèixer el nom de la branca o etiqueta que voleu utilitzar.

Les branques d'un mòdul són versions paral·leles d'aquest mòdul. Una bon exemple real de la utilització d'aquesta característica és el llançament d'un projecte de programari. Després d'un llançament important, hi ha errors en el codi que s'han d'arranjar, però la gent també vol afegir noves característiques. És molt difícil fer les dues coses alhora, perquè les noves característiques generalment introdueixen errors nous, cosa que dificulta el localitzar els antics. Per a resoldre aquest dilema, el CVS permet crear una versió paral·lela, que anomenarem la «branca de la versió estable», on només es poden afegir correccions d'errors, deixant la branca de llançament principal (HEAD) oberta per afegir noves característiques.

Les etiquetes s'utilitzen per a marcar una versió d'un projecte. El CVS marca una versió de cada fitxer amb l'etiqueta, així que quan obtingueu o actualitzeu a una etiqueta específica, s'obtindran sempre les mateixes versions dels fitxers. Per tant, en oposició a les branques, les etiquetes no són dinàmiques: no és possible desenvolupar una etiqueta. Les etiquetes són útils per a marcar productes nous, grans canvis en el codi, etc. Utilitzant etiquetes, podeu tornar amb facilitat el projecte a un estat anterior, per a reproduir i seguir els errors, generar el codi de llançament de nou, etc..

Figura 2.3. Una captura de pantalla del diàleg de recuperació del Cervisia

En iniciar el Cervisia, i obrir una còpia de treball seleccionant Fitxer → Obre una carpeta local..., podeu veure dues àrees principals a la finestra principal del Cervisia, la superior és una vista jerarquitzada (arbre) de la còpia de treball actual; la inferior s'utilitza per a mostrar les ordres de CVS que el Cervisia emet per a realitzar les seves taques, així com la sortida generada per aquestes ordres.

Per omissió, el Cervisia no mostra els fitxers que contenen les subcarpetes, per tant heu de fer clic a les carpetes que voleu veure. Per a mostrar tots els fitxers de la còpia de treball, seleccioneu Visualitza → Desplega l'arbre de fitxers. Per tornar a tancar totes les carpetes de la còpia de treball, escolliu Visualitza → Plega l'arbre de fitxers.

D'acord amb els ajustaments als vostres fitxers .cvsignore, els fitxers que normalment no voleu incloure en el repositori -com ara els fitxers d'objecte- no seran mostrats a la vista en arbre. A cada fila, podeu veure el seu estat corresponent. A l'ajustament per omissió, després d'obrir la carpeta local, l'estat és «Desconegut» perquè el Cervisia retarda l'obtenció de la informació fins que seleccioneu els fitxers i les carpetes l'estat dels quals voleu actualitzar o veure i escolliu Fitxer → Actualitza o Fitxer → Estat. Amb aquest enfocament, teniu una quantitat mínima de funcionalitat disponible fins i tot si no teniu una connexió permanent amb el servidor de CVS.

Figura 2.4. Una captura de pantalla de la vista principal del Cervisia

Les ordres del menú Fitxer normalment només actuen sobre els fitxers que heu marcat. També podeu marcar carpetes. Ara escolliu Fitxer → Estat o premeu F5. El Cervisia emetrà una ordre

cvs update -n noms_de_fitxer

per obtenir la informació de l'estat pels fitxers marcats. Tingueu present que el Cervisia va recursivament dintre de les subcarpetes només si heu establert l'opció corresponent en el menú Arranjament. Ara podreu veure una entrada a la columna Estat d'acord amb l'estat respectiu dels fitxers:

Ara que heu obtingut un resum sobre l'estat actual del CVS, potser voleu fer una actualització. Marqueu alguns fitxers (o l'arrel de l'arbre de carpetes, el qual equival a marcar tots els fitxers en aquesta carpeta). Ara escolliu Fitxer → Actualitza (per descomptat, podríeu haver seleccionat això a l'inici de la sessió). Ara podreu canviar l'estat d'alguns dels fitxers. Normalment, els fitxers que tenen «Necessita apedaçar-se» o «Necessita actualitzar-se» s'actualitzen. Per tant són possibles els següents elements nous a la columna d'estat:

Podríeu haver notat que, segons l'estat del fitxer de la fila, aquesta té un color diferent. Els colors són seleccionats per a reflectir d'alguna manera la prioritat de l'estat. Per exemple, un fitxer amb un conflicte està marcat en vermell per indicar heu de resoldre un conflicte abans que pugeu seguir treballant amb el fitxer. No obstant això, si la carpeta té un gran nombre de fitxers podeu perdre la vista general. Per obtenir informació més concreta quant a quins fitxers tenen un estat inusual, simplement feu clic a la capçalera de la columna Estat. La llista de fitxers s'ordenarà per prioritat, d'aquesta manera tindreu tota la informació important a l'inici de la llista. Per tornar a la vista ordenada alfabèticament, feu clic a la capçalera de la columna Nom de fitxer.

De la mateixa manera que en afegir fitxers, l'eliminació dels fitxers es fa en dos passos. Primer, s'han de registrar els fitxers com a eliminats escollint Fitxer → Elimina del repositori... o bé fent clic dret als fitxers marcats i escollint Elimina del repositori... des del menú contextual. Apareixerà el diàleg Elimina del CVS llistant els fitxers que heu marcat i se us demanarà confirmació. Premeu D'acord i el Cervisia emetrà l'ordre

cvs remove -f noms_de_fitxer

Després d'això, s'haurà de publicar aquesta modificació a la carpeta local, possiblement amb altres modificacions al projecte.

Les carpetes són gestionades fonamentalment de forma diferent als fitxers normals pel CVS. No són sota el control de revisions, és a dir no podeu dir quines carpetes existien en el projecte en una data determinada. A més, les carpetes no es poden esborrar mai explícitament (a excepció d'eliminar-les directament en el repositori).

Com alternativa, el CVS segueix la convenció que una carpeta «no existeix» en la versió del projecte si és buida. Aquesta convenció pot forçar-se utilitzant l'opció -P al cvs update i cvs checkout. Aquesta opció es pot establir en el menú Arranjament → Elimina les carpetes buides en actualitzar.

Es pot afegir una carpeta al repositori escollint Fitxer → Afegeix al repositori... o fent clic dret a les carpetes marcades i escollint Afegeix al repositori... des del menú contextual. Tingueu present que contràriament a afegir fitxers, afegir carpetes no requereix d'una publicació posterior. El Cervisia emetrà l'ordre

cvs add nom_del_directori

Quan hageu fet un cert nombre de canvis a la còpia de treball, i vulgueu que altres desenvolupadors en tinguin accés, els publicareu. Amb una publicació, emplaceu les vostres versions dels fitxers modificats com a una nova revisió al repositori. Una actualització posterior d'un altre desenvolupador li servirà les vostres modificacions a la seva còpia de treball.

Per tal de publicar un conjunt de fitxers, seleccioneu-los a la vista principal del Cervisia i escolliu Fitxer → Publica... o feu clic dret als fitxers marcats i escolliu Publica... des del menú contextual.

Figura 3.2. Una captura de pantalla del diàleg de publicació del Cervisia

Obtindreu un diàleg que mostrarà una llista dels fitxers seleccionats a la secció superior i un registre de missatges pels canvis a sota. El Cervisia ajuda de diverses formes per a trobar un missatge concret: primer, a la llista de fitxers podeu fer doble clic a un fitxer o prémer Retorn per tal de veure els canvis que heu fet en el fitxer. Segon, us donarà una llista dels missatges de registre que heu utilitzat prèviament en un quadre combinat. Tercer, aquest diàleg s'integrarà amb l'editor del registre de canvis del Cervisia descrit a continuació. En finalitzar el diàleg, s'utilitzarà l'ordre

cvs commit -m missatge noms_de_fitxer

.

%cvs update -r X

Amb el Cervisia és molt fàcil de mantenir un fitxer de registre dels canvis que sigui compatible amb l'establert a les línies mestres de programació de GNU. Per utilitzar-lo, escolliu Fitxer → Insereix una entrada al registre de canvis.... Si existeix un fitxer amb el nom ChangeLog al nivell superior de la vostra carpeta local, aquest fitxer serà carregat i tindreu la possibilitat d'editar-lo. Amb aquesta finalitat, a la part superior del fitxer, s'insereix una entrada amb la data actual i el vostre nom d'usuari (que es pot configurar com es descriu a «General»). Quan acabeu podeu tancar el diàleg fent clic a D'acord, el pròxim diàleg de publicació que obriu tindrà el missatge de registre establert al darrer missatge que heu introduït al registre de canvis.

Es poden produir conflictes cada vegada que feu canvis a un fitxer que també ha estat modificat per un altre desenvolupador. El conflicte és detectat pel CVS en actualitzar el fitxer modificat: llavors, el CVS intentarà fusionar les modificacions publicades per un altre desenvolupador a la vostra còpia de treball. La fusió falla si ambdues, les vostres modificacions i les seves modificacions se superposen en parts del fitxer, i el servidor de CVS emetrà un missatge d'error.

A la vista principal del Cervisia, s'indiquen els fitxers amb conflictes amb «Conflicte» a la columna d'estat i amb el color vermell. Ara és feina vostra resoldre aquests conflictes abans de publicar el fitxer. El CVS rebutjarà publicar qualsevol fitxer amb conflictes fins que s'hagi editat. Per descomptat podeu resoldre conflictes des de la vista principal de la manera tradicional: simplement feu doble clic al fitxer en qüestió i editeu-lo amb el vostre editor favorit.

El CVS marca els canvis conflictius emplaçant marques en mig dels fitxers, de la següent manera:

<<<<<<<
Canvis a la vostra còpia de treball
=======
Canvis al repositori
>>>>>>> número_de_revisió

Heu de substituir aquest bloc sencer amb la nova versió fusionada. Per descomptat, teniu una gran llibertat per a resoldre una sèrie de conflictes: per a cada conflicte podeu decidir adoptar una de les dues versions alternatives. També podeu decidir que tots dos enfocaments estan trencats i tornar a escriure una rutina completa o el fitxer complet des de zero.

Afortunadament, el Cervisia ofereix una interfície més agradable per a gestionar aquests conflictes. Això no significa que no necessitareu mai editar manualment els fitxers, però almenys podeu eliminar la necessitat de fer-ho per a resoldre conflictes trivials. Per utilitzar el diàleg Resolució CVS del Cervisia escolliu Fitxer → Resoldre... o feu clic dret al fitxer marcat i escolliu Resoldre... des del menú contextual.

Figura 3.3. Una captura de pantalla del diàleg de resolució del Cervisia

A la part superior del diàleg, podeu veure La vostra versió (A) del fitxer a mà esquerra i la versió en el repositori l'altra versió (B) a mà dreta. Les diferències entre ells estan marcades en color vermell. Sota d'aquestes dues columnes, podeu veure la Versió fusionada. La versió fusionada reflecteix quina d'aquestes seccions serà a la vostra còpia de treball si premeu el botó Desa.

Podeu anar enrere i endavant entre les seccions amb conflictes prement << i >>. a la part inferior central del diàleg podeu veure quina secció està marcada actualment. Per exemple, 2 de 3 vol dir que actualment esteu a la segona secció amb diferències d'un total de 3.

Ara podeu decidir secció per secció quina versió voleu tenir en el fitxer fusionat. Prement A tindreu la versió que heu editat. Prement B tindreu la versió del repositori. Prement A+B, s'afegiran ambdues versions, i la vostra versió vindrà primer. B+A obté el mateix resultat, però l'ordre serà diferent: primer la versió del repositori, després la vostra.

Si no esteu content amb cap d'aquestes versions, premeu Edita per obrir un editor de text simple on podreu editar la secció. En acabar l'edició, premeu D'acord per tornar al diàleg Resolució CVS i acabar de resoldre els conflictes. Podeu veure la secció que acabeu d'editar a la Versió fusionada, amb les vostres modificacions.

Per a desar les modificacions, sobreescrivint la versió de la còpia de treball, premeu Desa. Tingueu present que això desarà les eleccions no només de la selecció que esteu veient actualment, sinó de totes les versions en el fitxer. Si voleu desar-los en un altre fitxer, premeu Desa com a.... Premeu Tanca per a tancar el diàleg. Si tanqueu el diàleg sense desar, es perdran els canvis que heu fet.

De vegades voldreu oferir les vostres modificacions per revisar-les, abans de publicar-les, o no teniu accés al repositori (i per tant no podeu publicar). CVS ofereix formats estàndards per compartir les modificacions en la vostra còpia de treball, de manera que altres puguin revisar els canvis, provar-los en la seva còpia i aplicar-los al repositori CVS. Un fitxer contenint aquestes diferències s'anomena pedaç, i normalment és generat per l'ordre cvs diff, de la mateixa manera que les diferències en «Observant les diferències entre revisions». Compartir pedaços en lloc de grups de fitxers requereix menys amplada de banda, i els pedaços són més fàcils de gestionar, ja que podeu enviar només un fitxer de pedaç contenint totes les diferències de molts fitxers de codi font.

El Cervisia us dóna accés a aquesta característica seleccionant Avançat → Crea pedaç contra el repositori....

Una altra possibilitat és seleccionar un fitxer en la vista principal i seleccionar Navega pel registre... del menú Visualitza o dretaclicar el fitxer marcat i seleccionar Navega pel registre... del menú contextual, per tal d'obrir el Diàleg de navegació del registre. Ara seleccioneu la versió contra la que voleu crear un pedaç, com a revisió «A» i premeu el botó Crea un pedaç.... Això generarà un pedaç amb les diferències entre el fitxer marcat en la vostra còpia de treball i la versió seleccionada com a revisió «A».

Abans de generar el pedaç, el Cervisia mostra un diàleg permetent-vos configurar el format de sortida.

Figura 4.2. Una captura de pantalla del diàleg de pedaços del Cervisia

Després d'establir el format de sortida, el Cervisia genera el pedaç i mostra el diàleg Desa com a. Introduïu el nom de fitxer i la ubicació del fitxer de pedaç en aquest diàleg.

Amb l'ordre cvs annotate, CVS ofereix la possibilitat de veure - per cada línia d'un fitxer - qui ha modificat la línia més recentment. Aquesta vista pot ser útil per tal de trobar qui ha introduït un canvi en el comportament d'un programa o a qui se li ha de preguntar quant a algun canvi o errada en el codi.

El Cervisia us dóna accés a aquesta característica, però més endavant enriqueix la informació de forma interactiva. Podeu obtenir una vista anotada seleccionant Visualitza → Anotacions.... Una altra possibilitat és prémer el botó Anotacions en el diàleg de navegació del registre, on podeu seleccionar quina versió del fitxer voleu visualitzar. Podeu veure una captura de pantalla del diàleg en Figura 4.3, «Una captura de pantalla del diàleg d'anotacions del Cervisia».

Figura 4.3. Una captura de pantalla del diàleg d'anotacions del Cervisia

En el diàleg d'anotacions, podeu veure en una finestra la darrera versió del fitxer seleccionat (o la revisió versió «A», en el cas que hageu llançat el diàleg d'anotacions des del diàleg navega registre). En les columnes anteriors al text, podeu obtenir alguna informació relacionada als darrers canvis en cada línia. En la primera columna es mostra el número de línia. En la segona columna podeu veure el nom de l'autor i el número de revisió. Finalment, en la tercera columna podeu veure el contingut real d'aquesta línia.

En conseqüència, quan una certa línia us sembli estranya o penseu que hi ha una errada, podeu veure immediatament qui és el responsable d'aquesta línia. Però no només això, també podeu trobar perquè s'ha canviat aquesta línia. Per acabar, situeu el cursor del ratolí sobre el respectiu número de revisió. Apareixerà un consell emergent mostrant el missatge de registre i la data del canvi.

En marcar un fitxer en la vista principal i seleccionar Navega pel registre... del menú Visualitza o dretaclicant el fitxer marcat i seleccionant Navega pel registre... del menú contextual, es mostrarà el diàleg Registre de CVS (si marqueu més d'un, no passarà res, ja que el Cervisia només pot generar i analitzar el registre per un fitxer alhora). Aquest diàleg ofereix la funcionalitat de veure l'historial del fitxer. Usant-lo com un navegador de versió podeu:

Figura 4.4. Una captura de pantalla del diàleg de navegació de registres del Cervisia

Podeu seleccionar veure la historia proporcionada per l'ordre cvs log (Sortida CVS ), com un Arbre o en forma de Llista. El que preferiu és una qüestió de gustos i depèn de la informació en la que esteu interessat. L'arbre és una representació intuïtiva del que s'ha fet en diverses branques i per quins autors. Podeu veure els corresponents missatges de registre com a consells emergents. La llista és per la seva naturalesa, lineal i per tant, no ofereix una vista immediata de les branques, per altra banda, concentra més informació relevant en menys estat de pantalla, anomenant la data de cava canvi del fitxer i la primera part del missatge de registre. La informació de la sortida CVS és completa però extensa, i difícil de llegir. Per alleugerir aquests problemes, teniu l'habilitat de cercar el text de la sortida CVS, prement el botó Cerca....

Per obtenir més informació quant a una certa revisió, podeu clicar tant en la llista com en la vista en arbre. Els camps del centre del diàleg s'emplenen amb la informació completa proporcionada per cvs log. Podeu marcar dues revisions, anomenades «A» i «B», que és pertinent si feu ús de les següents característiques proporcionades pels botons. La revisió «A» es pot seleccionar amb el botó esquerre del ratolí, la revisió «B» amb el botó central. En la vista de llista, també podeu navegar amb les tecles del cursor. Per tal de marcar dues revisions «A» i «B», utilitzeu les dreceres Ctrl+A, Ctrl+B, respectivament. Utilitzant la vista Sortida del CVS , podeu clicar en Selecció per a la revisió A i Selecció per a la revisió B per a marcar les revisions.

Si premeu el botó Anotacions, obtindreu un diàleg mostrant el text del fitxer corresponent a la revisió marcada com «A». Cada línia està prefixada amb informació quant a qui l'ha editat per darrera vegada, i en quina revisió ha succeït això. Podeu obtenir més informació quant a visualitzar versions anotades en «Visualitzant una vista anotada d'un fitxer».

Si premeu el botó Diff, s'emetrà una crida a l'ordre cvs diff i obtindreu un diàleg on es mostraran totes les modificacions entre les dues revisions marcades. Si marqueu una revisió «A», però no una revisio «B», el Cervisia generarà les modificacions entre la versió del fitxer marcat com a revisió «A», i la versió de la còpia de treball del fitxer. Això permet veure les diferències entre la vostra versió del fitxer i qualsevol versió disponible en el CVS. Per a fer més fàcil de veure els canvis, s'utilitzen diferents colors per a marcar les línies que s'han afegit, eliminat o simplement canviat. Podeu obtenir més informació quant a veure les diferències en «Observant les diferències entre revisions».

Si premeu el botó Crea un pedaç..., obtindreu un diàleg el que que podreu establir les opcions de format per generar un fitxer contenint totes les modificacions entre les dues reversions marcades que es mostren. Si marqueu una revisió «A», però no una revisió «B», el Cervisia generarà les modificacions entre la versió marcada del fitxer com a revisió «A», i la versió del fitxer de la còpia de treball. Això permet generar un pedaç, o fitxer de diferències, entre la vostra versió del fitxer i qualsevol versió disponible en CVS. Després de configurar el format del pedaç en el diàleg, i prement D'acord, s'emet una ordre cvs diff per a generar el fitxer de diferències. S'obrirà un diàleg Desa com a. Introduïu el nom de fitxer i la ubicació del fitxer de pedaç que ha generat el Cervisia per tal de desar-lo. Podeu obtenir més informació quant a la creació de pedaços, i les opcions de format dels pedaços en «Creació de pedaços».

Si premeu el botó Visualitza, el Cervisia recuperarà la revisió marcada com «A» i la mostrarà utilitzant l'aplicació per omissió per a aquest tipus de fitxer.

Premeu el botó Tanca per abandonar el diàleg i tornar a la vista principal.

Per generar el registre que és la base pel diàleg Registre de CVS, el Cervisia emet la següent ordre:

cvs log nom_de_fitxer

Si el repositori emprat té activat el registre, el Cervisia pot presentar-vos un historial de certs esdeveniments com ara recuperacions, publicacions, etiquetatges, actualitzacions i llançaments. Seleccioneu Historial des del menú Visualitza, i el Cervisia emetrà l'ordre

cvs history -e -a

Ara podeu veure la llista d'esdeveniments, ordenats per la data, en la segona columna es mostra el tipus d'esdeveniment:

Figura 4.5. Una captura de pantalla del diàleg d'historial del Cervisia

Podeu ordenar la llista amb un altre criteri simplement clicant en la seva respectiva capçalera de columna. Per ordenar les entrades de l'historial en les que esteu interessat hi ha diverses opcions de filtre que s'activen amb caselles de selecció:

Els caràcters especials reconeguts pel cercador d'expressions regulars són:

Aquí només analitzarem els aspectes tècnics de l'etiquetatge i de les branques. Si només sou un usuari i no l'administrador del repositori, segurament no us trobareu amb el problema. No obstant això, si sou el vostre propi administrador, hauríeu de llegir primer quant als problemes no tècnics que acompanyen a les branques, per tal d'obtenir una impressió de quant de temps es consumeix i de com pot ser mantenir i netejar d'errors les diferents branques. L'apèndix inclou algunes referències quant a aquest tema.

L'etiquetatge simple és una cosa que fareu normalment quan feu un llançament. d'aquesta manera podreu tornar fàcilment quan vulgueu enrere a l'estat del projecte en aquesta data. Les etiquetes normalment consisteixen en el nom del projecte i el número de versió. Per exemple el Cervisia 1.0 està disponible sota l'etiqueta CERVISIA_1_0. El Cervisia força les regles estrictes del CVS quant a la constitució de noms vàlids d'etiquetes. Han de començar amb una lletra i poden contenir lletres, digits, guions i guions baixos.

Normalment, voldreu etiquetar el projecte sencer (encara que, per descomptat, CVS permet etiquetar només un subconjunt). Amb aquesta finalitat, marqueu la carpeta de nivell superior en la vista i seleccioneu Avançat → Etiqueta/branca. Ara, introduïu el nom de l'etiqueta, premeu Retorn i haureu enllestit.

La creació d'una branca no és significativament més difícil: en el diàleg d'etiquetatge marqueu la casella Crea branca amb aquesta etiqueta. També podeu esborrar una etiqueta existent: seleccioneu Avançat → Elimina etiqueta en la vista principal.

Un altre aspecte de les branques és la fusió de modificacions des d'una banca a la branca actual. Si esteu fent això, seleccioneu Avançat → Fusiona.... El diàleg que apareixerà us donarà dues opcions:

Podeu fusionar totes les modificacions realitzades en una branca a la branca actual, en aquest cas, marqueu la casella Fusiona des de branca i emplenar la branca des de la que voleu fusionar. El Cervisia executarà l'ordre

cvs update -j etiqueta_branca

Una altra possibilitat és que vulgueu fusionar només les modificacions fetes entre dos etiquetes d'una branca. Això normalment succeeix en fusionar des de la mateixa branca al tronc diverses vegades. En aquest cas, marqueu la casella Fusiona les modificacions i introduïu (en l'ordre correcte) les dos etiquetes apropiades. Això resulta en una ordre

cvs update -j etiqueta_branca1 -j etiqueta_branca2

Un vigilant és el nom convencional d'una característica de CVS per notificar als usuaris del repositori si un fitxer ha canviat o un desenvolupador a iniciat l'edició d'un fitxer. L'ús dels vigilants requereix que s'hagi arranjat correctament el fitxer $CVSROOT/CVSROOT/notify. Això no s'explica aquí; si necessiteu més informació quant a l'arranjament des del punt de vista de l'administrador, llegiu un dels llibres llistats en l'apèndix.

El suport principal dels vigilants del Cervisia són sis elements del menú.

Per tal d'afegir un vigilant a un o diversos fitxers, useu Avançat → Afegeix vigilant.... En el diàleg que obtindreu, podreu seleccionar ser notificat per qualsevol dels tipus d'esdeveniments que CVS accepta. Per exemple, si només voleu ser notificat quan un fitxer és publicat, marqueu les caselles Només i Publicacions. Si voleu ser notificat de qualsevol esdeveniment relacionat amb els fitxers marcats, marqueu la casella Tot. L'ordre usat en acceptar el diàleg és

cvs watch add -a commit noms_dels_fitxers

o amb una opció similar, depenent dels esdeveniments que trieu per observar.

SI ja no esteu interessat en alguns fitxers, podeu suprimir els vigilants sobre ells. Amb aquesta finalitat, useu Avançat → Elimina vigilant.... En el diàleg que obtindreu aquí, s'oferiran les mateixes opcions que en el formulari que heu emplenat en afegir el vigilant. Quan confirmeu aquest diàleg, el Cervisiaemet l'ordre

cvs watch remove noms_dels_fitxers

possiblement amb una opció -a pels esdeveniments seleccionats.

Finalment, podeu obtenir una llista de les persones que estan vigilant un conjunt de fitxers. Seleccioneu Avançat → Mostra els vigilants. Usar aquest element del menú resulta en una ordre

cvs watchers noms_dels_fitxers

En l'escenari normal d'ús de CVS cada desenvolupador treballa per separat en la seva carpeta local obtinguda. Quan vol modificar algun fitxer, simplement l'obre en l'editor i comença a treballar en ell. Ningú té coneixement quant a aquest treball fins que es publica el fitxer.

Per alguns grups de desenvolupadors, aquest no és el model preferit de cooperació. Volen estar notificats de quan algú està treballant en un fitxer tan aviat comença. Això es pot aconseguir amb algunes de les següents ordres CVS Abans de començar a editar un fitxer, seleccioneu-lo en la finestra principal del Cervisia i seleccioneu Avançat → Edita fitxers. Això executarà l'ordre

cvs edit noms_dels_fitxers

Això enviarà una notificació a qualsevol que hagi establert un vigilant edició en aquest fitxer. També us registrarà com a editor del fitxer. Podeu obtenir una llista de tots els editors d'un cert fitxer usant Avançat → Mostra els editors. Això és equivalent a escriure en la línia d'ordres

cvs editors noms_dels_fitxers

Una sessió d'edició finalitza automàticament en publicar el fitxer afectat. En aquest moment s'envia una notificació deseditat a totes les persones que hagin registrat un vigilant respectiu en el fitxer. Per descomptat, algunes vegades no voldreu publicar el fitxer, però voldreu cancel·lar la sessió d'edició del fitxer i revertir-lo a la versió anterior. Això es fa usant Avançat → Desfés l'edició de fitxers. Noteu que el Cervisia no us demanarà confirmació; això vol dir que si useu aquest element del menú, tot el treball fet des que vàreu usar Avançat → Edita fitxers es perdrà. Més exactament, el Cervisia usa l'ordre

echo y | cvs unedit noms_dels_fitxers

Fins ara, només hem parlat del casos en els que els editats i els deseditats s'usen voluntàriament pels desenvolupadors. En addició CVS implementa un model que força l'ús d'aquestes ordres. L'ordre responsable de commutar a aquest model és cvs watch on que no explicarem més detalladament perquè s'usa majorment per l'administrador del repositori. No obstant això el punt important des del punt de vista del desenvolupador és que quan el projecte força els editats, les còpies de treball s'obtenen com només de lectura. Això significa que no podeu editar un fitxer per omissió (tret que useu trucs com ara chmod). El fitxer es torna d'escriptura només en usar Avançat → Edita fitxers. Es torna de només lectura una altra vegada en publicar-lo o usar Avançat → Desfés l'edició de fitxers.

La interfície de l'editor del Cervisia també us ajuda amb projectes que forcen els vigilants d'una altra manera. Si acabeu d'iniciar un editor amb un fitxer de només lectura dobleclicant-lo o usant Fitxer → Edita, no podreu desar les modificacions. Això per descomptat, té una raó: sempre que vulgueu canviar un fitxer, haureu d'executar abans cvs edit, perquè totes les persones que estan vigilant el fitxer obtinguin una notificació que esteu treballant en ell.

En aquest cas, és recomanable marcar l'opció Arranjament → Fes el cvs edit automàticament quan sigui necessari. Ara, cada vegada que editeu un fitxer fent-hi doble clic, el Cervisia executarà cvs edit abans d'executar l'editor. D'aquesta manera podeu editar el vostre fitxer de la forma habitual. En finalitzar el vostre treball, publiqueu els fitxers, i els fitxers publicats seran de només lectura de nou.

El model de desenvolupament seguit habitualment quan s'usa CVS s'anomena obtencions sense reserves. Cada desenvolupador té la seva pròpia carpeta local on pot editar els fitxers com vulgui. I quan s'usen les característiques de supervisió com ara cvs edit. múltiples desenvolupadors poden treball en els fitxers sincronitzadament. Els canvis efectuats per un desenvolupador diferent són fusionats en la carpeta local en realitzar una actualització.

Altres sistemes de control de revisions - com ara RCS i SourceSafe usen un model diferent. Quan un desenvolupador vol editar un fitxer, l'ha de bloquejar. Només pot bloquejar un fitxer un editor alhora. Quan ha acabat l'edició, s'allibera el bloqueig. D'una banda, amb aquest model, no poden aparèixer conflictes mai. Per altra banda, dos desenvolupadors no poden treballar alhora en el mateix fitxer, encara que els seus canvis no afectin a ningú més. Això pot ser un coll d'ampolla. No parlarem dels beneficis d'organització d'ambdós enfocaments. No obstant això, mencionarem que, encara que CVS té algunes funcions per bloquejar, no és la manera preferida de treballar amb CVS. No heu d'usar aquestes característiques llevat que estigueu segur que l'encarregat del vostre projecte ho permet.

Amb el Cervisia, bloquejareu els fitxers de la següent manera. Seleccioneu els fitxers desitjats en la vista principal. Després seleccioneu Avançat → Bloqueja els fitxers. Això executa l'ordre

cvs admin -l noms_dels_fitxers

L'efecte contrari s'aconsegueix usant Avançat → Desbloqueja els fitxers. Això executa l'ordre

cvs admin -u noms_dels_fitxers