tde-i18n/tde-i18n-ca/docs/tdesdk/kompare/index.docbook

<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
   <!ENTITY kappname "&kompare;">
   <!ENTITY version "3.4">
   <!ENTITY package "tdesdk">
   <!ENTITY % addindex "IGNORE">
   <!ENTITY % Catalan  "INCLUDE">
]>

<book lang="&language;">

<bookinfo>
 <title>El manual de &kompare;</title>

 <authorgroup>

<author><firstname>Sean</firstname><surname>Wheller</surname><email>sean@inwords.co.za</email></author>
 &traductor.Antoni.Bella; 
 </authorgroup>

<copyright>
<year>2007</year>
<holder>Sean Wheller</holder>
</copyright>

 <legalnotice>&FDLNotice;</legalnotice>

<date>2007-01-20</date>
<releaseinfo>3.4</releaseinfo>

<!-- Abstract about this handbook -->

<abstract>
<para>&kompare; és un programa de frontal &IGU; que habilita diferències entre fitxer font per a que es puguin veure o fusionar. Es pot emprar per a comparar diferències sobre fitxers o continguts de carpetes. També suporta una varietat de formats de diff i proveeix moltes opcions per a personalitzar el nivell d'informació mostrada.</para>
<para>Aquest document descriu &kompare; versió &version;.</para>
</abstract>


<keywordset>
<keyword>KDE</keyword>
<keyword>Kompare</keyword>
<keyword>Diff</keyword>
<keyword>Fusiona</keyword>
<keyword>Pedaç</keyword>
<keyword>Bloc</keyword>
</keywordset>

</bookinfo>

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

<para>Quan dues o més persones treballen sobre un mateix fitxer, van i venen, es torna molt dificultós el veure quins canvis han realitzat a una nova versió o còpia del fitxer. El obrir cara-a-cara la nova còpia i l'original en l'aplicació usada per a crear la còpia final és una solució però resulta laboriós, una gran pèrdua de temps i esdevé un error. Aquí és a on un programa per a mostrar diferències, diffs curts, esdevé d'utilitat.</para>

<para>Tal com s'espera, un nom apropiat per a un programa com aquest seria &quot;diff&quot;. Per descomptat dit programa es troba instal·lat sobre la majoria de sistemes bastas en &Linux; i s'usa exactament per a aquest propòsit. Els desenvolupadors usen diff tot sovint, com a una eina de línia de comandaments, per a mostrar diferències entre versions d'un fitxer de codi font. De tota manera, l'ús de diff no es troba limitat a mostrar les diferències, es pot usar sobre molts altres tipus de fitxer basats en text.</para>

<para>Usar diff des de la línia de comandaments pot resultar confús, aprendre la seva sintaxi i desxifrar-ne la sortida pot desanimar la majoria de la gent. Aquí és a on &kompare; entra en el joc. Proveint un frontal gràfic per al programa diff, la interfície mostra els fitxers font i destí cara-a-cara amb totes les diferències automàticament ressaltades. Partint des d'aquest punt, els canvis en un fitxer es poden aplicar seqüencialment a l'altre fitxer sobre una base selectiva i controlada. No tots els canvis necessiten ser aplicats i si n'apliqueu un, aquest sempre es podrà &apos;desaplicar&apos;. Quan tots els canvis requerits s'hagin d'aplicar llavores es pot desar i es mostrarà com a normal en l'aplicació original emprada per a crear el fitxer.</para>

<para>A més de per a mostrar diferències entre fitxer font i destí, &kompare; es pot usar per a crear i veure un fitxer especial anomenat &apos;diff&apos;. Aquest fitxer captura les diferències entre les dues fonts dintre d'un únic fitxer que es podrà usar per a veure i aplicar canvis a qualsevol altra còpia del fitxer. Per exemple, si dues persones editen un document. La primera persona crearà canvis i els enviarà a la segona persona. Normalment, la primera persona enviarà una còpia completa de les modificacions a la segona persona, de manera que aquesta haurà de comparar el document modificat cara-a-cara amb una versió sense modificar del document. El procés per a això és una mica més elaborat del que s'ha exposat en els anteriors paràgrafs. Amb &kompare; la primera persona primer haurà de crear una còpia local del fitxer a modificar, llavores crear els canvis i comparar l'original i la còpia modificada. Ara usant &kompare; es podrà crear un fitxer diff que només capturi els canvis fets. Aquests es podran enviar a la segona persona en comptes de tot el fitxer que conté els canvis.</para>

<para>Usant &kompare; la segona persona podrà veure el fitxer diff, comparar-lo amb la còpia local del document i aplicar els canvis fets per la primera persona. De manera que aquest procés es podrà fer sobre moltes versions diferents del document, cada persona podrà fer canvis, crear diff, distribuir-los i aplicar-los. Aquest procés s'anomena comunament &quot;apedaçat&quot; (&quot;patching&quot;), un terme agafat del programa anomenat &quot;patch&quot;, el qual és una altra eina de línia de comandaments específicament dissenyada per al propòsit d'aplicar fitxers diff.</para>

<para>A vegades succeeix que gent edita un fitxer alhora. En aquest situació es pot donar el cas que creïn canvis sobre una mateixa línia. Això origina un problema, atès a que si no s'apliquen amb cura, la gent pot estar sobreescriguen la feina d'altres persones que ja han aplicat els seus fitxers de diff. Per sort els desenvolupadors dels programes diff i patch els sembla una qüestió a considerar i aquestes eines no permetran dits canvis sense una intervenció manual. Quan s'abasti dit estat, el coneixereu com a &quot;conflicte&quot;. &kompare; els mostrarà de manera que els pugueu resoldre, decidint quins aplicar al fitxer.</para>

