1.1 --- a/es/hgext.tex	Mon Dec 15 23:37:01 2008 -0500
     1.2 +++ b/es/hgext.tex	Wed Dec 24 12:40:20 2008 -0500
     1.3 @@ -351,90 +351,88 @@
     1.4  buzón de entrada del destinatario, de ahí su nombre ``bombardeo de
     1.5  parches''.
     1.6  
     1.7 -As usual, the basic configuration of the \hgext{patchbomb} extension
     1.8 -takes just one or two lines in your \hgrc.
     1.9 +Como es usual, la configuración básica de la extensión
    1.10 +\hgext{patchbomb} consta de una o dos líneas en su \hgrc.
    1.11  \begin{codesample2}
    1.12    [extensions]
    1.13    patchbomb =
    1.14  \end{codesample2}
    1.15 -Once you've enabled the extension, you will have a new command
    1.16 -available, named \hgxcmd{patchbomb}{email}.
    1.17 -
    1.18 -The safest and best way to invoke the \hgxcmd{patchbomb}{email}
    1.19 -command is to \emph{always} run it first with the
    1.20 -\hgxopt{patchbomb}{email}{-n} option.  This will show you what the
    1.21 -command \emph{would} send, without actually sending anything.  Once
    1.22 -you've had a quick glance over the changes and verified that you are
    1.23 -sending the right ones, you can rerun the same command, with the
    1.24 -\hgxopt{patchbomb}{email}{-n} option removed.
    1.25 -
    1.26 -The \hgxcmd{patchbomb}{email} command accepts the same kind of
    1.27 -revision syntax as every other Mercurial command.  For example, this
    1.28 -command will send every revision between 7 and \texttt{tip},
    1.29 -inclusive.
    1.30 +Cuando haya habilitado la extensión, dispondrá de una nueva orden,
    1.31 +llamada \hgxcmd{patchbomb}{email}.
    1.32 +
    1.33 +La forma mejor y más segura para invocar la orden
    1.34 +\hgxcmd{patchbomb}{email} es ejecutarla \emph{siempre} con la opción
    1.35 +\hgxopt{patchbomb}{email}{-n}; que le mostrará lo que la orden
    1.36 +\emph{enviaría}, sin enviar nada.  Una vez que haya dado un vistazo a
    1.37 +los cambios y verificado que está enviando los correctos, puede volver
    1.38 +a ejecutar la misma orden, sin la opción \hgxopt{patchbomb}{email}{-n}.
    1.39 +
    1.40 +La orden \hgxcmd{patchbomb}{email} acepta la misma clase de sintaxis
    1.41 +de revisiones como cualquier otra orden de Mercurial.  Por ejemplo,
    1.42 +enviará todas las revisiones entre la 7 y la \texttt{punta}, inclusive.
    1.43  \begin{codesample2}
    1.44    hg email -n 7:tip
    1.45  \end{codesample2}
    1.46 -You can also specify a \emph{repository} to compare with.  If you
    1.47 -provide a repository but no revisions, the \hgxcmd{patchbomb}{email}
    1.48 -command will send all revisions in the local repository that are not
    1.49 -present in the remote repository.  If you additionally specify
    1.50 -revisions or a branch name (the latter using the
    1.51 -\hgxopt{patchbomb}{email}{-b} option), this will constrain the
    1.52 -revisions sent.
    1.53 -
    1.54 -It's perfectly safe to run the \hgxcmd{patchbomb}{email} command
    1.55 -without the names of the people you want to send to: if you do this,
    1.56 -it will just prompt you for those values interactively.  (If you're
    1.57 -using a Linux or Unix-like system, you should have enhanced
    1.58 -\texttt{readline}-style editing capabilities when entering those
    1.59 -headers, too, which is useful.)
    1.60 -
    1.61 -When you are sending just one revision, the \hgxcmd{patchbomb}{email}
    1.62 -command will by default use the first line of the changeset
    1.63 -description as the subject of the single email message it sends.
    1.64 -
    1.65 -If you send multiple revisions, the \hgxcmd{patchbomb}{email} command
    1.66 -will usually send one message per changeset.  It will preface the
    1.67 -series with an introductory message, in which you should describe the
    1.68 -purpose of the series of changes you're sending.
    1.69 -
    1.70 -\subsection{Changing the behaviour of patchbombs}
    1.71 -
    1.72 -Not every project has exactly the same conventions for sending changes
    1.73 -in email; the \hgext{patchbomb} extension tries to accommodate a
    1.74 -number of variations through command line options.
    1.75 +También puede especificar un \emph{repositorio} para comparar.  Si
    1.76 +indica un repositoro sin revisiones, la orden \hgxcmd{patchbomb}{email}
    1.77 +enviará todas las revisiones en el repositorio local que no están
    1.78 +presentes en el repositorio remoto.  Si especifica revisiones
    1.79 +adicionalmente o el nombre de una rama(la última con la opción
    1.80 +\hgxopt{patchbomb}{email}{-b}), respetará las revisiones enviadas.
    1.81 +
    1.82 +Ejecutar la orden \hgxcmd{patchbomb}{email} sin los nombres de
    1.83 +aquellas personas a las cuales desea enviar el correo es completamente
    1.84 +seguro: si lo hace, solicitará tales valores de forma interactiva.
    1.85 +(Si está usando Linux o un sistema tipo Unix, tendrá capacidades
    1.86 +estilo--\texttt{readline} aumentadas cuando ingrese tales encabezados,
    1.87 +lo cual es sumamente útil.)
    1.88 +
    1.89 +Cuando envíe una sola revisión, la orden \hgxcmd{patchbomb}{email}
    1.90 +de forma predeterminada usará la primera línea de descripción del
    1.91 +conjunto de cambios como el tema del único mensaje que se enviará.
    1.92 +
    1.93 +Si envía varias revisiones, la orden \hgxcmd{patchbomb}{email} enviará
    1.94 +normalmente un mensaje por conjunto de cambios.  colocará como
    1.95 +prefacio un mensaje introductorio en el cual usted debería describir
    1.96 +el propósito de la serie de cambios que está enviando.
    1.97 +
    1.98 +\subsection{Cambiar el comportamiento de las bombas de parches}
    1.99 +
   1.100 +Cada proyecto tiene sus propias convenciones para enviar cambios en un
   1.101 +correo electrónico; la extensión \hgext{patchbomb} intenta acomodarse
   1.102 +a diferentes variaciones gracias a las opciones de la línea de órdenes:
   1.103  \begin{itemize}
   1.104 -\item You can write a subject for the introductory message on the
   1.105 -  command line using the \hgxopt{patchbomb}{email}{-s} option.  This
   1.106 -  takes one argument, the text of the subject to use.
   1.107 -\item To change the email address from which the messages originate,
   1.108 -  use the \hgxopt{patchbomb}{email}{-f} option.  This takes one
   1.109 -  argument, the email address to use.
   1.110 -\item The default behaviour is to send unified diffs (see
   1.111 -  section~\ref{sec:mq:patch} for a description of the format), one per
   1.112 -  message.  You can send a binary bundle instead with the
   1.113 -  \hgxopt{patchbomb}{email}{-b} option.  
   1.114 -\item Unified diffs are normally prefaced with a metadata header.  You
   1.115 -  can omit this, and send unadorned diffs, with the
   1.116 -  \hgxopt{patchbomb}{email}{--plain} option.
   1.117 -\item Diffs are normally sent ``inline'', in the same body part as the
   1.118 -  description of a patch.  This makes it easiest for the largest
   1.119 -  number of readers to quote and respond to parts of a diff, as some
   1.120 -  mail clients will only quote the first MIME body part in a message.
   1.121 -  If you'd prefer to send the description and the diff in separate
   1.122 -  body parts, use the \hgxopt{patchbomb}{email}{-a} option.
   1.123 -\item Instead of sending mail messages, you can write them to an
   1.124 -  \texttt{mbox}-format mail folder using the
   1.125 -  \hgxopt{patchbomb}{email}{-m} option.  That option takes one
   1.126 -  argument, the name of the file to write to.
   1.127 -\item If you would like to add a \command{diffstat}-format summary to
   1.128 -  each patch, and one to the introductory message, use the
   1.129 -  \hgxopt{patchbomb}{email}{-d} option.  The \command{diffstat}
   1.130 -  command displays a table containing the name of each file patched,
   1.131 -  the number of lines affected, and a histogram showing how much each
   1.132 -  file is modified.  This gives readers a qualitative glance at how
   1.133 -  complex a patch is.
   1.134 +\item Puede escribir un tema para el mensaje introductorio en la línea
   1.135 +  de órdenes con la opciń \hgxopt{patchbomb}{email}{-s}.  Toma un
   1.136 +  argumento: el tema del mensaje a usar.
   1.137 +\item Para cambiar el correo electrónico del campo del cual se
   1.138 +  origina, use la opción \hgxopt{patchbomb}{email}{-f}.  Toma un
   1.139 +  argumento, el correo electrónico a usar.
   1.140 +\item El comportamiento predeterminado es enviar diferencias
   1.141 +  unificadas (consulte la sección~\ref{sec:mq:patch} si desea una
   1.142 +  descripción del formato), una por mensaje.  Puede enviar un conjunto
   1.143 +  binario\ndt{binary bundle} con la opción \hgxopt{patchbomb}{email}{-b}.
   1.144 +\item Las diferencias unificadas están precedidas por un encabezado de
   1.145 +  metadatos.  Puede omitirlo, y enviar diferencias sin adornos con la
   1.146 +  opción \hgxopt{patchbomb}{email}{--plain}.
   1.147 +\item Las diferencias usualmente se envían ``en línea'', como parte
   1.148 +  del cuerpo del mensaje con la descripción del parche.  Que facilita a
   1.149 +  a la mayor cantidad de lectores citar y responder partes de un diff,
   1.150 +  dado que algunos clientes de correo solamente citarán la primera
   1.151 +  parte MIME del cuerpo de un mensaje.  Si prefiere enviar la
   1.152 +  descripción y el diff en partes separadas del cuerpo, use la opción
   1.153 +  \hgxopt{patchbomb}{email}{-a}.
   1.154 +\item En lugar de enviar mensajes de correo puede escribirlos a un
   1.155 +  fichero con formato-\texttt{mbox}- con la opción
   1.156 +  \hgxopt{patchbomb}{email}{-m}.  La opción recibe un argumento, el
   1.157 +  nombre del fichero en el cual escribir.
   1.158 +\item Si desea añadir un resumen con formato-\command{diffstat} en
   1.159 +  cada parche, y uno como mensaje introductorio, use la opción
   1.160 +  \hgxopt{patchbomb}{email}{-d}.  La orden \command{diffstat}
   1.161 +  despliega una tabla que contiene el nombre de cada fichero parchado,
   1.162 +  el número de líneas afectadas, y un historgrama mostrando cuánto ha
   1.163 +  sido modificado cada fichero.  Lo cual ofrece a los lectores una
   1.164 +  mirada cuantitativa de cuan complejo es el parche.
   1.165  \end{itemize}
   1.166  
   1.167  %%% Local Variables: