path: root/es_ES.ISO8859-1/articles/cvs-freebsd/article.xml

<?xml version="1.0" encoding="iso-8859-1" standalone="no"?>
<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook XML V4.2-Based Extension//EN"
	"../../../share/xml/freebsd42.dtd" [
<!ENTITY % entities PUBLIC "-//FreeBSD//ENTITIES DocBook FreeBSD Entity Set//ES" "../../share/xml/entities.ent">
%entities;
]>

<!--
  The FreeBSD Spanish Documentation Project
  $FreeBSD$
  $FreeBSDes$
-->

<article lang='es'>
  <articleinfo>
    <title>Configurar un repositorio CVS - a la manera de FreeBSD</title>

    <author>
      <firstname>Stijn</firstname>
      <surname>Hoop</surname>
      <affiliation>
        <address><email>stijn@win.tue.nl</email></address>
      </affiliation>
    </author>

    <copyright>
      <year>2001</year>
      <year>2002</year>
      <year>2003</year>
      <holder role="mailto:stijn@win.tue.nl">Stijn Hoop</holder>
    </copyright>

    <pubdate>$FreeBSD$</pubdate>

    <releaseinfo>$FreeBSD$</releaseinfo>

    <legalnotice id="trademarks" role="trademarks">
      &tm-attrib.freebsd;
      &tm-attrib.general;
    </legalnotice>

    <abstract>
      <para>Este artículo describe los pasos que dí para
        configurar un repositorio CVS con los mismos <quote>scripts</quote>
        usados por el proyecto &os; en su configuración.
        Tienen algunas ventajas frente a las demás
        configuraciones de CVS, por ejemplo una gestión más
	eficaz de los accesos a los árboles de código y
        la creación de mensajes de correo electrónico por
        cada commit.</para>
	&trans.es.jcamou;
    </abstract>
  </articleinfo>

  <sect1>
    <title>Introducción</title>

    <para>Muchos de los proyectos de software de código
      abierto usan <application>CVS</application> como su sistema
      de gestión de código.  Aunque <application>
      CVS</application> es bastante bueno para esto tiene sus
      inconvenientes y sus flaquezas.  Un ejemplo de esto es el compartir
      un árbol de código con otros desarrolladores, lo cual
      puede convertirse rápidamente en una pesadilla para la
      administración del sistema, especialmente si se desea
      proteger del acceso indiscriminado ciertas partes del
      árbol.</para>

    <para>&os; es uno de los proyectos que usan <application>
      CVS</application>.  También cuenta con una gran
      cantidad de desarrolladores alrededor del mundo.  Ellos
      mismos desarrollaron algunos <quote>scripts</quote> para hacer
      del manejo del repositorio una tarea más fácil.
      Recientemente estos <quote>scripts</quote> fueron revisados por
      &a.joe; para facilitar su uso en otros proyectos.  Este
      artículo muestra uno de los métodos para usar estos
      nuevos <quote>scripts</quote>.</para>

    <para>Si quiere sacar verdadero partido de la información que
      se le brinda en este artículo debe tener familiaridad con
      métodos básicos para realizar operaciones
      <application>CVS</application>.</para>
  </sect1>

  <sect1>
    <title>Comienzo de la configuración</title>

    <warning>
      <para>Es preferible que realice estos procedimientos
        en un repositorio de prueba vacío y podamos asi asegurarnos
        de que entiende todas las consecuencias.  Como siempre, asegúrese
        de tener respaldos recientes.</para>
    </warning>

    <sect2>
      <title>Inicio del repositorio</title>

      <para>Lo primero a hacer al configurar un nuevo repositorio
        es decirle a <application>CVS</application> que lo inicie:

        <screen>&prompt.user; <userinput>cvs -d <replaceable>ruta-al-repositorio
        </replaceable> init</userinput></screen>

        Esto le indica a <application>CVS</application> que cree
        el directorio administrativo <filename>CVSROOT</filename>,
        donde se albergarán todas las configuraciones.</para>
    </sect2>

    <sect2>
      <title>El grupo del repositorio</title>

      <para>Ahora vamos a crear al grupo dueño del repositorio.
        Todos los <quote>committers</quote> necesitan estar en este
        grupo, para de esta manera poder escribir en el repositorio.
        Asumiremos el grupo <literal>ncvs</literal> por defecto
        de &os;.

        <screen>&prompt.root; <userinput>pw groupadd <replaceable>ncvs
        </replaceable></userinput></screen>

        A continuación, es necesario usar &man.chown.8; en el directorio
        para ajustar los permisos al grupo reción agregado:

        <screen>&prompt.root; <userinput>chown -R :<replaceable>ncvs
        </replaceable>
        <replaceable>path-a-su-repositorio</replaceable></userinput></screen>

        Esto asegura que nadie podrá escribir en el repositorio
        sin los permisos de grupo adecuados.</para>
    </sect2>

    <sect2>
      <title>Obtención del código</title>

      <para>Ahora es necesario obtener el directorio <filename>
        CVSROOT</filename> del repositorio de &os;.  Puede hacerse muy
        fácilmente desde una réplica del CVS
        anónimo de &os;.  Para más información
