[LCFC] wml://devel/website/using_cvs

[Javi Taravilla <javiertaravilla@gmail.com>]

Otro a la siguiente fase.



-- 
Javier Taravilla

#use wml::debian::template title="Uso del CVS"
#use wml::debian::translation-check translation="1.21" maintainer="Luis Uribe"

<p>CVS es un programa para ayudar en la gestión de varias personas que
trabajan simultáneamente en el mismo material. Cada usuario crea una copia
local del repositorio principal. Las copias locales pueden residir en la
misma máquina o a lo largo del mundo. Los usuarios pueden entonces modificar
la copia local como deseen, y cuando el material modificado esté preparado, enviar
los cambios al repositorio principal.

<p>Para una accesso de solo lectura puede usar la <a href="http://cvs.debian.org/webwml/?root=webwml";>interfaz web</a>. Existen también muchos clientes gráficos como <a href="http://packages.debian.org/cervisia";>Cervisia</a> de KDE. Este documento describe el flujo de trabajo con el programa de linea de comandos <code>cvs</code>, aunque otros clientes ofrecen funciones similares.

<p>CVS no le permitirá enviar un fichero si la copia del repositorio
principal se ha modificado desde la última actualización que usted realizó.
Esto no suele ser un problema, ya que puede actualizar su copia
local. Si las modificaciones eran de partes diferentes a aquellas en las que trabajaba,
los cambios son mezclados silenciosamente. Si los cambios afectan al mismo área
en la que usted estuvo trabajando, le avisará de que hay un conflicto y que es necesario
editar el fichero y corregir el problema antes de enviarlo.

<P>A continuación usaremos un acceso anónimo como ejemplo. Si usted tiene
acceso a una cuenta que le da permiso de escritura en el repositorio, debería usar esa cuenta. 
Si está planeando hacer cambios, debería conseguir una cuenta antes de empezar, ya que los usuarios anónimos no pueden enviar cambios.
Vea la sección sobre <a href="#write-access">acceso con escritura</a> para más 
información.

<p>Para empezar a usar CVS, primero ha de <code>entrar</code> (login) en el servidor CVS:

<pre>
   cvs -d :pserver:anonymous@cvs.alioth.debian.org:/cvsroot/webwml login
</pre>

<p>(pulse intro cuando se le pida la clave)

<P>Para bajar una copia de los ficheros wml a su máquina local, necesita usar

<pre>
   cvs -d :pserver:anonymous@cvs.alioth.debian.org:/cvsroot/webwml checkout webwml
</pre>

<p>Puede obtener un subconjunto de páginas como este:

<pre>
   cvs -d :pserver:anonymous@cvs.alioth.debian.org:/cvsroot/webwml checkout -l \\
          webwml webwml/&lt;<var>idioma</var>&gt;
   cvs -d :pserver:anonymous@cvs.alioth.debian.org:/cvsroot/webwml checkout \\
          webwml/Perl webwml/english/template webwml/&lt;<var>idioma</var>&gt;/Pics
   cvs -d :pserver:anonymous@cvs.alioth.debian.org:/cvsroot/webwml checkout \\
          &lt;<var>ruta a los ficheros deseados</var>&gt;
</pre>

<p>Repita esto para todos los directorios o ficheros que quiera. La
segunda línea incluye todos los ficheros que necesitará si quiere
crear HTML a partir de los ficheros WML. Descargas parciales como esas no están en realidad permitidas, 
por lo que las instrucciones anteriores puede que no siempre funcionen.

<p>Si ha recibido un usuario y clave, insértela en el lugar de «anonymous»,
de esta forma:

<pre>
   cvs -d :ext:usuario@cvs.debian.org:/cvs/webwml checkout webwml/english/doc
</pre>

<P>Desde ahora, no necesitará usar la parte <code>'-d :ext:...'</code>
Cada pocos días tendrá que hacer

<pre>
   cvs update -d
</pre>

<p>para actualizar los ficheros del repositorio que hayan cambiado. La
opción de actualización <code>-d</code> añadirá automáticamente los nuevos directorios.
Puede que quiera crear un fichero <code>~/.cvsrc</code>, de forma que no tenga que teclear
las mismas opciones constantemente. Esto puede contener por ejemplo:

<pre>
cvs -z9
update -d -P
diff -u
</pre>

<P>Lo que sigue es para aquellos que tienen permiso de escritura en el repositorio.
Cuando termine con una página, puede enviar sus cambios al repositorio usando

<pre>
   cvs commit &lt;fichero&gt;.wml
</pre>

<p>o

<pre>
   cvs commit &lt;directorio&gt;    (para entregar todos los cambios en &lt;directorio&gt;)
</pre>

<p>o

<pre>
   cvs commit          (para entregar todos los cambios en el directorio actual y sus subdirectorios)
</pre>

<P>Si es la primera persona en traducir una página, necesita hacer

<pre>
   cvs add &lt;file&gt;.wml
</pre>

<p>antes de enviarla. Tenga en cuenta que <code>cvs add</code> no es recursivo, por lo que
necesitará añadir un directorio antes de añadir su contenido.

<P>Para más información sobre CVS, use <code>info cvs</code>.

<h3><a name="write-access">Acceso con escritura al CVS</a></h3>

<p>Para obtener acceso de escritura a la página web, solicite por favor unirse al <a href="https://alioth.debian.org/project/request.php?group_id=1135";> proyecto <code>webwml</code> en Alioth</a>.