# Manual del usuario de Meld

## Introducción

### ¿Qué es meld?

Meld muestra las diferencias entre archivos y directorios. Meld hace sencillo aislar y mezclar estas diferencias.

### Iniciar meld

#### Argumentos para la línea de comandos

`meld`

- iniciar meld con el diálogo de documento nuevo

`meld <file> <file> [file]`

- iniciar meld con el modo de comparación para 2 o 3 archivos

`meld <dir> <dir> [dir]`

- iniciar meld con el modo de comparación para 2 o 3 archivos

`meld <dir|file>`

- iniciar meld con el visor de control de código

«<>» denotan argumentos requeridos, «[]» denotan argumentos opcionales y «|» una opción.

Ejecute `meld --help` para obtener una lista completa de las opciones

## Comparación de archivos

### Comenzar

Para comenzar una comparación nueva use Archivo...->Nuevo...->Comparación de archivos. Puede comparar dos o tres archivos.

Para una comparación de dos archivos, por convenio, el original se muestra en el panel de la izquierda y la versión modificada en el panel de la derecha.

Para una comparación de tres archivos, el original se muestra en el panel del centro y los paneles a izquierda y derecha muestran las versiones modificadas. Por convenio se pone en el panel de la derecha la copia local modificada.

### Resumen de cambios

La posición de los cambios se resume en los márgenes de la ventana a izquierda y derecha. Por omisión el verde marca los añadidos y borrados mientras que el azul son cambios.

Puede saltar a un cambio individual pulsando en el margen o usando la barra de desplazamiento.

### Vista detallada

Los detalles de las diferencias se muestran en el texto y en el panel central. El texto insertado se muestra sobre un fondo sólido. Las líneas que contienen cambios se marcan sobre un fondo claro con los cambios individuales resaltados en un color más fuerte.

El área entre cada archivo muestra dónde ocurre cada cambio en el otro archivos. Puede desplazarse a través de los cambios utilizando la rueda del ratón sobre este área o bien usando las combinaciones de teclas Control+D, Control+E.

### Edición

Puede editar los archivos al igual que si fuese un editor de textos normal. Las diferencias se actualizarán automáticamente. Utilice Control+F para buscar y Control+G para repetir la última búsqueda.

Puede aplicar cambios pulsando los botones de combinar ("->" y "<-"). Manteniendo pulsada la tecla Mayús. se pueden borrar bloques. Manteniendo pulsada la tecla Control se puede hacer que el cambio actual se inserte antes o después de otro cambio.

Puede aplicar todos los cambios desde un archivo pulsando con el botón derecho sobre uno de los paneles de texto y eligiendo `Copiar todo lo de la izquierda` o `Copiar todo lo de la derecha`. También puede lanzar un editor externo desde este menú. Configure el editor externo en Configuración->Preferencias->Editor

### Filtrado

Puede ignorar cierto tipo de diferencias para encontrar diferencias más importantes. Todas estas opciones están disponibles en Configuración->Preferencias->Filtros de texto.

#### Expresiones regulares

Al comparar archivos, cada una de las expresiones regulares seleccionadas se ejecuta alternadamente sobre cada archivo. Si la expresión no contiene grupos entonces cualquier cosa que coincida con la expresión regular se sustituye por una cadena vacía antes de que comience la comparación. Si hay uno o más grupos entonces sólo estos grupos son sustituidos por la cadena vacía en lugar de la coincidencia completa.

El reemplazo ocurre a menudo en varias líneas a la vez. La cadena de entrada puede que contenga caracteres de línea nueva (\n). Si su expresión regular coincide con líneas nuevas la comparación será incorrecta. (La razón técnica es que las actualizaciones de diferencias incrementales en textos multilínea es complicada y no está implementada.)

Vea el módulo «re» de python para obtener más información acerca de expresiones regulares

#### Líneas en blanco

Los cambios que introducen o eliminan líneas en blanco pueden ignorarse. Esta opción es más útil si se usa combinada con uno o más filtros de expresiones regulares.

### Guardar

Cuando se tienen cambios sin guardar, un icono con un disco aparecerá al lado del nombre del archivo que se ha modificado. La etiqueta de la solapa y la ventana contendrán un asterisco después del nombre del archivo.

Guarde un archivo pulsando Control+s, seleccionando Archivo->Guardar desde el menú o bien con el botón de guardar de la barra de herramientas. Todas estas opciones guardan el archivo con el que se está trabajando actualmente (el que contiene el cursor)

### Barra de estado

La barra de estado muestra la posición del cursor (línea y columna) y también el progreso de los mensajes mientras se cargan y comparan archivos.

