TortoiseMerge es una aplicación gratuita/de código abierto. Le permite ver las diferencias entre ficheros de texto, fusionar esos cambios e incluso revisar y aplicar ficheros de diff unificados, a menudo llamados parches.

Mientras trabaja con ficheros de texto, por ejemplo ficheros de código en su lenguaje de programación favorito, o ficheros html/xml para su documentación o sitio web, a menudo tendrá situaciones donde desee comparar versiones diferentes de esos ficheros. A veces obtiene una versión diferente de alguien, a veces querrá ver los cambios que ha hecho.

Si está trabajando con un sistema de control de versiones (por ejemplo Subversion) a veces obtendrá conflictos cuando actualice su copia de trabajo. Esto ocurre si alguien ha modificado las mismas partes que usted del fichero en el que está trabajando. En esos casos tendrá que resolver esos conflictos manualmente. Aquí es donde TortoiseMerge puede ayudarle.

El siguiente diagrama le muestra las relaciones entre los ficheros involucrados en un conflicto:

Figura 1.1. Conflicto de ficheros

While working on TortoiseSVN we found that whenever users sent in patches to enhance the project or just to fix bugs, we had a lot of work just applying those patches. And many times those patches were outdated and couldn't be applied with the command line patch tool https://unxutils.sourceforge.net/ because we were working on those files and had sometimes changed those files already.

Esta era también la razón principal por la que TortoiseSVN no tenía implementada una opción TortoiseSVN → Crear Parche: preferíamos que los usuarios nos enviaran los ficheros completos porque así era más fácil aplicar los parches.

Así que gastamos mucho tiempo buscando en internet una herramienta GUI que pudiera aplicar ficheros de parche, pero todo lo que encontramos es que dicha herramienta no existía. Para acortar un poco una larga historia: decidimos que si nadie más podía proporcionarnos dicha herramienta tendríamos que escribirla nosotros. Ahí fue cuando nació TortoiseMerge.

Dado que TortoiseSVN ya utiliza la librería de Subversion, que contiene un buen motor de diferencias, era natural que utilizáramos esa librería en vez del diff de GNU.

Subversion 1.7 introduced the svn patch command which allows to apply a patch file to a working copy. TortoiseMerge uses now the same functions as the Subversion command to avoid different behaviors between the two.

En este modo está comparando dos ficheros. El fichero del panel izquierdo se considera el fichero original (a veces referido como de ellos) y el fichero en el panel derecho es el fichero modificado (a veces referido como mío).

Puede efectuar cambios simples basados-en-línea al fichero en el panel derecho, entre otros:

También puede editar el fichero de salida tal y como lo haría en un editor de texto. Las líneas que cambie de esta forma se marcarán utilizando un icono de un lápiz. Por favor, tenga en cuenta que si desea hacer alguno de los cambios basados en línea o bloque descritos anteriormente, es mejor que lo haga al principio: una vez que empiece a editar el fichero, TortoiseMerge no podrá mantener la relación de las líneas con los ficheros originales.

Esto a veces se denomina fusión a tres bandas, y se muestra en tres paneles. Aunque realmente hay cuatro ficheros involucrados. El fichero queno se muestra es el fichero base común, el último ancestro común de los dos ficheros que ahora están en conficto. Las relaciones entre los tres ficheros se explican en el diagrama siguiente:

Figura 2.1. Conflicto de ficheros

El fichero base representa la versión más antigua del fichero, desde donde Usted y Otros empezaron a hacer cambios. Mío representa el fichero base con todos los cambios que usted ha hecho, y De otros es el fichero con todos los cambios que cualquier otro ha hecho al fichero. El panel izquierdo le muestra los cambios en de otros respecto a su fichero base, y el panel derecho le muestra los cambios en mío relativos al fichero base. El panel inferior es el fichero resultado que es donde intenta resolver los conflictos.

En la vista de resolución de conflictos, puede elegir utilizar bloques míos, o de ellos, o ambos. Pero en este caso, los cambios se muestran en el panel inferior.

