hgbook
view es/mq-ref.tex @ 1102:77fa81a32f2e
2.7.5 zh translated ,1 fuzzy
| author | Zhaoping Sun <zhaopingsun@gmail.com> |
|---|---|
| date | Wed Nov 25 21:51:40 2009 -0500 (2009-11-25) |
| parents | 9da096de3c52 |
| children |
line source
1 \chapter{Referencia de las Colas de Mercurial}
2 \label{chap:mqref}
4 \section{Referencia de órdenes MQ}
5 \label{sec:mqref:cmdref}
7 Si desea dar un vistazo a las órdenes que ofrece MQ, use la orden
8 \hgcmdargs{help}{mq}.
10 \subsection{\hgxcmd{mq}{qapplied}---imprimir los parches aplicados}
12 La orden \hgxcmd{mq}{qapplied} imprime la pila actual de parches
13 aplicados. Los parches se imprimen en orden de antigüedad, primero
14 los más antiguos y después los más recientes, por lo tanto el último
15 parche de la lista es el que está en el ``tope''.
17 \subsection{\hgxcmd{mq}{qcommit}---consignar cambios en la cola del repositorio}
19 La orden \hgxcmd{mq}{qcommit} consigna cualquier cambio sobresaliente
20 en el repositorio \sdirname{.hg/patches}. Esta orden solamente
21 funciona si el directorio \sdirname{.hg/patches} es un repositorio,
22 p.e.~usted creó el directorio con
23 \hgcmdargs{qinit}{\hgxopt{mq}{qinit}{-c}} o ejecutó
24 \hgcmd{init} en el directorio después de correr \hgxcmd{mq}{qinit}.
26 Esta orden es un atajo para \hgcmdargs{commit}{--cwd .hg/patches}.
28 \subsection{\hgxcmd{mq}{qdelete}---eliminar un parche del fichero
29 \sfilename{series}}
31 La orden \hgxcmd{mq}{qdelete} elimina la entrada del fichero
32 \sfilename{series} para el parche en el directorio
33 \sdirname{.hg/patches}. No sca el parche si ha sido aplicado. De
34 forma predeterminada no borra el fichero del parche; use la opción
35 \hgxopt{mq}{qdel}{-f} para hacerlo.
37 Opciones:
38 \begin{itemize}
39 \item[\hgxopt{mq}{qdel}{-f}] Elimina el fichero del parche.
40 \end{itemize}
42 \subsection{\hgxcmd{mq}{qdiff}---imprimir la diferencia del último
43 parche aplicado}
45 La orden \hgxcmd{mq}{qdiff} imprime un diff del parche más
46 recientemente aplicado. Es equivalente a \hgcmdargs{diff}{-r-2:-1}.
48 \subsection{\hgxcmd{mq}{qfold}---fusionar (``integrar'') varios parches en
49 uno solo}
51 La orden \hgxcmd{mq}{qfold} fusiona muchos parches en el último parche
52 aplicado, de tal forma que el último parche aplicado es la unión de
53 todos los cambios de los parches en cuestión.
55 Los parches a fusionar no deben haber sido aplicados;
56 \hgxcmd{mq}{qfold} saldrá indicando un error si alguno ha sido
57 aplicado. El orden en el cual los parches se pliegan es
58 significativo; \hgcmdargs{qfold}{a b} significa ``aplique el parche
59 más reciente, seguido de \texttt{a}, y seguido de \texttt{b}''.
61 Los comentarios de los parches integrados se colocan al final de los
62 comentarios del parche destino, con cada bloque de comentarios
63 separado con tres asteriscos (``\texttt{*}''). Se usa la opción
64 \hgxopt{mq}{qfold}{-e} para editar el mensaje de consignación para el
65 conjunto de cambios/parches después de completarse el pliegue.
67 Opciones:
68 \begin{itemize}
69 \item[\hgxopt{mq}{qfold}{-e}] Edita el mensaje de consignación y la
70 descripción del parche del parche que se ha integrado.
71 \item[\hgxopt{mq}{qfold}{-l}] Usa los contenidos del fichero dado como
72 el nuevo mensaje de consignación y descripción del parche para el
73 parche a integrar.
74 \item[\hgxopt{mq}{qfold}{-m}] Usa el texto dado como el mensaje de
75 consignación y descripción del parche para el parche integrado.
76 \end{itemize}
78 \subsection{\hgxcmd{mq}{qheader}---desplegar el encabezado/descripción
79 de un parche}
81 La orden \hgxcmd{mq}{qheader} imprime el encabezado o descripción de
82 un parche. De forma predeterminada, imprime el encabezado del último
83 parche aplicado. Si se da un argumento, imprime el encabezado del
84 parche referenciado.
86 \subsection{\hgxcmd{mq}{qimport}---importar el parche de un tercero en
87 la cola}
89 La orden \hgxcmd{mq}{qimport} añade una entrada de un parche externo
90 al fichero \sfilename{series} y copia el parche en el directorio
91 \sdirname{.hg/patches}. Añade la entrada inmediatamente después del
92 último parche aplicado, pero no introduce el parche.
94 Si el directorio \sdirname{.hg/patches} es un repositorio,
95 \hgxcmd{mq}{qimport} automáticamente hace un \hgcmd{add} del parche
96 importado.
98 \subsection{\hgxcmd{mq}{qinit}---preparar un repositorio para trabajar
99 con MQ}
101 La orden \hgxcmd{mq}{qinit} prepara un repositorio para trabajar con
102 MQ. Crea un directorio llamado \sdirname{.hg/patches}.
104 Opciones:
105 \begin{itemize}
106 \item[\hgxopt{mq}{qinit}{-c}] Crea \sdirname{.hg/patches} como un
107 repositorio por sí mismo. También crea un fichero
108 \sfilename{.hgignore} que ignorará el fichero \sfilename{status}.
109 \end{itemize}
111 Cuando el directorio \sdirname{.hg/patches} es un repositorio, las órdenes
112 \hgxcmd{mq}{qimport} y \hgxcmd{mq}{qnew} hacen \hgcmd{add}
113 automáticamente a los parches nuevos.
115 \subsection{\hgxcmd{mq}{qnew}---crear un parche nuevo}
117 La orden \hgxcmd{mq}{qnew} crea un parche nuevo. Exige un argumento,
118 el nombre que se usará para tal parche. El parche recién creado está
119 vacío inicialmente. Se añade al fichero \sfilename{series} después
120 del último parche aplicado, y se introduce en el tope de ese parche.
122 Si \hgxcmd{mq}{qnew} encuentra ficheros modificados en el directorio
123 de trabajo, rehusará crear un parche nuevo a meos que se emplee
124 \hgxopt{mq}{qnew}{-f} la opción (ver más adelante). Este
125 comportamiento le permite hacer \hgxcmd{mq}{qrefresh} al último parche
126 aplicado antes de aplicar un parche nuevo encima de este.
128 Opciones:
129 \begin{itemize}
130 \item[\hgxopt{mq}{qnew}{-f}] Crea un parche nuevo si los contenidos
131 del directorio actual han sido modificados. Cualquier modificación
132 significativa se añade al parche recientemente creado, de tal forma
133 que al finalizar la orden, el directorio de trabajo no lucirá
134 modificado.
135 \item[\hgxopt{mq}{qnew}{-m}] Usa el texto dado como el mensaje de
136 consignación. Este texto se almacenará al principio del fichero del
137 parche, antes de los datos del parche.
138 \end{itemize}
140 \subsection{\hgxcmd{mq}{qnext}---imprimir el nombre del próximo parche}
142 La orden \hgxcmd{mq}{qnext} imprime el nombre del siguiente parche en
143 el fichero \sfilename{series} a continuación del último parche
144 aplicado. Este parche sería el próximo parche a aplicar si se
145 ejecutara la orden \hgxcmd{mq}{qpush}.
147 \subsection{\hgxcmd{mq}{qpop}---sustraer parches de la pila}
149 La orden \hgxcmd{mq}{qpop} elimina los parches aplicados del tope de
150 la pila de parches aplicados. De forma predeterminada solamente
151 remueve un parche.
153 Esta orden elimina los conjuntos de cambios que representan los
154 parches sustraídos del repositorio, y actualiza el directorio de
155 trabajo para deshacer los efectos de los parches.
157 Esta orden toma un argumento opcional, que usa como el nombre o el
158 índice del parche que desea sustraer. Si se da el nombre, sustraerá
159 los parches hasta que el parche nombrado sea el último parche
160 aplicado. Si se da un número, \hgxcmd{mq}{qpop} lo trata como un
161 índice dentro del fichero \sfilename{series}, contando desde
162 cero (no cuenta las líneas vacías o aquellas que sean únicamente
163 comentarios). Sustrae los parches hasta que el parche identificado
164 por el índice sea el último parche aplicado.
166 La orden \hgxcmd{mq}{qpop} no lee o escribe parches en el fichero
167 \sfilename{series}. \hgxcmd{mq}{qpop} se constituye por tanto en una
168 forma segura de sustraer un parche del fichero \sfilename{series} o un
169 parche que ha eliminado o renombrado completamente. En los dos
170 últimos casos, use el nombre del parche tal como lo hizo cuando lo
171 aplicó.
173 De forma predeterminada, la orden \hgxcmd{mq}{qpop} no sustraerá
174 parche alguno si el directorio de trabajo ha sido modificado. Puede
175 modificar este comportamiento con la opción \hgxopt{mq}{qpop}{-f}, que
176 revierte todas las modificaciones del directorio de trabajo.
178 Opciones:
179 \begin{itemize}
180 \item[\hgxopt{mq}{qpop}{-a}] Sustrae todos los parches aplicados.
181 Restaura el repositorio al estado antes de haber aplicado parche alguno.
182 \item[\hgxopt{mq}{qpop}{-f}] Revertir forzadamente cualquier
183 modificación del directorio de trabajo cuando se hace sustracciones.
184 \item[\hgxopt{mq}{qpop}{-n}] Sustraer un parche de la cola dado un nombre.
185 \end{itemize}
187 La orden \hgxcmd{mq}{qpop} elimina una línea del final del fichero
188 \sfilename{status} por cada parche que se sustrae.
190 \subsection{\hgxcmd{mq}{qprev}---imprimir el nombre del parche anterior}
192 La orden \hgxcmd{mq}{qprev} imprime el nombre del parche en el fichero
193 \sfilename{series} que está antes del último parche aplicado. Este
194 se volverá el último parche aplicado si ejecuta \hgxcmd{mq}{qpop}.
196 \subsection{\hgxcmd{mq}{qpush}---introducir parches a la pila}
197 \label{sec:mqref:cmd:qpush}
199 La orden \hgxcmd{mq}{qpush} añade parches a la pila. De forma
200 predeterminada añade solamente un parche.
202 Esta orden crea un conjunto de cambios que representa cada parche
203 aplicado y actualiza el directorio de trabajo aplicando los efectos de
204 los parches.
206 Los datos predeterminados cuando se crea un conjunto de cambios
207 corresponde a:
208 \begin{itemize}
209 \item La fecha de consignación y zona horaria corresponden a la hora
210 actual de la zona. Dado que tales datos se usan para computar la
211 identidad de un conjunto de cambios, significa que si hace
212 \hgxcmd{mq}{qpop} a un parche y \hgxcmd{mq}{qpush} de nuevo, el
213 conjunto de cambios que introduzca tendrá una identidad distinta a
214 la del conjunto de cambios que sustrajo.
215 \item El autor es el mismo que el predeterminado usado por la orden
216 \hgcmd{commit}.
217 \item El mensaje de consignación es cualquier texto del fichero del
218 parche que viene antes del primer encabezado del diff. Si no hay
219 tal texto, un mensaje predeterminado se sua para identificar el
220 nombre del parche.
221 \end{itemize}
222 Su un parche contiene un encabezado de parche de Mercurial (XXX add
223 link), la información en el encabezado del parche tiene precedencia
224 sobre el predeterminado.
226 Opciones:
227 \begin{itemize}
228 \item[\hgxopt{mq}{qpush}{-a}] Introduce todos los parches que no han
229 sido aplicados del fichero \sfilename{series} hasta que no haya nada
230 más para introducir.
231 \item[\hgxopt{mq}{qpush}{-l}] Añade el nombre del parche al final del
232 mensaje de consignación
233 \item[\hgxopt{mq}{qpush}{-m}] Si un parche no se aplica limpiamente,
234 usa la entrada para un parche en otra cola almacenada para computar
235 los parámetros en una fusión de tres, y aplica una fusión de tres
236 fuentes usando la maquinaria usual de Mercurial. Usa la resolución
237 de la fusión como el contenido del parche nuevo.
238 \item[\hgxopt{mq}{qpush}{-n}] Usa la cola mencionada si se está
239 fusionando en la introducción.
240 \end{itemize}
242 La orden \hgxcmd{mq}{qpush} lee, pero no modifica el fichero
243 \sfilename{series}. Añade al final del fichero \hgcmd{status} una
244 línea por cada parche que se introduce.
246 \subsection{\hgxcmd{mq}{qrefresh}---actualiza el último parche aplicado}
248 La orden \hgxcmd{mq}{qrefresh} actualiza el último parche aplicado.
249 Modifica el parche, elimina el último conjunto de cambios que
250 representó el parche, y crea un nuevo conjunto de cambios para
251 representar el parche modificado.
253 La orden \hgxcmd{mq}{qrefresh} busca las siguientes modificaciones:
254 \begin{itemize}
255 \item Los cambios al mensaje de consignación, p.e.~el texto antes del
256 primer encabezado de diff en el fichero del parche, se replejan en
257 el nuevo conjunto de cambios que representa el parche.
258 \item Las modificaciones a los ficheros a los que se les da
259 seguimiento en el directorio de trabajo se añade al parche.
260 \item Los cambios a los ficheros a los que se les da seguimiento con
261 \hgcmd{add}, \hgcmd{copy}, \hgcmd{remove}, o \hgcmd{rename}. Se
262 añaden al parche los ficheros añadidos, copiados y renombrados,
263 mientras que los ficheros eliminados y las fuentes renombradas se
264 eliminan.
265 \end{itemize}
267 Incluso si \hgxcmd{mq}{qrefresh} no detecta cambios, de todas maneras
268 recrea el conjunto de cambios que representa el cambio. Esto causa
269 que la identidad del conjunto de cambios difiera del conjunto de
270 cambios previo que identificó al parche.
272 Opciones:
273 \begin{itemize}
274 \item[\hgxopt{mq}{qrefresh}{-e}] Modificar la descripción de la
275 consignación y el parche con el editor de texto preferido.
276 \item[\hgxopt{mq}{qrefresh}{-m}] Modificar el mensaje de consignación
277 y la descripción del parche con el texto dado.
278 \item[\hgxopt{mq}{qrefresh}{-l}] Modificar el mensaje de consignación
279 y la descripción del parche con el texto del fichero dado.
280 \end{itemize}
282 \subsection{\hgxcmd{mq}{qrename}---renombrar un parche}
284 La orden \hgxcmd{mq}{qrename} renombra un parche y cambia la entrada
285 del parche en el fichero \sfilename{series}.
287 Con un argumento sencillo, \hgxcmd{mq}{qrename} renombra el último
288 parche aplicado. Con dos argumentos, renombra el primer argumento con
289 el segundo.
291 \subsection{\hgxcmd{mq}{qrestore}---restaurar el estado almacenado de
292 la cola}
294 XXX No idea what this does.
296 \subsection{\hgxcmd{mq}{qsave}---almacena el estado actual de la cola}
298 XXX Likewise.
300 \subsection{\hgxcmd{mq}{qseries}---imprime la serie completa de parches}
302 La orden \hgxcmd{mq}{qseries} imprime la serie completa de parches del
303 fichero \sfilename{series}. Imprime solamente los nombres de los
304 parches sin las líneas en blanco o comentarios. Imprime primero el
305 primero y de último, el último aplicado.
307 \subsection{\hgxcmd{mq}{qtop}---imprime el nombre del parche actual}
309 \hgxcmd{mq}{qtop} imprime el nombre del último parche aplicado.
311 \subsection{\hgxcmd{mq}{qunapplied}---imprimir los parches que aún no
312 se han aplicado}
314 La orden \hgxcmd{mq}{qunapplied} imprime los nombres de los parches
315 del fichero \sfilename{series} que todavía no han sido aplicados. Los
316 imprime de acuerdo al orden en el cual serían introducidos.
318 \subsection{\hgcmd{strip}---remover una revisión y sus descendientes}
320 La orden \hgcmd{strip} remueve una revisión, y todos sus descendientes
321 del repositorio. Deshace los efectos de las revisiones removidas del
322 repositorio, y actualiza el directorio de trabajo hasta el primer
323 padre de la revisión removida.
325 La orden \hgcmd{strip} almacena una copia de segurida de los conjuntos
326 de cambios en un agrupamiento, de forma tal que puedan ser reaplicados
327 en caso de que se hayan removido por equivocación.
329 Opciones:
330 \begin{itemize}
331 \item[\hgopt{strip}{-b}] Almacenar conjuntos de cambios no
332 relacionados que se han mezclado con los conjuntos de cambios que
333 están en franjas con el agrupamiento de copia de seguridad.
334 \item[\hgopt{strip}{-f}] Si una rama tiene varias ramas principales
335 remueve todos los frentes. XXX This should be renamed, y usa
336 \texttt{-f} para desagrupar revisiones cuando hay cambios pendientes.
337 \item[\hgopt{strip}{-n}] No almacene la copia de seguridad agrupada.
338 \end{itemize}
340 \section{Referencia de ficheros de MQ}
342 \subsection{El fichero \sfilename{series}}
344 El fichero \sfilename{series} contiene una lista de los nombres de
345 todos los parches que MQ puede aplicar. Se representa como una lista
346 de nombres, uno por línea. Se ignora el espacio en blanco al
347 principio y al final.
349 Las líneas pueden contener comentario. Un comentario comienza con el
350 caracter ``\texttt{\#}'', y va hasta el final de la línea. Se ignoran
351 las líneas vacías y las que solamente contengan comentarios.
353 En algún momento podría editar el fichero \sfilename{series} a mano,
354 por tal motivo se admiten comentarios y líneas en blanco como se
355 menciono anteriormente. Por ejemplo, puede poner en comentario un
356 parche temporalmente y \hgxcmd{mq}{qpush} omitirá tal parche cuando
357 los aplique. También puede cambiar el orden en el cual se aplican los
358 parches, reordenando las entradas en el fichero \sfilename{series}.
360 También es posible colocar el fichero \sfilename{series} bajo control
361 de revisiones; también es favorable colocar todos los parches que refiera
362 bajo control de revisiones. Si crea un directorio de parches con la
363 opción \hgxopt{mq}{qinit}{-c} de \hgxcmd{mq}{qinit}, esto se hará
364 automáticamente.
366 \subsection{El fichero \sfilename{status}}
368 El fichero \sfilename{status} contiene los nombres y los hashes de los
369 conjuntos de cambios de todos los parches que MQ ha aplicado. A
370 diferencia del fichero \sfilename{series}, este NO ha sido diseñado
371 para ser editado. No debería colocar este fichero bajo el control de
372 revisiones o modificarlo de forma alguna. MQ lo usa estrictamente
373 para administración interna.
375 %%% Local Variables:
376 %%% mode: latex
377 %%% TeX-master: "00book"
378 %%% End: