Manejo básico del CVS para colaborar con La Espiral

Javier Viñuales Gutiérrez

12 de enero de 2001

Introducción

(Nota del editor: hoy en día --enero de 2004-- esta receta está desactualizada respecto al funcionamiento de La Espiral, mas continúa teniendo un gran valor como ejemplo de como trabajar con un servidor CVS).

En esta receta, de una extensión mayor de lo normal por pura necesidad, no se va a explicar qué es el CVS ni para qué sirve, simplemente los pasos a seguir para un uso cotidiano con La Espiral, extensible a cualquier otro proyecto que tenga servidor CVS. Para saber qué es y más posibilidades del CVS se aconseja la consulta de cvs-book (paquete debian del mismo nombre).

Pasos a seguir

Suponiendo que tu nombre de usuario es emeteo (te lo dedico Mario :-D), esto son los pasos que has de seguir:

1. Crea el directorio de donde va a colgar tu copia local del repositorio. Por ejemplo "/home/emeteo/laespiral", situate en el directorio anterior.

2. Ejecuta:

cvs -d :pserver:emeteo@cvs.laespiral.org:/home/cvs login emeteo
(introducción de la contraseña)
cvs -z 9 -d :pserver:emeteo@cvs.laespiral.org:/home/cvs co módulo

Con estas órdenes primero entras al CVS de La Espiral y luego haces una copia local en tu disco duro de los contenidos del "módulo" que hayas escogido (en la sección de módulos te diremos los módulos que existen). Ya no tendrás que hacer uso nunca más de la opción "d" del comando cvs (no confundir con la opción "d" de las órdenes para cvs por ejemplo "cvs update -d"). Si no tienes una cuenta de acceso al servidor CVS, puedes usar el nombre de usuario anoncvs, con contraseña en blanco, que te dejará copiar ficheros del repositorio pero no modificarlos.

En ~/.cvspass se guarda la información necesaria usuario@servidor:directorio/al/repositorio y contraseña por cada vez que haces "cvs -d ... login" para un proyecto distinto, y permanecerá allí en cuanto no hagas "cvs -d ... logout". Sólo tendrás que situarte en el directorio de trabajo (del que cuelga el directorio "CVS", en este caso /home/emeteo/módulo) para trabajar y dar las órdenes indicadas por ejemplo en los dos apartados siguientes.

3. Cada vez que quieras introducir algo nuevo, modificar, borrar o lo que sea del repositorio, es más que recomendable hacer previamente:

cvs update -dP

Para actualizar (las opciones d y P crean nuevos directorios que hayan aparecido y borran los que ya no existan). Hay que observar siempre la información sobre el estado de los ficheros al hacer la actualización, indicada por "U", "P", "M", "A", "R", "C"; o "?".

U = actualizada la copia local con la copia remota.
P = como "U" pero sólo fueron añadidos parches.
M = la copia local ha sido modificada pero aún no se han realizado un
"cvs ci" (check in, introducción en el repositorio).
A = añadido un fichero a la copia local. No se actualizará en el
servidor hasta un "cvs ci".
R = borrado un fichero de la copia local. No se actualizará en el
servidor hasta un "cvs ci".
C = Existe un conflicto entre la copia local y la remota en el
servidor. Hay que corregir a mano lo que está marcado entre "<<<<<<"
y ">>>>>>".
? = Existe en la copia local pero no se ha añadido aún mediante "cvs
add". No se actualizará en el servidor hasta un "cvs ci" después del
"cvs add".

Especialmente importante es notar si existe alguna "C" al hacer update, hay que corregirlo de inmediato.

Operaciones usuales

¡A disfrutar del trabajo en grupo! ;-)

Para más información recuerda consultar cvs-book, navegable desde /usr/share/doc/cvsbook.

Módulos CVS de La Espiral

Los módulos disponibles para bajar del repositorio de La Espiral son los siguientes:

articulos

Artículos publicados en La Espiral. Solo se guardan en el repositorio las fuentes xml. Las otras versiones deberán ser obtenidas con el programa le2all del paquete le-docxml (el propio servidor cvs se encargará de hacerlo).

recetas

Las recetas en formato xml distribuidas en subdirectorios con 100 recetas cada uno; las modificaciones realizadas en este directorio son alimentadas automáticamente en la base de datos de recetas.

recetas-bin

Programas usados para aceptar, actualizar y consultar recetas.

le-www

Páginas web. Por cada página HTML, existirá únicamente el fichero fuente XML y en cada directorio un fichero Makefile para quien quiera generar una versión local de las páginas html usando el comando make (los ficheros html generados no deben ser subidos al repositorio). Cada vez que se altera una página xml en el repositorio, el servidor se encarga de revisar si se ajusta al DTD de las páginas web de La Espiral, y si lo hace, la convierte en html, independientemente de las ordenes que existan en el fichero Makefile. Por eso habrá que tener especial cuidado en confirmar que no existan errores de sintaxis xml antes de subir una página y tener en cuenta que las páginas quedarán visibles en la web inmediatamente después de entrar en el repositorio. Este módulo incluye los módulos "articulos" y "recetas", como subdirectorios del directorio documentacion.

le-admin

Ficheros de configuración de La Espiral: lista de correo, estadísticas de acceso, servidor cvs, páginas de estilo xsl, etc.

le-docxml

El paquete LE-Document, usado para crear y procesar las fuentes xml de las páginas web, artículos y recetas.

new-debs

Paquetes deb originales de La Espiral y que no han entrado en la versión oficial, así como algunos paquetes oficiales de los cuales dependen.

nparted

Repositorio del proyecto nParted.

debian-es

Repositorio del proyecto debian-es.

debian-586

Repositorio del proyecto debian-586.

laespiral

El repositorio cvs completo de La Espiral. Contiene todos los módulos anteriores (no es aconsejable a quien sufra de falta de espacio en disco o de demoras en la conexión).

En la lista de correo laespiral-cvs@matrio.com el servidor cvs anuncia cada vez que el repositorio sufre alteraciones. Quien esté interesado en recibir esos anuncios se puede suscribir a esa lista, enviando un mensaje que diga subscribe en el campo Subject, para laespiral-cvs-request@matrio.com.




Página creada en: 2004-11-04 11:40:56 +0000
© Copyright 2001, 2002, 2003, 2004, La Espiral, debian-laespiral@lists.debian.org
Permitida la copia y distribución textual, integral, siempre y cuando se mantenga este aviso.