<para>&kompare; també és un gran programa per a comparar canvis de fitxer sobre un nivell de carpeta. Quan s'usa per a comparar carpetes &kompare; examina recursivament les subcarpetes i els seus continguts de fitxer per a les diferències. En aquest cas d'ús, cada fitxer a on es trobin diferències serà automàticament obert i llistat per &kompare; en una manera fàcil de navegació entre els diversos fitxers, a ser possible.</para>

</chapter>

<chapter id="using">
<title>Usar &kompare;</title>

<sect1 id="getting-started">
<title>Començar</title>

<para>Aquesta secció proveeix instruccions per a iniciar &kompare; i proveir una guia ràpida per la interfície principal de &kompare;.</para>

<sect2 id="starting-kompare">
<title>Iniciar &kompare;</title>

<para>Una drecera per iniciar &kompare; es pot trobar en l'ítem <menuchoice><guimenu>Desenvolupament</guimenu><guimenuitem>Kompare</guimenuitem></menuchoice> del &kmenu;.</para>

<para>Quan s'inicia &kompare; la primera cosa que fa és mostrar un formulari de diàleg per a seleccionar els fitxers que voleu comparar. Es poden seleccionar opcions especials per a les propietats del diff i l'aparença. En el formulari de fitxer seleccioneu una font i destí a comparar. Això es pot fer sobre fitxers, carpetes o una &URL; i un fitxer. Una vegada seleccionades la font i el destí feu clic sobre el botó <guibutton>Compara</guibutton>.</para>

<para>Una vegada &kompare; descobreixi les diferències les mostrarà en la interfície principal. El comparar dos fitxers o una &URL; i un fitxer pot prendre uns quants segons. De manera que quan es comparen carpetes amb moltes subcarpetes i fitxers, aquest procés pot prendre una mica més de temps.</para>

<para>Per a una explicació de les opcions disponibles des d'un diff i aparença d'aquest mireu <xref linkend="configure-preferences"/>.</para>
</sect2>

<sect2 id="main-interface">
<title>La interfície principal</title>

<para>Aquesta secció proveeix una guia ràpida de la interfície principal la qual es compren de les àrees següents:</para>
<itemizedlist>
<listitem><para>Menús</para></listitem>
<listitem><para>Barra d'eines</para></listitem>
<listitem><para>Carpetes font i destí</para></listitem>
<listitem><para>Fitxers font i destí</para></listitem>
<listitem><para>Canvis a línia font i destí</para></listitem>
<listitem><para>Vista de text font i destí</para></listitem>
<listitem><para>Barra d'estat</para></listitem>
</itemizedlist>

<sect3 id="menus">
<title>Menús</title>
<para>&kompare; proveeix un menú amb una interfície caviant. L'explicació per als ítems de menú i les seves opcions es proveeixen en <xref linkend="command-reference"/>.</para>
</sect3>

<sect3 id="toolbar">
<title>Barra d'eines</title>
<para>La barra d'eines de &kompare; proveeix dreceres per a les operacions de diff i fusionat emprades més sovint. La barra d'eines conté les propietats orientació, posició de text, mida d'icones i quines dreceres d'icona seran mostrades, per a personalitzar el menú de context accedit fent clic amb el &BDR; sobre la barra d'eines. El menú també habilita o oculta la barra d'eines. Si la barra d'eines resta oculta i necessiteu tornar-la a mostrar, seleccioneu <menuchoice><guimenu>Arranjament</guimenu><guimenuitem>Mostra la barra d'eines</guimenuitem></menuchoice>.</para>
</sect3>

<sect3 id="source-destination-folders">
<title>Carpetes font i destí</title>
<para>Els plafons de carpeta font i destí mostren el contingut del que s'està comparant. Quan en la comparació s'inclouen moltes subcarpetes, llavores seleccionant una carpeta es mostrarà el primer document en dita carpeta que contingui una diferència a mostrar entre la font i el destí.</para>
</sect3>

<sect3 id="source-destination-files">
<title>Fitxers font i destí</title>
<para>El plafó de fitxer font i destí mostra els fitxers en els que es troba una diferència per a la carpeta font o destí actual. Quan una carpeta conté múltiples fitxers amb diferències, seran llistats tots els documents amb alguna diferència. El document seleccionat serà mostrat.</para>
</sect3>

<sect3 id="source-destination-lines">
<title>Canvis a línia font i destí</title>
<para>El plafó de canvis a línia font i destí recull les diferències trobades entre els documents font i destí. Seleccionar una de les entrades la ressaltarà al plafó i seleccionarà la diferència. Això és d'utilitat per a navegar i inspeccionar documents llargs amb moltes diferències.</para>
</sect3>

<sect3 id="source-destination-view">
<title>Vista font i destí</title>
<para>La vista font i destí és l'espai de treball principal de &kompare;. El contingut i diferències ressaltades del fitxer font i destí actual són mostrades aquí amb números de línia.</para>
</sect3>

<sect3 id="text-view">
<title>Vista de text</title>
<para>La <guilabel>Vista de text</guilabel> per omissió no és mostrada. Aquesta es pot obrir seleccionant <menuchoice><guimenu>Arranjament</guimenu><guimenuitem>Mostar vista de text</guimenuitem></menuchoice>.</para>
<!-- Other than a notepad, what is this text view good for?  -->
</sect3>

