hgbook

changeset 492:b7b6a085056e

merged ikks' changes
author Javier Rojas <jerojasro@devnull.li>
date Wed Jan 07 22:27:30 2009 -0500 (2009-01-07)
parents 795f2964e104 419853691d11
children 26fb9b724588 f89480678965
files
line diff
     1.1 --- a/es/Leame.1st	Wed Jan 07 22:26:07 2009 -0500
     1.2 +++ b/es/Leame.1st	Wed Jan 07 22:27:30 2009 -0500
     1.3 @@ -110,7 +110,7 @@
     1.4  || hgext.tex       || Igor Támara   ||    100%    || 13/12/2008 ||  16/12/2008 ||
     1.5  || template.tex    || Igor Támara   ||    100%    || 27/12/2008 ||  01/01/2009 ||
     1.6  || mq-collab.tex   || Javier Rojas  ||     20%    || 04/01/2009 ||             ||
     1.7 -|| mq-ref.tex      ||               ||            ||            ||             ||
     1.8 +|| mq-ref.tex      || Igor Támara   ||     30%    || 06/01/2009 ||             ||
     1.9  || cmdref.tex      || Igor Támara   ||    100%    || 01/01/2009 ||  01/01/2009 ||
    1.10  || license.tex     || Igor Támara   ||    100%    || 16/12/2008 ||  16/12/2008 ||
    1.11  || srcinstall.tex  || Igor Támara   ||    100%    || 01/01/2009 ||  01/01/2009 ||
     2.1 --- a/es/mq-ref.tex	Wed Jan 07 22:26:07 2009 -0500
     2.2 +++ b/es/mq-ref.tex	Wed Jan 07 22:27:30 2009 -0500
     2.3 @@ -1,129 +1,140 @@
     2.4 -\chapter{Mercurial Queues reference}
     2.5 +\chapter{Referencia de las Colas de Mercurial}
     2.6  \label{chap:mqref}
     2.7  
     2.8 -\section{MQ command reference}
     2.9 +\section{Referencia de órdenes MQ}
    2.10  \label{sec:mqref:cmdref}
    2.11  
    2.12 -For an overview of the commands provided by MQ, use the command
    2.13 +Si desea dar un vistazo a las órdenes que ofrece MQ, use la orden
    2.14  \hgcmdargs{help}{mq}.
    2.15  
    2.16 -\subsection{\hgxcmd{mq}{qapplied}---print applied patches}
    2.17 -
    2.18 -The \hgxcmd{mq}{qapplied} command prints the current stack of applied
    2.19 -patches.  Patches are printed in oldest-to-newest order, so the last
    2.20 -patch in the list is the ``top'' patch.
    2.21 -
    2.22 -\subsection{\hgxcmd{mq}{qcommit}---commit changes in the queue repository}
    2.23 -
    2.24 -The \hgxcmd{mq}{qcommit} command commits any outstanding changes in the
    2.25 -\sdirname{.hg/patches} repository.  This command only works if the
    2.26 -\sdirname{.hg/patches} directory is a repository, i.e.~you created the
    2.27 -directory using \hgcmdargs{qinit}{\hgxopt{mq}{qinit}{-c}} or ran
    2.28 -\hgcmd{init} in the directory after running \hgxcmd{mq}{qinit}.
    2.29 -
    2.30 -This command is shorthand for \hgcmdargs{commit}{--cwd .hg/patches}.
    2.31 -
    2.32 -\subsection{\hgxcmd{mq}{qdelete}---delete a patch from the
    2.33 -  \sfilename{series} file}
    2.34 -
    2.35 -The \hgxcmd{mq}{qdelete} command removes the entry for a patch from the
    2.36 -\sfilename{series} file in the \sdirname{.hg/patches} directory.  It
    2.37 -does not pop the patch if the patch is already applied.  By default,
    2.38 -it does not delete the patch file; use the \hgxopt{mq}{qdel}{-f} option to
    2.39 -do that.
    2.40 -
    2.41 -Options:
    2.42 -\begin{itemize}
    2.43 -\item[\hgxopt{mq}{qdel}{-f}] Delete the patch file.
    2.44 -\end{itemize}
    2.45 -
    2.46 -\subsection{\hgxcmd{mq}{qdiff}---print a diff of the topmost applied patch}
    2.47 -
    2.48 -The \hgxcmd{mq}{qdiff} command prints a diff of the topmost applied patch.
    2.49 -It is equivalent to \hgcmdargs{diff}{-r-2:-1}.
    2.50 -
    2.51 -\subsection{\hgxcmd{mq}{qfold}---merge (``fold'') several patches into one}
    2.52 -
    2.53 -The \hgxcmd{mq}{qfold} command merges multiple patches into the topmost
    2.54 -applied patch, so that the topmost applied patch makes the union of
    2.55 -all of the changes in the patches in question.
    2.56 -
    2.57 -The patches to fold must not be applied; \hgxcmd{mq}{qfold} will exit with
    2.58 -an error if any is.  The order in which patches are folded is
    2.59 -significant; \hgcmdargs{qfold}{a b} means ``apply the current topmost
    2.60 -patch, followed by \texttt{a}, followed by \texttt{b}''.
    2.61 -
    2.62 -The comments from the folded patches are appended to the comments of
    2.63 -the destination patch, with each block of comments separated by three
    2.64 -asterisk (``\texttt{*}'') characters.  Use the \hgxopt{mq}{qfold}{-e}
    2.65 -option to edit the commit message for the combined patch/changeset
    2.66 -after the folding has completed.
    2.67 -
    2.68 -Options:
    2.69 -\begin{itemize}
    2.70 -\item[\hgxopt{mq}{qfold}{-e}] Edit the commit message and patch description
    2.71 -  for the newly folded patch.
    2.72 -\item[\hgxopt{mq}{qfold}{-l}] Use the contents of the given file as the new
    2.73 -  commit message and patch description for the folded patch.
    2.74 -\item[\hgxopt{mq}{qfold}{-m}] Use the given text as the new commit message
    2.75 -  and patch description for the folded patch.
    2.76 -\end{itemize}
    2.77 -
    2.78 -\subsection{\hgxcmd{mq}{qheader}---display the header/description of a patch}
    2.79 -
    2.80 -The \hgxcmd{mq}{qheader} command prints the header, or description, of a
    2.81 -patch.  By default, it prints the header of the topmost applied patch.
    2.82 -Given an argument, it prints the header of the named patch.
    2.83 -
    2.84 -\subsection{\hgxcmd{mq}{qimport}---import a third-party patch into the queue}
    2.85 -
    2.86 -The \hgxcmd{mq}{qimport} command adds an entry for an external patch to the
    2.87 -\sfilename{series} file, and copies the patch into the
    2.88 -\sdirname{.hg/patches} directory.  It adds the entry immediately after
    2.89 -the topmost applied patch, but does not push the patch.
    2.90 -
    2.91 -If the \sdirname{.hg/patches} directory is a repository,
    2.92 -\hgxcmd{mq}{qimport} automatically does an \hgcmd{add} of the imported
    2.93 -patch.
    2.94 -
    2.95 -\subsection{\hgxcmd{mq}{qinit}---prepare a repository to work with MQ}
    2.96 -
    2.97 -The \hgxcmd{mq}{qinit} command prepares a repository to work with MQ.  It
    2.98 -creates a directory called \sdirname{.hg/patches}.
    2.99 -
   2.100 -Options:
   2.101 -\begin{itemize}
   2.102 -\item[\hgxopt{mq}{qinit}{-c}] Create \sdirname{.hg/patches} as a repository
   2.103 -  in its own right.  Also creates a \sfilename{.hgignore} file that
   2.104 -  will ignore the \sfilename{status} file.
   2.105 -\end{itemize}
   2.106 -
   2.107 -When the \sdirname{.hg/patches} directory is a repository, the
   2.108 -\hgxcmd{mq}{qimport} and \hgxcmd{mq}{qnew} commands automatically \hgcmd{add}
   2.109 -new patches.
   2.110 -
   2.111 -\subsection{\hgxcmd{mq}{qnew}---create a new patch}
   2.112 -
   2.113 -The \hgxcmd{mq}{qnew} command creates a new patch.  It takes one mandatory
   2.114 -argument, the name to use for the patch file.  The newly created patch
   2.115 -is created empty by default.  It is added to the \sfilename{series}
   2.116 -file after the current topmost applied patch, and is immediately
   2.117 -pushed on top of that patch.
   2.118 -
   2.119 -If \hgxcmd{mq}{qnew} finds modified files in the working directory, it will
   2.120 -refuse to create a new patch unless the \hgxopt{mq}{qnew}{-f} option is
   2.121 -used (see below).  This behaviour allows you to \hgxcmd{mq}{qrefresh} your
   2.122 -topmost applied patch before you apply a new patch on top of it.
   2.123 -
   2.124 -Options:
   2.125 -\begin{itemize}
   2.126 -\item[\hgxopt{mq}{qnew}{-f}] Create a new patch if the contents of the
   2.127 -  working directory are modified.  Any outstanding modifications are
   2.128 -  added to the newly created patch, so after this command completes,
   2.129 -  the working directory will no longer be modified.
   2.130 -\item[\hgxopt{mq}{qnew}{-m}] Use the given text as the commit message.
   2.131 -  This text will be stored at the beginning of the patch file, before
   2.132 -  the patch data.
   2.133 +\subsection{\hgxcmd{mq}{qapplied}---imprimir los parches aplicados}
   2.134 +
   2.135 +La orden \hgxcmd{mq}{qapplied} imprime la pila actual de parches
   2.136 +aplicados.  Los parches se imprimen en orden de antigüedad, primero
   2.137 +los más antiguos y después los más recientes, por lo tanto el último
   2.138 +parche de la lista es el que está en el ``tope''.
   2.139 +
   2.140 +\subsection{\hgxcmd{mq}{qcommit}---consignar cambios en la cola del repositorio}
   2.141 +
   2.142 +La orden \hgxcmd{mq}{qcommit} consigna cualquier cambio sobresaliente
   2.143 +en el repositorio \sdirname{.hg/patches}.  Esta orden solamente
   2.144 +funciona si el directorio \sdirname{.hg/patches} es un repositorio,
   2.145 +p.e.~usted creó el directorio con
   2.146 +\hgcmdargs{qinit}{\hgxopt{mq}{qinit}{-c}} o ejecutó
   2.147 +\hgcmd{init} en el directorio después de correr \hgxcmd{mq}{qinit}.
   2.148 +
   2.149 +Esta orden es un atajo para \hgcmdargs{commit}{--cwd .hg/patches}.
   2.150 +
   2.151 +\subsection{\hgxcmd{mq}{qdelete}---eliminar un parche del fichero
   2.152 +  \sfilename{series}}
   2.153 +
   2.154 +La orden \hgxcmd{mq}{qdelete} elimina la entrada del fichero
   2.155 +\sfilename{series} para el parche en el directorio
   2.156 +\sdirname{.hg/patches}.  No sca el parche si ha sido aplicado.  De
   2.157 +forma predeterminada no borra el fichero del parche; use la opción
   2.158 +\hgxopt{mq}{qdel}{-f} para hacerlo.
   2.159 +
   2.160 +Opciones:
   2.161 +\begin{itemize}
   2.162 +\item[\hgxopt{mq}{qdel}{-f}] Elimina el fichero del parche.
   2.163 +\end{itemize}
   2.164 +
   2.165 +\subsection{\hgxcmd{mq}{qdiff}---imprimir la diferencia del último
   2.166 +  parche aplicado}
   2.167 +
   2.168 +La orden \hgxcmd{mq}{qdiff} imprime un diff del parche más
   2.169 +recientemente aplicado.  Es equivalente a \hgcmdargs{diff}{-r-2:-1}.
   2.170 +
   2.171 +\subsection{\hgxcmd{mq}{qfold}---fusionar (``integrar'') varios parches en
   2.172 +  uno solo}
   2.173 +
   2.174 +La orden \hgxcmd{mq}{qfold} fusiona muchos parches en el último parche
   2.175 +aplicado, de tal forma que el último parche aplicado es la unión de
   2.176 +todos los cambios de los parches en cuestión.
   2.177 +
   2.178 +Los parches a fusionar no deben haber sido aplicados;
   2.179 +\hgxcmd{mq}{qfold} saldrá indicando un error si alguno ha sido
   2.180 +aplicado.  El orden en el cual los parches se pliegan es
   2.181 +significativo; \hgcmdargs{qfold}{a b} significa ``aplique el parche
   2.182 +más reciente, seguido de \texttt{a}, y seguido de \texttt{b}''.
   2.183 +
   2.184 +Los comentarios de los parches integrados se colocan al final de los
   2.185 +comentarios del parche destino, con cada bloque de comentarios
   2.186 +separado con tres asteriscos(``\texttt{*}'').  Se usa la opción
   2.187 +\hgxopt{mq}{qfold}{-e} para editar el mensaje de consignación para el
   2.188 +conjunto de cambios/parches después de completarse el pliegue.
   2.189 +
   2.190 +Opciones:
   2.191 +\begin{itemize}
   2.192 +\item[\hgxopt{mq}{qfold}{-e}] Edita el mensaje de consignación y la
   2.193 +  descripción del parche del parche que se ha integrado.
   2.194 +\item[\hgxopt{mq}{qfold}{-l}] Usa los contenidos del fichero dado como
   2.195 +  el nuevo mensaje de consignación y descripción del parche para el
   2.196 +  parche a integrar.
   2.197 +\item[\hgxopt{mq}{qfold}{-m}] Usa el texto dado como el mensaje de
   2.198 +  consignación y descripción del parche para el parche integrado.
   2.199 +\end{itemize}
   2.200 +
   2.201 +\subsection{\hgxcmd{mq}{qheader}---desplegar el encabezado/descripción
   2.202 +  de un parche}
   2.203 +
   2.204 +La orden \hgxcmd{mq}{qheader} imprime el encabezado o descripción de
   2.205 +un parche.  De forma predeterminada, imprime el encabezado del último
   2.206 +parche aplicado. Si se da un argumento, imprime el encabezado del
   2.207 +parche referenciado.
   2.208 +
   2.209 +\subsection{\hgxcmd{mq}{qimport}---importar el parche de un tercero en
   2.210 +  la cola}
   2.211 +
   2.212 +La orden \hgxcmd{mq}{qimport} añade una entrada de un parche externo
   2.213 +al fichero \sfilename{series} y copia el parche en el directorio
   2.214 +\sdirname{.hg/patches}.  Añade la entrada inmediatamente después del
   2.215 +último parche aplicado, pero no introduce el parche.
   2.216 +
   2.217 +Si el directorio \sdirname{.hg/patches} es un repositorio, 
   2.218 +\hgxcmd{mq}{qimport} automáticamente hace un \hgcmd{add} del parche
   2.219 +importado.
   2.220 +
   2.221 +\subsection{\hgxcmd{mq}{qinit}---preparar un repositorio para trabajar
   2.222 +  con MQ}
   2.223 +
   2.224 +La orden \hgxcmd{mq}{qinit} prepara un repositorio para trabajar con
   2.225 +MQ.  Crea un directorio llamado \sdirname{.hg/patches}.
   2.226 +
   2.227 +Opciones:
   2.228 +\begin{itemize}
   2.229 +\item[\hgxopt{mq}{qinit}{-c}] Crea \sdirname{.hg/patches} como un
   2.230 +  repositorio por sí mismo.  También crea un fichero
   2.231 +  \sfilename{.hgignore} que ignorará el fichero \sfilename{status}.
   2.232 +\end{itemize}
   2.233 +
   2.234 +Cuando el directorio \sdirname{.hg/patches} es un repositorio, las órdenes
   2.235 +\hgxcmd{mq}{qimport} y \hgxcmd{mq}{qnew} hacen \hgcmd{add}
   2.236 +automáticamente a los parches nuevos.
   2.237 +
   2.238 +\subsection{\hgxcmd{mq}{qnew}---crear un parche nuevo}
   2.239 +
   2.240 +La orden \hgxcmd{mq}{qnew} crea un parche nuevo.  Exige un argumento,
   2.241 +el nombre que se usará para tal parche.  El parche recién creado está
   2.242 +vacío inicialmente.   Se añade al fichero \sfilename{series} después
   2.243 +del último parche aplicado, y se introduce en el tope de ese parche.
   2.244 +
   2.245 +Si \hgxcmd{mq}{qnew} encuentra ficheros modificados en el directorio
   2.246 +de trabajo, rehusará crear un parche nuevo a meos que se emplee
   2.247 +\hgxopt{mq}{qnew}{-f} la opción(ver más adelante).  Este
   2.248 +comportamiento le permite hacer \hgxcmd{mq}{qrefresh} al último parche
   2.249 +aplicado antes de aplicar un parche nuevo encima de este.
   2.250 +
   2.251 +Opciones:
   2.252 +\begin{itemize}
   2.253 +\item[\hgxopt{mq}{qnew}{-f}] Crea un parche nuevo si los contenidos
   2.254 +  del directorio actual han sido modificados.  Cualquier modificación
   2.255 +  significativa se añade al parche recientemente creado,  de tal forma
   2.256 +  que al finalizar la orden, el directorio de trabajo no lucirá
   2.257 +  modificado.
   2.258 +\item[\hgxopt{mq}{qnew}{-m}] Usa el texto dado como el mensaje de
   2.259 +  consignación.  Este texto se almacenará al principio del fichero del
   2.260 +  parche, antes de los datos del parche.
   2.261  \end{itemize}
   2.262  
   2.263  \subsection{\hgxcmd{mq}{qnext}---print the name of the next patch}