comparison es/tour-basic.tex @ 463:932c10e8c225

now, this has section 1.5 finished. Last commit had 1.4. Typo in commit message

462:e8a5068c7605

el contenido de un cambio como un \emph{diff unificado} (si usted
nunca ha visto un diff unificado antes, vea la
sección~\ref{sec:mq:patch} para un vistazo global).
\interaction{tour.log-vp}

\section{All about command options}

Let's take a brief break from exploring Mercurial commands to discuss
a pattern in the way that they work; you may find this useful to keep
in mind as we continue our tour.

Mercurial has a consistent and straightforward approach to dealing
with the options that you can pass to commands.  It follows the
conventions for options that are common to modern Linux and Unix
systems.
\begin{itemize}
\item Every option has a long name.  For example, as we've already
  seen, the \hgcmd{log} command accepts a \hgopt{log}{--rev} option.
\item Most options have short names, too.  Instead of
  \hgopt{log}{--rev}, we can use \hgopt{log}{-r}.  (The reason that
  some options don't have short names is that the options in question
  are rarely used.)
\item Long options start with two dashes (e.g.~\hgopt{log}{--rev}),
  while short options start with one (e.g.~\hgopt{log}{-r}).
\item Option naming and usage is consistent across commands.  For
  example, every command that lets you specify a changeset~ID or
  revision number accepts both \hgopt{log}{-r} and \hgopt{log}{--rev}
  arguments.
\end{itemize}
In the examples throughout this book, I use short options instead of
long.  This just reflects my own preference, so don't read anything
significant into it.

Most commands that print output of some kind will print more output
when passed a \hggopt{-v} (or \hggopt{--verbose}) option, and less
when passed \hggopt{-q} (or \hggopt{--quiet}).

\section{Making and reviewing changes}

Now that we have a grasp of viewing history in Mercurial, let's take a
look at making some changes and examining them.

463:932c10e8c225

el contenido de un cambio como un \emph{diff unificado} (si usted
nunca ha visto un diff unificado antes, vea la
sección~\ref{sec:mq:patch} para un vistazo global).
\interaction{tour.log-vp}

\section{Todo acerca de las opciones para comandos}

Tomemos un breve descanso de la tarea de explorar los comandos de
Mercurial para hablar de un patrón en la manera en qué trabajan; será
útil tener esto en mente a medida que avanza nuestra gira.

Mercurial tiene un enfoque consistente y directo en el manejo de las
opciones que usted le puede pasar a los comandos. Se siguen las
convenciones para opciones que son comunes en sistemas Linux y Unix
modernos.
\begin{itemize}
\item Cada opción tiene un nombre largo. Por ejemplo, el comando
    \hgcmd{log} acepta la opción \hgopt{log}{--rev}, como ya hemos
    visto.
\item Muchas opciones tienen también un nombre corto. En vez de
    \hgopt{log}{--rev}, podemos usar \hgopt{log}{-r}.  (El motivo para
    que algunas opciones no tengan nombres cortos es que dichas
    opciones se usan rara vez.)
\item Las opciones largas empiezan con dos guiones (p.ej.~\hgopt{log}{--rev}),
    mientras que las opciones cortas empiezan con uno (e.g.~\hgopt{log}{-r}).
\item El nombre  y uso de las opciones es consistente en todos los
    comandos. Por ejemplo, cada comando que le permite pasar un ID de
    conjunto de cambios o un número de revisión acepta tanto la opción
    \hgopt{log}{-r} como la \hgopt{log}{--rev}.
\end{itemize}
En los ejemplos en este libro, uso las opciones cortas en vez de las
largas. Esto sólo muestra mis preferencias, así que no le dé
significado especial a eso.

Muchos de los comandos que generan salida de algún tipo mostrarán más
salida cuando se les pase la opción \hggopt{-v} (o
\hggopt{--verbose}\ndt{Prolijo.}), y menos cuando se les pase la opción \hggopt{-q}
(o \hggopt{--quiet}\ndt{Silencioso.}).

\section{Making and reviewing changes}

Now that we have a grasp of viewing history in Mercurial, let's take a
look at making some changes and examining them.