diff options
Diffstat (limited to 'es_ES.ISO8859-1/articles/p4-primer/article.xml')
| -rw-r--r-- | es_ES.ISO8859-1/articles/p4-primer/article.xml | 132 |
1 files changed, 59 insertions, 73 deletions
diff --git a/es_ES.ISO8859-1/articles/p4-primer/article.xml b/es_ES.ISO8859-1/articles/p4-primer/article.xml index 593feebfd9..79e77bf743 100644 --- a/es_ES.ISO8859-1/articles/p4-primer/article.xml +++ b/es_ES.ISO8859-1/articles/p4-primer/article.xml @@ -1,24 +1,19 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook XML V4.5-Based Extension//EN" - "../../../share/xml/freebsd45.dtd"> +<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook XML V5.0-Based Extension//EN" + "../../../share/xml/freebsd50.dtd"> +<article xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:lang="es"> + -<article lang='es'> - <title><application>Perforce</application> en el contexto del desarrollo de &os;</title> - - <articleinfo> + <info><title><application>Perforce</application> en el contexto del desarrollo de &os;</title> <authorgroup> - <author> - <firstname>Scott</firstname> - <surname>Long</surname> - <affiliation> + <author><personname><firstname>Scott</firstname><surname>Long</surname></personname><affiliation> <address><email>scottl@FreeBSD.org</email> </address> - </affiliation> - </author> + </affiliation></author> </authorgroup> - <legalnotice id="trademarks" role="trademarks"> + <legalnotice xml:id="trademarks" role="trademarks"> &tm-attrib.freebsd; &tm-attrib.cvsup; &tm-attrib.general; @@ -27,9 +22,9 @@ <pubdate>$FreeBSD$</pubdate> <releaseinfo>$FreeBSD$</releaseinfo> - </articleinfo> + </info> -<sect1 id="intro"> +<sect1 xml:id="intro"> <title>Introducción</title> <para>El proyecto &os; utiliza el sistema de control de versiones @@ -37,7 +32,7 @@ experimentales que todavía no están listos para ser incluidos en el repositorio principal de CVS.</para> - <sect2 id="resources"> + <sect2 xml:id="resources"> <title>Disponibilidad, documentación y recursos</title> <para>Aunque que el producto <application>Perforce</application> @@ -45,7 +40,7 @@ interactuar con el servidor se distribuye libremente. Pueden descargarse versiones binarias del mismo desde el sitio web de <application>Perforce</application>: - <ulink url="http://www.perforce.com/perforce/loadprog.html"></ulink>. + <uri xlink:href="http://www.perforce.com/perforce/loadprog.html">http://www.perforce.com/perforce/loadprog.html</uri>. </para> <para>Existe un cliente gráfico, pero la mayoría de la gente @@ -54,7 +49,7 @@ dicha herramienta para la línea de órdenes.</para> <para>En - <ulink url="http://www.perforce.com/perforce/technical.html"></ulink> + <uri xlink:href="http://www.perforce.com/perforce/technical.html">http://www.perforce.com/perforce/technical.html</uri> encontrará documentación <quote>online</quote> detallada.</para> @@ -66,26 +61,24 @@ <para>El servidor &os; <application>Perforce</application> se encuentra en - <hostid role="fqdn">perforce.freebsd.org</hostid>, + <systemitem class="fqdomainname">perforce.freebsd.org</systemitem>, puerto <literal>1666</literal>. Puede navegar por el repositorio desde - <ulink url="http://perforce.freebsd.org"></ulink>. + <uri xlink:href="http://perforce.freebsd.org">http://perforce.freebsd.org</uri>. Ciertas partes del repositorio se exportan automáticamente hacia diversos servidores <application>CVSup</application>.</para> </sect2> </sect1> -<sect1 id="start"> +<sect1 xml:id="start"> <title>Los comienzos</title> <para>El primer paso para utilizar <application>Perforce</application> consiste en obtener una cuenta en el servidor. Si ya dispone de una cuenta en - <hostid - role="domainname">FreeBSD.org</hostid> + <systemitem class="fqdomainname">FreeBSD.org</systemitem> entre en - <hostid - role="hostname">freefall</hostid> + <systemitem class="fqdomainname">freefall</systemitem> y ejecute el siguiente comando utilizando una contraseña distinta del acceso de su &os; o de cualquier otro mecanismo de autenticación SSH:</para> @@ -93,8 +86,7 @@ <screen>&prompt.user; <userinput>/usr/local/bin/p4newuser</userinput></screen> <para>Por supuesto si no tiene una cuenta en - <hostid - role="domainname">FreeBSD.org</hostid> + <systemitem class="fqdomainname">FreeBSD.org</systemitem> necesitará coordinarse con su mentor.</para> @@ -111,8 +103,7 @@ <note> <para>Los usuarios con acceso <quote>shell</quote> al <quote>cluster</quote> - <hostid - role="domainname">FreeBSD.org</hostid> + <systemitem class="fqdomainname">FreeBSD.org</systemitem> pueden querer encapsular el protocolo cliente-servidor de <application>Perforce</application> a través de un túnel SSH, en cuyo caso la variable de arriba @@ -125,8 +116,8 @@ el nombre de usuario y la contraseña anteriores del siguiente modo:</para> - <screen>&prompt.user; <userinput>export P4USER=<replaceable>nombre_de_usuario</replaceable></userinput> -&prompt.user; <userinput>export P4PASSWD=<replaceable>contraseña</replaceable></userinput></screen> + <screen>&prompt.user; <userinput>export P4USER=nombre_de_usuario</userinput> +&prompt.user; <userinput>export P4PASSWD=contraseña</userinput></screen> <para>Compruebe que todo funciona mediante la siguiente orden:</para> @@ -139,7 +130,7 @@ </para> </sect1> -<sect1 id="clients"> +<sect1 xml:id="clients"> <title>Clientes</title> <para>El sistema <application>Perforce</application> proporciona @@ -182,7 +173,7 @@ Puede ser cualquier cosa, pero debe ser una cadena única dentro del servidor <application>Perforce</application>. Suelen usarse nombres como - <literal><replaceable>nombre_de_usuario</replaceable>_<replaceable>nombre_de_máquina</replaceable></literal>, + <literal>nombre_de_usuario_nombre_de_máquina</literal>, que permite identificar fácilmente a los clientes cuando se navega por ellos. Por defecto hay ya un nombre, que se @@ -250,15 +241,14 @@ <para>Esto asociará por completo el repositorio <application>Perforce</application> al directorio - <filename class="directory">Root</filename> + <filename>Root</filename> del cliente. <emphasis>NO USE ESTE VALOR POR DEFECTO</emphasis>. El repositorio de &os; es enorme e intentar asociarlo y sincronizarse con dicho repositorio tardará muchísimo y consumirá enormes recursos. Asocie sólamente la sección del repositorio en la que va a trabajar. Por ejemplo, hay un árbol para el proyecto - smpng en <filename - class="directory">//depot/projects/smpng</filename>. Una + smpng en <filename>//depot/projects/smpng</filename>. Una asociación en ese caso sería algo así:</para> <programlisting>//depot/projects/smpng/... //<replaceable>cliente</replaceable>/...</programlisting> @@ -305,14 +295,14 @@ <para>Puede listar los clientes existentes mediante <command>p4 clients</command>. Puede listarlos sin que sufran modificaciones mediante <command>p4 client -o - <replaceable>nombre_cliente</replaceable></command>.</para> + nombre_cliente</command>.</para> <para>Siempre que se interactue con ficheros en <application>Perforce</application> la variable de entorno <envar>P4CLIENT</envar> debe contener al nombre del cliente que se está utilizando, es decir:</para> - <screen>&prompt.user; <userinput>export P4CLIENT=<replaceable>nombredemicliente</replaceable></userinput></screen> + <screen>&prompt.user; <userinput>export P4CLIENT=nombredemicliente</userinput></screen> <para>Fíjese en que las asociaciones del cliente en el repositorio no son exclusivos; varios clientes pueden estar asociados en la @@ -323,7 +313,7 @@ </para> </sect1> -<sect1 id="syncing"> +<sect1 xml:id="syncing"> <title>Sincronizaciones</title> <para>Una vez definida la especificación del cliente y una vez @@ -355,18 +345,18 @@ <para>Puede sincronizarse parte del árbol o del cliente especificando una ruta relativa a la orden <quote>sync</quote>. Por ejemplo, para sincronizar sólo el directorio - <filename class="directory">ufs</filename> + <filename>ufs</filename> del proyecto <literal>smpng</literal> ejecute lo siguiente:</para> - <screen>&prompt.user; <userinput>cd <replaceable>raizdelproyecto</replaceable>/smpng</userinput> + <screen>&prompt.user; <userinput>cd raizdelproyecto/smpng</userinput> &prompt.user; <userinput>p4 sync src/sys/ufs/...</userinput></screen> <para>El uso de rutas locales relativas funciona en muchas otras órdenes <command>p4</command>.</para> </sect1> -<sect1 id="branches"> +<sect1 xml:id="branches"> <title>Ramas</title> <para>Una de las características más interesantes de @@ -392,8 +382,7 @@ la jerga de <application>Perforce</application>) es un único árbol plano. Se accede a cada fichero a través de una - sencilla ruta bajo el directorio <filename - class="directory">//depot</filename>, tanto si se trata de un + sencilla ruta bajo el directorio <filename>//depot</filename>, tanto si se trata de un fichero de nueva creación como si proviene de una ramificación. Esto supone una gran diferencia con respecto a sistemas como CVS, @@ -407,7 +396,7 @@ especificación de rama. Es similar a la especificación de un cliente, pero se crea mediante la orden <command>p4 branch - <replaceable>nombre_de_rama</replaceable></command>.</para> + nombre_de_rama</command>.</para> <para>Veamos los campos más importantes:</para> @@ -479,7 +468,7 @@ sección.</para> </sect1> -<sect1 id="Integrations"> +<sect1 xml:id="Integrations"> <title>Integraciones</title> <para><quote>Integración</quote> es el término que se utiliza @@ -500,7 +489,7 @@ se muestra en la siguiente orden: </para> - <screen>&prompt.user; <userinput>p4 integrate -b <replaceable>nombrederama</replaceable></userinput></screen> + <screen>&prompt.user; <userinput>p4 integrate -b nombrederama</userinput></screen> <para><replaceable>nombrederama</replaceable> es el nombre que se ha dado a la @@ -542,7 +531,7 @@ siguiente sección.</para> </sect1> -<sect1 id="submit"> +<sect1 xml:id="submit"> <title>Aplicación de cambios en el repositorio</title> <para>Los cambios que se han realizado en local se deben @@ -620,7 +609,7 @@ que depende del caso concreto.</para> </sect1> -<sect1 id="editing"> +<sect1 xml:id="editing"> <title>Edición</title> <para>En el servidor se almacena y mantiene el estado de cada @@ -635,7 +624,7 @@ <para>Para abrir un fichero para editarlo utilice <command>p4 edit</command> de la siguiente forma:</para> - <screen>&prompt.user; <userinput>p4 edit <replaceable>nombredefichero</replaceable></userinput></screen> + <screen>&prompt.user; <userinput>p4 edit nombredefichero</userinput></screen> <para>Esto marca el fichero en el servidor con el estado de edición, lo que permite entregar el fichero posteriormente @@ -669,7 +658,7 @@ original ejecute <command>p4 revert</command> de la siguiente forma:</para> - <screen>&prompt.user; <userinput>p4 revert <replaceable>nombredefichero</replaceable></userinput></screen> + <screen>&prompt.user; <userinput>p4 revert nombredefichero</userinput></screen> <para>Esto resincroniza el fichero con el contenido del servidor y elimina en el servidor el atributo de edición para ese fichero. @@ -687,7 +676,7 @@ <command>p4 sync</command>.</para> </sect1> -<sect1 id="changes"> +<sect1 xml:id="changes"> <title>Cambios, descripciones e historial</title> <para>Puede ver el historial de cambios realizados al @@ -699,7 +688,7 @@ modificación. Si lo que se quiere son los detalles de un cambio en concreto utilice <command>p4 describe - <replaceable>numero_de_cambio</replaceable></command>. Esta orden + numero_de_cambio</command>. Esta orden proporciona el <quote>log</quote> y los <quote>diffs</quote> de dicho cambio. Normalmente se utilizan las opciones <option>-du</option> o @@ -707,12 +696,12 @@ contextuales, respectivamente, en lugar del formato del <quote>diff</quote> nativo.</para> - <para><command>p4 filelog <replaceable>nombre_de_fichero</replaceable></command> + <para><command>p4 filelog nombre_de_fichero</command> muestra el historial de un fichero, incluyendo todas sus modificaciones, integraciones y ramas que contenga.</para> </sect1> -<sect1 id="diffs"> +<sect1 xml:id="diffs"> <title><quote>diffs</quote></title> <para>Existen dos formas de generar <quote>diffs</quote> de ficheros en @@ -753,11 +742,11 @@ <option>-dc</option> sí pueden usarse. Las dos formas de esta orden son:</para> - <screen>&prompt.user; <userinput>p4 diff2 -b <replaceable>nombrederama</replaceable></userinput></screen> + <screen>&prompt.user; <userinput>p4 diff2 -b nombrederama</userinput></screen> <para>y</para> - <screen>&prompt.user; <userinput>p4 diff2 //depot/<replaceable>ruta1</replaceable> //depot/<replaceable>ruta2</replaceable></userinput></screen> + <screen>&prompt.user; <userinput>p4 diff2 //depot/ruta1 //depot/ruta2</userinput></screen> </listitem> </varlistentry> </variablelist> @@ -778,11 +767,10 @@ compatibles</emphasis>, pero no esto no incluye ficheros nuevos o borrados. Este <quote>script</quote> puede serle de utilidad para este <quote>proceso necesario</quote>: - <ulink - url="http://people.freebsd.org/~scottl/awkdiff"></ulink>.</para> + <uri xlink:href="http://people.freebsd.org/~scottl/awkdiff">http://people.freebsd.org/~scottl/awkdiff</uri>.</para> </sect1> -<sect1 id="add-rm-files"> +<sect1 xml:id="add-rm-files"> <title>Añadir o eliminar ficheros</title> <para>La integración de una rama hará que @@ -793,7 +781,7 @@ crear el fichero y ejecutar <command>p4 add</command> de la siguiente forma:</para> - <screen>&prompt.user; <userinput>p4 add <replaceable>nombredefichero</replaceable></userinput></screen> + <screen>&prompt.user; <userinput>p4 add nombredefichero</userinput></screen> <para>Si quiere añadir un árbol completo de ficheros ejecute:</para> @@ -812,7 +800,7 @@ <para>Borrar un fichero es igualmente sencillo mediante <command>p4 delete</command>:</para> - <screen>&prompt.user; <userinput>p4 delete <replaceable>nombredefichero</replaceable></userinput></screen> + <screen>&prompt.user; <userinput>p4 delete nombredefichero</userinput></screen> <para>Esta orden marcará el fichero para que sea borrado del <quote>depósito</quote> la siguiente vez que se ejecute una @@ -832,7 +820,7 @@ el repositorio.</para> </sect1> -<sect1 id="working-with-diffs"> +<sect1 xml:id="working-with-diffs"> <title>El trabajo con <quote>diffs</quote></title> <para>Algunas veces puede ser necesario aplicar un <quote>diff</quote> @@ -869,7 +857,7 @@ <command>p4 submit</command> para entregar los cambios.</para> </sect1> -<sect1 id="renaming-files"> +<sect1 xml:id="renaming-files"> <title>Cambiar nombres de ficheros</title> <para><application>Perforce</application> no dispone de una forma @@ -885,9 +873,9 @@ que consiste en efectuar una integración dentro del mismo árbol y de una sola vez. Veamos un ejemplo:</para> - <screen>&prompt.user; <userinput>p4 integrate -i <replaceable>ficheroprevio</replaceable> <replaceable>ficheronuevo</replaceable></userinput> + <screen>&prompt.user; <userinput>p4 integrate -i ficheroprevio ficheronuevo</userinput> &prompt.user; <userinput>p4 resolve</userinput> -&prompt.user; <userinput>p4 delete <replaceable>ficheroprevio</replaceable></userinput> +&prompt.user; <userinput>p4 delete ficheroprevio</userinput> &prompt.user; <userinput>p4 submit</userinput></screen> <para>La integración fuerza a <application>Perforce</application> a @@ -901,7 +889,7 @@ no debería utilizarse en integraciones basadas en ramas.</para> </sect1> -<sect1 id="freebsd-cvs-and-p4"> +<sect1 xml:id="freebsd-cvs-and-p4"> <title>Interacciones entre el CVS de &os; y Perforce</title> <para>Los repositorios de @@ -911,8 +899,7 @@ <application>Perforce</application>. Cada 2 minutos se pregunta al servidor de CVS sobre cambios realizados en la rama HEAD, y dichos cambios se entregan a <application>Perforce</application> dentro del - árbol <filename - class="directory">//depot/vendor/freebsd/...</filename>. + árbol <filename>//depot/vendor/freebsd/...</filename>. De este modo este árbol permite la ramificación y la integración de proyectos derivados. Cualquier proyecto que implique la modificación del código fuente de @@ -935,7 +922,7 @@ ese es su caso.</para> </sect1> -<sect1 id="offline-ops"> +<sect1 xml:id="offline-ops"> <title>Funcionamiento sin conexión de red</title> <para>Uno de los inconvenientes de <application>Perforce</application> es @@ -963,13 +950,12 @@ así que tenga especial cuidado con esto.</para> </sect1> -<sect1 id="soc"> +<sect1 xml:id="soc"> <title>Consideraciones finales para el <quote>Google Summer of Code</quote></title> <para>La mayoría de los proyectos de &os; dentro del programa <quote>Google Summer of Code</quote> están en - <filename - class="directory">//depot/projects/soc2005/<replaceable>nombre_del_proyecto</replaceable>/...</filename> + <filename>//depot/projects/soc2005/nombre_del_proyecto/...</filename> en el servidor &os; de <application>Perforce</application>.</para> <para>Entre las responsabilidades del mentor del proyecto |