<!--
	consulte <ulink
        url="&url.books.handbook;/anoncvs.html">el capítulo
-->
	consulte <ulink
	url="http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/anoncvs.html">el
        capítulo correspondiente del Handbook</ulink>.
        Asumiremos que el código está en
        <filename>CVSROOT-freebsd</filename> en el directorio
        actual.</para>
    </sect2>

    <sect2>
      <title>Copia de los <quote>scripts</quote> de &os;</title>

      <para>El siguiente paso consiste en copiar el código de &os;
        sito en <filename>CVSROOT</filename> a nuestro
        repositorio.  Si está familiarizado con <application>CVS
        </application>, puede pensar que se puede
        realizar importando los <quote>scripts</quote>, lo que debería
	permitirle sincronizar posteriores versiones muy fácilmente.
        No es así, <application>CVS</application> tiene una
        deficiencia en este aspecto: al intentar importar
        código al directorio
        <filename>CVSROOT</filename> no se actualizarán los
        ficheros administrativos necesarios.  Para hacer que esto
        suceda es necesario ejecutar <quote>checkin</quote>
        en cada uno de ellos después de importarlos,
        perdiendo asi el valor de <literal>cvs import</literal>.
	En consecuencia el método recomendado para este
	cometido es sencillamente copiar los
	<quote>scripts</quote>.</para>

      <para>No importa en realidad si no encuentra demasiado sentido al
	párrafo anterior, el resultado será el mismo.
        Simplemente haga <quote>check out</quote> de su <filename>CVSROOT
        </filename> y copie los ficheros de &os; a su copia local:

        <screen>&prompt.user; <userinput>cvs -d <replaceable>
        ruta-a-su-repositorio </replaceable> checkout CVSROOT</userinput>
        &prompt.user; <userinput>cd CVSROOT</userinput>
        &prompt.user; <userinput>cp ../CVSROOT-freebsd/* .</userinput>
        &prompt.user; <userinput>cvs add *</userinput></screen>

        Tenga en cuenta que probablemente recibirá advertencias
        acerca de directorios no copiados; es normal que suceda pero no
	debe usted preocuparse porque éstos no son
        necesarios.</para>
    </sect2>

    <sect2>
      <title>Los <quote>scripts</quote></title>

      <para>Ahora ya cuenta con una copia exacta en su directorio de
	trabajo de los <quote>scripts</quote> que &os; usa en la
	gestión de su repositorio.
        He aquí una descripción del cometido de cada uno de
	ellos.</para>

      <itemizedlist>
        <listitem>
          <para><filename>access</filename> - este fichero
            no se usa en la configuración por defecto.
            Se usa en <link linkend="freebsdspecific">la
            configuración del proyecto &os;</link>,
            el cual controla el acceso al repositorio.  Puede
            borrar este fichero si no quiere usarlo en su
            configuración.</para>
        </listitem>

        <listitem>
          <para><filename>avail</filename> - este fichero
            controla el acceso al repositorio.  Dentro del mismo
            es posible especificar grupos de personas
            autorizadas para el acceso al repositorio,
            asi como commits no autorizados en uno o más
            directorios dados.  Deberá
            editarlo para que contenga los grupos
            y directorios que se usarán en su
            repositorio.</para>
        </listitem>

        <listitem>
          <para><filename>cfg.pm</filename> - este fichero
            se encarga de analizar su configuración
            y provee la configuración por defecto.
            <emphasis>No</emphasis> deberá usted
            cambiar nada en este fichero.  Si va a hacer cambios
            su configuración deberán ir en
            <filename>cfg_local.pm</filename>.
            </para>
        </listitem>

        <listitem>
          <para><filename>cfg_local.pm</filename> -
            contiene todos los parámetros configurables del
            sistema.  Deberá configurar todo tipo de
            cosas en este fichero, tales como el envío
            por correo electrónico de los mensajes
            de commit, desde qué <quote>hosts</quote> pueden
	    hacer commits los usuarios, etc.  Más
            información más adelante en el texto.</para>
        </listitem>

        <listitem>
          <para><filename>checkoutlist</filename> - este fichero
            lista todos los ficheros bajo control de <application>
            CVS</application> en este directorio, aparte de aquellos
            estándar creados por <literal>cvs init</literal>.
            Deberá editar éste para borrar algunos
            ficheros específicos del proyecto &os;.</para>
        </listitem>

        <listitem>
          <para><filename>commit_prep.pl</filename> - este <quote>
	    script</quote> se encarga de realizar algunas comprobaciones
	    previas a cada commit según las modificaciones hechas o
	    o no en su versión de
            <filename>cfg_local.pm</filename>.
            No debería modificar este <quote>script</quote>.</para>
        </listitem>

        <listitem>
          <para><filename>commitcheck</filename> - este <quote>script</quote>
            es invocado directamente por <application>CVS</application>.
            En primer lugar comprueba que la <quote>committer</quote> tenga
            acceso a una parte específica del árbol usando
            <filename>cvs_acls.pl</filename>, para después
            ejecutar <filename>commit_prep.pl</filename>, mediante el que
	    efectuará las comprobaciones de rigor previas a cada
	    commit.  Si todo ha ido bien  <application>CVS</application>
            permitirá que el commit tenga lugar.  No debería
            tocar este fichero.</para>
        </listitem>

        <listitem>
          <para><filename>commitinfo</filename> - este fichero es
            usado por <application>CVS</application> para determinar
            qué <quote>script</quote> se deberá ejecutar
	    antes de hacer el commit, en este caso
            <filename>commitcheck</filename>.
            Tampoco debería tener que modificar este fichero.</para>
        </listitem>

        <listitem>
          <para><filename>config</filename> - el fichero de
            configuración del repositorio.  Debería
            editarlo si es necesario aunque la mayoría de
            los administradores lo dejan tal y como viene por defecto.
            Dispone de más información sobre las opciones
            que pueden declararse en él en el manual de
            <application>CVS</application>.</para>
        </listitem>

        <listitem>
          <para><filename>cvs_acls.pl</filename> - este <quote>script</quote>
            determina la identidad de los <quote>committers</quote>, así
            como si tiene permitido acceder al árbol.
            Está basado en el fichero <filename>avail</filename>.
            No debería tener que modificar este fichero.</para>
        </listitem>

        <listitem>
          <para><filename>cvsignore</filename> - este fichero especifica
            los ficheros que <application>CVS</application> no debe
            incluir en el repositorio.  Puede editarlo a su gusto.
            Para más información sobre fichero consulte
            el manual de <application>CVS</application>.
            </para>
        </listitem>

        <listitem>
          <para><filename>cvswrappers</filename> -
            <application>CVS</application> usa este fichero para activar
	    o desactivar la expansión de
            la expansión de palabras clave o si el
            fichero debe ser considerado binario.  Este fichero puede
            editarse  según necesidades.  Para más
	    información sobre este fichero consulte el manual de
            <application>CVS</application>.
            Tenga en cuenta que las opciones <literal>-t</literal> y <literal>
            -f</literal> no funcionan correctamente con <application>
            CVS</application> cliente/servidor.</para>
        </listitem>

        <listitem>
          <para><filename>edithook</filename> - este fichero ya no
            se usa, aunque se mantenga por razones históricas.
            Este fichero puede borrarse con total tranquilidad sin miedo de
            perjudicar la configuración.</para>
        </listitem>

        <listitem>
          <para><filename>editinfo</filename> - <application>CVS
            </application> usa este fichero en las sobreescrituras de
	    edición.  &os; no usa esta función ya que el
	    análisis de mensajes de <quote>log</quote> se hace
	    mediante <filename>verifymsg</filename> y
	    <filename>logcheck</filename>.  Esto se debe a que
	    <filename>editinfo</filename> no funciona correctamente con
	    commits remotos ni con aquellos que usan las opciones
            <literal>-m</literal> o <literal>-F</literal>.
            No debería tener que modificar este fichero.</para>
        </listitem>

        <listitem>
          <para><filename>exclude</filename> - este fichero lista
            expresiones regulares usadas por
	    <filename>commit_prep.pl</filename> para determinar ficheros
	    que no puedan contener cabeceras de revisión.  En la
	    configuración que se usa en &os; todos los ficheros
	    bajo control de revisión necesitan tener lo que se
	    llama una cabecera de revisión
	    (&dollar;FreeBSD&dollar;).  Todos los ficheros que aparezcan
	    en alguna de las líneas de
            <filename>exclude</filename> no pasan por dicha revisión.
	    Incluya en este fichero entradas para aquellos ficheros que no
	    puedan tener una cabecera de revisión.  Si va a instalar
	    los <quote>scripts</quote> <filename>CVSROOT/</filename> es un
	    firme candidato para figurar en este fichero.</para>
        </listitem>

        <listitem>
          <para><filename>log_accum.pl</filename> - este es el
	    <quote>script</quote> encargado de obtener el mensaje de
	    <quote>log</quote> que genera <filename>logcheck</filename> y
	    añadirlo a un fichero de <quote>log</quote> en el repositorio
	    para que pueda disponerse de respaldos en caso de necesidad.
	    También gestiona el envío de un correo electrónico
	    a la dirección que el administrador declare (en
            <filename>cfg_local.pm</filename>).  <filename>loginfo
            </filename> se encarga de conectar <filename>log_accum.pl
            </filename> con <application>CVS</application>.  No
            debería tener que modificar este fichero.</para>
        </listitem>

        <listitem>
          <para><filename>logcheck</filename> - este fichero revisa el
            mensaje de commit proporcionado por el
            <quote>committer</quote> e intenta esterilizarlo, valga la
            expresión.  Este fichero conecta con
            <application>CVS</application> via <filename>verifymsg
            </filename>.  Tampoco debería tener que modificar este
	    fichero.</para>

          <note><para>Este <quote>script</quote> depende de un hack de <application>
            CVS</application> propio de &os;: esta versión lee el
            mensaje de <quote>log</quote> después de que este
	    <quote>script</quote> lo haya modificado.  La versión
            estándar de <application>CVS</application>
            no hace esto, lo que hace a <filename>
            logcheck</filename> incapaz de limpiar los mensajes de
	    <quote>log</quote>, aunque es capaz de comprobar que
	    esté sintácticamente correcto.
            <application>CVS</application> 1.11.2 puede configurarse
            para tener el mismo comportamiento que la
            versión de &os; activando <literal>
            RereadLogAfterVerify=always</literal> en el fichero
            <filename>config</filename>.</para></note>
        </listitem>

        <listitem>
          <para><filename>loginfo</filename> - este fichero es usado por
            <application>CVS</application> para controlar dónde se
	    envía la información de <quote>log</quote>;
            aquí es donde <filename>log_accum.pl</filename>
            entra en escena.  No debería tener que modificar
	    este fichero.
          </para>
        </listitem>

        <listitem>
          <para><filename>modules</filename> - este fichero mantiene su
            significado tradicional en <application>CVS</application>.
            Deberá borrar los módulos propios de &os; de la
            versión que vaya a usar.  Puede editarlo a su
            gusto.  Tiene más información acerca de este fichero
            en el manual de <application>CVS</application>.</para>
        </listitem>

        <listitem>
          <para><filename>notify</filename> -
            <application>CVS</application> usa este fichero en caso de que
            alguien ponga un fichero en modo <quote>watch</quote>.  No se usa en el
            repositorio de &os; y puede editarse cuanto se desee.
            Tiene más información acerca de este fichero
            en el manual de <application>CVS</application>.</para>
        </listitem>

        <listitem>
          <para><filename>options</filename> - este fichero se usa
            específicamente en la versión de <application>CVS
            </application>
            de &os;, así como en la versión de Debian.
            Contiene una palabra clave para expander cabeceras de
            revisión.  Tendrá que modificar este fichero
	    y escribir la misma palabra que haya declarado en
            <filename>cfg_local.pm</filename> (si es que quiere usar esa
            característica, claro está; el valor por defecto
	    es FreeBSD)</para>
        </listitem>

        <listitem>
          <para><filename>rcsinfo</filename> - este fichero mapea
            directorios en el repositorio para aplicar una plantilla
            como <filename>rcstemplate</filename>.  Por defecto &os;
            usa una plantilla para el repositorio.  Es posible
            añadir otras plantillas si se estima conveniente.</para>
        </listitem>

        <listitem>
          <para><filename>tagcheck</filename> - este fichero controla
            el acceso a marcar <quote>tags</quote> (etiquetas) en el
	    repositorio.  La versión por defecto en &os; no admite
	    etiquetas con nombre RELENG* debido al proceso de ingeniería
	    de releases.  Puede editar este fichero según sus
	    necesidades.</para>
        </listitem>

        <listitem>
          <para><filename>taginfo</filename> - este fichero mapea operaciones
            de etiquetado en los directorios del repositorio, cosa necesaria en
	    el funcionamiento habitual de <quote>scripts</quote> de control como
            <filename>tagcheck</filename>.  No debería tener que modificar
            este fichero.</para>
        </listitem>

        <listitem>
          <para><filename>unwrap</filename> - este <quote>script</quote> puede ser
            usado para alterar el estado de ficheros binarios en una forma opuesta a
	    como lo hace <filename>cvswrappers</filename>, descrito al principio de esta
	    lista.   No se usa en la configuración que funciona hoy día
	    en &os; porque no funciona correctamente con commits remotos.
            No debería tener que modificar este fichero.</para>
        </listitem>

        <listitem>
          <para><filename>verifymsg</filename> - este fichero mapea
            directorios del repositorio con <quote>scripts</quote> encargados del proceso
	    posterior de mensajes de commit en ficheros de <quote>log</quote>, por
            ejemplo <filename>logcheck</filename>.
            No debería verse en la necesidad de modificar este fichero.</para>
        </listitem>

        <listitem>
          <para><filename>wrap</filename> - este script puede usarse
            para poner ficheros binarios bajo el efecto de
	    <filename>cvswrappers</filename> (descrito al principio de esta
	    lista) en cada <quote>checkin</quote>.  No se usa en la
	    configuración que mantiene el proyecto &os; porque no
	    funciona correctamente con commits remotos.  No debería tener
	    que modificar este fichero.
            </para>
        </listitem>
      </itemizedlist>
    </sect2>

    <sect2>
      <title>Modificación de los <quote>scripts</quote></title>

      <para>El siguiente paso es configurar los <quote>scripts</quote> para que
        se adapten a sus necesidades.  Tendrá que revisar todos y
        cada uno de los ficheros en el directorio y hacer sus propios
        cambios y configuraciones.  Seguramente tendrá que editar los
        siguientes ficheros:</para>

      <procedure>
        <step>
          <para>Si no desea usar los <quote>scripts</quote> de la
          <link linkend="freebsdspecific">
          configuración específica de &os;</link>
          puede borrar tranquilamente el fichero <filename>
          access</filename>:

          <screen>&prompt.user; <userinput>cvs rm -f access</userinput>
          </screen></para>
        </step>

        <step>
          <para>Editar <filename>avail</filename> para que contenga los
            diferentes directorios del repositorio en los cuales quiera
            controlar el acceso.  Asegúrese de mantener la línea
            <literal>avail||CVSROOT</literal>, si no lo hace no podrí
            realizar el siguiente paso.</para>

          <para>Otra de las opciones que puede añadir a este fichero
            es el grupo de <quote>committers</quote>.  Por defecto
            &os; usa el fichero <filename>access</filename> para
            listar todos sus <quote>committers</quote> pero se puede
            usar cualquier fichero que se desee.  También es
            posible agregar grupos si se desea (la sintaxis está
            declarada en la primera parte de <filename>cvs_acls.pl
            </filename>).</para>
        </step>

        <step>
          <para>Edite <filename>cfg_local.pm</filename> para que contenga
            las opciones deseadas.  Seguramente le serán de gran
            interés las siguientes configuraciones:

            <itemizedlist>
              <listitem>
                <para><literal>%TEMPLATE_HEADERS</literal> - éstos son
                  procesados por los <quote>scripts</quote> de <quote>log</quote>
		  y se insertan bajo el correo de commit si es que existen.
                  Puede que quiera borrar las entradas <literal>PR</literal>
                  y <literal>MFC after</literal>; y claro, puede agregar
                  las suyas.</para>
              </listitem>

              <listitem>
                <para><literal>$MAIL_BRANCH_HDR</literal> - puede añadir
                  una cabecera en cada correo de commit en la que se detalle la
		  rama (<quote>branch</quote>) en la que se ha hecho el commit.
                  Defina la cabecera según su configuración y
		  necesidades o déjelo vacío si no desea usar dicha
		  cabecera.</para>
              </listitem>

              <listitem>
                <para><literal>@COMMIT_HOSTS</literal> - defina éste valor
		  si desea listar los <quote>hosts</quote> desde los que será
		  posible hacer commits.
                  </para>
              </listitem>

              <listitem>
                <para><literal>$MAILADDRS</literal> - defina éste como
                  la dirección del administrador o de alguna lista donde
                  reciban los correos de commit.</para>
              </listitem>

              <listitem>
		<para><literal>@LOG_FILE_MAP</literal> - cambie este
		  valor como desee.  Cada expresión regular
		  (regexp) se compara en el directorio del commit, y el
		  mensaje de log del commit se guarda en el subdirectorio
		  <filename>commitlogs</filename> en el nombre de fichero
		  mencionado.</para>
              </listitem>

              <listitem>
                <para><literal>$COMMITCHECK_EXTRA</literal> - si no
                  desea usar las <link linkend="freebsdspecific">comprobaciones
                  de acceso específicas de &os;</link> debería
                  borrar la definición de <literal>
                  $COMMITCHECK_EXTRA</literal> de este fichero.</para>
              </listitem>
            </itemizedlist>

          <note><para>Cambiar el parámetro <literal>$IDHEADER</literal>
            es algo que sólo puede asegurarse que funcionará en
            &os;; depende de las modificaciones
            específicas de <application>CVS</application> hechas por
            &os;.</para></note>

          Revise <filename>cfg.pm</filename> y compruebe si alguna de las
          opciones puede modificarse, aunque los cambios propuestos en los
	  párrafos anteriores son bastante razonables.</para>
        </step>

        <step>
	  <para>Seguramente quiera borrar las líneas del principio de
	    <filename>exclude</filename> (las que contienen
            <literal>^ports/</literal>, entre otras), puesto que son
	    específicas de &os;.  Además de esto
            comente las líneas que empiecen con
            <literal>^CVSROOT/</literal> y agregue una línea sólo
            con <literal>^CVSROOT/</literal>.  Después de que
            <quote>wrapper</quote> sea instalado puede añadir
            su cabecera a los ficheros en el directorio <filename>
            CVSROOT</filename> y restaurar estas líneas; por lo
            pronto sólo estarán estorbarán en el momento
	    que quiera hacer un commit.</para>
        </step>

        <step>
          <para>Edite <filename>modules</filename> y borre todo lo
            relacionado con &os;.  Añada sus propios módulos
            si lo cree necesario.</para>
        </step>

        <step>
          <note><para>Este paso es sólo necesario si usted ha
            declarado un valor a <literal>$IDHEADER</literal>
            en <filename>cfg_local.pm</filename> (que sólo
            funciona usando la versión de <application>CVS
            </application> modificada por &os;).</para></note>

          <para>Edite <filename>options</filename> y asegúrese
            de que la etiqueta declarada sea la misma que en <filename>
            cfg_local.pm</filename>.  Simplemente cambie la etiqueta
            <literal>FreeBSD</literal> por la suya.</para>
        </step>

        <step>
          <para>Edite <filename>rcstemplate</filename> para que
            contenga las mismas palabras clave
	    (o <quote>keywords</quote>) declaradas en
            <filename>cfg_local.pm</filename>.</para>
        </step>

        <step>
          <para>Puede borrar (este paso es opcional) las comprobaciones
            realizadas por <filename>tagcheck</filename>.  Puede
            simplemente añadir <literal>exit 0</literal> al principio
            del fichero para deshabilitar todas las comprobaciones que
	    hace sobre las etiquetas.</para>
        </step>

        <step>
          <para>El último paso antes de terminar es
            asegurarse de que sea posible guardar de modo seguro los
	    mensajes de commit.  Por defecto se guardan en el propio
            repositorio, en el subdirectorio <filename>commitlogs</filename>
            del directorio <filename>CVSROOT</filename>.  Este
            directorio debe crearse del siguiente modo:

            <screen>&prompt.user; <userinput>mkdir commitlogs
            </userinput>&prompt.user; <userinput>cvs add commitlogs
            </userinput></screen></para>

        </step>
      </procedure>

      <para>Después de una revisión cuidadosa
        debe hacer los commits necesarios con sus cambios.  Asegúrese
        de haber activado su acceso al directorio <filename>
        CVSROOT</filename> en su <filename>avail</filename> antes
        de intentarlo.  Una vez haya comprobado que todo es correcto puede
	hacer lo siguiente:

        <screen>&prompt.user; <userinput>cvs commit -m '<replaceable>- Commit
        para iniciar los scripts de FreeBSD</replaceable>'</userinput>
        </screen></para>
    </sect2>

    <sect2>
      <title>Prueba de la configuración</title>

      <para>Ahora ya está listo para la primera prueba: un commit
        forzado al fichero <filename>avail</filename> para asegurarnos
        de que todo funciona como se espera.

        <screen>&prompt.user; <userinput>cvs commit -f -m'<replaceable>Commit
        forzado para probar los nuevos scripts en CVSROOT</replaceable>'
        avail</userinput></screen>

        Si todo ha funcionado ¡felicidades!  Dispone de una
        configuración de los <quote>scripts</quote> de &os; en su repositorio.
        Si <application>CVS</application> le da algún tipo de error
        en algo revise todo de nuevo y asegúrese de que todos
        los pasos se hayan hecho correctamente.</para>
    </sect2>
  </sect1>

  <sect1 id="freebsdspecific">
    <title>Configuración específica de &os;</title>

    <para>El proyecto &os; utliza una configuración
      ligeramente diferente de la descrita; se usan los ficheros de
      configuración del subdirectorio
      <filename>freebsd</filename> en <filename>CVSROOT</filename>.
      El proyecto lo hace de esta manera debido al gran número de
      committers y a que todos y todas han de estar en el mismo grupo.
      Un <quote>wrapper</quote> simple fué escrito para poder
      asegurar que los usuarios tengan permisos correctos para poder hacer
      hacer commits; este <quote>wrapper</quote> establece el id del grupo al
      que el repositorio tiene.</para>

    <para>Si su repositorio lo necesita también los
      pasos para hacerlo están documentados más adelante.  Pero
      antes de nada veamos una descripción de los ficheros involucrados.</para>

    <sect2>
      <title>Ficheros usados en la configuración de &os;</title>

      <para>
        <itemizedlist>
          <listitem>
            <para><filename>access</filename> - este fichero controla
              la información de acceso.  Se debe editar este
              fichero e incluir a todos los miembros del proyecto.</para>
          </listitem>

          <listitem>
            <para><filename>freebsd/cvswrap.c</filename> - este es el
              código de CVS wrapper que va a ser necesario
              instalar para hacer que todos los chequeos de acceso
              funcionen.  Mas información sobre él más
	      adelante en el texto.  Debería editar las rutas de las
              macros <literal>ACCESS</literal> y <literal>REALCVS</literal>
              para que se correspondan con su configuración.
              </para>
          </listitem>

          <listitem>
            <para><filename>freebsd/mailsend.c</filename> - este fichero
              es necesario para la configuración de la lista
              de correo de &os;.  No deberá tocar este
              fichero.</para>
          </listitem>
        </itemizedlist>
      </para>
    </sect2>

    <sect2>
      <title>El procedimiento</title>

      <procedure>
        <step>
          <para>Edite el fichero <filename>access</filename> para que
            sólo contenga su nombre de usuario.</para>
        </step>

        <step>
          <para>Edite el fichero <filename>cvswrap.c</filename> para que
            contenga la ruta correcta de su configuración.  Se
            define con una macro llamada <literal>ACCESS</literal>.
            Deberá cambiar también el lugar del binario de
            <command>cvs</command> si no coincide con el de su
            sistema.  <filename>cvswrap.c</filename> está pensado
            para sustituir al comando cvs del sistema, que pasará a
            ser <filename>/usr/bin/ncvs
            </filename>.</para>

          <para>Mi copia de <filename>cvswrap.c</filename> tiene lo
            siguiente:</para>

          <programlisting>#define ACCESS "/local/cvsroot/CVSROOT/access"
#define REALCVS "/usr/bin/ncvs"</programlisting>
        </step>

        <step>
          <para>Instalaremos después wrapper para asegurarnos de que
            se haya convertido en el grupo correcto al hacer el commit.
            Tiene el código fuente en
            <filename>cvswrap.c</filename> en su
            <filename>CVSROOT</filename>.</para>

	  <para>Tendrá que compilar el código una vez haya
	    incluido en el las rutas correctas:

            <screen>&prompt.user; <userinput>cc -o cvs cvswrap.c
            </userinput></screen>
            E instálelos (necesitará ejecutar este paso como root):

            <screen>&prompt.root; <userinput>mv /usr/bin/cvs /usr/bin/ncvs
            </userinput>
            &prompt.root; <userinput>mv cvs /usr/bin/cvs</userinput>
            &prompt.root; <userinput>chown root:<replaceable>ncvs</replaceable>
            /usr/bin/cvs /usr/bin/ncvs</userinput>
            &prompt.root; <userinput>chmod o-rw /usr/bin/ncvs</userinput>
            &prompt.root; <userinput> chmod u-w,g+s /usr/bin/cvs</userinput>
            </screen>

            Esto instala wrapper como el comando <command>cvs</command>
            por defecto; así nos aseguramos de que cualquiera que
            quiera usar el repositorio necesita tener los niveles de acceso
            correctos.</para>
        </step>

        <step>
          <para>Ahora ya puede eliminar a todos los usuarios del grupo del repositorio.
            Todo control de acceso lo hará a partir de ahora wrapper y este wrapper
            establecerá el grupo de acceso correcto.</para>
        </step>
      </procedure>
    </sect2>

    <sect2>
      <title>Prueba de la configuración</title>

      <para>Su wrapper debería estar listo.  Debería probarlo,
        claro está, haciendo un commit forzado al fichero <filename>
        access</filename>:

        <screen>&prompt.user; <userinput>cvs commit -f -m '<replaceable>Commit
        forzado para probar los nuevos scripts en CVSROOT</replaceable>'
        access</userinput></screen>

        Si algo falla asegúrese de que todos los pasos arriba
        descritos se han realizado correctamente.</para>
    </sect2>
  </sect1>
</article>