Hola a todos:

Desde hace no mucho tiempo, Gentoo Linux está proporcionando un servicio 
de acceso anónimo a sus distintos repositorios. De cara a nuestro grupo 
de documentación, puede resultar bastante útil obtener una copia del 
repositorio de documentación y trabajar directamente con ella, en lugar 
de con archivos sueltos como hacemos ahora.

Si no hay algún motivo en contra, actualizaré la documentación estos 
días para incluir el resumen que adjunto un poco más abajo y recomendar, 
de ahora en adelante, el uso del cvs.

Un saludo.

Breve Introducción:

--------- 8< --------------

=== INSTALACIÓN ===

Gentoo utiliza como gestor de su repositorio el sistema CVS. Debemos 
tenerlo instalado para poder obtener la copia del repositorio en nuestro 
sistema local. Instalarlo es bastante sencillo:

# emerge cvs

Una vez instalado, procedemos a obtener una copia del repositorio.

# cvs -d :pserver:anonymous@g.o/var/cvsroot co gentoo

Este comando creará un directorio llamado gentoo/ en nuestro sistema el 
cual contendrá una imagen del repositorio oficial.

Nota:
La descarga inicial del repositorio implica una transferencia bastante 
pesada de datos. Si se para el proceso de cvs, se puede matar (cntrl+C) 
y volver a ejecutar, pues seguirá por donde se quedó.

Encontraremos los archivos fuente (xml) de los documentos oficiales 
dentro del directorio gentoo/xml/htdocs/ básicamente bajo doc/ y proj/.

=== EMPLEO ===

Se puede trabajar con los documentos del repositorio de manera habitual,
haciendo los cambios necesarios.

Una vez realizados los cambios necesarios, podemos obtener el parche 
necesario para enviar a bugzilla mediante el comando:

# cvs diff -u fichero > doc.patch

Para actualizar nuestro cvs, únicamente necesitamos ejecutar:

# cvs update -dP

El comando update actualizará el directorio desde donde haya sido 
ejecutado y todos sus subdirectorios, pero no todo el repositorio 
entero, a no ser que se haga desde la raíz del mismo.

--------- 8< --------------

Más información puede encontrarse en el cvs-tutorial de Gentoo o en la 
web en general.

-- 
Jose Luis Rivero [yoswink@g.o]
Gentoo/Doc Gentoo/Alpha
-- 
gentoo-doc-es@g.o mailing list