hgbook

diff es/concepts.tex @ 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 bc2136732cd6
children 59fbfb7e790c
line diff
     1.1 --- a/es/concepts.tex	Fri Nov 14 00:09:26 2008 -0500
     1.2 +++ b/es/concepts.tex	Sat Nov 15 20:04:33 2008 -0500
     1.3 @@ -261,72 +261,83 @@
     1.4    \label{fig:concepts:revlog}
     1.5  \end{figure}
     1.6  
     1.7 -\section{The working directory}
     1.8 -
     1.9 -In the working directory, Mercurial stores a snapshot of the files
    1.10 -from the repository as of a particular changeset.
    1.11 -
    1.12 -The working directory ``knows'' which changeset it contains.  When you
    1.13 -update the working directory to contain a particular changeset,
    1.14 -Mercurial looks up the appropriate revision of the manifest to find
    1.15 -out which files it was tracking at the time that changeset was
    1.16 -committed, and which revision of each file was then current.  It then
    1.17 -recreates a copy of each of those files, with the same contents it had
    1.18 -when the changeset was committed.
    1.19 -
    1.20 -The \emph{dirstate} contains Mercurial's knowledge of the working
    1.21 -directory.  This details which changeset the working directory is
    1.22 -updated to, and all of the files that Mercurial is tracking in the
    1.23 -working directory.
    1.24 -
    1.25 -Just as a revision of a revlog has room for two parents, so that it
    1.26 -can represent either a normal revision (with one parent) or a merge of
    1.27 -two earlier revisions, the dirstate has slots for two parents.  When
    1.28 -you use the \hgcmd{update} command, the changeset that you update to
    1.29 -is stored in the ``first parent'' slot, and the null ID in the second.
    1.30 -When you \hgcmd{merge} with another changeset, the first parent
    1.31 -remains unchanged, and the second parent is filled in with the
    1.32 -changeset you're merging with.  The \hgcmd{parents} command tells you
    1.33 -what the parents of the dirstate are.
    1.34 -
    1.35 -\subsection{What happens when you commit}
    1.36 -
    1.37 -The dirstate stores parent information for more than just book-keeping
    1.38 -purposes.  Mercurial uses the parents of the dirstate as \emph{the
    1.39 -  parents of a new changeset} when you perform a commit.
    1.40 +\section{El directorio de trabajo}
    1.41 +
    1.42 +% TODO revisar párrafo, no me convence la traducción
    1.43 +En el directorio de trabajo, Mercurial almacena una instantánea de los
    1.44 +ficheros  del repositorio como si fueran los de un conjunto de cambios
    1.45 +particular.
    1.46 +
    1.47 +El directorio de trabajo ``sabe'' qué conjunto de cambios contiene.
    1.48 +Cuando usted actualiza el directorio de trabajo para que contenga un
    1.49 +conjunto de cambios particular, Mercurial busca la revisión adecuada
    1.50 +del manifiesto para averiguar qué ficheros estaba monitoreando cuando
    1.51 +se hizo la consignación del conjunto de cambios, y qué revisión de
    1.52 +cada fichero era la actual en ese momento. Luego de eso, recrea una
    1.53 +copia de cada uno de esos ficheros, con los mismos contenidos que
    1.54 +tenían cuando fue consignado el conjunto de cambios.
    1.55 +
    1.56 +El \emph{estado de directorio}\ndt{dirstate, en inglés en el
    1.57 +original.} contiene el conocimiento de Mercurial acerca del directorio
    1.58 +de trabajo. Allí se detalla a qué conjunto de cambios es actualizado
    1.59 +el directorio de trabajo, y todos los ficheros que Mercurial está
    1.60 +monitoreando en este directorio.
    1.61 +
    1.62 +Tal como la revisión de un revlog tiene espacio para dos padres, para
    1.63 +que pueda representar tanto una revisión normal (con un solo padre) o
    1.64 +una fusión de dos revisiones anteriores, el estado de directorio tiene
    1.65 +espacio para dos padres. Cuando usted usa el comando \hgcmd{update},
    1.66 +el conjunto de cambios al que usted se actualiza es almacenado en la
    1.67 +casilla destinada al ``primer padre'', y un ID nulo es almacenado en
    1.68 +la segunda. Cuando usted hace una fusión (\hgcmd{merge}) con otro
    1.69 +conjunto de cambios, la casilla para el primer padre permanece sin
    1.70 +cambios, y la casilla para el segundo es actualizada con el conjunto
    1.71 +de cambios con el que usted acaba de hacer la fusión. El comando
    1.72 +\hgcmd{parents} le indica cuáles son los padres del estado de
    1.73 +directorio.
    1.74 +
    1.75 +\subsection{Qué pasa en una consignación}
    1.76 +
    1.77 +El estado de directorio almacena información sobre los padres para
    1.78 +algo más que mero registro. Mercurial usa los padres del estado de
    1.79 +directorio como \emph{los padres de un nuevo conjunto de cambios}
    1.80 +cuando usted hace una consignación.
    1.81  
    1.82  \begin{figure}[ht]
    1.83    \centering
    1.84    \grafix{wdir}
    1.85 -  \caption{The working directory can have two parents}
    1.86 +  \caption{El directorio de trabajo puede tener dos padres}
    1.87    \label{fig:concepts:wdir}
    1.88  \end{figure}
    1.89  
    1.90 -Figure~\ref{fig:concepts:wdir} shows the normal state of the working
    1.91 -directory, where it has a single changeset as parent.  That changeset
    1.92 -is the \emph{tip}, the newest changeset in the repository that has no
    1.93 -children.
    1.94 +La figura~\ref{fig:concepts:wdir} muestra el estado normal del
    1.95 +directorio de trabajo, que tiene un único conjunto de cambios como
    1.96 +padre. Dicho conjunto de cambios es la \emph{punta}, el conjunto de
    1.97 +cambios más reciente en el repositorio que no tiene hijos.
    1.98  
    1.99  \begin{figure}[ht]
   1.100    \centering
   1.101    \grafix{wdir-after-commit}
   1.102 -  \caption{The working directory gains new parents after a commit}
   1.103 +  \caption{El directorio de trabajo obtiene nuevos padres luego de una
   1.104 +  consignación}
   1.105    \label{fig:concepts:wdir-after-commit}
   1.106  \end{figure}
   1.107  
   1.108 -It's useful to think of the working directory as ``the changeset I'm
   1.109 -about to commit''.  Any files that you tell Mercurial that you've
   1.110 -added, removed, renamed, or copied will be reflected in that
   1.111 -changeset, as will modifications to any files that Mercurial is
   1.112 -already tracking; the new changeset will have the parents of the
   1.113 -working directory as its parents.
   1.114 -
   1.115 -After a commit, Mercurial will update the parents of the working
   1.116 -directory, so that the first parent is the ID of the new changeset,
   1.117 -and the second is the null ID.  This is shown in
   1.118 -figure~\ref{fig:concepts:wdir-after-commit}.  Mercurial doesn't touch
   1.119 -any of the files in the working directory when you commit; it just
   1.120 -modifies the dirstate to note its new parents.
   1.121 +Es útil pensar en el directorio de trabajo como en ``el conjunto de
   1.122 +cambios que estoy a punto de enviar''. Cualquier fichero que usted le
   1.123 +diga a Mercurial que fue añadido, borrado, renombrado o copiado, se
   1.124 +verá reflejado en ese conjunto de cambios, como también se verán las
   1.125 +modificaciones a cualquiera de los ficheros que Mercurial ya esté
   1.126 +monitoreando; el nuevo conjunto de cambios dentrá los padres del
   1.127 +directorio de trabajo como propios.
   1.128 +
   1.129 +Luego de una consignación, Mercurial actualizará los padres del
   1.130 +directorio de trabajo, de tal manera que el primer padre sea el ID del
   1.131 +nuevo conjunto de cambios, y el segundo sea el ID nulo. Esto puede
   1.132 +verse en la figura~\ref{fig:concepts:wdir-after-commit}.  Mercurial no
   1.133 +toca ninguno de los ficheros del directorio de trabajo cuando usted
   1.134 +hace la consignación; sólo modifica el estado de directorio para
   1.135 +anotar sus nuevos padres.
   1.136  
   1.137  \subsection{Creating a new head}
   1.138