<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="es">
<head>
<meta http-equiv="X-UA-Compatible" content="IE=Edge" />
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Bazaar en cinco minutos — documentación de Bazaar - 2.7.0</title>
<link rel="stylesheet" href="../_static/classic.css" type="text/css" />
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script type="text/javascript" src="../_static/language_data.js"></script>
<script type="text/javascript" src="../_static/translations.js"></script>
<link rel="shortcut icon" href="../_static/bzr.ico"/>
<link rel="search" title="Búsqueda" href="../search.html" />
<link rel="next" title="Referencia Rapida" href="../quick-reference/index.html" />
<link rel="prev" title="Indice de Documentacion de Bazaar" href="../index.html" />
</head><body>
<div class="related" role="navigation" aria-label="related navigation">
<h3>Navegación</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="../quick-reference/index.html" title="Referencia Rapida"
accesskey="N">siguiente</a></li>
<li class="right" >
<a href="../index.html" title="Indice de Documentacion de Bazaar"
accesskey="P">anterior</a> |</li>
<li><a href="http://bazaar.canonical.com/">
<img src="../_static/bzr icon 16.png" /> Inicio</a> | </li>
<a href="http://doc.bazaar.canonical.com/">Documentación</a> | </li>
<li class="nav-item nav-item-0"><a href="../index.html">Contenidos (2.7.0)</a> »</li>
</ul>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body" role="main">
<div class="section" id="bazaar-en-cinco-minutos">
<h1>Bazaar en cinco minutos<a class="headerlink" href="#bazaar-en-cinco-minutos" title="Enlazar permanentemente con este título">¶</a></h1>
<div class="section" id="introduccion">
<h2>Introducción<a class="headerlink" href="#introduccion" title="Enlazar permanentemente con este título">¶</a></h2>
<p>Bazaar es un sistema de control de versiones distribuido que facilita que
varias personas puedan trabajar de forma conjunta en proyectos de software.</p>
<p>A lo largo de los próximos cinco minutos, aprenderá cómo poner sus archivos
bajo control de versiones, como registrar cambios en ellos, examinar su
trabajo, publicarlo y enviar su trabajo para que sea integrado en el trunk de
un proyecto.</p>
<p>Si prefiere una introducción más detallada, eche un vistazo a
<a class="reference internal" href="#aprendiendo-mas">Aprendiendo Más</a>.</p>
</div>
<div class="section" id="instalacion">
<h2>Instalación<a class="headerlink" href="#instalacion" title="Enlazar permanentemente con este título">¶</a></h2>
<p>Esta guía no describe cómo instalar Bazaar pero normalmente es muy
sencillo. Puede encontrar intrucciones de instalación en:</p>
<ul class="simple">
<li><strong>GNU/Linux:</strong> Bazaar, probablemente, ya esté en su distribución GNU/Linux.</li>
<li><strong>Windows:</strong> <a class="reference external" href="http://wiki.bazaar.canonical.com/WindowsDownloads">instrucciones de instalación para Windows</a>.</li>
<li><strong>Mac OS X:</strong> <a class="reference external" href="http://wiki.bazaar.canonical.com/MacOSXBundle">instrucciones de instalación para Mac OS X</a>.</li>
</ul>
<p>Para otras plataformas y para instalar desde el código fuente, vea las
páginas de <a class="reference external" href="http://wiki.bazaar.canonical.com/Download">Descarga</a> e <a class="reference external" href="http://wiki.bazaar.canonical.com/InstallationFaq">Instalación</a>.</p>
</div>
<div class="section" id="presentese">
<h2>Preséntese<a class="headerlink" href="#presentese" title="Enlazar permanentemente con este título">¶</a></h2>
<p>Antes de empezar a trabajar, es conveniente que le diga a Bazaar quién es
usted. De ese modo su trabajo será identificando correctamente en los logs
de revisión.</p>
<p>Utilice su nombre y dirección de email en lugar de John Doe, teclee:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ bzr whoami "John Doe <john.doe@gmail.com>"
</pre></div>
</div>
<p>Bazaar creará o modificará ahora un archivo de configuración, incluyendo su
nombre y dirección de email.</p>
<p>Ahora compruebe que su nombre y dirección de email se han registrado correctamente:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ bzr whoami
John Doe <john.doe@gmail.com>
</pre></div>
</div>
</div>
<div class="section" id="ponga-archivos-bajo-control-de-versiones">
<h2>Ponga archivos bajo control de versiones<a class="headerlink" href="#ponga-archivos-bajo-control-de-versiones" title="Enlazar permanentemente con este título">¶</a></h2>
<p>Vamos a crear un directorio y algunos archivos para utilizar con Bazaar:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ mkdir miproyecto
$ cd miproyecto
$ mkdir subdirectorio
$ touch test1.txt test2.txt test3.txt subdirectorio/test4.txt
</pre></div>
</div>
<p><strong>Nota para usuarios de Windows:</strong> utilice Windows Explorer para crear sus
directorios, luego haga click derecho en dichos directorios y seleccione
<code class="docutils literal notranslate"><span class="pre">Nuevo</span> <span class="pre">archivo</span></code> para crear sus archivos.</p>
<p>Ahora vamos a hacer que Bazaar se inicialize en el directorio de su proyecto:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ bzr init
</pre></div>
</div>
<p>Si parece que no ha ocurrido nada no se preocupe. Bazaar ha creado un
<a class="reference external" href="http://wiki.bazaar.canonical.com/Branch">branch</a> dónde guardará sus archivos y su histórico de revisiones.</p>
<p>El siguiente paso es decirle a Bazaar a que archivos desea seguirles la pista.
Ejecutando <code class="docutils literal notranslate"><span class="pre">bzr</span> <span class="pre">add</span></code> agregará recursivamente todos los elementos dentro del
proyecto:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ bzr add
added subdirectorio
added test1.txt
added test2.txt
added test3.txt
added subdirectorio/test4.txt
</pre></div>
</div>
<p>A continuación tome una instantánea de sus archivos agregándolos a su branch.
Agregue un mensaje para explicar por qué hace el commit:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ bzr commit -m "Importación inicial"
</pre></div>
</div>
<p>Como Bazaar es un sistema de control de versiones distribuido, no necesita
conectar con un servidor central para hacer el commit. Bazaar guarda su
branch y todos sus commits dentro del directorio con el que está trabajando,
busque el subdirectorio <code class="docutils literal notranslate"><span class="pre">.bzr</span></code>.</p>
</div>
<div class="section" id="haciendo-cambios-en-sus-archivos">
<h2>Haciendo cambios en sus archivos<a class="headerlink" href="#haciendo-cambios-en-sus-archivos" title="Enlazar permanentemente con este título">¶</a></h2>
<p>Vamos a cambiar un archivo e introduzcamos ese cambio en su branch.</p>
<p>Edite <code class="docutils literal notranslate"><span class="pre">test1.txt</span></code> en su editor favorito y luego compruebe qué ha hecho:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ bzr diff
=== modified file 'test1.txt'
--- test1.txt 2007-10-08 17:56:14 +0000
+++ test1.txt 2007-10-08 17:46:22 +0000
@@ -0,0 +1,1 @@
+test test test
</pre></div>
</div>
<p>Añada su trabajo al branch de Bazaar:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ bzr commit -m "Añadida la primera línea de texto"
Committed revision 2.
</pre></div>
</div>
</div>
<div class="section" id="viendo-el-log-de-revisiones">
<h2>Viendo el log de revisiones<a class="headerlink" href="#viendo-el-log-de-revisiones" title="Enlazar permanentemente con este título">¶</a></h2>
<p>Puede ver el histórico de su branch navegando su log:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ bzr log
------------------------------------------------------------
revno: 2
committer: John Doe <john.doe@gmail.com>
branch nick: miproyecto
timestamp: Mon 2007-10-08 17:56:14 +0000
message:
Añadida la primera línea de texto
------------------------------------------------------------
revno: 1
committer: John Doe <john.doe@gmail.com>
branch nick: miproyecto
timestamp: Mon 2006-10-08 17:46:22 +0000
message:
Importación inicial
</pre></div>
</div>
</div>
<div class="section" id="publicando-su-branch-con-sftp">
<h2>Publicando su branch con SFTP<a class="headerlink" href="#publicando-su-branch-con-sftp" title="Enlazar permanentemente con este título">¶</a></h2>
<p>Hay un par de maneras para publicar su branch. Si ya tiene un servidor
SFTP o se siente cómodo configurando uno, puede publicar su branch con el.</p>
<p>Sino salte a la siguiente sección para publicar con <a class="reference external" href="https://launchpad.net/">Launchpad</a>, un
servicio de hosting gratuito para Bazaar.</p>
<p>Vamos a suponer que desea publicar su branch en <code class="docutils literal notranslate"><span class="pre">www.example.com/miproyecto</span></code>:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ bzr push --create-prefix sftp://su.nombre@example.com/~/public_html/miproyecto
2 revision(s) pushed.
</pre></div>
</div>
<p>Bazaar creará un directorio <code class="docutils literal notranslate"><span class="pre">miproyecto</span></code> en el servidor remoto e
introducirá su branch en él.</p>
<p>Ahora cualquiera podrá crear su propia copia de su branch tecleando:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ bzr branch http://www.example.com/miproyecto
</pre></div>
</div>
<p><strong>Nota:</strong> para utilizar SFTP deberá instalar <code class="docutils literal notranslate"><span class="pre">paramiko</span></code> y
<code class="docutils literal notranslate"><span class="pre">pyCrypto</span></code>. Vea <a class="reference external" href="http://wiki.bazaar.canonical.com/InstallationFaq">http://wiki.bazaar.canonical.com/InstallationFaq</a> para más información.</p>
</div>
<div class="section" id="publicando-su-branch-con-launchpad">
<h2>Publicando su branch con Launchpad<a class="headerlink" href="#publicando-su-branch-con-launchpad" title="Enlazar permanentemente con este título">¶</a></h2>
<p>Launchpad es una suite de herramientas de desarrollo y hosting
para proyectos de software libre. Puede utilizarlo para publicar su branch.</p>
<p>Si no dispone de una cuenta de Launchpad, siga la <a class="reference external" href="https://help.launchpad.net/CreatingYourLaunchpadAccount">guia de registro de cuentas</a>
y <a class="reference external" href="https://launchpad.net/people/+me/+editsshkeys">registre una clave SSH</a> en su nueva cuenta de Launchpad.</p>
<p>Cambie <code class="docutils literal notranslate"><span class="pre">john.doe</span></code> por su nombre de usuario de Launchpad, teclee:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ bzr push bzr+ssh://john.doe@bazaar.launchpad.net/~john.doe/+junk/miproyecto
</pre></div>
</div>
<p><strong>Nota:</strong> <code class="docutils literal notranslate"><span class="pre">+junk</span></code> significa que este branch no está asociado con ningún proyecto
concreto en Launchpad.</p>
<p>Ahora cualquiera podrá crear su propia copia de su branch tecleando:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ bzr branch http://bazaar.launchpad.net/~john.doe/+junk/miproyecto
</pre></div>
</div>
<p>También puede ver información sobre su branch, histórico de revisiones
incluido, en <a class="reference external" href="https://code.launchpad.net/people/+me/+junk/miproyecto">https://code.launchpad.net/people/+me/+junk/miproyecto</a></p>
</div>
<div class="section" id="creando-su-propia-copia-de-otro-branch">
<h2>Creando su propia copia de otro branch<a class="headerlink" href="#creando-su-propia-copia-de-otro-branch" title="Enlazar permanentemente con este título">¶</a></h2>
<p>Para trabajar con el código de otra persona, tendrá que hacer su propia
copia de su branch. Vamos a coger un ejemplo real, la interfaz GTK de Bazaar:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ bzr branch http://bazaar.launchpad.net/~bzr/bzr-gtk/trunk bzr-gtk.john
Branched 292 revision(s).
</pre></div>
</div>
<p>Bazaar descargará todos los archivos y el histórico de revisiones completo
del trunk branch del proyecto bzr-gtk y creará una copia llamada
bzr-gtk.john.</p>
<p>Ahora dispone de su propia copia del branch y puede enviar cambios con
o sin una conexión de red. Puede compartir su branch en cualquier momento
publicándola y, si el equipo de bzr-gtk desea utilizar su trabajo, Bazaar
les facilita integrar su branch dentro de su trunk branch.</p>
</div>
<div class="section" id="actualizando-su-branch-desde-el-branch-principal">
<h2>Actualizando su branch desde el branch principal<a class="headerlink" href="#actualizando-su-branch-desde-el-branch-principal" title="Enlazar permanentemente con este título">¶</a></h2>
<p>Mientras envía cambios a su branch, es probable que otras personas también
sigan enviando código al branch principal.</p>
<p>Para asegurarse de que su branch está al dia debería integrar los cambios
desde el principal dentro de su branch personal:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ bzr merge
Merging from saved parent location: http://bazaar.launchpad.net/~bzr/bzr-gtk/trunk
All changes applied successfully.
</pre></div>
</div>
<p>Compruebe qué ha cambiado:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ bzr diff
</pre></div>
</div>
<p>Si está contento con los cambios puede añadirlos en su branch personal:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ bzr commit -m "Integración desde el branch principal"
Committed revision 295.
</pre></div>
</div>
</div>
<div class="section" id="integrando-su-trabajo-en-el-branch-principal">
<h2>Integrando su trabajo en el branch principal<a class="headerlink" href="#integrando-su-trabajo-en-el-branch-principal" title="Enlazar permanentemente con este título">¶</a></h2>
<p>Después de haber trabajado en su branch personal de bzr-gtk puede que
quiera enviar sus cambios de vuelta al proyecto. La manera más fácil
es utilizando una instrucción merge.</p>
<p>Una instrucción merge es una petición de lectura mecánica para
llevar a cabo una integración concreta. Por lo general contiene un
parche de vista previa de la integración y, o bien contiene las
revisiones necesarias, o proporciona un branch donde pueden encontrarse.</p>
<p>Sustituyendo <code class="docutils literal notranslate"><span class="pre">mycode.patch</span></code>, cree su instrucción merge:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ bzr send -o mycode.patch
Using saved parent location: http://bazaar.launchpad.net/~bzr/bzr-gtk/trunk
</pre></div>
</div>
<p>Ahora puede enviar por email la instruccion merge al proyecto bzr-gtk
quien, si así lo quieren, pueden utilizarla para integrar su trabajo
dentro del branch principal.</p>
</div>
<div class="section" id="aprendiendo-mas">
<h2>Aprendiendo más<a class="headerlink" href="#aprendiendo-mas" title="Enlazar permanentemente con este título">¶</a></h2>
<p>Puede encontrar más sobre Bazaar en la
<a class="reference external" href="../user-guide/index.html">Guía de Usuario de Bazaar</a>.</p>
<p>Para aprender sobre Bazaar por línea de comandos:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ bzr help
</pre></div>
</div>
<p>Para aprender sobre comandos de Bazaar:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ bzr help commands
</pre></div>
</div>
<p>Para aprender acerca del tema o comando “”foo”“:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ bzr help foo
</pre></div>
</div>
</div>
</div>
</div>
</div>
</div>
<div class="sphinxsidebar" role="navigation" aria-label="main navigation">
<div class="sphinxsidebarwrapper">
<h3><a href="../index.html">Table of Contents</a></h3>
<ul>
<li><a class="reference internal" href="#">Bazaar en cinco minutos</a><ul>
<li><a class="reference internal" href="#introduccion">Introducción</a></li>
<li><a class="reference internal" href="#instalacion">Instalación</a></li>
<li><a class="reference internal" href="#presentese">Preséntese</a></li>
<li><a class="reference internal" href="#ponga-archivos-bajo-control-de-versiones">Ponga archivos bajo control de versiones</a></li>
<li><a class="reference internal" href="#haciendo-cambios-en-sus-archivos">Haciendo cambios en sus archivos</a></li>
<li><a class="reference internal" href="#viendo-el-log-de-revisiones">Viendo el log de revisiones</a></li>
<li><a class="reference internal" href="#publicando-su-branch-con-sftp">Publicando su branch con SFTP</a></li>
<li><a class="reference internal" href="#publicando-su-branch-con-launchpad">Publicando su branch con Launchpad</a></li>
<li><a class="reference internal" href="#creando-su-propia-copia-de-otro-branch">Creando su propia copia de otro branch</a></li>
<li><a class="reference internal" href="#actualizando-su-branch-desde-el-branch-principal">Actualizando su branch desde el branch principal</a></li>
<li><a class="reference internal" href="#integrando-su-trabajo-en-el-branch-principal">Integrando su trabajo en el branch principal</a></li>
<li><a class="reference internal" href="#aprendiendo-mas">Aprendiendo más</a></li>
</ul>
</li>
</ul>
<h4>Tema anterior</h4>
<p class="topless"><a href="../index.html"
title="capítulo anterior">Indice de Documentacion de Bazaar</a></p>
<h4>Próximo tema</h4>
<p class="topless"><a href="../quick-reference/index.html"
title="próximo capítulo">Referencia Rapida</a></p>
<div role="note" aria-label="source link">
<h3>Esta página</h3>
<ul class="this-page-menu">
<li><a href="../_sources/mini-tutorial/index.txt"
rel="nofollow">Mostrar el código</a></li>
</ul>
</div>
<div id="searchbox" style="display: none" role="search">
<h3>Búsqueda rápida</h3>
<div class="searchformwrapper">
<form class="search" action="../search.html" method="get">
<input type="text" name="q" />
<input type="submit" value="Ir a" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
</div>
<script type="text/javascript">$('#searchbox').show(0);</script>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="related" role="navigation" aria-label="related navigation">
<h3>Navegación</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="../quick-reference/index.html" title="Referencia Rapida"
>siguiente</a></li>
<li class="right" >
<a href="../index.html" title="Indice de Documentacion de Bazaar"
>anterior</a> |</li>
<li><a href="http://bazaar.canonical.com/">
<img src="../_static/bzr icon 16.png" /> Inicio</a> | </li>
<a href="http://doc.bazaar.canonical.com/">Documentación</a> | </li>
<li class="nav-item nav-item-0"><a href="../index.html">Contenidos (2.7.0)</a> »</li>
</ul>
</div>
<div class="footer" role="contentinfo">
© Derechos de autor 2009-2011 Canonical Ltd.
Creado con <a href="http://sphinx-doc.org/">Sphinx</a> 1.8.4.
</div>
</body>
</html>
