~bzr-pqm/bzr/bzr.dev

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
=======================
Bazaar en cinco minutos
=======================

.. contents:: Contenidos

Introducción
============

Bazaar es un sistema de control de versiones distribuido que facilita que
varias personas puedan trabajar de forma conjunta en proyectos de software.

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.

Si prefiere una introducción más detallada, eche un vistazo a
`Aprendiendo Más`_.


Instalación
===========

Esta guía no describe cómo instalar Bazaar pero normalmente es muy
sencillo. Puede encontrar intrucciones de instalación en:

- **GNU/Linux:** Bazaar, probablemente, ya esté en su distribución GNU/Linux.
- **Windows:** `instrucciones de instalación para Windows`_.
- **Mac OS X:** `instrucciones de instalación para Mac OS X`_.

Para otras plataformas y para instalar desde el código fuente, vea las
páginas de Descarga_ e Instalación_.

.. _instrucciones de instalación para Windows: http://bazaar-vcs.org/WindowsDownloads
.. _instrucciones de instalación para Mac OS X: http://bazaar-vcs.org/MacOSXBundle
.. _Descarga: http://bazaar-vcs.org/Download
.. _Instalación: http://bazaar-vcs.org/InstallationFaq


Preséntese
==========

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.

Utilice su nombre y dirección de email en lugar de John Doe, teclee::

  $ bzr whoami "John Doe <john.doe@gmail.com>"
  
Bazaar creará o modificará ahora un archivo de configuración, incluyendo su
nombre y dirección de email.

Ahora compruebe que su nombre y dirección de email se han registrado correctamente::

  $ bzr whoami
  John Doe <john.doe@gmail.com>


Ponga archivos bajo control de versiones
========================================

Vamos a crear un directorio y algunos archivos para utilizar con Bazaar::

 $ mkdir miproyecto
 $ cd miproyecto
 $ mkdir subdirectorio
 $ touch test1.txt test2.txt test3.txt subdirectorio/test4.txt
 
**Nota para usuarios de Windows:** utilice Windows Explorer para crear sus
directorios, luego haga click derecho en dichos directorios y seleccione
``Nuevo archivo`` para crear sus archivos.

Ahora vamos a hacer que Bazaar se inicialize en el directorio de su proyecto::

  $ bzr init
  
Si parece que no ha ocurrido nada no se preocupe. Bazaar ha creado un
branch_ dónde guardará sus archivos y su histórico de revisiones.

.. _branch: http://bazaar-vcs.org/Branch

El siguiente paso es decirle a Bazaar a que archivos desea seguirles la pista.
Ejecutando ``bzr add`` agregará recursivamente todos los elementos dentro del 
proyecto::

 $ bzr add
 added subdirectorio
 added test1.txt
 added test2.txt
 added test3.txt
 added subdirectorio/test4.txt

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::

  $ bzr commit -m "Importación inicial"
  
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 ``.bzr``.


Haciendo cambios en sus archivos
================================

Vamos a cambiar un archivo e introduzcamos ese cambio  en su branch.

Edite ``test1.txt`` en su editor favorito y luego compruebe qué ha hecho::

 $ 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

Añada su trabajo al branch de Bazaar::

  $ bzr commit -m "Añadida la primera línea de texto"
  Committed revision 2.


Viendo el log de revisiones
===========================

Puede ver el histórico de su branch navegando su log::

  $ 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


Publicando su branch con sftp
=============================

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.

Sino salte a la siguiente sección para publicar con Launchpad_, un
servicio de hosting gratuito para Bazaar.

.. _Launchpad: https://launchpad.net/

Vamos a suponer que desea publicar su branch en ``www.example.com/miproyecto``::

 $ bzr push --create-prefix sftp://su.nombre@example.com/~/public_html/miproyecto
 2 revision(s) pushed.
 
Bazaar creará un directorio ``miproyecto`` en el servidor remoto e
introducirá su branch en él.
 
Ahora cualquiera podrá crear su propia copia de su branch tecleando::

 $ bzr branch http://www.example.com/miproyecto
 
**Nota:** para utilizar sftp deberá instalar ``paramiko`` y
``pyCrypto``. Vea http://bazaar-vcs.org/InstallationFaq para más información.


Publicando su branch con Launchpad
==================================

Launchpad es una suite de herramientas de desarrollo y hosting
para proyectos de software libre. Puede utilizarlo para publicar su branch.

Si no dispone de una cuenta de Launchpad, siga la `guia de registro de cuentas`_
y `registre una clave SSH`_ en su nueva cuenta de Launchpad.

.. _guia de registro de cuentas: https://help.launchpad.net/CreatingYourLaunchpadAccount
.. _registre una clave SSH: https://launchpad.net/people/+me/+editsshkeys

Cambie ``john.doe`` por su nombre de usuario de Launchpad, teclee::

 $ bzr push bzr+ssh://john.doe@bazaar.launchpad.net/~john.doe/+junk/miproyecto

**Nota:** ``+junk`` significa que este branch no está asociado con ningún proyecto 
concreto en Launchpad.

Ahora cualquiera podrá crear su propia copia de su branch tecleando::

 $ bzr branch http://bazaar.launchpad.net/~john.doe/+junk/miproyecto
 
También puede ver información sobre su branch, histórico de revisiones
incluido, en https://code.launchpad.net/people/+me/+junk/miproyecto


Creando su propia copia de otro branch
======================================

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::

  $ bzr branch http://bazaar.launchpad.net/~bzr/bzr-gtk/trunk bzr-gtk.john
  Branched 292 revision(s).                                                        

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.

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.


Actualizando su branch desde el branch principal
================================================

Mientras envía cambios a su branch, es probable que otras personas también
sigan enviando código al branch principal.

Para asegurarse de que su branch está al dia debería integrar los cambios
desde el principal dentro de su branch personal::

  $ bzr merge
  Using saved location: http://bazaar.launchpad.net/~bzr/bzr-gtk/trunk
  All changes applied successfully.
            
Compruebe qué ha cambiado::

  $ bzr diff
 
Si está contento con los cambios puede añadirlos en su branch personal::

  $ bzr commit -m "Integración desde el branch principal"
  Committed revision 295.


Integrando su trabajo en el branch principal
============================================

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.

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.

Sustituyendo ``mycode.patch``, cree su instrucción merge::

 $ bzr send -o mycode.patch
 Using saved location: http://bazaar.launchpad.net/~bzr/bzr-gtk/trunk
 
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.
 
 
Aprendiendo más
===============

Puede encontrar más sobre Bazaar en la
`Guía de Usuario de Bazaar <../guia-usuario/index.html>`_.

Para aprender sobre Bazaar por línea de comandos::

  $ bzr help

Para aprender sobre comandos de Bazaar::

  $ bzr help commands

Para aprender acerca del tema o comando ''foo''::

  $ bzr help foo