<sect3 id="statusbar">
<title>Barra d'estat</title>
<para>La barra d'estat proveeix un resum del fitxer o carpeta font i destí sota comparació. La barra d'estat també informa el nombre de canvis trobats en el document actual i du la comptabilitat de les diferències que han estat aplicades. A més, la barra d'estat mostar una vista ràpida del nombre de documents que contenen diferències i el número del document que està seleccionat. Per exemple, una comparació sobre dues carpetes pot retornar 1890 fitxers amb diferències. El document actualment seleccionat seria el número 18.</para>
</sect3>
</sect2>
</sect1>

<sect1 id="viewing-differences">
<title>Visualitzar les diferències</title>

<sect2 id="managing-screen-real-estate">
<title>Gestionar l'estat real a la pantalla</title>
<para>&kompare; mostra el fitxer font i destí emprant un tant percent igual de l'àrea de treball de vista en la interfície principal. Aquesta àrea proveeix algunes característiques que ajuden a optimitzar l'ús de l'estat real a la pantalla mentre es visualitzen les diferències, incloent:</para>
<variablelist>
<varlistentry>
<term>Barra de desplaçament doble</term>
<listitem><para>La característica més òbvia és que es proveeixen des barres de desplaçament; una sobre la dreta i l'altra sobre l'esquerra de l'àrea de vista. Usant-les és possible moure's ràpidament a traves de la comparació.</para></listitem>
</varlistentry>
<varlistentry>
<term>Canviar de lloc la nansa</term>
<listitem><para>L'espai vertical entre la vista font i destí no tan sols fa possible el veure l'inici i final de les línies dels plafons, sinó que també és una nansa que permet ajustar el tant percent ocupat entre les vistes font i destí que comprenen el plafó de vista. Per a canviar la mida del plafó per a una de les vistes, mantenir el punter del ratolí sobre la nansa i llavors premeu el botó del ratolí i arrossegueu-lo a dreta o esquerra. Naturalment, incrementa l'àrea d'un plafó fent minvar l'àrea disponible en els contigus.</para></listitem>
</varlistentry>
<varlistentry>
<term>Ancorar</term>
<listitem><para>L'espai de treball principal es pot ancorar des de la interfície principal fent clic sobre el botó <guibutton>desancora</guibutton> localitzat a la part superior dreta del plafó principal. Aquest obre l'espai de treball principal en una finestra pròpia, permetent amidar-la al llarg de la pantalla.</para></listitem>
</varlistentry>
<varlistentry>
<term>Canviar la barra d'estat</term>
<listitem>
<para>La barra d'estat del plafó de vista es pot mostar o ocultar seleccionant <menuchoice><guimenu>Arranjament</guimenu><guimenuitem>Mostra/Oculta la barra d'estat</guimenuitem></menuchoice>.</para>
</listitem>
</varlistentry>
</variablelist>
</sect2>

<sect2 id="switching-source-and-destination-view">
<title>Canviar les vistes font i destí</title>

<para>A vegades es pot usar per a considerar quin fitxer amb quines diferències seran aplicades com a la font. Per exemple, quan es comparen dues versions modificades d'un fitxer i es descobreix que un d'aquests conté moltes més modificacions que l'altra. El fitxer amb més canvis fora millor com a font, atès que serà necessari aplicar menys diferències.</para>
<para>En aquest cas seleccioneu <menuchoice><guimenu>Fitxer</guimenu><guimenuitem>Intercanvia font amb destí</guimenuitem></menuchoice>. Això canviarà els fitxers mostrats en tots els plafons.</para>
</sect2>
	
<sect2 id="display-difference-statistics">
<title>Mostrar estadístiques de diferències</title>
<para>Per a un resum ràpid de les diferències, seleccioneu <menuchoice><guimenu>Fitxer</guimenu><guimenuitem>Mostra estadístiques</guimenuitem></menuchoice>. El qual mostrarà el diàleg <guilabel>Estadístiques del diff</guilabel>. Es proveirà la següent informació:</para>
<variablelist>
<varlistentry>
<term><guilabel>Fitxer antic:</guilabel></term>
<listitem><para>El nom de fitxer que serà usualment el fitxer de destí o el fitxer que restarà sense modificar i al qual s'aplicaran les diferències.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Fitxer nou:</guilabel></term>
<listitem><para>El nom de fitxer que usualment serà el fitxer font o el fitxer que restarà sense modificar.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Format:</guilabel></term>
<listitem><para>El format diff usat per a mostrar la diferència (mireu <xref linkend="diff-format"/>).</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Nombre de blocs:</guilabel></term>
<listitem>
<para>El nombre de blocs trobats en la diferència.</para>
<para>Un bloc és un <quote><emphasis>bloc</emphasis></quote> de línies que han estat marcades com a diferents entre font i destí i poden incloure línies de context depenent del format de diff, al valor <guilabel>Línies de context</guilabel> (mireu <xref linkend="diff-format"/>).</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Nombre de diferències</guilabel></term>
<listitem><para>El nombre de diferències trobades, no blocs. Un bloc pot contenir una o més diferències quan el rang de línia canviada i les línies de context d'un o més canvis es solapen.</para></listitem>
</varlistentry>
</variablelist>
</sect2>

<sect2 id="navigating-the-difference-view">
<title>Navegar a través de la vista de diferències</title>
<para>&kompare; habilita la navegació ràpida de diferències sobre un fitxer i de múltiples fitxers quan es tracta de comparar arbres de carpetes.</para>

