rev |
line source |
jerojasro@343
|
1 \chapter{Una gira de Mercurial: lo básico}
|
jerojasro@343
|
2 \label{chap:tour-basic}
|
jerojasro@343
|
3
|
jerojasro@343
|
4 \section{Instalar Mercurial en su sistema}
|
jerojasro@343
|
5 \label{sec:tour:install}
|
jerojasro@343
|
6 Hay paquetes binarios precompilados de Mercurial disponibles para cada
|
jerojasro@343
|
7 sistema operativo popular. Esto hace fácil empezar a usar Mercurial
|
jerojasro@343
|
8 en su computador inmediatamente.
|
jerojasro@343
|
9
|
jerojasro@343
|
10 \subsection{Linux}
|
jerojasro@343
|
11
|
jerojasro@343
|
12 Dado que cada distribución de Linux tiene sus propias herramientas de
|
jerojasro@343
|
13 manejo de paquetes, políticas, y ritmos de desarrollo, es difícil dar
|
jerojasro@343
|
14 un conjunto exhaustivo de instrucciones sobre cómo instalar el paquete
|
jerojasro@343
|
15 de Mercurial. La versión de Mercurial que usted tenga a disposición
|
jerojasro@343
|
16 puede variar dependiendo de qué tan activa sea la persona que mantiene
|
jerojasro@343
|
17 el paquete para su distribución.
|
jerojasro@343
|
18
|
jerojasro@343
|
19 Para mantener las cosas simples, me enfocaré en instalar Mercurial
|
jerojasro@343
|
20 desde la línea de comandos en las distribuciones de Linux más
|
jerojasro@343
|
21 populares. La mayoría de estas distribuciones proveen administradores
|
jerojasro@343
|
22 de paquetes gráficos que le permitirán instalar Mercurial con un solo
|
jerojasro@343
|
23 clic; el nombre de paquete a buscar es \texttt{mercurial}.
|
jerojasro@343
|
24
|
jerojasro@343
|
25 \begin{itemize}
|
jerojasro@343
|
26 \item[Debian]
|
jerojasro@343
|
27 \begin{codesample4}
|
jerojasro@343
|
28 apt-get install mercurial
|
jerojasro@343
|
29 \end{codesample4}
|
jerojasro@343
|
30
|
jerojasro@343
|
31 \item[Fedora Core]
|
jerojasro@343
|
32 \begin{codesample4}
|
jerojasro@343
|
33 yum install mercurial
|
jerojasro@343
|
34 \end{codesample4}
|
jerojasro@343
|
35
|
jerojasro@343
|
36 \item[Gentoo]
|
jerojasro@343
|
37 \begin{codesample4}
|
jerojasro@343
|
38 emerge mercurial
|
jerojasro@343
|
39 \end{codesample4}
|
jerojasro@343
|
40
|
jerojasro@343
|
41 \item[OpenSUSE]
|
jerojasro@343
|
42 \begin{codesample4}
|
jerojasro@343
|
43 yum install mercurial
|
jerojasro@343
|
44 \end{codesample4}
|
jerojasro@343
|
45
|
jerojasro@343
|
46 \item[Ubuntu] El paquete de Mercurial de Ubuntu está basado en el de
|
jerojasro@343
|
47 Debian. Para instalarlo, ejecute el siguiente comando.
|
jerojasro@343
|
48 \begin{codesample4}
|
jerojasro@343
|
49 apt-get install mercurial
|
jerojasro@343
|
50 \end{codesample4}
|
jerojasro@343
|
51 El paquete de Mercurial para Ubuntu tiende a atrasarse con respecto
|
jerojasro@343
|
52 a la versión de Debian por un margen de tiempo considerable
|
jerojasro@343
|
53 (al momento de escribir esto, 7 meses), lo que en algunos casos
|
jerojasro@343
|
54 significará que usted puede encontrarse con problemas que ya habrán
|
jerojasro@343
|
55 sido resueltos en el paquete de Debian.
|
jerojasro@343
|
56 \end{itemize}
|
jerojasro@343
|
57
|
jerojasro@343
|
58 \subsection{Solaris}
|
jerojasro@343
|
59
|
jerojasro@343
|
60 SunFreeWare, en \url{http://www.sunfreeware.com}, es una buena fuente
|
jerojasro@343
|
61 para un gran número de paquetes compilados para Solaris para las
|
jerojasro@343
|
62 arquitecturas Intel y Sparc de 32 y 64 bits, incluyendo versiones
|
jerojasro@343
|
63 actuales de Mercurial.
|
jerojasro@343
|
64
|
jerojasro@343
|
65 \subsection{Mac OS X}
|
jerojasro@343
|
66
|
jerojasro@343
|
67 Lee Cantey publica un instalador de Mercurial para Mac OS~X en
|
jerojasro@343
|
68 \url{http://mercurial.berkwood.com}. Este paquete funciona en tanto
|
jerojasro@343
|
69 en Macs basados en Intel como basados en PowerPC. Antes de que pueda
|
jerojasro@343
|
70 usarlo, usted debe instalar una versión compatible de Universal
|
jerojasro@343
|
71 MacPython~\cite{web:macpython}. Esto es fácil de hacer; simplemente
|
jerojasro@501
|
72 siga las instrucciones del sitio de Lee.
|
jerojasro@343
|
73
|
jerojasro@343
|
74 También es posible instalar Mercurial usando Fink o MacPorts, dos
|
jerojasro@343
|
75 administradores de paquetes gratuitos y populares para Mac OS X. Si
|
jerojasro@343
|
76 usted tiene Fink, use \command{sudo apt-get install mercurial-py25}.
|
jerojasro@343
|
77 Si usa MacPorts, \command{sudo port install mercurial}.
|
jerojasro@343
|
78
|
jerojasro@343
|
79 \subsection{Windows}
|
jerojasro@343
|
80
|
jerojasro@343
|
81 Lee Cantey publica un instalador de Mercurial para Windows en
|
jerojasro@343
|
82 \url{http://mercurial.berkwood.com}. Este paquete no tiene
|
jerojasro@343
|
83 % TODO traducción de it just works. Agreed?
|
jerojasro@343
|
84 dependencias externas; ``simplemente funciona''.
|
jerojasro@343
|
85
|
jerojasro@343
|
86 \begin{note}
|
jerojasro@343
|
87 La versión de Windows de Mercurial no convierte automáticamente
|
jerojasro@343
|
88 los fines de línea entre estilos Windows y Unix. Si usted desea
|
jerojasro@343
|
89 compartir trabajo con usuarios de Unix, deberá hacer un trabajo
|
jerojasro@343
|
90 adicional de configuración. XXX Terminar esto.
|
jerojasro@343
|
91 \end{note}
|
jerojasro@343
|
92
|
jerojasro@343
|
93 \section{Arrancando}
|
jerojasro@343
|
94
|
jerojasro@343
|
95 Para empezar, usaremos el comando \hgcmd{version} para revisar si
|
jerojasro@343
|
96 Mercurial está instalado adecuadamente. La información de la versión
|
jerojasro@343
|
97 que es impresa no es tan importante; lo que nos importa es si imprime
|
jerojasro@343
|
98 algo en absoluto.
|
jerojasro@343
|
99
|
jerojasro@343
|
100 \interaction{tour.version}
|
jerojasro@343
|
101
|
jerojasro@343
|
102 % TODO builtin-> integrado?
|
jerojasro@343
|
103 \subsection{Ayuda integrada}
|
jerojasro@343
|
104
|
jerojasro@343
|
105 Mercurial provee un sistema de ayuda integrada. Esto es invaluable
|
jerojasro@343
|
106 para ésas ocasiones en la que usted está atorado tratando de recordar
|
jerojasro@343
|
107 cómo ejecutar un comando. Si está completamente atorado, simplemente
|
jerojasro@343
|
108 ejecute \hgcmd{help}; esto imprimirá una breve lista de comandos,
|
jerojasro@343
|
109 junto con una descripción de qué hace cada uno. Si usted solicita
|
jerojasro@343
|
110 ayuda sobre un comando específico (como abajo), se imprime información
|
jerojasro@343
|
111 más detallada.
|
jerojasro@343
|
112 \interaction{tour.help}
|
jerojasro@343
|
113 Para un nivel más impresionante de detalle (que usted no va a
|
jerojasro@343
|
114 necesitar usualmente) ejecute \hgcmdargs{help}{\hggopt{-v}}. La opción
|
jerojasro@343
|
115 \hggopt{-v} es la abreviación para \hggopt{--verbose}, y le indica a
|
jerojasro@343
|
116 Mercurial que imprima más información de lo que haría usualmente.
|
jerojasro@343
|
117
|
jerojasro@352
|
118 \section{Trabajar con un repositorio}
|
jerojasro@352
|
119
|
jerojasro@352
|
120 En Mercurial, todo sucede dentro de un \emph{repositorio}. El
|
jerojasro@362
|
121 repositorio para un proyecto contiene todos los ficheros que
|
jerojasro@352
|
122 ``pertenecen a'' ése proyecto, junto con un registro histórico de los
|
jerojasro@362
|
123 ficheros de ese proyecto.
|
jerojasro@352
|
124
|
jerojasro@352
|
125 No hay nada particularmente mágico acerca de un repositorio; es
|
jerojasro@362
|
126 simplemente un árbol de directorios en su sistema de ficheros que
|
jerojasro@352
|
127 Mercurial trata como especial. Usted puede renombrar o borrar un
|
jerojasro@352
|
128 repositorio en el momento que lo desee, usando bien sea la línea de
|
jerojasro@352
|
129 comandos o su explorador de ficheros.
|
jerojasro@352
|
130
|
jerojasro@352
|
131 \subsection{Hacer una copia local de un repositorio}
|
jerojasro@352
|
132
|
jerojasro@352
|
133 \emph{Copiar} un repositorio es sólo ligeramente especial. Aunque
|
jerojasro@362
|
134 usted podría usar un programa normal de copia de ficheros para hacer
|
jerojasro@352
|
135 una copia del repositorio, es mejor usar el comando integrado que
|
jerojasro@352
|
136 Mercurial ofrece. Este comando se llama \hgcmd{clone}\ndt{Del término
|
jerojasro@352
|
137 ``clonar'' en inglés.}, porque crea una copia idéntica de un
|
jerojasro@352
|
138 repositorio existente.
|
jerojasro@343
|
139 \interaction{tour.clone}
|
jerojasro@352
|
140 Si nuestro clonado tiene éxito, deberíamos tener un directorio local
|
jerojasro@362
|
141 llamado \dirname{hello}. Este directorio contendrá algunos ficheros.
|
jerojasro@343
|
142 \interaction{tour.ls}
|
jerojasro@362
|
143 Estos ficheros tienen el mismo contenido e historial en nuestro
|
jerojasro@352
|
144 repositorio y en el repositorio que clonamos.
|
jerojasro@352
|
145
|
jerojasro@352
|
146 Cada repositorio Mercurial está completo, es autocontenido e
|
jerojasro@362
|
147 independiente. Contiene su propia copia de los ficheros y la historia
|
jerojasro@352
|
148 de un proyecto. Un repositorio clonado recuerda la ubicación de la que
|
jerojasro@352
|
149 fue clonado, pero no se comunica con ese repositorio, ni con ningún
|
jerojasro@352
|
150 otro, a menos que usted le indique que lo haga.
|
jerojasro@352
|
151
|
jerojasro@352
|
152 Lo que esto significa por ahora es que somos libres de experimentar
|
jerojasro@355
|
153 con nuestro repositorio, con la tranquilidad de saber que es una
|
jerojasro@355
|
154 % TODO figure out what to say instead of sandbox
|
jerojasro@355
|
155 ``caja de arena'' privada que no afectará a nadie más.
|
jerojasro@355
|
156
|
jerojasro@355
|
157 \subsection{Qué hay en un repositorio?}
|
jerojasro@355
|
158
|
jerojasro@355
|
159 Cuando miramos en detalle dentro de un repositorio, podemos ver que
|
jerojasro@355
|
160 contiene un directorio llamado \dirname{.hg}. Aquí es donde Mercurial
|
jerojasro@355
|
161 mantiene todos los metadatos del repositorio.
|
jerojasro@343
|
162 \interaction{tour.ls-a}
|
jerojasro@343
|
163
|
jerojasro@355
|
164 Los contenidos del directorio \dirname{.hg} y sus subdirectorios son
|
jerojasro@355
|
165 exclusivos de Mercurial. Usted es libre de hacer lo que desee con
|
jerojasro@362
|
166 cualquier otro fichero o directorio en el repositorio.
|
jerojasro@343
|
167
|
jerojasro@357
|
168 Para introducir algo de terminología, el directorio \dirname{.hg} es
|
jerojasro@362
|
169 el repositorio ``real'', y todos los ficheros y directorios que
|
jerojasro@357
|
170 coexisten con él están en el \emph{directorio de trabajo}. Una forma
|
jerojasro@357
|
171 sencilla de recordar esta distinción es que el \emph{repositorio}
|
jerojasro@357
|
172 % TODO unificar con Igor, si historia o historial
|
jerojasro@357
|
173 contiene el \emph{historial} de su proyecto, mientras que el
|
jerojasro@357
|
174 \emph{directorio de trabajo} contiene una \emph{instantánea} de su
|
jerojasro@357
|
175 proyecto en un punto particular del historial.
|
jerojasro@357
|
176
|
jerojasro@357
|
177 \section{Vistazo rápido al historial}
|
jerojasro@357
|
178
|
jerojasro@357
|
179 Una de las primeras cosas que se desea hacer con un repositorio nuevo,
|
jerojasro@501
|
180 poco conocido, es conocer su historial. El comando \hgcmd{log} nos
|
jerojasro@357
|
181 permite ver el mismo.
|
jerojasro@343
|
182 \interaction{tour.log}
|
jerojasro@358
|
183 Por defecto este programa imprime un párrafo breve por cada cambio al
|
jerojasro@358
|
184 proyecto que haya sido grabado. Dentro de la terminología de
|
jerojasro@501
|
185 Mercurial, cada uno de estos eventos es llamado \emph{conjunto de
|
jerojasro@358
|
186 cambios}, porque pueden contener un registro de cambios a varios
|
jerojasro@362
|
187 ficheros.
|
jerojasro@358
|
188
|
jerojasro@358
|
189 Los campos de la salida de \hgcmd{log} son los siguientes.
|
jerojasro@343
|
190 \begin{itemize}
|
jerojasro@358
|
191 \item[\texttt{changeset}]\hspace{-0.5em}\ndt{Conjunto de cambios.} Este campo
|
jerojasro@358
|
192 tiene un número, seguido por un
|
jerojasro@358
|
193 % TODO digo mejor seguido por un dos puntos ? string =>
|
jerojasro@358
|
194 % cadena?
|
jerojasro@358
|
195 \texttt{:}, seguido por una cadena hexadecimal. Ambos son
|
jerojasro@358
|
196 \emph{identificadores} para el conjunto de cambios. Hay dos
|
jerojasro@358
|
197 identificadores porque el número es más corto y más fácil de
|
jerojasro@358
|
198 recordar que la cadena hexadecimal.
|
jerojasro@358
|
199
|
jerojasro@358
|
200 \item[\texttt{user}]\hspace{-0.5em}\ndt{Usuario.} La identidad de la
|
jerojasro@358
|
201 persona que creó el conjunto de cambios. Este es un campo en el
|
jerojasro@358
|
202 que se puede almacenar cualquier valor, pero en la mayoría de los
|
jerojasro@358
|
203 casos contiene el nombre de una persona y su dirección de correo
|
jerojasro@358
|
204 electrónico.
|
jerojasro@358
|
205
|
jerojasro@362
|
206 \item[\texttt{date}]\hspace{-0.5em}\ndt{Fecha.} La fecha y hora en la
|
jerojasro@362
|
207 que el conjunto de cambios fue creado, y la zona horaria en la que
|
jerojasro@362
|
208 fue creado. (La fecha y hora son locales a dicha zona horaria;
|
jerojasro@362
|
209 ambos muestran la fecha y hora para la persona que creó el
|
jerojasro@501
|
210 conjunto de cambios).
|
jerojasro@362
|
211
|
jerojasro@362
|
212 \item[\texttt{summary}]\hspace{-0.5em}\ndt{Sumario.}
|
jerojasro@362
|
213 La primera línea del texto que usó la persona que creó el conjunto
|
jerojasro@362
|
214 de cambios para describir el mismo.
|
jerojasro@343
|
215 \end{itemize}
|
jerojasro@362
|
216 El texto impreso por \hgcmd{log} es sólo un sumario; omite una gran
|
jerojasro@362
|
217 cantidad de detalles.
|
jerojasro@362
|
218
|
jerojasro@362
|
219 La figura~\ref{fig:tour-basic:history} es una representación
|
jerojasro@362
|
220 gráfica del historial del repositorio \dirname{hello}, para hacer más
|
jerojasro@362
|
221 fácil ver en qué dirección está ``fluyendo'' el historial. Volveremos
|
jerojasro@362
|
222 a esto varias veces en este capítulo y en los siguientes.
|
jerojasro@343
|
223
|
jerojasro@343
|
224 \begin{figure}[ht]
|
jerojasro@343
|
225 \centering
|
jerojasro@343
|
226 \grafix{tour-history}
|
jerojasro@501
|
227 \caption{Historial gráfico del repositorio \dirname{hello}}
|
jerojasro@343
|
228 \label{fig:tour-basic:history}
|
jerojasro@343
|
229 \end{figure}
|
jerojasro@343
|
230
|
jerojasro@362
|
231 \subsection{Conjuntos de cambios, revisiones, y comunicándose con
|
jerojasro@362
|
232 otras personas}
|
jerojasro@362
|
233
|
jerojasro@362
|
234 %TODO sloppy => desordenado ? TODO hablar del inglés? o de español?
|
jerojasro@362
|
235 Ya que el inglés es un lenguaje notablemente desordenado, y el área de
|
jerojasro@362
|
236 ciencias de la computación tiene una notable historia de confusión de
|
jerojasro@362
|
237 % TODO insertar ? al revés. no sé cómo en un teclado de estos.
|
jerojasro@362
|
238 términos (porqué usar sólo un término cuando cuatro pueden servir?),
|
jerojasro@362
|
239 el control de revisiones tiene una variedad de frases y palabras que
|
jerojasro@362
|
240 tienen el mismo significado. Si usted habla acerca del historial de
|
jerojasro@362
|
241 Mercurial con alguien, encontrará que la expresión ``conjunto de
|
jerojasro@362
|
242 cambios'' es abreviada a menudo como ``cambio'' o (por escrito)
|
jerojasro@362
|
243 ``cset''\ndt{Abreviatura para la expresión ``changeset'' en inglés.},
|
jerojasro@362
|
244 y algunas veces un se hace referencia a un conjunto de cambios como
|
jerojasro@362
|
245 una ``revisión'' o ``rev''\ndt{De nuevo, como abreviación para el
|
jerojasro@362
|
246 término en inglés para ``revisión'' (``revision'').}.
|
jerojasro@362
|
247
|
jerojasro@362
|
248 Si bien no es relevante qué \emph{palabra} use usted para referirse al
|
jerojasro@362
|
249 concepto ``conjunto de cambios'', el \emph{identificador} que usted
|
jerojasro@362
|
250 use para referise a ``un \emph{conjunto de cambios} particular'' es
|
jerojasro@362
|
251 muy importante. Recuerde que el campo \texttt{changeset} en la salida
|
jerojasro@362
|
252 de \hgcmd{log} identifica un conjunto de cambios usando tanto un
|
jerojasro@362
|
253 número como una cadena hexadecimal.
|
jerojasro@362
|
254
|
jerojasro@343
|
255 \begin{itemize}
|
jerojasro@362
|
256 \item El número de revisión \emph{sólo es válido dentro del
|
jerojasro@362
|
257 repositorio}.
|
jerojasro@362
|
258 \item Por otro lado, la cadena hexadecimal es el
|
jerojasro@362
|
259 \emph{identificador permanente e inmutable} que siempre
|
jerojasro@362
|
260 identificará ése conjunto de cambios en \emph{todas} las
|
jerojasro@362
|
261 copias del repositorio.
|
jerojasro@343
|
262 \end{itemize}
|
jerojasro@362
|
263 La diferencia es importante. Si usted le envía a alguien un correo
|
jerojasro@362
|
264 electrónico hablando acerca de la ``revisión~33'', hay una
|
jerojasro@362
|
265 probabilidad alta de que la revisión~33 de esa persona \emph{no sea la
|
jerojasro@501
|
266 misma suya}. Esto sucede porque el número de revisión depende del
|
jerojasro@362
|
267 orden en que llegan los cambios al repositorio, y no hay ninguna
|
jerojasro@362
|
268 garantía de que los mismos cambios llegarán en el mismo orden en
|
jerojasro@362
|
269 diferentes repositorios. Tres cambios dados $a,b,c$ pueden aparecer en
|
jerojasro@362
|
270 un repositorio como $0,1,2$, mientras que en otro aparecen como
|
jerojasro@362
|
271 $1,0,2$.
|
jerojasro@362
|
272
|
jerojasro@362
|
273 Mercurial usa los números de revisión simplemente como una abreviación
|
jerojasro@362
|
274 conveniente. Si usted necesita hablar con alguien acerca de un
|
jerojasro@362
|
275 conjunto de cambios, o llevar el registro de un conjunto de cambios
|
jerojasro@362
|
276 por alguna otra razón (por ejemplo, en un reporte de fallo), use el
|
jerojasro@362
|
277 identificador hexadecimal.
|
jerojasro@343
|
278
|
jerojasro@363
|
279 \subsection{Ver revisiones específicas}
|
jerojasro@363
|
280
|
jerojasro@363
|
281 Para reducir la salida de \hgcmd{log} a una sola revisión, use la
|
jerojasro@363
|
282 opción \hgopt{log}{-r} (o \hgopt{log}{--rev}). Puede usar un número
|
jerojasro@363
|
283 de revisión o un identificador hexadecimal de conjunto de cambios, y
|
jerojasro@363
|
284 puede pasar tantas revisiones como desee.
|
jerojasro@363
|
285
|
jerojasro@363
|
286 \interaction{tour.log-r}
|
jerojasro@363
|
287
|
jerojasro@363
|
288 Si desea ver el historial de varias revisiones sin tener que mencionar
|
jerojasro@363
|
289 cada una de ellas, puede usar la \emph{notación de rango}; esto le
|
jerojasro@363
|
290 permite expresar el concepto ``quiero ver todas las revisiones entre
|
jerojasro@363
|
291 $a$ y $b$, inclusive''.
|
jerojasro@343
|
292 \interaction{tour.log.range}
|
jerojasro@363
|
293 Mercurial también respeta el orden en que usted especifica las
|
jerojasro@363
|
294 revisiones, así que \hgcmdargs{log}{-r 2:4} muestra $2,3,4$ mientras
|
jerojasro@363
|
295 que \hgcmdargs{log}{-r 4:2} muestra $4,3,2$.
|
jerojasro@363
|
296
|
jerojasro@363
|
297 \subsection{Información más detallada}
|
jerojasro@363
|
298 Aunque la información presentada por \hgcmd{log} es útil si usted sabe
|
jerojasro@363
|
299 de antemano qué está buscando, puede que necesite ver una descripción
|
jerojasro@501
|
300 completa del cambio, o una lista de los ficheros que cambiaron, si
|
jerojasro@363
|
301 está tratando de averiguar si un conjunto de cambios dado es el que
|
jerojasro@363
|
302 usted está buscando. La opción \hggopt{-v} (or \hggopt{--verbose}) del
|
jerojasro@363
|
303 comando \hgcmd{log} le da este nivel extra de detalle.
|
jerojasro@343
|
304 \interaction{tour.log-v}
|
jerojasro@343
|
305
|
jerojasro@363
|
306 Si desea ver tanto la descripción como el contenido de un cambio,
|
jerojasro@363
|
307 añada la opción \hgopt{log}{-p} (o \hgopt{log}{--patch}). Esto muestra
|
jerojasro@363
|
308 % TODO qué hacemos con diff unificado? convervarlo, por ser la
|
jerojasro@363
|
309 % acepción usual?
|
jerojasro@363
|
310 el contenido de un cambio como un \emph{diff unificado} (si usted
|
jerojasro@363
|
311 nunca ha visto un diff unificado antes, vea la
|
jerojasro@363
|
312 sección~\ref{sec:mq:patch} para un vistazo global).
|
jerojasro@343
|
313 \interaction{tour.log-vp}
|
jerojasro@343
|
314
|
jerojasro@364
|
315 \section{Todo acerca de las opciones para comandos}
|
jerojasro@364
|
316
|
jerojasro@364
|
317 Tomemos un breve descanso de la tarea de explorar los comandos de
|
jerojasro@365
|
318 Mercurial para hablar de un patrón en la manera en que trabajan; será
|
jerojasro@364
|
319 útil tener esto en mente a medida que avanza nuestra gira.
|
jerojasro@364
|
320
|
jerojasro@365
|
321 Mercurial tiene un enfoque directo y consistente en el manejo de las
|
jerojasro@364
|
322 opciones que usted le puede pasar a los comandos. Se siguen las
|
jerojasro@364
|
323 convenciones para opciones que son comunes en sistemas Linux y Unix
|
jerojasro@364
|
324 modernos.
|
jerojasro@343
|
325 \begin{itemize}
|
jerojasro@364
|
326 \item Cada opción tiene un nombre largo. Por ejemplo, el comando
|
jerojasro@364
|
327 \hgcmd{log} acepta la opción \hgopt{log}{--rev}, como ya hemos
|
jerojasro@364
|
328 visto.
|
jerojasro@364
|
329 \item Muchas opciones tienen también un nombre corto. En vez de
|
jerojasro@364
|
330 \hgopt{log}{--rev}, podemos usar \hgopt{log}{-r}. (El motivo para
|
jerojasro@364
|
331 que algunas opciones no tengan nombres cortos es que dichas
|
jerojasro@364
|
332 opciones se usan rara vez.)
|
jerojasro@364
|
333 \item Las opciones largas empiezan con dos guiones (p.ej.~\hgopt{log}{--rev}),
|
jerojasro@364
|
334 mientras que las opciones cortas empiezan con uno (e.g.~\hgopt{log}{-r}).
|
jerojasro@364
|
335 \item El nombre y uso de las opciones es consistente en todos los
|
jerojasro@364
|
336 comandos. Por ejemplo, cada comando que le permite pasar un ID de
|
jerojasro@364
|
337 conjunto de cambios o un número de revisión acepta tanto la opción
|
jerojasro@364
|
338 \hgopt{log}{-r} como la \hgopt{log}{--rev}.
|
jerojasro@343
|
339 \end{itemize}
|
jerojasro@364
|
340 En los ejemplos en este libro, uso las opciones cortas en vez de las
|
jerojasro@364
|
341 largas. Esto sólo muestra mis preferencias, así que no le dé
|
jerojasro@364
|
342 significado especial a eso.
|
jerojasro@364
|
343
|
jerojasro@364
|
344 Muchos de los comandos que generan salida de algún tipo mostrarán más
|
jerojasro@364
|
345 salida cuando se les pase la opción \hggopt{-v} (o
|
jerojasro@364
|
346 \hggopt{--verbose}\ndt{Prolijo.}), y menos cuando se les pase la opción \hggopt{-q}
|
jerojasro@364
|
347 (o \hggopt{--quiet}\ndt{Silencioso.}).
|
jerojasro@343
|
348
|
jerojasro@366
|
349 \section{Hacer y repasar cambios}
|
jerojasro@366
|
350
|
jerojasro@366
|
351 Ahora que tenemos una comprensión adecuada sobre cómo revisar el
|
jerojasro@366
|
352 historial en Mercurial, hagamos algunos cambios y veamos cómo
|
jerojasro@366
|
353 examinarlos.
|
jerojasro@366
|
354
|
jerojasro@366
|
355 Lo primero que haremos será aislar nuestro experimento en un
|
jerojasro@366
|
356 repositorio propio. Usaremos el comando \hgcmd{clone}, pero no hace
|
jerojasro@501
|
357 falta clonar una copia del repositorio remoto. Como ya contamos con
|
jerojasro@366
|
358 una copia local del mismo, podemos clonar esa. Esto es mucho más
|
jerojasro@366
|
359 rápido que clonar a través de la red, y en la mayoría de los casos
|
jerojasro@366
|
360 clonar un repositorio local usa menos espacio en disco también.
|
jerojasro@343
|
361 \interaction{tour.reclone}
|
jerojasro@368
|
362 A manera de recomendación, es considerado buena práctica mantener una
|
jerojasro@368
|
363 copia ``prístina'' de un repositorio remoto a mano, del cual usted
|
jerojasro@368
|
364 puede hacer clones temporales para crear cajas de arena para cada
|
jerojasro@368
|
365 tarea en la que desee trabajar. Esto le permite trabajar en múltiples
|
jerojasro@368
|
366 tareas en paralelo, teniendo cada una de ellas aislada de las otras
|
jerojasro@368
|
367 hasta que estén completas y usted esté listo para integrar los cambios
|
jerojasro@368
|
368 de vuelta. Como los clones locales son tan baratos, clonar y destruir
|
jerojasro@368
|
369 repositorios no consume demasiados recursos, lo que facilita hacerlo
|
jerojasro@368
|
370 en cualquier momento.
|
jerojasro@368
|
371
|
jerojasro@371
|
372 En nuestro repositorio \dirname{my-hello}, hay un fichero
|
jerojasro@368
|
373 \filename{hello.c} que contiene el clásico programa ``hello,
|
jerojasro@368
|
374 world''\ndt{Hola, mundo.}. Usaremos el clásico y venerado comando
|
jerojasro@371
|
375 \command{sed} para editar este fichero y hacer que imprima una segunda
|
jerojasro@368
|
376 línea de salida. (Estoy usando el comando \command{sed} para hacer
|
jerojasro@368
|
377 esto sólo porque es fácil escribir un ejemplo automatizado con él.
|
jerojasro@368
|
378 Dado que usted no tiene esta restricción, probablemente no querrá usar
|
jerojasro@368
|
379 \command{sed}; use su editor de texto preferido para hacer lo mismo).
|
jerojasro@343
|
380 \interaction{tour.sed}
|
jerojasro@343
|
381
|
jerojasro@368
|
382 El comando \hgcmd{status} de Mercurial nos dice lo que Mercurial sabe
|
jerojasro@371
|
383 acerca de los ficheros en el repositorio.
|
jerojasro@343
|
384 \interaction{tour.status}
|
jerojasro@371
|
385 El comando \hgcmd{status} no imprime nada para algunos ficheros, sólo
|
jerojasro@368
|
386 una línea empezando con ``\texttt{M}'' para el fichero
|
jerojasro@368
|
387 \filename{hello.c}. A menos que usted lo indique explícitamente,
|
jerojasro@371
|
388 \hgcmd{status} no imprimirá nada respecto a los ficheros que no han
|
jerojasro@368
|
389 sido modificados.
|
jerojasro@368
|
390
|
jerojasro@368
|
391 La ``\texttt{M}'' indica que Mercurial se dio cuenta de que nosotros
|
jerojasro@368
|
392 modificamos \filename{hello.c}. No tuvimos que \emph{decirle} a
|
jerojasro@371
|
393 Mercurial que íbamos a modificar ese fichero antes de hacerlo, o que
|
jerojasro@368
|
394 lo modificamos una vez terminamos de hacerlo; él fue capaz de darse
|
jerojasro@368
|
395 cuenta de esto por sí mismo.
|
jerojasro@368
|
396
|
jerojasro@371
|
397 Es algo útil saber que hemos modificado el fichero \filename{hello.c},
|
jerojasro@368
|
398 pero preferiríamos saber exactamente \emph{qué} cambios hicimos.
|
jerojasro@368
|
399 Para averiguar esto, usamos el comando \hgcmd{diff}.
|
jerojasro@343
|
400 \interaction{tour.diff}
|
jerojasro@343
|
401
|
jerojasro@371
|
402 \section{Grabar cambios en un nuevo conjunto de cambios}
|
jerojasro@371
|
403
|
jerojasro@371
|
404 Podemos modificar, compilar y probar nuestros cambios, y usar
|
jerojasro@371
|
405 \hgcmd{status} y \hgcmd{diff} para revisar los mismos, hasta que
|
jerojasro@371
|
406 estemos satisfechos con los resultados y lleguemos a un momento en el
|
jerojasro@371
|
407 que sea natural que querramos guardar nuestro trabajo en un nuevo
|
jerojasro@371
|
408 conjunto de cambios.
|
jerojasro@371
|
409
|
jerojasro@371
|
410 El comando \hgcmd{commit} nos permite crear un nuevo conjunto de
|
jerojasro@371
|
411 cambios. Nos referiremos usualmente a esto como ``hacer una consigna''
|
jerojasro@371
|
412 o consignar.
|
jerojasro@371
|
413
|
jerojasro@371
|
414 \subsection{Definir un nombre de usuario}
|
jerojasro@371
|
415
|
jerojasro@371
|
416 Cuando usted trata de ejecutar \hgcmd{commit}\ndt{Hacer una
|
jerojasro@371
|
417 consignación} por primera vez, no está garantizado que lo logre.
|
jerojasro@371
|
418 Mercurial registra su nombre y dirección en cada cambio que usted
|
jerojasro@371
|
419 consigna, para que más adelante otros puedan saber quién es el
|
jerojasro@371
|
420 responsable de cada cambio. Mercurial trata de encontrar un nombre de
|
jerojasro@371
|
421 % TODO consigna o consignación?
|
jerojasro@371
|
422 usuario adecuado con el cual registrar la consignación. Se intenta con
|
jerojasro@371
|
423 cada uno de los siguientes métodos, en el orden presentado.
|
jerojasro@343
|
424 \begin{enumerate}
|
jerojasro@371
|
425 \item Si usted pasa la opción \hgopt{commit}{-u} al comando \hgcmd{commit}
|
jerojasro@371
|
426 en la línea de comandos, seguido de un nombre de usuario, se le da a
|
jerojasro@371
|
427 esto la máxima precedencia.
|
jerojasro@371
|
428 \item A continuación se revisa si usted ha definido la variable de
|
jerojasro@371
|
429 entorno \envar{HGUSER}.
|
jerojasro@371
|
430 \item Si usted crea un fichero en su directorio personal llamado
|
jerojasro@371
|
431 \sfilename{.hgrc}, con una entrada \rcitem{ui}{username}, se usa
|
jerojasro@371
|
432 luego. Para revisar cómo debe verse este fichero, refiérase a la
|
jerojasro@371
|
433 sección~\ref{sec:tour-basic:username} más abajo.
|
jerojasro@371
|
434 \item Si usted ha definido la variable de entorno \envar{EMAIL}, será
|
jerojasro@371
|
435 usada a continuación.
|
jerojasro@371
|
436 \item Mercurial le pedirá a su sistema buscar su nombre de usuario
|
jerojasro@371
|
437 % TODO host => máquina
|
jerojasro@371
|
438 local, y el nombre de máquina, y construirá un nombre de usuario a
|
jerojasro@371
|
439 partir de estos componentes. Ya que esto generalmente termina
|
jerojasro@371
|
440 generando un nombre de usuario no muy útil, se imprimirá una
|
jerojasro@371
|
441 advertencia si es necesario hacerlo.
|
jerojasro@343
|
442 \end{enumerate}
|
jerojasro@371
|
443 Si todos estos procedimientos fallan, Mercurial fallará, e imprimirá
|
jerojasro@371
|
444 un mensaje de error. En este caso, no le permitirá hacer la
|
jerojasro@371
|
445 consignación hasta que usted defina un nombre de usuario.
|
jerojasro@371
|
446
|
jerojasro@371
|
447 Trate de ver la variable de entorno \envar{HGUSER} y la opción
|
jerojasro@371
|
448 \hgopt{commit}{-u} del comando \hgcmd{commit} como formas de
|
jerojasro@371
|
449 \emph{hacer caso omiso} de la selección de nombre de usuario que
|
jerojasro@371
|
450 Mercurial hace normalmente. Para uso normal, la manera más simple y
|
jerojasro@371
|
451 sencilla de definir un nombre de usuario para usted es crear un
|
jerojasro@371
|
452 fichero \sfilename{.hgrc}; los detalles se encuentran más adelante.
|
jerojasro@371
|
453
|
jerojasro@371
|
454 \subsubsection{Crear el fichero de configuración de Mercurial}
|
jerojasro@343
|
455 \label{sec:tour-basic:username}
|
jerojasro@343
|
456
|
jerojasro@371
|
457 Para definir un nombre de usuario, use su editor de texto favorito
|
jerojasro@371
|
458 para crear un fichero llamado \sfilename{.hgrc} en su directorio
|
jerojasro@371
|
459 personal. Mercurial usará este fichero para obtener las
|
jerojasro@371
|
460 configuraciones personalizadas que usted haya hecho. El contenido
|
jerojasro@371
|
461 inicial de su fichero \sfilename{.hgrc} debería verse así.
|
jerojasro@343
|
462 \begin{codesample2}
|
jerojasro@371
|
463 # Este es un fichero de configuración de Mercurial.
|
jerojasro@343
|
464 [ui]
|
jerojasro@371
|
465 username = Primernombre Apellido <correo.electronico@dominio.net>
|
jerojasro@343
|
466 \end{codesample2}
|
jerojasro@371
|
467 La línea ``\texttt{[ui]}'' define una \emph{section} del fichero de
|
jerojasro@371
|
468 configuración, así que usted puede leer la línea ``\texttt{username =
|
jerojasro@371
|
469 ...}'' como ``defina el valor del elemento \texttt{username} en la
|
jerojasro@371
|
470 sección \texttt{ui}''.
|
jerojasro@371
|
471 Una sección continua hasta que empieza otra nueva, o se llega al final
|
jerojasro@371
|
472 del fichero. Mercurial ignora las líneas vacías y considera cualquier
|
jerojasro@371
|
473 texto desde el caracter ``\texttt{\#}'' hasta el final de la línea
|
jerojasro@371
|
474 como un comentario.
|
jerojasro@371
|
475
|
jerojasro@371
|
476 \subsubsection{Escoger un nombre de usuario}
|
jerojasro@371
|
477
|
jerojasro@371
|
478 Usted puede usar el texto que desee como el valor del campo de
|
jerojasro@371
|
479 configuración \texttt{username}, ya que esta información será leída
|
jerojasro@371
|
480 por otras personas, e interpretada por Mercurial. La convención que
|
jerojasro@371
|
481 sigue la mayoría de la gente es usar su nombre y dirección de correo,
|
jerojasro@371
|
482 como en el ejemplo anterior.
|
jerojasro@343
|
483
|
jerojasro@343
|
484 \begin{note}
|
jerojasro@371
|
485 % TODO web
|
jerojasro@371
|
486 El servidor web integrado de Mercurial ofusca las direcciones de
|
jerojasro@371
|
487 correo, para dificultar la tarea de las herramientas de
|
jerojasro@371
|
488 recolección de direcciones de correo que usan los
|
jerojasro@371
|
489 spammers\ndt{Personas que envían correo no solicitado, también
|
jerojasro@371
|
490 conocido como correo basura}. Esto reduce la probabilidad de que
|
jerojasro@371
|
491 usted empiece a recibir más correo basura si publica un
|
jerojasro@371
|
492 repositorio en la red.
|
jerojasro@343
|
493 \end{note}
|
jerojasro@343
|
494
|
jerojasro@371
|
495 \subsection{Escribir un mensaje de consignación}
|
jerojasro@371
|
496
|
jerojasro@371
|
497 Cuando consignamos un cambio, Mercurial nos ubica dentro de un editor
|
jerojasro@371
|
498 de texto, para ingresar un mensaje que describa las modificaciones que
|
jerojasro@371
|
499 hemos introducido en este conjunto de cambios. Esto es conocido como
|
jerojasro@371
|
500 un \emph{mensaje de consignación}. Será un registro de lo que hicimos
|
jerojasro@371
|
501 y porqué lo hicimos, y será impreso por \hgcmd{log} una vez hayamos
|
jerojasro@371
|
502 hecho la consignación.
|
jerojasro@343
|
503 \interaction{tour.commit}
|
jerojasro@343
|
504
|
jerojasro@371
|
505 El editor en que \hgcmd{commit} nos ubica contendrá una línea vacía,
|
jerojasro@371
|
506 seguida de varias líneas que empiezan con la cadena ``\texttt{HG:}''.
|
jerojasro@343
|
507 \begin{codesample2}
|
jerojasro@371
|
508 \emph{línea vacía}
|
jerojasro@343
|
509 HG: changed hello.c
|
jerojasro@343
|
510 \end{codesample2}
|
jerojasro@371
|
511 Mercurial ignora las líneas que empiezan con ``\texttt{HG:}''; sólo
|
jerojasro@371
|
512 las usa para indicarnos para cuáles ficheros está registrando los
|
jerojasro@371
|
513 cambios. Modificar o borrar estas líneas no tiene ningún efecto.
|
jerojasro@371
|
514
|
jerojasro@371
|
515 \subsection{Escribir un buen mensaje de consignación}
|
jerojasro@371
|
516
|
jerojasro@371
|
517 Ya que por defecto \hgcmd{log} sólo muestra la primera línea de un
|
jerojasro@371
|
518 mensaje de consignación, lo mejor es escribir un mensaje cuya primera
|
jerojasro@371
|
519 línea tenga significado por sí misma. A continuación se encuentra un
|
jerojasro@371
|
520 ejemplo de un mensaje de consignación que \emph{no} sigue esta
|
jerojasro@371
|
521 pauta, y debido a ello tiene un sumario que no es legible.
|
jerojasro@343
|
522 \begin{codesample2}
|
jerojasro@343
|
523 changeset: 73:584af0e231be
|
jerojasro@371
|
524 user: Persona Censurada <persona.censurada@ejemplo.org>
|
jerojasro@343
|
525 date: Tue Sep 26 21:37:07 2006 -0700
|
jerojasro@371
|
526 summary: se incluye buildmeister/commondefs. Añade un módulo
|
jerojasro@343
|
527 \end{codesample2}
|
jerojasro@343
|
528
|
jerojasro@371
|
529 Con respecto al resto del contenido del mensaje de consignación, no
|
jerojasro@371
|
530 hay reglas estrictas-y-rápidas. Mercurial no interpreta ni le da
|
jerojasro@371
|
531 importancia a los contenidos del mensaje de consignación, aunque es
|
jerojasro@371
|
532 posible que su proyecto tenga políticas que definan una manera
|
jerojasro@371
|
533 particular de escribirlo.
|
jerojasro@371
|
534
|
jerojasro@371
|
535 Mi preferencia personal es usar mensajes de consignación cortos pero
|
jerojasro@371
|
536 informativos, que me digan algo que no puedo inferir con una mirada
|
jerojasro@371
|
537 rápida a la salida de \hgcmdargs{log}{--patch}.
|
jerojasro@371
|
538
|
jerojasro@371
|
539 \subsection{Cancelar una consignación}
|
jerojasro@371
|
540
|
jerojasro@371
|
541 Si usted decide que no desea hacer la consignación mientras está
|
jerojasro@371
|
542 editando el mensaje de la misma, simplemente cierre su editor sin
|
jerojasro@371
|
543 guardar los cambios al fichero que está editando. Esto hará que no
|
jerojasro@371
|
544 pase nada ni en el repositorio ni en el directorio de trabajo.
|
jerojasro@371
|
545
|
jerojasro@371
|
546 Si ejecutamos el comando \hgcmd{commit} sin ningún argumento, se
|
jerojasro@371
|
547 registran todos los cambios que hemos hecho, como lo indican
|
jerojasro@371
|
548 \hgcmd{status} y \hgcmd{diff}.
|
jerojasro@371
|
549
|
jerojasro@371
|
550 \subsection{Admirar nuestro trabajo}
|
jerojasro@371
|
551
|
jerojasro@371
|
552 Una vez hemos terminado la consignación, podemos usar el comando
|
jerojasro@371
|
553 \hgcmd{tip}\ndt{Punta.} para mostrar el conjunto de cambios que acabamos de crear.
|
jerojasro@371
|
554 La salida de este comando es idéntica a la de \hgcmd{log}, pero sólo
|
jerojasro@371
|
555 muestra la revisión más reciente en el repositorio.
|
jerojasro@343
|
556 \interaction{tour.tip}
|
jerojasro@371
|
557 Nos referimos a la revisión más reciente en el repositorio como la
|
jerojasro@371
|
558 revisión de punta, o simplemente la punta.
|
jerojasro@343
|
559
|
jerojasro@379
|
560 \section{Compartir cambios}
|
jerojasro@379
|
561
|
jerojasro@379
|
562 Anteriormente mencionamos que los repositorios en Mercurial están auto
|
jerojasro@379
|
563 contenidos. Esto quiere decir que el conjunto de cambios que acabamos
|
jerojasro@379
|
564 de crear sólo existe en nuestro repositorio \dirname{my-hello}. Veamos
|
jerojasro@379
|
565 unas cuantas formas de propagar este cambio a otros repositorios.
|
jerojasro@343
|
566
|
jerojasro@372
|
567 \subsection{Jalar cambios desde otro repositorio}
|
jerojasro@343
|
568 \label{sec:tour:pull}
|
jerojasro@343
|
569
|
jerojasro@372
|
570 Para empezar, clonemos nuestro repositorio \dirname{hello} original,
|
jerojasro@372
|
571 el cual no contiene el cambio que acabamos de consignar. Llamaremos a
|
jerojasro@372
|
572 este repositorio temporal \dirname{hello-pull}.
|
jerojasro@343
|
573 \interaction{tour.clone-pull}
|
jerojasro@343
|
574
|
jerojasro@372
|
575 Usaremos el comando \hgcmd{pull} para traer los cambios de
|
jerojasro@372
|
576 \dirname{my-hello} y ponerlos en \dirname{hello-pull}. Sin embargo,
|
jerojasro@372
|
577 traer cambios desconocidos y aplicarlos en un repositorio es una
|
jerojasro@372
|
578 perspectiva que asusta al menos un poco. Mercurial cuenta con el
|
jerojasro@379
|
579 comando \hgcmd{incoming}\ndt{Entrante, o cambios entrantes.} para
|
jerojasro@379
|
580 decirnos qué cambios \emph{jalaría} el comando \hgcmd{pull} al
|
jerojasro@379
|
581 repositorio, sin jalarlos.
|
jerojasro@343
|
582 \interaction{tour.incoming}
|
jerojasro@372
|
583 (Por supuesto, alguien podría enviar más conjuntos de cambios al
|
jerojasro@372
|
584 repositorio en el tiempo que pasa entre la ejecución de
|
jerojasro@372
|
585 \hgcmd{incoming} y la ejecución de \hgcmd{pull} para jalar los
|
jerojasro@372
|
586 cambios, así que es posible que terminemos jalando cambios que no
|
jerojasro@372
|
587 esperábamos.)
|
jerojasro@372
|
588
|
jerojasro@372
|
589 Traer cambios al repositorio simplemente es cuestión de ejecutar el
|
jerojasro@372
|
590 comando \hgcmd{pull}, indicándole de qué repositorio debe jalarlos.
|
jerojasro@343
|
591 \interaction{tour.pull}
|
jerojasro@372
|
592 Como puede verse por las salidas antes-y-después de \hgcmd{tip}, hemos
|
jerojasro@372
|
593 jalado exitosamente los cambios en nuestro repositorio. Aún falta un
|
jerojasro@372
|
594 paso para que podamos ver estos cambios en nuestro directorio de
|
jerojasro@372
|
595 trabajo.
|
jerojasro@372
|
596
|
jerojasro@372
|
597 \subsection{Actualizar el directorio de trabajo}
|
jerojasro@343
|
598
|
jerojasro@379
|
599 Hasta ahora hemos pasado por alto la relación entre un repositorio y
|
jerojasro@379
|
600 su directorio de trabajo. El comando \hgcmd{pull} que ejecutamos en la
|
jerojasro@379
|
601 sección~\ref{sec:tour:pull} trajo los cambios al repositorio, pero si
|
jerojasro@379
|
602 revisamos, no hay rastro de esos cambios en el directorio de trabajo.
|
jerojasro@379
|
603 Esto pasa porque \hgcmd{pull} (por defecto) no modifica el directorio de
|
jerojasro@379
|
604 trabajo. En vez de eso, usamos el comando
|
jerojasro@379
|
605 \hgcmd{update}\ndt{Actualizar.} para hacerlo.
|
jerojasro@343
|
606 \interaction{tour.update}
|
jerojasro@343
|
607
|
jerojasro@379
|
608 Puede parecer algo raro que \hgcmd{pull} no actualice el directorio de
|
jerojasro@379
|
609 trabajo automáticamente. De hecho, hay una buena razón para esto:
|
jerojasro@379
|
610 usted puede usar \hgcmd{update} para actualizar el directorio de
|
jerojasro@379
|
611 trabajo al estado en que se encontraba en \emph{cualquier revisión}
|
jerojasro@501
|
612 del historial del repositorio. Si usted hubiera actualizado el
|
jerojasro@379
|
613 directorio de trabajo a una revisión anterior---digamos, para buscar
|
jerojasro@379
|
614 el origen de un fallo---y hubiera corrido un \hgcmd{pull} que hubiera
|
jerojasro@379
|
615 actualizado el directorio de trabajo automáticamente a la nueva
|
jerojasro@379
|
616 revisión, puede que no estuviera particularmente contento.
|
jerojasro@379
|
617
|
jerojasro@379
|
618 Sin embargo, como jalar-y-actualizar es una secuencia de operaciones
|
jerojasro@379
|
619 muy común, Mercurial le permite combinarlas al pasar la opción
|
jerojasro@379
|
620 \hgopt{pull}{-u}
|
jerojasro@379
|
621 a \hgcmd{pull}.
|
jerojasro@343
|
622 \begin{codesample2}
|
jerojasro@343
|
623 hg pull -u
|
jerojasro@343
|
624 \end{codesample2}
|
jerojasro@379
|
625 Si mira de vuelta la salida de \hgcmd{pull} en la
|
jerojasro@379
|
626 sección~\ref{sec:tour:pull} cuando lo ejecutamos sin la opción \hgopt{pull}{-u},
|
jerojasro@379
|
627 verá que el comando imprimió un amable recordatorio de que tenemos que
|
jerojasro@379
|
628 encargarnos explícitamente de actualizar el directorio de trabajo:
|
jerojasro@343
|
629 \begin{codesample2}
|
jerojasro@343
|
630 (run 'hg update' to get a working copy)
|
jerojasro@343
|
631 \end{codesample2}
|
jerojasro@343
|
632
|
jerojasro@379
|
633 Para averiguar en qué revisión se encuentra el directorio de trabajo,
|
jerojasro@379
|
634 use el comando \hgcmd{parents}.
|
jerojasro@343
|
635 \interaction{tour.parents}
|
jerojasro@379
|
636 Si mira de nuevo la figura~\ref{fig:tour-basic:history}, verá flechas
|
jerojasro@379
|
637 conectando cada conjunto de cambios. En cada caso, el nodo del que la flecha
|
jerojasro@379
|
638 \emph{sale} es un padre, y el nodo al que la flecha \emph{llega} es
|
jerojasro@379
|
639 su hijo. El directorio de trabajo tiene un padre exactamente de la
|
jerojasro@379
|
640 misma manera; ése es el conjunto de cambios que contiene actualmente
|
jerojasro@379
|
641 el directorio de trabajo.
|
jerojasro@379
|
642
|
jerojasro@379
|
643 Para actualizar el conjunto de trabajo a una revisión particular, pase
|
jerojasro@379
|
644 un número de revisión o un ID de conjunto de cambios al comando
|
jerojasro@379
|
645 \hgcmd{update}.
|
jerojasro@343
|
646 \interaction{tour.older}
|
jerojasro@379
|
647 Si no indica explícitamente una revisión, \hgcmd{update} actualizará
|
jerojasro@379
|
648 hasta la revisión de punta, como se vio en la segunda llamada a
|
jerojasro@379
|
649 \hgcmd{update} en el ejemplo anterior.
|
jerojasro@379
|
650
|
jerojasro@379
|
651 \subsection{Empujar cambios a otro repositorio}
|
jerojasro@379
|
652
|
jerojasro@379
|
653 Mercurial nos permite empujar cambios a otro repositorio, desde el
|
jerojasro@379
|
654 % TODO cambié "visitando" por "usando"
|
jerojasro@379
|
655 repositorio que estemos usando actualmente. De la misma forma que en
|
jerojasro@379
|
656 el ejemplo de \hgcmd{pull} arriba, crearemos un repositorio temporal
|
jerojasro@379
|
657 para empujar allí nuestros cambios.
|
jerojasro@343
|
658 \interaction{tour.clone-push}
|
jerojasro@379
|
659 El comando \hgcmd{outgoing}\ndt{Saliente. Cambios salientes.} nos dice
|
jerojasro@379
|
660 qué cambios serían empujados en el otro repositorio.
|
jerojasro@343
|
661 \interaction{tour.outgoing}
|
jerojasro@379
|
662 Y el comando \hgcmd{push} se encarga de empujar dichos cambios.
|
jerojasro@343
|
663 \interaction{tour.push}
|
jerojasro@379
|
664 Al igual que \hgcmd{pull}, el comando \hgcmd{push} no actualiza el
|
jerojasro@379
|
665 directorio de trabajo del repositorio en el que estamos empujando los
|
jerojasro@379
|
666 cambios. (A diferencia de \hgcmd{pull}, \hgcmd{push} no ofrece la
|
jerojasro@379
|
667 opción \texttt{-u} para actualizar el directorio de trabajo del otro
|
jerojasro@379
|
668 repositorio.)
|
jerojasro@379
|
669
|
jerojasro@379
|
670 % TODO poner interrogante de apertura
|
jerojasro@379
|
671 Qué pasa si tratamos de jalar o empujar cambios y el repositorio
|
jerojasro@379
|
672 receptor ya tiene esos cambios? Nada emocionante.
|
jerojasro@343
|
673 \interaction{tour.push.nothing}
|
jerojasro@343
|
674
|
jerojasro@379
|
675 \subsection{Compartir cambios a través de una red}
|
jerojasro@379
|
676
|
jerojasro@379
|
677 Los comandos que hemos presentando en las pocas secciones anteriores
|
jerojasro@379
|
678 no están limitados a trabajar con repositorios locales. Cada uno de
|
jerojasro@379
|
679 ellos funciona exactamente de la misma manera a través de una conexión
|
jerojasro@379
|
680 % TODO poner ndt para URL
|
jerojasro@379
|
681 de red. Simplemente pase una URL en vez de una ruta local.
|
jerojasro@343
|
682 \interaction{tour.outgoing.net}
|
jerojasro@379
|
683 En este ejemplo, podemos ver qué cambios empujaríamos al repositorio
|
jerojasro@379
|
684 remoto, aunque, de manera entendible, el repositorio remoto está
|
jerojasro@379
|
685 configurado para no permitir a usuarios anónimos empujar cambios a él.
|
jerojasro@343
|
686 \interaction{tour.push.net}
|
jerojasro@343
|
687
|
jerojasro@343
|
688 %%% Local Variables:
|
jerojasro@343
|
689 %%% mode: latex
|
jerojasro@343
|
690 %%% TeX-master: "00book"
|
jerojasro@343
|
691 %%% End:
|