Modo de uso

A continuación se propone una sencilla metodología de trabajo con CVS para evitar trabajos redundantes. Piense por ejemplo en la eliminación de erratas o errores en documentos o en código fuente.

Antes de cada sesión de trabajo es conveniente hacer cvs update -Pd para asegurarnos de que disponemos de las últimas modificaciones registradas en el repositorio.

Justo al acabar cada sesión de trabajo es conveniente hacer cvs commit (se puede abreviar en cvs ci) para que todas nuestras modificaciones se registren en el repositorio.

Añadir nuevos módulos al repositorio

Para añadir nuevos modulos al repositorio se usa la orden cvs import, que le indica a CVS que debe crear una copia en el repositorio del conjunto de ficheros del directorio actual.

Por ello, para importar un nuevo módulo al repositorio debemos situarnos primero en el directorio raíz del módulo donde están los ficheros del mismo y ejecutar la orden:

<<configuración de las variables de entorno de CVS>>
cd directorio-donde-se-encuentran-los-ficheros
cvs import nombre-módulo etiqueta-vendedor etiqueta-versión

Donde:

• nombre-módulo: es el nombre que le queremos dar al nuevo módulo.
• etiqueta-vendedor: es el nombre que usa CVS para etiquetar la rama que crea con la importación. Puede ser una cadena cualquiera de letras, números y subrayados.
• etiqueta-versión: es el nombre que usa CVS para etiquetar la versión concreta que se crea con esta importación. Puede ser una cadena cualquiera de letras, números y subrayados.

Descargar un módulo por primera vez

Para crear una copia de trabajo local del módulo CVS deseado debemos usar la orden cvs checkout (abreviable como cvs co):

<<configuración de las variables de entorno de CVS>>
cd padre-de-directorio-donde-se-alojará-el-módulo
cvs checkout nombre-del-módulo

Esto creará una jerarquía de directorios donde se almacenará la copia local de trabajo el módulo. Este paso sólo hay que hacerlo una vez por cada módulo.

A partir de este momento no es necesario configurar las variables de entorno porque CVS sabe a qué repositorio pertenece el módulo con sólo examinar los subdirectorios CVS. No se debe modificar nunca esos subdirectorios a mano. De lo contrario CVS perderá la pista de a que módulo pertenecen los ficheros, cuáles son las versiones de la copia local, etc.

Actualizar nuestra copia local desde el repositorio

Cuando queramos actualizar la copia local de trabajo del módulo con los cambios que hayan podido hacer otros usuarios y que están recogidos en el repositorio deberemos emplear la orden update:

cd directorio-del-módulo
cvs update -Pd

Publicar nuestras modificaciones en el repositorio

Se usa la orden commit (o su equivalente ci):

cd directorio-del-módulo
cvs commit

Tras lo cual el sistema mostrará la pantalla de un editor de textos (el que tengamos configurado como nuestro favorito en la variable de entorno EDITOR) para que introduzcamos el mensaje de log, una o dos líneas describiendo los cambios realizados en el módulo desde el último commit.

Algunas opciones que admite la orden commit son:

• -l : Solamente se aplica a los ficheros del directorio actual, no a sus subdirectorios.
• -R : Se aplica a los subdirectorios de forma recursiva (por defecto).
• -F fichero: Lee el mensaje de log de un fichero, en lugar de invocar al editor.
• -m "mensaje" : Permite indicar el mensaje de log (debe ir entre comillas), en lugar de invocar al editor.
• -f: Obliga a realizar un commit sobre un fichero incluso si no hemos hecho modificaciones al mismo.