Manual de Kompare
Copyright © 2007 Sean Wheller
Se concede permiso para copiar, distribuir y/o modificar este documento bajo los términos de la Licencia Libre de Documentación de GNU, versión 1.1 o posterior publicada por la Free Software Foundation; con secciones no invariantes, con textos que no estén en la cubierta, y con textos que no estén en la contraportada. Se incluye una copia de la licencia en the section entitled "GNU Free Documentation License".
Kompare es un programa GUI que muestra las diferencias entre archivos fuente y permite fusionarlos. Kompare puede utilizarse para comparar diferencias en los archivos o en los contenidos de las carpetas. Kompare soporta varios formatos diff y proporciona muchas opciones para personalizar el nivel de información que se muestra.
Este documento describe la versión 3.4 de Kompare.
Tabla de contenidos
Cuando dos o más personas están trabajando sobre un archivo y lo van utilizando alternativamente, puede ser difícil ver qué cambios se han hecho en una nueva versión o copia del archivo. Abrir la copia nueva y el original enfrentándolas en la aplicación utilizada para crearlas puede ser una solución, pero muy laboriosa, consume tiempo y puede inducir a errores. Es en este punto donde un programa que muestre las diferencias puede ser útil.
Como se podría esperar, un nombre adecuado para un programa de este tipo podría ser «diff». Como puede comprobar, el programa diff está instalado en la mayor parte de los sistemas basados en Linux® y se utiliza para este propósito. Los desarrolladores utilizan diff con frecuencia, como una herramienta de línea de órdenes, para mostrar las diferencias entre versiones de un archivo de código fuente. Sin embargo, el uso de diff no está limitado a mostrar las diferencias en los archivos de código fuente, y puede utilizarse también en muchos tipos de archivo basados en texto.
Utilizar diff desde la línea de órdenes puede ser confuso, aprender la sintaxis de la orden diff y descifrar la salida puede desconcertar a mucha gente. Es aquí donde Kompare entra en juego. Proporciona una interfaz gráfica para el programa diff. La interfaz muestra los archivos fuente y destino uno al lado del otro con todas las diferencias resaltadas de forma automática. Desde este punto de partida, los cambios en un archivo puede aplicarse secuencialmente en el otro archivo en una base selectiva y controlada. No todos los cambios tienen porqué aplicarse y si aplica un cambio siempre puede 'deshacerse'. Cuando se hayan aplicado todos los cambios necesarios, podrán guardarse y se mostrarán de la forma habitual en la aplicación original utilizada para crear el archivo.
Además de mostrar las diferencias entre los archivos fuente y destino, Kompare puede utilizar para crear y ver un archivo especial llamado un 'diff'. Este archivo captura las diferencias entre las dos fuentes en un solo archivo que puede utilizarse para ver y aplicar cambios a cualquier otra copia del archivo. Por ejemplo, si dos personas están editando un documento. La primera persona desea hacer cambios y enviar los cambios hechos a la segunda persona. Normalmente, la primera persona enviará una copia completa del documento modificado a la segunda persona, quien debería comparar el documento modificado situándolo al lado de la versión sin modificar. El proceso para ésto es más parecido al que hemos descrito en el párrafo anterior. Con Kompare la primera persona debería hacer una copia local del archivo que se quiere modificar y a continuación realizar los cambios y comparar el original y la copia modificada. Ahora, utilizando Kompare puede crearse un archivo diff que contendrá solo los cambios efectuados. Éste puede enviarse a la segunda persona en lugar de un archivo completo que contenga los cambios.
Utilizando Kompare la segunda persona puede ver el archivo diff, compararlo con la copia local del documento y aplicar los cambios realizados por la primera persona. De esta forma el proceso puede realizarse para muchas versiones del documento, de forma que cada persona pueda hacer cambios, crear los diffs, distribuirlos y aplicarlos. Este proceso es lo que se suele llamar «parcheado», un término que se toma del programa llamado «patch» (parche, en inglés) que es otra herramienta de la línea de órdenes especialmente diseñada con el objetivo de aplicar los archivos diff.
A veces sucede que varias personas editan un archivo a la vez. En esta situación es probable que estas personas hagan cambios en el documento exactamente al mismo tiempo. Ésto crea un problema porque, sino se aplican con cuidado, unas personas pueden sobreescribir el trabajo de otras en el momento de aplicar los cambios que reciben. Afortunadamente los desarrolladores de los programas diff y patch tuvieron ésto en cuenta y por ello estas herramientas no permiten que estos cambios se apliquen sin intervención manual. Cuando se alcanza este estado, se produce lo que se conoce como «conflicto». Kompare mostrará los conflictos que puede resolver manualmente, decidiendo qué cambios deberían aplicarse a qué archivo.
Kompare es también un gran programa para la comparación de cambios en archivos a nivel de carpeta. Cuando se utilizan para comparar carpetas, Kompare examina recursivamente las subcarpetas y los archivos que contengan para encontrar diferencias. En esta situación, cada archivo en el que se encuentren diferencias se abre automáticamente y se lista en Kompare, permitiéndose una navegación sencilla entre los diferentes archivos.
Esta sección proporciona instrucciones para iniciar Kompare y proporciona una visita rápida a la interfaz principal de Kompare.
Un acceso rápido para iniciar Kompare se puede encontrar en el menú K en el grupo Desarrollo: ->.
Cuando Kompare se inicia, lo primero que hace es mostrar un diálogo desde el que puede seleccionar los archivos que desea comparar. Se pueden seleccionar también configuraciones especiales para las propiedades del diff, así como para el aspecto. En el formulario del archivo es posible seleccionar los archivos fuente y destino para compararlos. Éstos pueden ser dos archivos cualesquiera o un URL y un archivo. Una vez que se hayan seleccionado los archivos fuente y destino pulse el botón .
Una vez que Kompare haya descubierto las diferencias se mostrarán en la interfaz principal. Cuando se comparan dos archivos o un url y un archivo el proceso tan solo dura unos segundos. Sin embargo, cuando se comparan carpetas con muchos archivos y subcarpetas, el proceso puede durar bastante.
Para obtener más información sobre las opciones disponibles para el diff y el aspecto de los formularios consulte Capítulo 3, Configurar las preferencias.
Esta sección proporciona una vista rápida de la interfaz principal que está dividida en dos áreas:
Menús
Barra de herramientas
Carpetas fuente y destino
Archivos fuente y destino
Cambios de línea fuente y destino
Vista de texto fuente y destino
Barra de estado
Kompare proporciona una interfaz con la que se puede interactuar a través de los menús. Para obtener una explicación más detallada de los elementos del menú y sus opciones consulte Capítulo 4, Referencia de órdenes.
La barra de herramientas de Kompare proporciona accesos rápidos a las operaciones diff y de fusionado usadas con más frecuencia. La orientación de la barra de herramientas, posicionamiento del texto, propiedades del tamaño de los iconos y que iconos de accesos rápidos se mostrarán pueden personalizarse desde el menú contextual de la barra de herramientas que aparece cuando se pulsa sobre ella con el botón derecho del ratón. La barra de herramientas también incluye un menú que le permite activarla u ocultarla. Si la barra de herramientas está oculta y desea mostrarla, seleccione ->.
Los paneles de las carpetas fuente y destino muestran las carpetas de las que se ha realizado la comparación de archivos. Cuando se incluyen muchas subcarpetas en la comparación, seleccionando una carpeta se mostrará el primer documento en la carpeta que contenga diferencias entre el fuente y el destino.
El panel de archivos fuente y destino muestran los archivos en los que se encontraron diferencias entre la carpeta fuente y la de destino. Cuando una carpeta contiene varios documentos con diferencias, se listan todos los documentos con diferencias. Se mostrará el documento seleccionado.
Los cambios del panel de línea fuente y destino resumen las diferencias encontradas entre la fuente actual y los documentos de destino. Seleccionar un registro dentro del panel resalta y selecciona la diferencia. Es una forma práctica de navegar e inspeccionar documentos grandes con muchas diferencias.
Las vista fuente y destino conforman el espacio de trabajo principal de Kompare. Aquí se muestran los contenidos y se resaltan las diferencias entre los archivos fuente y destino junto los números de línea.
La vista Vista de texto no se muestra de forma predeterminada. Puede abrirse seleccionando ->.
La barra de estado proporciona un resumen de los archivos o carpetas fuente y destino que se estén comparando. La barra de estado también informa del número de cambios encontrados en el documento actual y cuenta las diferencias que se hayan aplicado. Además la barra de estado muestra el número global de documentos que contienen diferencias y el número de documentos seleccionados de este conjunto. Por ejemplo, una comparación que se ejecuta sobre dos carpetas puede devolver 1890 archivos con diferencias. El documento seleccionado es el número 18 de 1890.
Kompare muestra los archivos fuente y destino utilizando el mismo porcentaje del área de trabajo de la vista de la interfaz principal. Éste área de la vista proporciona algunas características que le ayudan a optimizar el uso de la disposición de la pantalla mientras observa las diferencias, incluyendo:
La funcionalidad más obvia es que existen barras de desplazamiento en la parte derecha e izquierda del área de vista. Utilizando las barras de desplazamiento es posible moverse rápidamente a través de la comparación.
El espacio vertical entre la vista fuente y la de destino no solo hace posible una vista más clara que permite ver el principio y el fin de las líneas de cada panel, sino que también permite manejar el ajuste del porcentaje ocupado por las vista de fuente y destino que comprenden la vista del panel. Para cambiar el tamaño del panel para una de estas vistas, mantenga el puntero del ratón sobre el manejador del espacio y a continuación mantenga pulsado el botón del ratón y arrástrelo a izquierda y derecho. naturalmente, incrementar el área de uno de los paneles reducirá el área disponible para el panel opuesto del área de la vista de paneles.
El espacio de trabajo puede desempotrarse del interfaz principal pulsando el botón situado en la parte superior derecha del panel del espacio de trabajo principal. Ésto abre el espacio de trabajo principal en una ventana independiente, lo que permitirá maximizarla y redimensionarla a lo largo de la pantalla.
La barra de estado del panel de vista puede activarse o desactivarse seleccionando ->.
Algunas veces puede ser práctico tener en cuenta a qué archivo se le aplicarán las diferencias y qué archivo se considerará fuente. Por ejemplo, cuando se comparan dos versiones modificadas de un arhcivo y se descubre que uno de los archivos tienen muchas más modificaciones que el otro. El archivo con más cambios podría ser una mejor fuente, mientras que aquel con pocas diferencias podría ser al que se aplicasen las diferencias.
En este caso seleccione ->. Ésta opción intercambiará los archivos mostrados en todos los paneles de Kompare.
Para dar un vistazo rápido a las diferencias, seleccione ->. Ésto mostrará el diálogo Estadísticas de diff. Se proporcionará la siguiente información
El nombre del archivo que suele ser habitualmente el archivo de destino o el archivo que no se ha modificado y al qué se aplicarán las diferencias.
El nombre del archivo nuevo que suele coincidir con el archivo fuente o con el archivo que se ha modificado.
El formato diff utilizado para mostrar la diferencia (consulte “Formato”).
El número de bloques que se han encontrado en la diferencia.
Un bloque es un «conjunto» de líneas que contienen diferencias entre la fuente el destino y pueden incluir líneas contextuales dependiendo del valor de las líneas de contexto del formato diff (consulte “Formato”).
El número actual de diferencias encontradas, no de bloques. Un bloque puede contener una o más diferencias cuando el rango de cambio de líneas de cambio y las líneas de contexto de dos o más cambios se solapan.
Kompare permite una navigación rápida por las diferencias tanto a nivel de archivo como a nivel de comparar árboles de carpeta.
Una diferencia se puede seleccionar:
pulsando una línea en el panel de cambios de las líneas fuente y destino (parte superior derecha de la ventana principal).
pulsando la diferencia resaltada en el panel de vista.
recorriendo las diferencias en una comparación (consulte “Recorrer las diferencias”).
Cuando se selecciona una diferencia se considera que tiene «el foco» y se muestra en un color más claro que las diferencias que no están seleccionadas.
Cuenado en una comparación se encuentran diferencias una de las mejores formas de revisarlas es recorrerlas en una orden lógico, generalmente de arriba hacia abajo.
De forma predeterminada Kompare selecciona la primera diferencia que se encuentre en una comparación. Seleccionando -> (Ctrl+Abajo) la siguiente diferencia será la que se seleccione. Para seleccionar la diferencia anterior seleccione -> (Ctrl+Arriba).
De esta forma es posible recorrer las diferencias de una forma ordenanda, aplicando o deshaciendo las diferencias de las revisiones.
Cuando se realiza una comparación a nivel de carpeta, es posible encontrar diferencias en muchos archivos. Se puede encontrar una lista completa de los archivos comparados con las diferencias encontradas en los paneles «Carpetas fuente y destino» y «Archivos fuente y destino». No obstante, Kompare solo muestra una comparación cada vez entre la fuente y el destino.
Para cambiar de documento en este escenario están disponibles las siguientes opciones:
Seleccione el panel «Carpetas fuente y destino» para mostrar en el panel «Archivos fuente y destino» los archivos en los que se han encontrado diferencias, y a continuación seleccione un archivo.
Seleccione -> (Ctrl+RePág) o -> (Ctrl+AvPág) para mostrar en el panel «Archivos fuente y destino» el archivo anterior o siguiente con diferencias.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Kompare realiza la tarea de aplicar o deshacer las diferencias aplicadas con tan solo apuntar y pulsar. Se pueden realizar múltiples operaciones de aplicación o no aplicación en una o en todas las operaciones, permaneciendo en memoria sin escribir los archivos al disco hasta que no se realice la grabación.
Para aplicar una diferencia, pulse la región de la diferencia resaltada, y a continuación seleccione -> (Espacio).
Para deshacer una diferencia, pulse sobre la región de la diferencia resaltada que se hubiera aplicado, y a continuación seleccione -> (Retroceso).
Después de revisar las diferencias entre los archivos y encontrarlas todas aceptable es posible aplicarlas todas en una sola operación seleccionando -> (Ctrl+A).
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Los archivos Diff sólo contienen los cambios hechos en los archivos, o un conjunto de archivos en un sistema de carpetas, y pueden contener o no un número de líneas contextuales después de las líneas de cambios. El conjunto de cambios de una línea y sus líneas de contenido es lo que se conoce como bloque. Por tanto, un archivo diff puede contener varios bloques de uno o más archivos. Cuando las líneas contextuales de dos o más bloques se solapan, se consideran un solo bloque. Los archivos Diff también pueden utilizarse para:
Aplicar los cambios contenidos en los bloques a un archivo original.
Aplicar los cambios contenidos en los bloques a un archivo o conjunto de archivos en un sistema de carpetas.
Realizar modificaciones antes de aplicarlas a un archivo original o a un conjunto de archivos en un sistema de carpetas.
Para crear un archivo diff debe mostrarse una comparación en Kompare. Asumiendo que éste es el caso, a continuación seleccione ->. Ésto mostrará el diálogo Opciones de diff (consulte “Preferencias Diff” para obtener más información sobre los formatos diff y las opciones). Después de configurar estas opciones, pulse el botón y guarde el diff en un archivo con la extensión .diff.
Es posible mostrar los contenidos de un archivo diff en Kompare abriendo el archivo diff con ->.
Cuando se ve un archivo diff, se muestran los bloques entre el archivo fuente y el destino. Recuerde que solo se muestran los bloques, no las líneas que no han sufrido modificación. En algunos casos se crea un archivo diff con 0 líneas de contexto. En este caso solo se mostrarán las líneas cambiadas.
Cuando un archivo diff contiene bloques de varios archivos, Kompare mostrará los bloques para un solo archivo cada vez y podrá moverse de un archivo a otro como si fueran archivos reales, incluso aunque esta información solo la proporcione los contenidos del archivo diff.
Cuando se ven las diferencias en un archivo diff es posible aplicarlas como si estuviera comparando archivos fuente y destino (consulte “Fusionar diferencias”).
En los casos en que se proporcione un archivo diff es posible comparar los bloques en el diff con los de un archivo o carpeta. Para hacerlo seleccione ->. A continuación introduzca las rutas Archivo/Carpeta y Salida diff.
Mientras se están viendo las diferencias entre un archivo fuente y un archivo diff es posible aplicar las diferencias como si estuviera comparando archivos fuente y destino (consulte “Fusionar diferencias”).
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Kompare permite a los usuarios configurar las preferencias sobre su aspecto para dar formato a las diferencias en la interfaz principal y establecer las propiedades de comportamiento del programa diff. Al diálogo Preferencias puede accederse seleccionando ->.
Para configurar las preferencias del aspecto seleccione el elemento de menú Vista (consulte “Preferencias de vista”).
Para configurar las preferencias para las propiedades del programa diff seleccione el elemento de menú Diff (consulte “Preferencias Diff”).
El menú que encontramos en el diálogo Preferencias muestra las pestañas Apariencia y Fuentes.
El formulario Apariencia proporciona los controles para administrar los Colores utilizados para hacer notar la diferencia en la interfaz principal, el comportamiento de la Rueda del ratón cuando la gira y cómo se administra la conversión de los Tabuladores a espacios.
Grupo colores
Para ajustar las preferencias de color utilizadas al mostrar las diferencias, pulse el botón color para mostrar el diálogo Seleccionar color para los siguientes estados:
Líneas que se han eliminado o no existen, entre fuente y destino.
Las líneas que se han cambiado o modificado, entre fuente y destino.
Las líneas que se añadido entre fuente y destino.
Cualquiera de los estados superiores en los que la diferencia se aplicó entre fuente y destino.
Rueda del ratón
El número de líneas a desplazar las diferencias cuando se gira la rueda del ratón hacia delante o atrás.
Tabuladores a espacios
Convierte cada tabulador en n espacios.
El menú del diálogo Preferencias muestra las pestañas Diff, Formato, Opciones y Excluir. Estos formularios puede utilizarse para configurar las propiedades de comportamiento del programa Diff.
Opciones de ajuste para el Formato de salida y el número de Líneas de contexto.
Formato de salida
El formato de salida de contexto añade varias líneas de contexto sobre las líneas en las que se encuentran diferencias.
diff puede generar órdenes que le indican al editor de texto ed cómo cambiar el primer archivo en el segundo. Históricamente, ésta era el único modo de salida aceptable para convertir un archivo en otro. Con la llegada de patch esta opción se utiliza muy raramente.
El formato de salida normal muestra las diferentes líneas sin ninguna línea de contexto.
El formato de salida RCS está especialmente diseñado para utilizarse por el sistema de revisión de control (RCS, del inglés Revision Control System). Al igual que el formato Ed, este formato se utiliza en escasas ocasiones desde que se introdujo el programa patch.
El formato de salida unificado es una variación del formato de contexto. Se considera mejor que el de contexto porque la salida es más compacta que en el de contexto ya que omite líneas de contexto redundantes.
Utilizar el formato cara por cara mostrará los archivos listados en dos columnas con una separador entre ellas. Ésta opción solo está disponible en el diálogo Opciones Diff (consulte “Crear un Diff”).
Líneas de contexto
Cuando se utiliza un formato diff con contexto o unificado utilizar este parámetro permitirá controlar el número de líneas de contexto incluidas.
La pestaña Opciones permite configurar las opciones soportadas por el programa diff.
General
Si se marca fuerza a diff a mostrar los cambios de mayúsculas y minúsculas, puntuación, espacio, etc. cuando se realiza la comprobación.
Indica a diff que procese los archivos con alta velocidad.
Si se marca se omiten los cambios de mayúsculas y minúsculas.
Ignorar expresiones regulares
Ignora las líneas que coincidan con una expresión regular.
Espacios en blanco
Cuando está marcada la salida de diff convertirá los caracteres de tabulación al número de espacios definidos en la opción del menú Preferenciasdentro de la opción Tabuladores a espacios.
Cuando se marca se ignoran las líneas con longitud cero que contengan diferencias entre la fuente y el destino
Pueden cambiarse los espacios en blanco antes, después y entre las líneas dependiendo de los diferentes editores. Cuando se marca esta opción se ignorarán los cambios.
Cuando se marca las diferencias en los espacios en blanco se ignorarán completamente.
Cuando se marca los espacios en blanco resultado del cambio de los tabuladores se ignorarán.
El formulario Excluir activa la utilización de las opciones del filtro proporcionadas por el programa diff.
Patrón de archivo a excluir
Excluye archivos basándose en el filtrado con comodines
Archivo con nombres de archivo a excluir
Define el filtro basado en el contenido de un archivo de administración externo.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Muestra el diálogo Abrir.
Muestra el diálogo Comparar archivos o directorios
Muestra el diálogo Fusionar archivo/directorio con salida diff.
Escribe las diferencias aplicadas al archivo fuente o destino actual.
Escribe las diferencias aplicadas a todos los archivos fuente o destino.
Muestra el diálogo Opciones de diff para definir el formato y las opciones del diff.
Cambia el fuente y el destino.
Muestra el diálogo Mostrar estadísticas
Sale de Kompare
Deshace todos los cambios realizados anteriormente entre la fuente y el destino.
Invierte una diferencia seleccionada que se había aplicado anteriormente.
Aplica una diferencia seleccionada.
Aplica todas las diferencias entre el fuente y el destino.
Sitúa el archivo anterior, en la lista de diferencias, como archivo actual en el panel de vista.
Sitúa el siguiente archivo, en la lista de diferencias, como archivo actual en el panel de vista.
Selecciona la diferencia anterior a la diferencia seleccionada.
Selecciona la siguiente diferencia a la diferencia seleccionada.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Muestra u oculta la barra de herramientas.
Muestra u oculta la barra de estado.
Muestra el panel Vista de texto.
Muestra el diálogo Configurar accesos rápidos.
Muestra la Barra de herramientas de configuración.
Muestra el diálogo Preferencias de Kompare.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Inicia el sistema de ayuda de KDE mostrando las páginas de información de Kompare. (este documento).
Modifica la forma del puntero transformandola en una combinación de flecha e interrogación. Al pulsar sobre elementos dentro de Kompare se abrirá una ventana de ayuda (si existe para ese caso particular) describiendo la función de dicho elemento.
Abre un cuadro de diálogo de informe de fallos donde puede informar de un fallo o solicitar una mejora o nueva propiedad “deseable”.
Mostrará información sobre la versión y el autor.
Muestra la versión de KDE y otra información básica.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Kompare
Derechos de autor del programa. 2001-2004. John Firebaugh (jfirebaugh AT kde.org) y Otto Bruggeman(otto.bruggeman AT home.nl).
Derechos de autor de la documentación. (c) 2007 Sean Wheller (sean AT inwords.co.za).
Traducido por Miguel Revilla Rodríguez (yo AT miguelrevilla.com), Marcos Fouces Lago (mfouces AT yahoo.es) y Santiago Fernández Sancho (santi AT kde-es.org).
Esta documentación está sujeta a los términos de la Licencia de Documentación Libre GNU.
Este programa está sujeto a los términos de la Licencia Pública General GNU.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Tabla de contenidos
Kompare forma parte del proyecto KDE http://www.kde.org/.
Kompare está incluido en el paquete kdesdk en ftp://ftp.kde.org/pub/kde/, el servidor FTP del proyecto KDE.
Para poder compilar e instalar Kompare en su sistema, introduzca las siguientes instrucciones en el directorio raíz de la distribución de Kompare:
%./configure%make%make install
Como Kompare utiliza autoconf y automake no debería producirse ningún problema en la compilación. Si encuentra alguna dificultad le rogamos que se dirija a los foros de discusión de KDE.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team