Un fichero de parche es un fichero de diff unificado de Subversion, que contiene la información necesaria para aplicar cambios a un conjunto de ficheros. El parche puede haber sido proporcionado por otro desarrollador para que pueda ver sus cambios y posiblemente confirmarlos en el repositorio. O puede haber sido generado internamente por TortoiseSVN cuando compara dos carpetas. Esto ocurre cuando compara una revisión del repositorio con una carpeta de copia de trabajo, o si compara dos revisiones diferentes del repositorio, o si compara dos rutas de repositorio diferentes.

En cada caso TortoiseMerge mostrará una pequeña ventana mostrando los ficheros incluídos en el parche. Al hacer doble click en uno de estos ficheros, se obitene el fichero relevante y se aplican los cambios. El panel izquierdo muestra el contenido original del fichero y el panel derecho muestra cómo queda tras aplicar el parche.

Puede editar el fichero en el panel derecho exactamente igual que lo haría en el modo de comparación/edición.

TortoiseMerge tiene tres modos de vista principales: un panel, dos paneles y tres paneles. La vista de uno o dos paneles se utiliza para ver cambios, y la vista de tres paneles se utiliza para resolver conflictos.

Viendo / Fusionando

Figura 3.1. Vista de un panel

Figura 3.2. Vista de dos paneles

La vista de dos paneles tiene algunas funcionalidades que no están disponibles en la vista de un panel:

• Los cambios dentro de las líneas modificadas se muestran con colores diferentes. Las partes añadidas en la cadena se muestran con un color claro, aunque por supuesto puede configurar los colores utilizados aquí. Las partes eliminadas se indican con una línea vertical marrón oscura en la cadena. Observe la captura de pantalla anterior para ver cómo funciona.

• Reorganizar código a menudo significa un montón de cambios en los espacios en blanco (espacios, tabuladores, nuevas líneas) pero no cambios reales en el código. Por ejemplo, divide una línea muy larga en varias líneas, o a veces junta varias líneas en una única.

  Dichos cambios se marcan con un círculo blanco en la parte izquierda de las vistas. Si observa dicho círculo blanco, inmediatamente sabrá que no se ha cambiado realmente nada ahí y no tendrá que seguir comprobando el bloque cambiado.

• Hand editing of the file in the right pane is possible in two-pane view. Such changes are marked with a pencil symbol. Hand editing of the file in the left pane is also possible, only when Enable Edit is pressed when the left pane is active.

Si quiere comparar/fusionar tres ficheros, TortoiseMerge le mostrará las diferencias en una vista de tres paneles. Esta vista también se utiliza si necesita resolver ficheros en conflicto.

Figura 3.3. Vista de tres paneles

El panel izquierdo le muestra las diferencias entre el fichero De otros y el fichero Base, mientras que el panel derecho le muestra las diferencias entre el fichero Mío y el fichero Base. El panel inferior le muestra el resultado de fusionar los ficheros Base, Mío y el De otros con posibles conflictos.

Si pasa el ratón por encima del título del panel, una etiqueta de ayuda le mostrará los nombres de ficheros utilizados para las diferencias en cada panel.

Hand editing of the file in the left pane or right pane is also possible, only when Enable Edit is pressed when that pane is active.

Aplicando parches

Cuando TortoiseMerge termine de parsear el fichero de parche, le mostrará una pequeña ventana con todos los ficheros que tienen cambios según el fichero de parche.

Figura 3.4. Lista de ficheros de parche

Si el nombre del fichero se muestra en negro, el parche se puede aplicar sin problemas. Eso significa que el fichero no está desactualizado según el parche. Sin embargo, si el nombre del fichero se muestra en rojo, entonces el parche no se puede aplicar directamente porque ya ha cambiado ese fichero.

La ventana del archivo parche tiene un menú contextual que le permitirá previsualizar el efecto del parche en el archivo actual (aplicar sin guardar), aplicar y guardar los cambios para el archivo seleccionado, o aplicar y guardar los cambios to todos los archivos de la lista. Si hace doble clic se previsualizarán los cambios.

Depending on your setting, you either see a toolbar or a ribbon with many buttons. The buttons all show a tooltip explaining their function when you hover the mouse pointer over them.

