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