<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
<book id="index" lang="manual_meld">
  <title>Manual del usuario de Meld</title>

  <bookinfo>
    <title>Manual del usuario de Meld</title>

    <authorgroup>
      <author>
        <firstname>Stephen</firstname>

        <surname>Kennedy</surname>

        <email>stevek@gnome.org</email>
      </author>
    </authorgroup>

    <copyright>
      <year>2004</year>

      <holder>Stephen Kennedy</holder>
    </copyright><copyright><year>2005</year><holder>Jorge González (jorge.gonzalez.gonzalez@hispalinux.es)</holder></copyright><copyright><year>2005</year><holder>Francisco Javier F. Serrador (serrador@gnome.org)</holder></copyright>

    <releaseinfo>Esta es la versión 0.1 del manual de meld y describe la versión 0.9.6 de meld</releaseinfo>
  </bookinfo>

  <chapter id="introduction">
    <title>Introducción</title>

    <sect1 id="introduction_whatismeld">
      <title>¿Qué es meld?</title>

      <para>Meld muestra las diferencias entre archivos y directorios. Meld hace sencillo aislar y mezclar estas diferencias.</para>
    </sect1>

    <sect1 id="introduction_startingmeld">
      <title>Iniciar meld</title>

      <sect2>
        <title>Argumentos para la línea de comandos</title>

        <variablelist>
          <varlistentry>
            <term><userinput>meld</userinput></term>

            <listitem>
              <para>iniciar meld con el diálogo de documento nuevo</para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term><userinput>meld &lt;file&gt; &lt;file&gt;
            [file]</userinput></term>

            <listitem>
              <para>iniciar meld con el modo de comparación para 2 o 3 archivos</para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term><userinput>meld &lt;dir&gt; &lt;dir&gt;
            [dir]</userinput></term>

            <listitem>
              <para>iniciar meld con el modo de comparación para 2 o 3 archivos</para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term><userinput>meld &lt;dir|file&gt;</userinput></term>

            <listitem>
              <para>iniciar meld con el visor de control de código</para>
            </listitem>
          </varlistentry>
        </variablelist>

        <note>
          <para>«&lt;&gt;» denotan argumentos requeridos, «[]» denotan argumentos opcionales y «|» una opción.</para>
        </note>

        <note>
          <para>Ejecute <userinput>meld --help</userinput> para obtener una lista completa de las opciones</para>
        </note>
      </sect2>
    </sect1>
  </chapter>

  <chapter id="filecompare">
    <title>Comparación de archivos</title>

    <sect1 id="filecompare_starting">
      <title>Comenzar</title>

      <para>Para comenzar una comparación nueva use <guimenu>Archivo...-&gt;Nuevo...-&gt;Comparación de archivos</guimenu>. Puede comparar dos o tres archivos.</para>

      <para>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>

      <para>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.</para>
    </sect1>

    <sect1 id="filecompare_summary">
      <title>Resumen de cambios</title>

      <para>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.</para>

      <para>Puede saltar a un cambio individual pulsando en el margen o usando la barra de desplazamiento.</para>
    </sect1>

    <sect1 id="filecompare_detailed">
      <title>Vista detallada</title>

      <para>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.</para>

      <para>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 <keysym>Control+D</keysym>, <keysym>Control+E</keysym>.</para>
    </sect1>

    <sect1 id="filecompare_editing">
      <title>Edición</title>

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

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

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

    <sect1 id="filecompare_filtering">
      <title>Filtrado</title>

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

      <sect2>
        <title>Expresiones regulares</title>

        <para>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.</para>

        <warning>
          <para>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.)</para>
        </warning>

        <para><note>
            <para>Vea el módulo «re» de python para obtener más información acerca de expresiones regulares</para>
          </note></para>
      </sect2>

      <sect2>
        <title>Líneas en blanco</title>

        <para>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.</para>
      </sect2>
    </sect1>

    <sect1 id="filecompare_saving">
      <title>Guardar</title>

      <para>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.</para>

      <para>Guarde un archivo pulsando <keysym>Control+s</keysym>, seleccionando <guimenu>Archivo-&gt;Guardar</guimenu> 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)</para>
    </sect1>

    <sect1 id="filecompare_status">
      <title>Barra de estado</title>

      <para>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.</para>
    </sect1>
  </chapter>

  <chapter id="foldercompare">
    <title>Comparación de carpetas</title>

    <sect1 id="foldercompare_starting">
      <title>Comenzar</title>

      <para>Para comenzar una nueva comparación de directorios use <guimenu>Archivo-&gt;Nuevo...-&gt;Comparación de directorios</guimenu>. Puede comparar dos o tres directorios.</para>

      <para>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>

      <para>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.</para>
    </sect1>

    <sect1 id="foldercompare_summary">
      <title>Resumen de cambios</title>

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

      <para>Puede saltar a un cambio individual pulsando en el margen o usando la barra de desplazamiento.</para>
    </sect1>

    <sect1 id="foldercompare_detailed">
      <title>Vista detallada</title>

      <para>Los archivos modificados se resaltan en rojo, los nuevos en verde y los borrados se tachan. Vea también <xref linkend="dir_content_filtering"/></para>

      <para>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>

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

    <sect1 id="foldercompare_editing">
      <title>Edición</title>

      <para>Active un objeto con una <mousebutton>pulsación doble</mousebutton> del ratón o bien pulsando la tecla <keysym>Intro</keysym>para comenzar una comparación de archivos individual.</para>

      <para>Existen opciones adiciones disponibles en el menú contextual al pulsar con el <mousebutton>botón derecho del ratón</mousebutton>.</para>

      <para>Para seleccionar múltiples objetos utilice <mousebutton>Mayús.+pulsación del ratón</mousebutton> y <mousebutton>Control+pulsación del ratón</mousebutton>.</para>
    </sect1>

    <sect1 id="foldercompare_filtering">
      <title>Filtrado</title>

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

      <sect2>
        <title>Ocultar explícitamente</title>

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

      <sect2>
        <title>Sensibilidad a capitalización</title>

        <para>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.</para>
      </sect2>

      <sect2>
        <title>Filtrado por estado</title>

        <para>Todos los objetos tienen un estado que es uno de: <itemizedlist><listitem><para>Modificado (hay alguna diferencia de contenido entre los archivos presentes)</para></listitem><listitem><para>Nuevo (no hay diferencias de contenido entre los archivos presentes pero el archivo falta en, al menos, un directorio)</para></listitem><listitem><para>Idéntico (los archivos tienen el mismo contenido y todos existen)</para></listitem></itemizedlist></para>

        <para>Use the toolbar buttons to control which items are shown by their state.<note><para>En la versión actual sólo los archivos se filtran por estado. Los directorios siempre se muestran.</para></note></para>
      </sect2>

      <sect2>
        <title>Filtrado por nombre</title>

        <para>Puede ocultar de la comparación los patrones de nombres de archivo seleccionados usando la barra de herramientas. Utilice <guimenu>Configuración-&gt;Preferencias-&gt;Filtros de archivo</guimenu> para personalizar los patrones.</para>
      </sect2>

      <sect2 id="dir_content_filtering">
        <title>Filtrado por contenido</title>

        <para>Si existen diferencias entre archivos, pero todas ellas coinciden con las expresiones regulares especificadas en <guimenu>Configuración-&gt;Preferencias-&gt;Filtros de texto</guimenu>, entonces el nombre de archivo no se resalta en rojo pero aparece en cursiva.</para>
      </sect2>
    </sect1>
  </chapter>

  <chapter id="sourcecontrol">
    <title>Control de código</title>

    <sect1 id="sourcecontrol_starting">
      <title>Comenzar</title>

      <para>Para visualizar una copia de trabajo utilice <guimenu>Archivo-&gt;Nuevo...-&gt;Visor CVS</guimenu> o <guimenu>Archivo-&gt;Nuevo...-&gt;Visor SVN</guimenu>.</para>

      <para>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.</para>
    </sect1>

    <sect1 id="sourcecontrol_filtering">
      <title>Filtrado</title>

      <para>El visor puede filtrar sobre cuatro estados: <itemizedlist><listitem><para>Normal (el archivo no ha sufrido cambios desde la última vez que se revisó)</para></listitem><listitem><para>No controlados (el archivo existe localmente pero no se ha revisado)</para></listitem><listitem><para>Ignorados (el archivo se ignora explícitamente e.j. a través de .cvsignore)</para></listitem><listitem><para>Modificados (localmente, añadidos o eliminados)</para></listitem></itemizedlist></para>

      <para>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».</para>
    </sect1>

    <sect1 id="sourcecontrol_viewing">
      <title>Ver las diferencias</title>

      <para>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.</para>

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

    <sect1 id="sourcecontrol_changes">
      <title>Cambios</title>

      <para>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.</para>
    </sect1>

    <sect1 id="sourcecontrol_console">
      <title>Mostrar la consola</title>

      <para>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.</para>
    </sect1>
  </chapter>
</book>