En la parte izquierda de la ventana está una barra de lugar. Esto proporciona una rápida referencia visual de dónde están los cambios en el fichero. La barra tiene tres columnas. La columna izquierda se refiere al panel izquierdo, la columna derecha al panel derecho, y la columna central al panel inferior (si está presente). En la vista de un solo panel sólo se utiliza la columna izquierda. La barra de lugar se puede utilizar también como una barra para mover todas las ventanas simultáneamente.

Si haces doble clic sobre una palabra, entonces cada una de las apariciones de esa palabra será resaltada en todo el documento, tanto en los páneles principales como en la barra de localización. Para remover el resaltado haz doble clic de nuevo sobre la palabra.

Si hace clic en el margen izquierdo, o si hace triple clic dentro de una línea, esa línea entera se seleccionará.

Below the bottom window is the status bar. This shows the number of lines added and deleted in Theirs and Mine, and the number of unresolved conflicts remaining.

The status bar also contains combo box controls which indicate how the files are handled and treated:

Las líneas cambiadas se marcan con un icono para indicar qué tipo de cambio ocurrió.

Se añadió una línea.

Se eliminó una línea.

Se deshizo un cambio revirtiendo al contenido original de la línea.

Esta línea sólo contiene cambios en los espacios en blanco. Donde aparezcan líneas consecutivas marcadas, el párrafo puede haberse reformateado, causando que las palabras se cambien a las líneas adyacentes.

Se ha editado la línea a mano, utilizando TortoiseMerge como editor de texto.

Esta línea está en conflicto.

Esta línea está en conflicto, pero el efecto está oculto por la configuración de los espacios en blanco o de los finales de línea.

This line is detected as being moved from / to another location.

TortoiseMerge no sólo le muestra las diferencias entre los ficheros, sino que también le permite resolver conflictos o aplicar cambios.

If you're in two pane view, then you can only edit the file in the right pane (Mine). To apply changes made in the left file (Theirs), right click on the changed lines and select Context Menu → Use text block from 'theirs' . Then the changes from the left file are added to the right file.

A veces en realidad querrá utilizar ambos bloques de texto, y el menú contextual también le ofrece Menú contextual → Utilizar ambos bloques de texto (este primero) y Menú contextual → Utilizar ambos bloques de texto (este el último).

También puede editar el fichero de salida tal y como lo haría en un editor de texto. Las líneas que cambie de esta forma se marcarán utilizando un icono de un lápiz. Por favor, tenga en cuenta que si desea hacer alguno de los cambios basados en línea o bloque descritos anteriormente, es mejor que lo haga al principio: una vez que empiece a editar el fichero, TortoiseMerge no podrá mantener la relación de las líneas con los ficheros originales.

If you're in three pane view (sometimes called merge view) you can only edit the file in the bottom view (Merged). As in two pane view, you can right click on conflicted lines and either select Context Menu → Use text block from 'theirs' or Context Menu → Use text block from 'mine' . In addition, if you want both blocks, you can select Context Menu → Use text block from 'mine' before 'theirs' or Context Menu → Use text block from 'theirs' before 'mine' . According to the command you've selected, the changes are used in the resulting Merged file.

A veces un fichero se marcará como en conflicto en Subversion, pero cuando lo vea utilizando TortoiseMerge no se muestra ningún conflicto. Esto puede ser debido a su selección de la forma en la que se tratan los espacios en blanco. Si elige ignorar los cambios en el fin de línea o en los espacios en blanco, esas líneas se marcarán utilizando el icono Conflicto-Ignorado. Para resolver el conflicto aún necesitará elegir qué versión desea utilizar.

Cuando inicia TortoiseMerge sin ningún argumento en la línea de comandos tendrá que abrir los ficheros manualmente, utilizando Archivo → Abrir.

Figura 3.5. El diálogo Abrir

Lo primero que tiene que hacer es decidir si sólo quiere comparar/fusionar ficheros, o si quiere aplicar un fichero de parche. Dependiendo de su elección, se activan las casillas de texto y los botones de navegación correspondientes.