## Comparación de carpetas

### Comenzar

Para comenzar una nueva comparación de directorios use Archivo->Nuevo...->Comparación de directorios. Puede comparar dos o tres directorios.

Para una comparación de dos archivos, por convenio, el original se muestra en el panel de la izquierda y la versión modificada en el panel de la derecha.

Para una comparación de tres archivos, el original se muestra en el panel del centro y los paneles a izquierda y derecha muestran las versiones modificadas. Por convenio se pone en el panel de la derecha la copia local modificada.

### Resumen de cambios

Similar a la comparación de archivos, en los márgenes de las ventanas se marcan los directorios nuevos, borrados y/o modificados.

Puede saltar a un cambio individual pulsando en el margen o usando la barra de desplazamiento.

### Vista detallada

Los archivos modificados se resaltan en rojo, los nuevos en verde y los borrados se tachan. Vea también dir_content_filtering

El archivo o carpeta más recientemente modificado tiene un punto rojo superpuesto en el icono. Se puede ver información detallada acerca de los permisos y la hora de modificación en la barra de estado al seleccionar el archivo o directorio.

Para navegar utilice el ratón o las teclas Arriba, Abajo, Izquierda y Derecha. Adicionalmente puede usar Control+D y Control+E para moverse por las modificaciones siguiente y previa respectivamente.

### Edición

Active un objeto con una pulsación doble del ratón o bien pulsando la tecla Intropara comenzar una comparación de archivos individual.

Existen opciones adiciones disponibles en el menú contextual al pulsar con el botón derecho del ratón.

Para seleccionar múltiples objetos utilice Mayús.+pulsación del ratón y Control+pulsación del ratón.

### Filtrado

A menudo la comparación inicial contiene demasiada información espúrea. Puede usar los filtros para aislar las diferencias que considere importantes.

#### Ocultar explícitamente

Para ocultar un objeto (y todos los subdirectorios para directorios) use el botón de ocultar de la barra de herramientas.

#### Sensibilidad a capitalización

Por omisión las comparaciones de archivos por nombre son sensibles a capitalización. Utilice el botón de la barra de herramientas para cambiar esta opción.

#### Filtrado por estado

Todos los objetos tienen un estado que es uno de:

- Modificado (hay alguna diferencia de contenido entre los archivos presentes)

- Nuevo (no hay diferencias de contenido entre los archivos presentes pero el archivo falta en, al menos, un directorio)

- Idéntico (los archivos tienen el mismo contenido y todos existen)

Use the toolbar buttons to control which items are shown by their state.

En la versión actual sólo los archivos se filtran por estado. Los directorios siempre se muestran.

#### Filtrado por nombre

Puede ocultar de la comparación los patrones de nombres de archivo seleccionados usando la barra de herramientas. Utilice Configuración->Preferencias->Filtros de archivo para personalizar los patrones.

#### Filtrado por contenido

Si existen diferencias entre archivos, pero todas ellas coinciden con las expresiones regulares especificadas en Configuración->Preferencias->Filtros de texto, entonces el nombre de archivo no se resalta en rojo pero aparece en cursiva.

## Control de código

### Comenzar

Para visualizar una copia de trabajo utilice Archivo->Nuevo...->Visor CVS o Archivo->Nuevo...->Visor SVN.

El visor se usa para examinar y efectuar o revertir cambios locales. No está desarrollado para ser un cliente de control de código completo.

### Filtrado

El visor puede filtrar sobre cuatro estados:

- Normal (el archivo no ha sufrido cambios desde la última vez que se revisó)

- No controlados (el archivo existe localmente pero no se ha revisado)

- Ignorados (el archivo se ignora explícitamente e.j. a través de .cvsignore)

- Modificados (localmente, añadidos o eliminados)

Si existen varios cambios en varios directorios o en un árbol grande, el conmutador «Recursivo» aplanar el listado de directorios. Es especialmente útil usarlo junto con el filtro de «modificados».

### Ver las diferencias

Activar un archivo sin modificar lo abre en el visor de archivos. Activar un archivo modificado abre una comparación de dos vías para examinar los cambios.

Puede examinar varios cambios a la vez usando Mayús+pulsación del ratón y Control+pulsación del ratón para seleccionar múltiples objetos.

### Cambios

La barra de herramientas contiene comandos para realizar las operaciones más comunes sobre el control del código. También se puede acceder a estas operaciones a través de un menú contextual.

### Mostrar la consola

En la parte inferior de la ventana de control de código se puede expandir una ventana que contiene todas las operaciones de control de código y su salida. Pulse en la barra del expansor para cambiar entre ocultar y mostrar la consola.