<sect3 id="selecting-a-difference">
<title>Seleccionar una diferència</title>
<para>Es pot seleccionar una diferència usant:</para>
<itemizedlist>
<listitem><para>Fer clic sobre el plafó de canvis a línia font i destí (d'alt a la dreta de la finestra principal).</para></listitem>
<listitem><para>Fer clic sobre la diferència ressaltada en el plafó de vista.</para></listitem>
<listitem><para>Travessar les diferències llistades en una comparació (mireu <xref linkend="traversing-differences"/>).</para></listitem>
</itemizedlist>
<para>Quan una diferència està seleccionada aquesta es considera que obté <quote>el focus</quote> i es mostra en un color fort que difereix de les sense seleccionar.</para>
</sect3>
			
<sect3 id="traversing-differences">
<title>Travessar les diferències</title>
<para>Quan una comparació troba moltes diferències, una de les millors maneres d'entre-les és travessar-les seguint un ordre lògic, usualment de d'alt a baix.</para>
<para>Per omissió &kompare; selecciona la primera diferència trobada en una comparació. Per a seleccionar la diferència següent seguiu la selecció actual fins que obtingui el focus <menuchoice><guimenu>Diferència</guimenu><guimenuitem>Diferència següent</guimenuitem></menuchoice> (<keycombo action="simul">&Ctrl;<keycap>Avall</keycap></keycombo>). Per a seleccionar la diferència anterior seguiu la selecció actual fins que obtingui el focus <menuchoice><guimenu>Diferència</guimenu><guimenuitem>Diferència anterior</guimenuitem></menuchoice> (<keycombo action="simul">&Ctrl;<keycap>Amunt</keycap></keycombo>).</para>
<para>D'aquesta manera és possible travessar les diferències en una manera ordenada, aplicant i desaplicant diferències a mesura que les anem visualitzant.</para>
</sect3>

<sect3 id="switching-between-files">
<title>Canviar entre fitxers</title>
<para>Quan s'ha realitzat una comparció dintre d'un nivell de carpeta, la majoria de fitxers poden trobar-se amb diferències. Una llista completa dels fitxers comparats amb les diferències trobades és proveida en els plafons <quote>Carpetes font i destí</quote> i <quote>Fitxers font i destí</quote>. De tota manera, &kompare; mostra les diferències entre font i destí en una manera d'una comparació cada vegada.</para>
<para>Per a canviar entre documents en aquest escenari estan disponibles les següents opcions:</para>
<itemizedlist>
<listitem><para>Seleccionar el plafó <quote>Carpetes font i destí</quote> per a mostrar les diferències trobades en el plafó <quote>Fitxers font i destí</quote>, llavors seleccioneu un fitxer.</para></listitem>
<listitem><para>Seleccionar <menuchoice><guimenu>Diferència</guimenu><guimenuitem>Fitxer previ</guimenuitem></menuchoice> (<keycombo action="simul">&Ctrl;<keycap>RePàg</keycap></keycombo>) o <menuchoice><guimenu>Diferència</guimenu><guimenuitem>Fitxer següent</guimenuitem></menuchoice> (<keycombo action="simul">&Ctrl;<keycap>AvPàg</keycap></keycombo>) per a mostrar la diferència anterior o següent trobada en el fitxer al plafó <quote>Fitxers font i destí</quote>.</para>
</listitem>
</itemizedlist>
</sect3>
</sect2>
</sect1>

<sect1 id="merging-differences">
<title>Fusionar les diferències</title>

<para>&kompare; fa la tasca d'aplicar i desaplicar diferències com a un simple apunta i fes clic. Es poden fer múltiples accions sobre una mateixa diferència, degut a que aquestes es mantindran en memòria i no seran escrites al fitxer del disc fins que l'operació sigui realitzada.</para>

<sect2 id="applying-a-difference">
<title>Aplicar una diferència</title>
<para>Per aplicar una diferència, feu clic sobre la regió de diferència per a ressaltar-la, llavors seleccioneu <menuchoice><guimenu>Diferència</guimenu><guimenuitem>Aplica la diferència</guimenuitem></menuchoice> (<keycombo><keycap>Espai</keycap></keycombo>).</para>
</sect2>

<sect2 id="unapplying-a-difference">
<title>Desaplicar una diferència</title>
<para>Per a desaplicar una diferència, feu clic sobre la regió de diferència per a ressaltar-la, llavors seleccioneu <menuchoice><guimenu>Diferència</guimenu><guimenuitem>Desaplica la diferència</guimenuitem></menuchoice> (<keycombo><keycap>Espai enrere</keycap></keycombo>).</para>
</sect2>
	
<sect2 id="applying-all-differences">
<title>Aplicar totes les diferències</title>
<para>Després de revisar diferències entre fitxers i trobar totes acceptables les podreu aplicar amb una única operació seleccionat <menuchoice><guimenu>Diferència</guimenu><guimenuitem>Aplica-ho tot</guimenuitem></menuchoice> (<keycombo><keycap>A</keycap></keycombo>).</para>
</sect2>

<sect2 id="unapplying-all-differences">
<title>Desaplicar totes les diferències</title>
<para>Per a diferències que han estat aplicades seleccioneu <menuchoice><guimenu>Diferència</guimenu><guimenuitem>Desaplica-ho tot</guimenuitem></menuchoice> (<keycombo><keycap>U</keycap></keycombo>).</para>
</sect2>

<sect2 id="saving-changes">
<title>Desar canvis</title>
<para>Una vegada les diferències han estat aplicades podreu fer l'acció de desar seleccionant <menuchoice><guimenu>Fitxer</guimenu><guimenuitem>Desa</guimenuitem></menuchoice> o <menuchoice><guimenu>Fitxer</guimenu><guimenuitem>Desa-ho tot...</guimenuitem></menuchoice>.</para>
<para>Les diferències són desades tant al fitxer font com al de destí.</para>
</sect2>
</sect1>

<sect1 id="working-with-diff-files">
<title>Treballar amb fitxers diff</title>
<para>Els fitxers diff només contenen els canvis fets entre fitxers, o un conjunt de fitxers en un sistema de carpeta, i poden o no contenir un cert nombre de línies de context abans i després de les línies canviades. La suma d'una línia canviada i les seves línies de context es mostren com a un bloc. Quan les línies de context de dos o més blocs es solapen, llavores es consideren un únic bloc. Els fitxers diff es poden usar per a:</para>
<itemizedlist>
<listitem><para>Aplicar els canvis continguts en els blocs a un fitxer original.</para></listitem>
<listitem><para>Aplicar els canvis continguts en els blocs a un fitxer o conjunt de fitxers original dintre d'un sistema de carpeta.</para></listitem>
<listitem><para>Modificar abans d'aplicar a un fitxer o conjunt de fitxers original dintre d'un sistema de carpeta.</para></listitem>
</itemizedlist>

<sect2 id="creating-a-diff">
<title>Crear un diff</title>
<para>Per a crear un fitxer diff s'haurà de mostrar una comparació a &kompare;. Assumim que aquest és el cas, llavores seleccioneu <menuchoice><guimenu>Fitxer</guimenu><guimenuitem>Desa .diff</guimenuitem></menuchoice>. Això mostrarà el diàleg <guilabel>Opcions de diff</guilabel> (mireu <xref linkend="diff-settings"/> per a més informació sobre els formats i opcions de diff). Després de configurar aquestes opcions, feu clic sobre el botó <guibutton>Desa</guibutton> i es desarà el diff a un fitxer amb la extensió <filename class="extension">.diff</filename>.</para>
</sect2>

<sect2 id="displaying-a-diff">
<title>Mostrar un diff</title>
<para>És possible mostrar el contingut d'un fitxer diff amb &kompare; obrint el formulari de fitxer diff <menuchoice><guimenu>Fitxer</guimenu><guimenuitem>Obre diff...</guimenuitem></menuchoice>.</para>
<para>Quan es visualitza un fitxer diff es mostren els blocs entre el fitxer font i destí, recordant que només es mostren els blocs, no les línies sense modificar. En alguns casos es crea un fitxer diff amb 0 línies de context. En aquest cas tan sols es mostraran les línies canviades.</para>
<para>Quan un fitxer diff conté blocs de múltiples fitxers &kompare; mostra els blocs de cada fitxer un a la vegada i podreu canviar entre aquests com si fossin fitxers reals , encara que el contingut del fitxer diferent només ofereixi la informació proveïda pel diff.</para>
</sect2>

<sect2 id="applying-a-diff">
<title>Aplicar diferències en un fitxer diff</title>
<para>Quan es visualitzen diferències en un fitxer diff és possible aplicar la diferència quan es comparen els fitxers font i destí (mireu <xref linkend="merging-differences"/>).</para>
</sect2>

<sect2 id="blending-a-diff">
<title>Fusionar una &URL; amb un diff</title>
<para>En els casos on es proveeix un fitxer diff és possible comparar els blocs en el diff contra un fitxer o carpeta. Per a fer-ho seleccioneu <menuchoice><guimenu>Fitxer</guimenu><guimenuitem>Fusiona la URL amb el diff...</guimenuitem></menuchoice> Llavores introduïu les rutes cap al <guilabel>Fitxer/carpeta</guilabel> i la <guilabel>Sortida de diff</guilabel>.</para>
<para>Quan es visualitzen diferències entre un fitxer font i un fitxer diff és possible aplicar la diferència mentre compareu els fitxers font i destí (mireu <xref linkend="merging-differences"/>).</para>
</sect2>

</sect1>
</chapter>

<chapter id="configure-preferences">
<title>Configurar les preferències</title>

<para>&kompare; habilita als usuaris un conjunt de preferències d'aparença per a formatar les diferències en la interfície principal i establir les propietats de comportament del programa diff. Es pot accedir al diàleg <guilabel>Preferències</guilabel> seleccionant <menuchoice><guimenu>Arranjament</guimenu><guisubmenu>Configura &kompare;...</guisubmenu></menuchoice></para>

<para>Per a configurar les preferències de l'aparença seleccioneu l'ítem de menú <guilabel>Visualitza</guilabel> (mireu <xref linkend="view-settings"/>).</para>

<para>Per a configurar les preferències de propietats del programa diff seleccioneu l'ítem de menú <guilabel>Diferència</guilabel> (mireu <xref linkend="diff-settings"/>).</para>

<sect1 id="view-settings">
<title>Arranjament de la vista</title>
<para>El menú <guimenu>Visualitza</guimenu> es troba sobre el diàleg <guilabel>Preferències</guilabel> i mostra els formularis en pestanya <guilabel>Aparença</guilabel> i <guilabel>Fonts</guilabel>.</para>

<sect2 id="appearance">
<title>Aparença</title>
<para>El formulari <guilabel>Aparença</guilabel> proveeix controls per a gestionar els <guilabel>Colors</guilabel> usats per a remarcar les diferències en la interfície principal, el comportament de la <guilabel>Roda del ratolí</guilabel> quan juga amunt i avall així com la conversió de <guilabel>Tabulacions a espais</guilabel>.</para>
<screenshot>
<screeninfo>Arranjament de l'aparença a &kompare;</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="settings-view1.png" format="PNG"/>
      </imageobject>
        <textobject>
        <phrase>Arranjament de l'aparença a &kompare;</phrase>
      </textobject>
    </mediaobject>
</screenshot>
<variablelist>
<title>Grup de color</title>
<para>Per ajustar les preferències de color usades quan es mostren les diferències, feu clic al botó de color per a mostrar el diàleg <guilabel>Trieu el color</guilabel> perla següents estats:</para>
<varlistentry>
<term><guilabel>Color de eliminat</guilabel></term>
<listitem><para>Línies que han estat eliminades, que no existeixen, entre la font i el destí.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Color de canviat</guilabel></term>
<listitem><para>Línies que han estat canviades, modificades, entre la font i el destí. </para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Color de afegit</guilabel></term>
<listitem><para>Línies que han estat afegides entre la font i el destí.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Color de aplicat</guilabel></term>
<listitem><para>Qualsevol dels anteriors estats a on la diferència ha estat aplicada entre la font i el destí.</para></listitem>
</varlistentry>
</variablelist>
<variablelist>
<title>Roda del ratolí</title>
<varlistentry>
<term><guilabel>Nombre de línies</guilabel></term>
<listitem><para>El nombre de línies que es saltaran en moure endavant o enrere la roda del ratolí.</para></listitem>
</varlistentry>
</variablelist>
<variablelist>
<title>Tabulacions a espais</title>
<varlistentry>
<term><guilabel>Nombre d'espais als que convertir un caràcter de tabulació</guilabel></term>
<listitem><para>Converteix cada caràcter de tabulació a un número de caràcters d'espai.</para></listitem>
</varlistentry>
</variablelist>
</sect2>

<sect2 id="fonts">
<title>Fonts</title>
<screenshot>
<screeninfo>Arranjament de fonts a &kompare;</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="settings-view2.png" format="PNG"/>
      </imageobject>
        <textobject>
        <phrase>Arranjament de fonts a &kompare;</phrase>
      </textobject>
    </mediaobject>
</screenshot>
<para>Selecciona la família i mida de la font a mostrar quan es mostrin les diferències.</para>
</sect2>
</sect1>

<sect1 id="diff-settings">
<title>Arranjament de diff</title>
<para>El menú <guimenu>Diff</guimenu> trobat sobre el diàleg <guilabel>Preferències</guilabel> mostra els formularis en pestanya <guilabel>Diff</guilabel>, <guilabel>Format</guilabel>, <guilabel>Opcions</guilabel> i <guilabel>Excloure</guilabel>. Aquests formularis es poden usar per a configurar les propiestats en el comportament del programa Diff.</para>

<sect2 id="diff">
<title>Diff</title>
<screenshot>
<screeninfo>Arranjament de diff a &kompare;</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="settings-diff1.png" format="PNG"/>
      </imageobject>
        <textobject>
        <phrase>Arranjament de diff a &kompare;</phrase>
      </textobject>
    </mediaobject>
</screenshot>
<para>El comandament usat per executar el programa diff (per omissió <application>diff</application>).</para>
</sect2>

<sect2 id="diff-format">
<title>Format</title>
<screenshot>
<screeninfo>Arranjament de format a &kompare;</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="settings-diff2.png" format="PNG"/>
      </imageobject>
        <textobject>
        <phrase>Arranjament de format a &kompare;</phrase>
      </textobject>
    </mediaobject>
</screenshot>
<para>Ajusta les opcions per al <guilabel>Format de sortida</guilabel> i el nombre de <guilabel>Línies de context</guilabel>.</para>
<variablelist>
<title>Format de la sortida</title>
<varlistentry>
<term><guilabel>Context</guilabel></term>
<listitem>
<para>El format de sortida context afegeix diverses línies de context de les que es troben al voltant de la/les que difereixen.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Ed</guilabel></term>
<listitem>
<para>diff pot produir comandaments que surtin directament cap a l'editor ed per a canviar el primer fitxer dintre del segon. Històricament, aquesta manera tan sols és una sortida adequada per a edició automàtica d'un fitxer dintre d'un altre. Amb l'aparició de <application>patch</application> aquesta opció gairebé no s'usa mai.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Normal</guilabel></term>
<listitem>
<para>El format de sortida normal mostra les línies diferents sense cap línia de context. </para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>RCS</guilabel></term>
<listitem>
<para>El format de sortida RCS està especialment dissenyat per a ser usat pel sistema de control de revisions (Revision Control System - <acronym>RCS</acronym>). Com amb el format Ed, aquest format s'empra rarament degut a la introducció del programa <application>patch</application>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Unificat</guilabel></term>
<listitem>
<para>El format de sortida unificat és una variació del format de context. Aquest es considera una millora degut a que és més compacte i omet línies de context redundants.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Cara-a-cara</guilabel></term>
<listitem>
<para>Aquest format de sortida mostra els fitxers llistats en dues columnes amb un separador entre ells. Aquesta opció tan sols està disponible des del diàleg <guilabel>Opcions del diff</guilabel> (mireu <xref linkend="creating-a-diff"/>).</para>
</listitem>
</varlistentry>
</variablelist>
<variablelist>
<title>Línies de context</title>
<varlistentry>
<term><guilabel>Nombre de línies de context</guilabel></term>
<listitem>
<para>Quan es realitza un diff amb format de sortida de context o unificada s'usa aquest paràmetre per a controlar el nombre de línies de context a incloure.</para>
</listitem>
</varlistentry>
</variablelist>
</sect2>

<sect2 id="options">
<title>Opcions</title>
<screenshot>
<screeninfo>Arranjament de les opcions a &kompare;</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="settings-diff3.png" format="PNG"/>
      </imageobject>
        <textobject>
        <phrase>Arranjament de les opcions a &kompare;</phrase>
      </textobject>
    </mediaobject>
</screenshot>
<para>El formulari en pestanya <guilabel>Opcions</guilabel>  permet la configuració de les opcions suportades pel programa diff.</para>
<variablelist>
<title>General</title>
<varlistentry>
<term><guilabel>Cerca canvis menors</guilabel></term>
<listitem><para>Quan està marcat força el mostra canvis en la puntuació, espais, &etc;</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Optimitza per a fitxers grans</guilabel></term>
<listitem><para>Quan està marcat diff processa els fitxers a gran velocitat.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Ignora canvis entre minúscula/majúscula</guilabel></term>
<listitem><para>Quan està marcat els canvis entre majúscules i minúscules seran omesos.</para></listitem>
</varlistentry>
</variablelist>
<variablelist>
<title>Ignora expressió regular</title>
<varlistentry>
<term><guilabel>Ignora expressió regular</guilabel></term>
<listitem><para>Ignora les línies que coincideixin amb una expressió regular.</para></listitem>
</varlistentry>
</variablelist>
<variablelist>
<title>Espai en blanc</title>
<varlistentry>
<term><guilabel>Expandre les tabulacions a espais a la sortida</guilabel></term>
<listitem><para>Quan està marcat les sortides de diff convertirà els caràcters de tabulació al nombre d'espais definit en el diàleg <guilabel>Preferències</guilabel> menú <guimenu>Visualitza</guimenu> opció <guilabel>Tabulacions a espais</guilabel>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Ignora línies buides afegides o eliminades</guilabel></term>
<listitem><para>Quan està marcat les línies amb zero caràcters que difereixin entre la font i el destí seran ignorades.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Ignora canvis en la quantitat d'espais en blanc</guilabel></term>
<listitem><para>L'espai abans, després i entre les línies es pot canviar depenent dels diferents editors. Quan aquesta opció està marcada canvis com aquests seran ignorats.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Ignora tots els espais en blanc</guilabel></term>
<listitem><para>Quan està marcat les diferències d'espai en blanc seran completament ignorades.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Ignora canvis provocats per la distància de tabulació</guilabel></term>
<listitem><para>Quan està marcat els canvis resultants d'un espai en blanc en caràcters de tabulació seran ignorats.</para></listitem>
</varlistentry>
</variablelist>
</sect2>

<sect2 id="exclude">
<title>Excloure</title>
<para>El formulari en pestanya <guilabel>Excloure</guilabel> habilita l'ús de les opcions de filtre proveïdes pel programa diff.</para>
<screenshot>
<screeninfo>Arranjament de excloure a &kompare;</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="settings-diff4.png" format="PNG"/>
      </imageobject>
        <textobject>
        <phrase>Arranjament de excloure a &kompare;</phrase>
      </textobject>
    </mediaobject>
</screenshot>
<variablelist>
<title>Patró de fitxer a excloure</title>
<varlistentry>
<term><guilabel>Patró de fitxer a excloure</guilabel></term>
<listitem><para>Exclou fitxers basant-se en el filtratge sobre un jòquer.</para></listitem>
</varlistentry>
</variablelist>
<variablelist>
<title>Fitxer amb noms de fitxer a excloure</title>
<varlistentry>
<term><guilabel>Fitxer amb noms de fitxer a excloure</guilabel></term>
<listitem><para>Defineix el filtratge basant-se en el contingut d'un fitxer de gestió extern.</para></listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>

</chapter>

<chapter id="command-reference">
<title>Referència de comandaments</title>

<sect1 id="file-menu">
<title>El menú <guimenu>Fitxer</guimenu></title>
<variablelist>
<varlistentry>
<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>O</keycap></keycombo> </shortcut> <guimenu>Fitxer</guimenu><guimenuitem>Obre diff...</guimenuitem></menuchoice></term>
<listitem><para>Mostra el diàleg <guilabel>Obre</guilabel>.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>C</keycap></keycombo> </shortcut> <guimenu>Fitxer</guimenu><guimenuitem>Compara fitxers...</guimenuitem></menuchoice></term>
<listitem><para>Mostra el diàleg <guilabel>Compara fitxers o carpetes</guilabel>.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>B</keycap></keycombo> </shortcut> <guimenu>Fitxer</guimenu><guimenuitem>Fusiona la URL amb el diff...</guimenuitem></menuchoice></term>
<listitem><para>Mostra el diàleg <guilabel>Fusiona el fitxer/carpeta amb la sortida de diff</guilabel>.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo> </shortcut> <guimenu>Fitxer</guimenu><guimenuitem>Desa</guimenuitem></menuchoice></term>
<listitem><para>Escriu les diferències aplicades a la font actual i/o al fitxer destí.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><guimenu>Fitxer</guimenu><guimenuitem>Desa-ho tot</guimenuitem></menuchoice></term>
<listitem><para>Escriu les diferències aplicades a totes les fonts i/o fitxers destí.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><guimenu>Fitxer</guimenu><guimenuitem>Desa .diff</guimenuitem></menuchoice></term>
<listitem><para>Mostra el diàleg <guilabel>Opcions de diff</guilabel> per a definir el format i opcions de diff.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><guimenu>Fitxer</guimenu><guimenuitem>Intercanvia font amb destí</guimenuitem></menuchoice></term>
<listitem><para>Canvis font i destí.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><guimenu>Fitxer</guimenu><guimenuitem>Mostra estadístiques</guimenuitem></menuchoice></term>
<listitem><para>Mostra el diàleg <guilabel>Estadístiques de diff</guilabel>.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo> </shortcut> <guimenu>Fitxer</guimenu><guimenuitem>Abandona</guimenuitem></menuchoice></term>
<listitem><para>Surt de &kompare;.</para></listitem>
</varlistentry>
</variablelist>
</sect1>

<sect1 id="difference-menu">
<title>El menú <guimenu>Diferència</guimenu></title>
<variablelist>
<varlistentry>
<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>U</keycap></keycombo> </shortcut> <guimenu>Diferència</guimenu><guimenuitem>Desfés-ho tot</guimenuitem></menuchoice></term>
<listitem><para>Desaplica totes les diferències prèviament aplicades entre font i destí.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><shortcut><keycap>Espai enrere</keycap></shortcut> <guimenu>Diferència</guimenu><guimenuitem>Desfés diferència</guimenuitem></menuchoice></term>
<listitem><para>Reverteix una diferència seleccionada prèviament aplicada.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><shortcut><keycap>Espai</keycap></shortcut> <guimenu>Diferència</guimenu><guimenuitem>Aplica la diferència</guimenuitem></menuchoice></term>
<listitem><para>Aplica una diferència seleccionada.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>A</keycap></keycombo> </shortcut> <guimenu>Diferència</guimenu><guimenuitem>Aplica-ho tot</guimenuitem></menuchoice></term>
<listitem><para>Aplica totes les diferències entre font i destí.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>RePàg</keycap></keycombo> </shortcut> <guimenu>Diferència</guimenu><guimenuitem>Fitxer previ</guimenuitem></menuchoice></term>
<listitem><para>Crea la diferència prèvia, en la llista de diferències, el fitxer actual en el plafó de vista.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>AvPàg</keycap></keycombo> </shortcut> <guimenu>Diferència</guimenu><guimenuitem>Fitxer següent</guimenuitem></menuchoice></term>
<listitem><para>Crea la diferència següent, en la llista de diferències, el fitxer actual en el plafó de vista.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>Amunt</keycap></keycombo> </shortcut> <guimenu>Diferència</guimenu><guimenuitem>Diferència anterior</guimenuitem></menuchoice></term>
<listitem><para>Selecciona la diferència immediatament a sobre de la diferència actualment seleccionada.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>Avall</keycap></keycombo> </shortcut> <guimenu>Diferència</guimenu><guimenuitem>Diferència següent</guimenuitem></menuchoice></term>
<listitem><para>Selecciona la diferència immediatament a sota de la diferència actualment seleccionada.</para></listitem>
</varlistentry>
</variablelist>
</sect1>

<sect1 id="settingsmenu">
<title>El menú <guimenu>Arranjament</guimenu></title>
<variablelist>
<varlistentry>
<term><menuchoice><guimenu>Arranjament</guimenu><guimenuitem>Mostra/Oculta la barra d'eines</guimenuitem></menuchoice></term>
<listitem><para>Canvia el mostrar o cultar la barra d'eines.</para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><guimenu>Arranjament</guimenu> <guimenuitem>Mostra/Oculta la barra d'estat</guimenuitem></menuchoice></term>
<listitem><para>Canvia el mostrar o cultar la barra d'estat.</para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><guimenu>Arranjament</guimenu><guimenuitem>Mostra la vista de text</guimenuitem></menuchoice></term>
<listitem><para>Mostra el plafó <guilabel>Vista de text</guilabel>.</para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><guimenu>Arranjament</guimenu><guimenuitem>Configura dreceres...</guimenuitem></menuchoice></term>
<listitem><para>Mostra el diàleg <guilabel>Configura dreceres</guilabel>.</para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><guimenu>Arranjament</guimenu><guimenuitem>Configura barres d'eines...</guimenuitem></menuchoice></term>
<listitem><para>Mostra el diàleg <guilabel>Configura les barres d'eines</guilabel>.</para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><guimenu>Arranjament</guimenu><guimenuitem>Configura &kompare;...</guimenuitem></menuchoice></term>
<listitem><para>Mostra el diàleg <guilabel>Preferències</guilabel> de &kompare;.</para></listitem>
</varlistentry>
</variablelist>
</sect1>

<sect1 id="help-menu">
<title>El menú <guimenu>Ajuda</guimenu></title>
&help.menu.documentation; </sect1>
</chapter>

<chapter id="credits">

<title>Crèdits i llicència</title>

<para>&kompare; </para>
<para>Programa copyright 2001-2004, &John.Firebaugh; &John.Firebaugh.mail; i Otto Bruggeman<email>otto.bruggeman@home.nl</email> </para>

<para>Documentació Copyright &copy; 2007 Sean Wheller <email>sean@inwords.co.za</email> </para>

<para>Traductor de la documentació: &credits.Antoni.Bella;</para> 
&underFDL; &underGPL; </chapter>

<appendix id="installation">
<title>Instal·lació</title>

<sect1 id="getting-kapp">
<title>Com obtenir &kompare;</title>
&install.intro.documentation; </sect1>


<sect1 id="compilation">
<title>Compilació i instal·lació</title>
&install.compile.documentation; </sect1>


</appendix>

&documentation.index; 
</book>

<!--
Local Variables:
mode: sgml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:

// vim:ts=2:sw=2:tw=78:noet
-->