jerojasro@339: \chapter*{Prefacio}
jerojasro@339: \addcontentsline{toc}{chapter}{Prefacio}
jerojasro@339: \label{chap:preface}
jerojasro@339: 
jerojasro@343: El control distribuido de revisiones es un territorio relativamente 
jerojasro@339: nuevo, y ha crecido hasta ahora 
jerojasro@339: % TODO el original dice "due to", que sería "debido", pero creo que "gracias
jerojasro@339: % a" queda mejor 
jerojasro@339: gracias a  a la voluntad que tiene la gente de salir y explorar
jerojasro@339: territorios desconocidos.
jerojasro@339: % TODO revisar la frase anterior. me tomé muchas licencias para
jerojasro@339: % traducirla
jerojasro@339: 
jerojasro@339: Estoy escribiendo este libro acerca de control de revisiones
jerojasro@339: distribuido porque creo que es un tema importante que merece una guía
jerojasro@339: de campo. Escogí escribir acerca de Mercurial porque es la herramienta
jerojasro@339: %TODO puse explorar en vez de aprender, you be the judge dear reviewer ;)
jerojasro@339: más fácil para explorar el terreno, y sin embargo escala a las
jerojasro@341: demandas de retadores ambientes reales donde muchas otras herramientas
jerojasro@341: de control de revisiones fallan.
jerojasro@339: 
jerojasro@341: \section{Este libro es un trabajo en progreso}
jerojasro@341: Estoy liberando este libro mientras lo sigo escribiendo, con la
jerojasro@341: esperanza de que pueda ser útil a otros. También espero que los
jerojasro@341: lectores contribuirán como consideren adecuado.
jerojasro@339: 
jerojasro@341: \section{Acerca de los ejemplos en este libro}
jerojasro@341: Este libro toma un enfoque inusual hacia las muestras de código. Cada
jerojasro@341: ejemplo está ``en directo''---cada uno es realmente el resultado de un
jerojasro@341: % TODO shell script
jerojasro@341: script de shell que ejecuta los comandos de Mercurial que usted ve.
jerojasro@341: Cada vez que una copia del libro es construida desde su código fuente,
jerojasro@341: % TODO scripts
jerojasro@341: todos los scripts de ejemplo son ejecutados automáticamente, y sus
jerojasro@341: resultados actuales son comparados contra los resultados esperados.
jerojasro@339: 
jerojasro@341: La ventaja de este enfoque es que los ejemplos siempre son precisos;
jerojasro@341: ellos describen \emph{exactamente} el comportamiento de la versión de
jerojasro@341: Mercurial que es mencionada en la portada del libro. Si yo actualizo
jerojasro@341: la versión de Mercurial que estoy documentando, y la salida de algún
jerojasro@341: comando cambia, la construcción falla.
jerojasro@339: 
jerojasro@341: Hay una pequeña desventaja de este enfoque, que las fechas y horas que
jerojasro@341: usted verá en los ejemplos tienden a estar ``aplastadas'' juntas de una
jerojasro@341: forma que no sería posible si los mismos comandos fueran escritos por
jerojasro@341: un humano. Donde un humano puede emitir no más de un comando cada
jerojasro@341: pocos segundos, con cualquier marca de tiempo resultante
jerojasro@341: correspondientemente separada, mis scripts automatizados de ejemplos
jerojasro@341: ejecutan muchos comandos en un segundo.
jerojasro@339: 
jerojasro@341: % TODO commit
jerojasro@341: Como un ejemplo de esto, varios commits consecutivos en un ejemplo
jerojasro@341: pueden aparecer como habiendo ocurrido durante el mismo segundo. Usted
jerojasro@341: puede ver esto en el ejemplo \hgext{bisect} en la
jerojasro@341: sección~\ref{sec:undo:bisect}, por ejemplo.
jerojasro@339: 
jerojasro@343: Así que cuando usted lea los ejemplos, no le dé mucha importancia a
jerojasro@343: las fechas o horas que vea en las salidas de los comandos. Pero
jerojasro@343: \emph{tenga} confianza en que el comportamiento que está viendo es
jerojasro@343: consistente y reproducible.
jerojasro@339: 
jerojasro@343: \section{Colofón---este libro es Libre}
jerojasro@343: Este libro está licenciado bajo la Licencia de Publicación Abierta, y
jerojasro@343: es producido en su totalidad usando herramientas de Software Libre. Es
jerojasro@343: compuesto con \LaTeX{}; las ilustraciones son dibujadas y generadas
jerojasro@343: con \href{http://www.inkscape.org/}{Inkscape}.
jerojasro@339: 
jerojasro@343: El código fuente completo para este libro es publicado como un
jerojasro@343: repositorio Mercurial, en \url{http://hg.serpentine.com/mercurial/book}.
jerojasro@339: 
jerojasro@339: %%% Local Variables: 
jerojasro@339: %%% mode: latex
jerojasro@339: %%% TeX-master: "00book"
jerojasro@339: %%% End: