hgbook
view es/cmdref.tex @ 1106:aed0e9396b14
2.8.1 zh translation
| author | Zhaoping Sun <zhaopingsun@gmail.com> |
|---|---|
| date | Thu Dec 10 13:49:35 2009 -0500 (2009-12-10) |
| parents | 9da096de3c52 |
| children |
line source
1 \chapter{Referencia de Órdenes}
2 \label{cmdref}
4 \cmdref{add}{Añade ficheros en la próxima consignación}
5 \optref{add}{I}{include}
6 \optref{add}{X}{exclude}
7 \optref{add}{n}{dry-run}
9 \cmdref{diff}{imprime los cambios en el historial o el directorio actual}
11 Mostrar las diferencias entre revisiones para ficheros especificados o
12 directorios, con el formato unificado diff. Si desea ver una
13 descripción del formato unificado diff, ver la sección~\ref{sec:mq:patch}.
15 De forma predeterminada, esta orden no imprime las diferencias para
16 los ficheros binarios que Mercurial esté siguiendo. Para controlar
17 este comportamiento, vea las opciones \hgopt{diff}{-a} y
18 \hgopt{diff}{--git}.
20 \subsection{Options}
22 \loptref{diff}{nodates}
24 Omite la fecha y hora cuando se muestran los encabezados de las
25 diferencias.
27 \optref{diff}{B}{ignore-blank-lines}
29 No imprime los cambios que solamente insertan o eliminan líneas en
30 blanco. Una línea que contiene espacios en blanco no se considera
31 como una línea en blanco.
33 \optref{diff}{I}{include}
35 Incluye ficheros y directorios cuyos nombres coinciden con los
36 patrones elegidos.
38 \optref{diff}{X}{exclude}
40 Excluye los ficheros y directorios cuyos nombres coinciden con los
41 patrones elegidos.
43 \optref{diff}{a}{text}
45 Si no especifica esta opción, \hgcmd{diff} no mostrará las diferencias
46 de los ficheros que detecte como binarios. Al especificar \hgopt{diff}{-a}
47 se forza a \hgcmd{diff} a tratar los ficheros como texto, y generar
48 diferencias para todos.
50 Esta opción es útil para los ficherso que son ``texto en mayor
51 medida'' pero que tienen caracteres NUL. Si lo usa en ficheros que
52 contienen muchos datos binarios, la salida será incomprensible.
54 \optref{diff}{b}{ignore-space-change}
56 No imprime si el único cambio que en la línea es la cantidad de
57 espacio en blanco.
59 \optref{diff}{g}{git}
61 Mostrar diferencias compatibles con \command{git}. XXX reference a format
62 description.
64 \optref{diff}{p}{show-function}
66 Mostrar el nombre de la función que contiene el código en una porción
67 del encabzado usando una heurística simple. Esta funcionalidad se
68 habilita de forma predeterminada, así que la opción \hgopt{diff}{-p}
69 no tiene efectos a menos que cambie el valor de
70 \rcitem{diff}{showfunc} en la configuración, como en el ejemplo
71 siguiente.
72 \interaction{cmdref.diff-p}
74 \optref{diff}{r}{rev}
76 Especifique una o más revisiones para comparar. La orden \hgcmd{diff}
77 acepta hasta dos opciones \hgopt{diff}{-r} para especificar las
78 revisiones a comparar.
80 \begin{enumerate}
81 \setcounter{enumi}{0}
82 \item Despliega las diferencias entre la revisión padre y del directorio
83 de trabajo.
84 \item Despliega las diferencias entre el conjunto de cambios
85 especificados y el directorio de trabajo.
86 \item Despliega las diferencias entre dos conjuntos de cambios
87 especificados.
88 \end{enumerate}
90 Puede especificar dos revisiones usando o bien sea las opciones
91 \hgopt{diff}{-r} o la notación de rango. Por ejemplo, las dos
92 especificaciones de revisiones a continuación son equivalentes:
93 \begin{codesample2}
94 hg diff -r 10 -r 20
95 hg diff -r10:20
96 \end{codesample2}
98 Cuando especifica dos revisiones, esto tiene significado para
99 Mercurial. Esto significa que \hgcmdargs{diff}{-r10:20} producirá un
100 diff que transformará los ficheros desde los contenidos en la revisión
101 10 a los contenidos de la revisión 20, mientras que
102 \hgcmdargs{diff}{-r20:10} significa lo opuesto: el diff que
103 transformaría los contenidos de los ficheros de la revisión 20 a los
104 contenidos de la revisión 10. No puede invertir el orden de esta
105 forma si está haciendo un diff frente al directorio de trabajo.
107 \optref{diff}{w}{ignore-all-space}
109 \cmdref{version}{imprime la información de versión y derechos de reproducción}
111 Esta orden despliega la versión de Mercurial que está usando, y su
112 nota de derechos de reproducción. Hay cuatro clases de cadenas de
113 versión posibles:
114 \begin{itemize}
115 \item La cadena ``\texttt{unknown}''. Esta versión de Mercurial no fue
116 construida en un repositorio de Mercurial, y no puede determinar su
117 propia versión.
118 \item Una cadena numérica corta, tal como ``\texttt{1.1}''. Esta es
119 una construcción de una versión de Mercurial que se identifica con
120 una etiqueta específica en el repositorio en el cual fue
121 armada (Esto no significa necesariamente que está ejecutando una
122 versión oficial; alguien pudo haber añadido tal etiqueta a cualquier
123 versión del repositorio en el cual armaron Mercurial).
124 \item Una cadena hexadecimal, tal como ``\texttt{875489e31abe}''.
125 Esta es una construcción de una revisión dada de Mercurial.
126 \item Una cadena hexadecimal seguida por una fecha, tal como
127 ``\texttt{875489e31abe+20070205}''. Esta construcción de la
128 revisión de Mercurial fue la construcción de un repositorio que tuvo
129 cambios locales que no han sido consignados.
130 \end{itemize}
132 \subsection{Consejos y trucos}
134 \subsubsection{¿Por qué difieren los resultados de \hgcmd{diff} y
135 \hgcmd{status}?}
136 \label{cmdref:diff-vs-status}
138 Cuando ejecuta la orden \hgcmd{status}, verá una lista de ficheros
139 para los cuales Mercurial almacenará cambios la próxima vez que
140 consigne. Si ejecuta la orden \hgcmd{diff}, verá que imprime
141 diferencias solamente para un \emph{subconjunto} de los ficheros que
142 \hgcmd{status} liste. Hay dos posibles razones para este comportamiento:
144 La primera es que \hgcmd{status} imprime cierta clase de
145 modificaciones que \hgcmd{diff} no despliega normalmente. La orden
146 \hgcmd{diff} usualmente despliega diferencias unificadas, las cuales
147 no tienen la habilidad de representar algunos cambios que Mercurial
148 puede seguir. Lo más notable es que las diferencias tradicionales no
149 pueden representar un cambio acerca de la ejecutabilidad de un
150 fichero, pero Mercurial sí almacena esta información.
152 Si usa la opción \hgopt{diff}{--git} de \hgcmd{diff}, mostrará
153 diferencias compatibles con \command{git} que \emph{pueden} desplegar
154 esta información adicional.
156 La segunda razón posible para que \hgcmd{diff} esté imprimiendo
157 diferencias para un subconjunto de ficheros de lo que muestra
158 \hgcmd{status} es que si usted le invoca sin argumento alguno,
159 \hgcmd{diff} imprime diferencias frente al primer padre del directorio
160 de trabajo. Si ha ejecutado \hgcmd{merge} para fusionar dos conjuntos
161 de cambios, pero no ha consignado aún los resultados de la fusión, su
162 directorio de trabajo tiene dos padres (use \hgcmd{parents} para
163 verlos). Mientras que \hgcmd{status} imprime modificaciones relativas
164 a \emph{ambos} padres después de una fusión que no se ha consignado,
165 \hgcmd{diff} opera aún relativo solamente al primer padre. Puede
166 lograr que imprima las diferencias relativas al segundo padre
167 especificando tal padre con la opción \hgopt{diff}{-r}. No hay forma
168 de hacer que imprima las diferencias relativas a los dos padres.
170 \subsubsection{Generar diferencias seguras en binarios}
172 Si usa la opción \hgopt{diff}{-a} para forzar que Mercurial imprima
173 las diferencias de los ficheros que so o bien ``casi completamente
174 texto'' o contienen muchos datos binarios, tales diferencias no pueden
175 aplicarse subsecuentemente a la orden \hgcmd{import} de Mercurial o a
176 la orden \command{patch} del sistema.
178 Si desea generar una diferencia de un fichero binario que es seguro
179 para usarlo como entrada a la orden \hgcmd{import}, use la opción
180 \hgcmd{diff}{--git} cuando genere el parche. La orden \command{patch}
181 del sistema no puede tratar con parches binarios.
183 %%% Local Variables:
184 %%% mode: latex
185 %%% TeX-master: "00book"
186 %%% End: