hgbook

diff es/undo.tex @ 387:7864f2264e28

translated some paragraphs of undo.tex
author Igor TAmara <igor@tamarapatino.org>
date Sun Nov 02 19:24:30 2008 -0500 (2008-11-02)
parents d2467817c934
children 9fdb45b994d4
line diff
     1.1 --- a/es/undo.tex	Sun Nov 02 14:23:01 2008 -0500
     1.2 +++ b/es/undo.tex	Sun Nov 02 19:24:30 2008 -0500
     1.3 @@ -208,100 +208,101 @@
     1.4  Si necesita que las modificaciones en el archivo destino del
     1.5  renombramiento se muestren, no olvide copiarlas encima.)
     1.6  
     1.7 -Estos aspectos engorrosos de revertir el renombramiento se constituyen
     1.8 +Estos aspectos engorrosos al revertir un renombramiento se constituyen
     1.9  discutiblemente en un fallo de Mercurial.
    1.10  
    1.11 -\section{Dealing with committed changes}
    1.12 -
    1.13 -Consider a case where you have committed a change $a$, and another
    1.14 -change $b$ on top of it; you then realise that change $a$ was
    1.15 -incorrect.  Mercurial lets you ``back out'' an entire changeset
    1.16 -automatically, and building blocks that let you reverse part of a
    1.17 -changeset by hand.
    1.18 -
    1.19 -Before you read this section, here's something to keep in mind: the
    1.20 -\hgcmd{backout} command undoes changes by \emph{adding} history, not
    1.21 -by modifying or erasing it.  It's the right tool to use if you're
    1.22 -fixing bugs, but not if you're trying to undo some change that has
    1.23 -catastrophic consequences.  To deal with those, see
    1.24 -section~\ref{sec:undo:aaaiiieee}.
    1.25 -
    1.26 -\subsection{Backing out a changeset}
    1.27 -
    1.28 -The \hgcmd{backout} command lets you ``undo'' the effects of an entire
    1.29 -changeset in an automated fashion.  Because Mercurial's history is
    1.30 -immutable, this command \emph{does not} get rid of the changeset you
    1.31 -want to undo.  Instead, it creates a new changeset that
    1.32 -\emph{reverses} the effect of the to-be-undone changeset.
    1.33 -
    1.34 -The operation of the \hgcmd{backout} command is a little intricate, so
    1.35 -let's illustrate it with some examples.  First, we'll create a
    1.36 -repository with some simple changes.
    1.37 +\section{Tratar cambios consignados}
    1.38 +
    1.39 +Considere un caso en el que ha consignado el cambio $a$, y otro cambio
    1.40 +$b$ sobre este; se ha dado cuenta que el cambio $a$ era
    1.41 +incorrecto. Mercurial le permite ``retroceder'' un conjunto de cambios
    1.42 +completo automáticamente, y construir bloques que le permitan revertir
    1.43 +parte de un conjunto de cambios a mano.
    1.44 +
    1.45 +Antes de leer esta sección, hay algo para tener en cuenta: la orden
    1.46 +\hgcmd{backout} deshace cambios \emph{adicionando} a la historia, sin
    1.47 +modificar o borrar.  Es la herramienta correcta si está arreglando
    1.48 +fallos, pero no si está tratando de deshacer algún cambio que tiene
    1.49 +consecuencias catastróficas.  Para tratar con esos, vea la sección~\ref{sec:undo:aaaiiieee}.
    1.50 +
    1.51 +\subsection{Retroceder un conjunto de cambios}
    1.52 +
    1.53 +La orden \hgcmd{backout} le permite ``deshacer'' los efectos de todo
    1.54 +un conjunto de cambios de forma automatizada.  Dado que la historia de
    1.55 +Mercurial es inmutable, esta orden \emph{no} se deshace del conjunto
    1.56 +de cambios que usted desea deshacer.  En cambio, crea un nuevo
    1.57 +conjunto de cambios que \emph{reversa} el conjunto de cambios que
    1.58 +usted indique.
    1.59 +
    1.60 +La operación de la orden \hgcmd{backout} es un poco intrincada, y lo
    1.61 +ilustraremos con algunos ejemplos. Primero crearemos un repositorio
    1.62 +con algunos cambios sencillos.
    1.63  \interaction{backout.init}
    1.64  
    1.65 -The \hgcmd{backout} command takes a single changeset ID as its
    1.66 -argument; this is the changeset to back out.  Normally,
    1.67 -\hgcmd{backout} will drop you into a text editor to write a commit
    1.68 -message, so you can record why you're backing the change out.  In this
    1.69 -example, we provide a commit message on the command line using the
    1.70 -\hgopt{backout}{-m} option.
    1.71 -
    1.72 -\subsection{Backing out the tip changeset}
    1.73 -
    1.74 -We're going to start by backing out the last changeset we committed.
    1.75 +La orden \hgcmd{backout} toma un ID de conjunto de cambios como su
    1.76 +argumento; el conjunto de cambios a retroceder. Normalmente
    1.77 +\hgcmd{backout} le ofrecerá un editor de texto para escribir el
    1.78 +mensaje de la consignación, para dejar un registro de por qué está
    1.79 +retrocediendo. En este ejemplo, colocamos un mensaje en la
    1.80 +consignación usando la opción \hgopt{backout}{-m} .
    1.81 +
    1.82 +\subsection{Retroceder el conjunto de cambios tip}
    1.83 +
    1.84 +Comenzamos retrocediendo el último conjunto de cambios que consignamos.
    1.85  \interaction{backout.simple}
    1.86 -You can see that the second line from \filename{myfile} is no longer
    1.87 -present.  Taking a look at the output of \hgcmd{log} gives us an idea
    1.88 -of what the \hgcmd{backout} command has done.
    1.89 +Puede ver que la segunda línea de \filename{myfile} ya no está
    1.90 +presente.  La salida de \hgcmd{log} nos da una idea de lo que la orden
    1.91 +\hgcmd{backout} ha hecho.
    1.92  \interaction{backout.simple.log}
    1.93 -Notice that the new changeset that \hgcmd{backout} has created is a
    1.94 -child of the changeset we backed out.  It's easier to see this in
    1.95 -figure~\ref{fig:undo:backout}, which presents a graphical view of the
    1.96 -change history.  As you can see, the history is nice and linear.
    1.97 +Vea que el nuevo conjunto de cambios que \hgcmd{backout} ha creado es
    1.98 +un hijo del conjunto de cambios que retrocedimos. Es más sencillo de
    1.99 +ver en la figura~\ref{fig:undo:backout}, que presenta una vista
   1.100 +gráfica de la historia de cambios.  Como puede ver, la historia es
   1.101 +bonita y lineal.
   1.102  
   1.103  \begin{figure}[htb]
   1.104    \centering
   1.105    \grafix{undo-simple}
   1.106 -  \caption{Backing out a change using the \hgcmd{backout} command}
   1.107 +  \caption{Retroceso de un cambio con la orden \hgcmd{backout}}
   1.108    \label{fig:undo:backout}
   1.109  \end{figure}
   1.110  
   1.111 -\subsection{Backing out a non-tip change}
   1.112 -
   1.113 -If you want to back out a change other than the last one you
   1.114 -committed, pass the \hgopt{backout}{--merge} option to the
   1.115 -\hgcmd{backout} command.
   1.116 +\subsection{Retroceso de un cambio que no es tip}
   1.117 +
   1.118 +Si desea retrocede un cambio distinto al último que ha consignado, use
   1.119 +la opción \hgopt{backout}{--merge} a la orden \hgcmd{backout}.
   1.120  \interaction{backout.non-tip.clone}
   1.121 -This makes backing out any changeset a ``one-shot'' operation that's
   1.122 -usually simple and fast.
   1.123 +Que resulta en un retroceso de un conjunto de cambios ``en un sólo
   1.124 +tiro'', una operación que resulta normalmente rápida y sencilla.
   1.125  \interaction{backout.non-tip.backout}
   1.126  
   1.127 -If you take a look at the contents of \filename{myfile} after the
   1.128 -backout finishes, you'll see that the first and third changes are
   1.129 -present, but not the second.
   1.130 +Si ve los contenidos del fichero \filename{myfile} después de
   1.131 +finalizar el retroceso, verá que el primer y el tercer cambio están
   1.132 +presentes, pero no el segundo.
   1.133  \interaction{backout.non-tip.cat}
   1.134  
   1.135 -As the graphical history in figure~\ref{fig:undo:backout-non-tip}
   1.136 -illustrates, Mercurial actually commits \emph{two} changes in this
   1.137 -kind of situation (the box-shaped nodes are the ones that Mercurial
   1.138 -commits automatically).  Before Mercurial begins the backout process,
   1.139 -it first remembers what the current parent of the working directory
   1.140 -is.  It then backs out the target changeset, and commits that as a
   1.141 -changeset.  Finally, it merges back to the previous parent of the
   1.142 -working directory, and commits the result of the merge.
   1.143 +Como lo muestra la historia gráfica en la
   1.144 +figura~\ref{fig:undo:backout-non-tip}, Mercurial realmente consigna
   1.145 +\emph{dos} cambios en estas situaciones (los nodos encerrados en una
   1.146 +caja son aquellos que Mercurial consigna automaticamente).  Antes de
   1.147 +que Mercurial comience el proceso de retroceso, primero recuerda cuál
   1.148 +es el padre del directorio de trabajo.  Posteriormente hace un
   1.149 +retroceso al conjunto de cambios objetivo y lo consigna como un
   1.150 +conjunto de cambios. Finalmente, fusiona con el padre anterior del
   1.151 +directorio de trabajo, y consigna el resultado de la fusión.
   1.152  
   1.153  % TODO: to me it looks like mercurial doesn't commit the second merge automatically!
   1.154  
   1.155  \begin{figure}[htb]
   1.156    \centering
   1.157    \grafix{undo-non-tip}
   1.158 -  \caption{Automated backout of a non-tip change using the \hgcmd{backout} command}
   1.159 +  \caption{Retroceso automatizado de un cambio a algo que no es tip con la orden \hgcmd{backout}}
   1.160    \label{fig:undo:backout-non-tip}
   1.161  \end{figure}
   1.162  
   1.163 -The result is that you end up ``back where you were'', only with some
   1.164 -extra history that undoes the effect of the changeset you wanted to
   1.165 -back out.
   1.166 +El resultado es que usted termina ``donde estaba'', solamente con un
   1.167 +poco de historia adicional que deshace el efecto de un conjunto de
   1.168 +cambios que usted quería evitar.
   1.169  
   1.170  \subsubsection{Always use the \hgopt{backout}{--merge} option}
   1.171