hgbook

changeset 420:0774efad9003

translated up to section 4.4.1 (included). updated the project status file
author Javier Rojas <jerojasro@devnull.li>
date Sat Nov 15 20:04:33 2008 -0500 (2008-11-15)
parents 7f5d542be96b
children 93bd78a98b78
files es/Leame.1st es/concepts.tex
line diff
     1.1 --- a/es/Leame.1st	Fri Nov 14 00:12:51 2008 -0500
     1.2 +++ b/es/Leame.1st	Sat Nov 15 20:04:33 2008 -0500
     1.3 @@ -101,7 +101,7 @@
     1.4  || tour-basic.tex  || Javier Rojas  ||    100%    || 19/10/2008 ||  27/10/2008 ||
     1.5  || undo.tex        || Igor Támara   ||    100%    || 26/10/2008 ||  07/11/2008 ||
     1.6  || tour-merge.tex  || Javier Rojas  ||    100%    || 28/10/2008 ||  03/11/2008 ||
     1.7 -|| concepts.tex    || Javier Rojas  ||     32%    || 03/11/2008 ||             ||
     1.8 +|| concepts.tex    || Javier Rojas  ||     55%    || 03/11/2008 ||             ||
     1.9  || intro.tex	   || Igor Támara   ||	  100%	  || 08/11/2008	||  09/11/2008 ||
    1.10  || collab.tex      || Igor Támara   ||     39%    || 10/11/2008 ||             ||
    1.11  
     2.1 --- a/es/concepts.tex	Fri Nov 14 00:12:51 2008 -0500
     2.2 +++ b/es/concepts.tex	Sat Nov 15 20:04:33 2008 -0500
     2.3 @@ -261,72 +261,83 @@
     2.4    \label{fig:concepts:revlog}
     2.5  \end{figure}
     2.6  
     2.7 -\section{The working directory}
     2.8 -
     2.9 -In the working directory, Mercurial stores a snapshot of the files
    2.10 -from the repository as of a particular changeset.
    2.11 -
    2.12 -The working directory ``knows'' which changeset it contains.  When you
    2.13 -update the working directory to contain a particular changeset,
    2.14 -Mercurial looks up the appropriate revision of the manifest to find
    2.15 -out which files it was tracking at the time that changeset was
    2.16 -committed, and which revision of each file was then current.  It then
    2.17 -recreates a copy of each of those files, with the same contents it had
    2.18 -when the changeset was committed.
    2.19 -
    2.20 -The \emph{dirstate} contains Mercurial's knowledge of the working
    2.21 -directory.  This details which changeset the working directory is
    2.22 -updated to, and all of the files that Mercurial is tracking in the
    2.23 -working directory.
    2.24 -
    2.25 -Just as a revision of a revlog has room for two parents, so that it
    2.26 -can represent either a normal revision (with one parent) or a merge of
    2.27 -two earlier revisions, the dirstate has slots for two parents.  When
    2.28 -you use the \hgcmd{update} command, the changeset that you update to
    2.29 -is stored in the ``first parent'' slot, and the null ID in the second.
    2.30 -When you \hgcmd{merge} with another changeset, the first parent
    2.31 -remains unchanged, and the second parent is filled in with the
    2.32 -changeset you're merging with.  The \hgcmd{parents} command tells you
    2.33 -what the parents of the dirstate are.
    2.34 -
    2.35 -\subsection{What happens when you commit}
    2.36 -
    2.37 -The dirstate stores parent information for more than just book-keeping
    2.38 -purposes.  Mercurial uses the parents of the dirstate as \emph{the
    2.39 -  parents of a new changeset} when you perform a commit.
    2.40 +\section{El directorio de trabajo}
    2.41 +
    2.42 +% TODO revisar párrafo, no me convence la traducción
    2.43 +En el directorio de trabajo, Mercurial almacena una instantánea de los
    2.44 +ficheros  del repositorio como si fueran los de un conjunto de cambios
    2.45 +particular.
    2.46 +
    2.47 +El directorio de trabajo ``sabe'' qué conjunto de cambios contiene.
    2.48 +Cuando usted actualiza el directorio de trabajo para que contenga un
    2.49 +conjunto de cambios particular, Mercurial busca la revisión adecuada
    2.50 +del manifiesto para averiguar qué ficheros estaba monitoreando cuando
    2.51 +se hizo la consignación del conjunto de cambios, y qué revisión de
    2.52 +cada fichero era la actual en ese momento. Luego de eso, recrea una
    2.53 +copia de cada uno de esos ficheros, con los mismos contenidos que
    2.54 +tenían cuando fue consignado el conjunto de cambios.
    2.55 +
    2.56 +El \emph{estado de directorio}\ndt{dirstate, en inglés en el
    2.57 +original.} contiene el conocimiento de Mercurial acerca del directorio
    2.58 +de trabajo. Allí se detalla a qué conjunto de cambios es actualizado
    2.59 +el directorio de trabajo, y todos los ficheros que Mercurial está
    2.60 +monitoreando en este directorio.
    2.61 +
    2.62 +Tal como la revisión de un revlog tiene espacio para dos padres, para
    2.63 +que pueda representar tanto una revisión normal (con un solo padre) o
    2.64 +una fusión de dos revisiones anteriores, el estado de directorio tiene
    2.65 +espacio para dos padres. Cuando usted usa el comando \hgcmd{update},
    2.66 +el conjunto de cambios al que usted se actualiza es almacenado en la
    2.67 +casilla destinada al ``primer padre'', y un ID nulo es almacenado en
    2.68 +la segunda. Cuando usted hace una fusión (\hgcmd{merge}) con otro
    2.69 +conjunto de cambios, la casilla para el primer padre permanece sin
    2.70 +cambios, y la casilla para el segundo es actualizada con el conjunto
    2.71 +de cambios con el que usted acaba de hacer la fusión. El comando
    2.72 +\hgcmd{parents} le indica cuáles son los padres del estado de
    2.73 +directorio.
    2.74 +
    2.75 +\subsection{Qué pasa en una consignación}
    2.76 +
    2.77 +El estado de directorio almacena información sobre los padres para
    2.78 +algo más que mero registro. Mercurial usa los padres del estado de
    2.79 +directorio como \emph{los padres de un nuevo conjunto de cambios}
    2.80 +cuando usted hace una consignación.
    2.81  
    2.82  \begin{figure}[ht]
    2.83    \centering
    2.84    \grafix{wdir}
    2.85 -  \caption{The working directory can have two parents}
    2.86 +  \caption{El directorio de trabajo puede tener dos padres}
    2.87    \label{fig:concepts:wdir}
    2.88  \end{figure}
    2.89  
    2.90 -Figure~\ref{fig:concepts:wdir} shows the normal state of the working
    2.91 -directory, where it has a single changeset as parent.  That changeset
    2.92 -is the \emph{tip}, the newest changeset in the repository that has no
    2.93 -children.
    2.94 +La figura~\ref{fig:concepts:wdir} muestra el estado normal del
    2.95 +directorio de trabajo, que tiene un único conjunto de cambios como
    2.96 +padre. Dicho conjunto de cambios es la \emph{punta}, el conjunto de
    2.97 +cambios más reciente en el repositorio que no tiene hijos.
    2.98  
    2.99  \begin{figure}[ht]
   2.100    \centering
   2.101    \grafix{wdir-after-commit}
   2.102 -  \caption{The working directory gains new parents after a commit}
   2.103 +  \caption{El directorio de trabajo obtiene nuevos padres luego de una
   2.104 +  consignación}
   2.105    \label{fig:concepts:wdir-after-commit}
   2.106  \end{figure}
   2.107  
   2.108 -It's useful to think of the working directory as ``the changeset I'm
   2.109 -about to commit''.  Any files that you tell Mercurial that you've
   2.110 -added, removed, renamed, or copied will be reflected in that
   2.111 -changeset, as will modifications to any files that Mercurial is
   2.112 -already tracking; the new changeset will have the parents of the
   2.113 -working directory as its parents.
   2.114 -
   2.115 -After a commit, Mercurial will update the parents of the working
   2.116 -directory, so that the first parent is the ID of the new changeset,
   2.117 -and the second is the null ID.  This is shown in
   2.118 -figure~\ref{fig:concepts:wdir-after-commit}.  Mercurial doesn't touch
   2.119 -any of the files in the working directory when you commit; it just
   2.120 -modifies the dirstate to note its new parents.
   2.121 +Es útil pensar en el directorio de trabajo como en ``el conjunto de
   2.122 +cambios que estoy a punto de enviar''. Cualquier fichero que usted le
   2.123 +diga a Mercurial que fue añadido, borrado, renombrado o copiado, se
   2.124 +verá reflejado en ese conjunto de cambios, como también se verán las
   2.125 +modificaciones a cualquiera de los ficheros que Mercurial ya esté
   2.126 +monitoreando; el nuevo conjunto de cambios dentrá los padres del
   2.127 +directorio de trabajo como propios.
   2.128 +
   2.129 +Luego de una consignación, Mercurial actualizará los padres del
   2.130 +directorio de trabajo, de tal manera que el primer padre sea el ID del
   2.131 +nuevo conjunto de cambios, y el segundo sea el ID nulo. Esto puede
   2.132 +verse en la figura~\ref{fig:concepts:wdir-after-commit}.  Mercurial no
   2.133 +toca ninguno de los ficheros del directorio de trabajo cuando usted
   2.134 +hace la consignación; sólo modifica el estado de directorio para
   2.135 +anotar sus nuevos padres.
   2.136  
   2.137  \subsection{Creating a new head}
   2.138