# O Manual do &kompare;

Sean Wheller sean@inwords.co.za
Pedro Morais

    morais@kde.org

Tradução
2007 Sean Wheller
&FDLNotice;
2016-07-05
4.1.3 (Aplicações 16.04)

O &kompare; é um programa &GUI; de interface que permite ver e reunir as diferenças entre os ficheiros de código. O &kompare; pode ser usado para comparar as diferenças entre ficheiros ou entre o conteúdo de pastas. O &kompare; suporta uma grande variedade de formatos do 'diff' e oferece várias opções para personalizar o nível de informação que é apresentado.

KDE Kompare Diff Reunir Modificação Bloco

## Introdução

Quando duas ou mais pessoas estiverem a trabalhar num ficheiro e o passam um para o outro e vice-versa, torna-se difícil saber que variações foram feitas sobre uma versão nova, ou se deseja copiar um ficheiro. Se abrir a cópia nova e o original, lado-a-lado, na aplicação usada para o criar, será uma solução possível mas trabalhosa, morosa e sujeita a erros. Este é o caso em que é necessário e útil um programa para mostrar as diferenças.

Como seria de esperar, um nome apropriado para um programa destes seria diff (diminutivo de diferença em inglês). Como acontece, o programa 'diff' está instalado na maioria dos sistemas baseados em &Linux; e é usado exactamente para este fim. Os programadores usam normalmente o 'diff', como ferramenta da linha de comandos, para mostrar as diferenças entre versões de ficheiros de código. Contudo, a utilização do 'diff' não está limitada à apresentação das diferenças nos ficheiros de código-fonte, podendo ser usada em vários tipos de ficheiros baseados em texto.

A utilização do 'diff' na linha de comandos poderá ser confusa, a aprendizagem da sintaxe e a descodificação do resultado poderão assustar a maioria das pessoas. Aí é onde o &kompare; aparece em jogo. Ao oferecer uma interface gráfica para o programa 'diff', a interface mostra os ficheiros de origem e destino lado-a-lado, com todas as diferenças realçadas automaticamente. Neste ponto de partida, as alterações num ficheiro poderão ser aplicadas sequencialmente ao outro, usando uma base selectiva e controlada. Nem todas as alterações precisam de ser aplicadas e, se quiser aplicar uma alteração, esta poderá sempre ser 'ignorada' ou anulada. Quando todas as alterações necessárias tiverem sido aplicadas, estas poderão ser gravadas e aparecerão de forma normal, como acontece na aplicação usada para criar o ficheiro.

Para além de mostrar as diferenças entre um ficheiro de origem e um de destino, o &kompare; pode ser usado para criar e ver um ficheiro especial, chamado um ficheiro 'diff'. Este ficheiro captura as diferenças entre as duas fontes para um único ficheiro, que poderá então ser usado para ver e aplicar as alterações a outra cópia qualquer do ficheiro. Por exemplo, se duas pessoas estiverem a editar um documento, a primeira pessoa quer fazer alterações e enviar apenas essas alterações à segunda pessoa. Normalmente, a primeira pessoa iria enviar uma cópia completa do documento modificado para a segunda pessoa, que teria depois de comparar o documento modificado, lado-a-lado com a versão não-modificada. O processo para tal é muito semelhante ao descrito nos parágrafos anteriores. Com o &kompare;, a primeira pessoa iria fazer uma cópia local do ficheiro a ser modificado, faria as alterações e depois iria comparar o original e a cópia modificada. Agora, ao usar o &kompare;, poderá criar um ficheiro 'diff' que captura apenas as alterações feitas. Este poderá ser enviado para a segunda pessoa, em vez de enviar um ficheiro inteiro com os dados e as alterações.

Se usar o &kompare;, a segunda pessoa poderá ver o ficheiro 'diff', compará-lo com a cópia local do documento e aplicar as alterações feitas pela primeira pessoa. Como tal, o processo poderá funcionar assim para várias versões do documento, onde cada pessoa faz as alterações, cria os ficheiros 'diff', distribui-os e aplica-os. Este processo é conhecido em inglês como patching, um termo retirado do programa patch, que é outra ferramenta da linha de comandos, desenhada especificamente para aplicar os ficheiros do 'diff'.

Acontece por vezes que existam várias pessoas a editar um ficheiro ao mesmo tempo. Nesta situação, é provável que as pessoas façam alterações no documento exactamente na mesma linha. Isto gera um problema porque, sem o cuidado devido, as pessoas poderão estar a sobrepor o trabalho das outras, à medida que aplicam os ficheiros de 'diff' que recebem. Felizmente, os programadores dos programas 'diff' e 'patch' tiveram isso em consideração e, deste modo, estas ferramentas não irão aplicar essas alterações sem alguma intervenção manual. Quando se atinge este estado, este é referido como um conflito. O &kompare; irá mostrar os conflitos, de modo que os possa resolver manualmente, decidindo as alterações que deverão ser aplicadas a um dado ficheiro.

O &kompare; também é um programa óptimo para comparar as alterações de ficheiros ao nível da pasta. Quando for usado para comparar pastas, o &kompare; examina recursivamente as sub-pastas e o conteúdo dos seus ficheiros, à procura de diferenças. Neste caso, cada um dos ficheiros em que foram encontradas diferenças é aberto automaticamente e listado pelo &kompare;, onde é possível navegar facilmente pelos vários ficheiros.

## Usar o &kompare;

### Começar

Esta secção fornece instruções para iniciar o &kompare; e oferece uma viagem rápida pela interface principal do &kompare;.

#### Iniciar o &kompare;

Um atalho para iniciar o &kompare; poderá ser encontrado no menu de aplicações, no grupo de Desenvolvimento, em Desenvolvimento Kompare.

Quando o &kompare; se inicia, a primeira coisa que faz é mostrar uma janela, na qual poderá seleccionar os ficheiros que deseja comparar. As opções especiais de propriedades do 'diff', bem como a aparência, poderão também ser aqui seleccionadas. No formulário do ficheiro, seleccione a origem e o destino a comparar. Estes poderão ser dois ficheiros, pastas ou um &URL; e um ficheiro. Logo que a origem e o destino estejam seleccionados, carregue no botão Comparar.

Logo que o &kompare; tenha descoberto as diferenças, irá mostrar a interface principal. Ao comparar dois ficheiros, ou um URL e um ficheiro, o processo levará apenas alguns segundos. Contudo, ao comparar pastas com diversas sub-pastas e ficheiros, este processo poderá levar mais algum tempo.

Para uma explicação das opções disponíveis do 'diff', bem como os formatos de aparência, veja a secção .

#### A Interface Principal

Esta secção oferece uma viagem rápida pela interface principal, composta pelas seguintes áreas:

- Menus

- Barra de Ferramentas

- Pastas de Origem e Destino

- Ficheiros de Origem e Destino

- Mudanças de Linha na Origem e no Destino

- Área de Texto da Origem e do Destino

- Barra de Estado

##### Menus

O &kompare; oferece uma interface baseada em menus. Está disponível uma explicação para os itens do menu e as suas opções em .

##### Barra de Ferramentas

A barra de ferramentas do &kompare; oferece atalhos para as operações de diferenças e junções usadas com maior frequência. A orientação da barra de ferramentas, a posição do texto, as propriedades do tamanho dos ícones e a visibilidade dos ícones de atalho poderão ser personalizadas no menu de contexto da barra de ferramentas, ao carregar com o botão direito do rato na barra de ferramentas. O menu de contexto da barra de ferramentas também permite esconder a barra de ferramentas. Se esta ficar escondida e você desejar torná-la visível de novo, seleccione a opção do menu Configuração Mostrar a Barra de Ferramentas.

##### Pastas de Origem e Destino

A área das pastas de origem e destino mostram as pastas nas quais se encontram os ficheiros comparados. Quando estiverem incluídas várias pastas na comparação, então a selecção de uma pasta irá mostrar o primeiro documento nessa pasta, onde foi encontrada uma diferença entre a origem e o destino.

##### Ficheiros de Origem e Destino

A área dos ficheiros de origem e destino mostram os ficheiros em que foram encontradas diferenças, tanto para a pasta de origem como a de destino. Quando uma dada pasta tiver vários documentos com diferenças, serão apresentados todos os documentos com diferenças. Estará visível o documento que estiver seleccionado nesta área.

##### Mudanças de Linha na Origem e Destino

A área das mudanças de linhas da origem e destino resumem as diferenças encontradas entre os documentos de origem e de destino. Se seleccionar um registo nessa área, irá realçar e seleccionar a diferença. Esta é uma forma útil de navegar e inspeccionar os documentos grandes com muitas diferenças.

##### Área de Origem e de Destino

A área de origem e destino é o espaço de trabalho principal do &kompare;. O conteúdo e as diferenças realçadas, para o ficheiro de origem e destino seleccionado de momento, aparecem aqui com os números de linha.

##### Vista de Texto

A Área de Texto não aparece por omissão. Esta poderá ser aberta se seleccionar a opção Configuração Mostrar a Área de Texto.

##### Barra de Estado

A barra de estado oferece um resumo do ficheiro ou pasta de origem e de destino a serem comparados. A barra de estado apresenta também o número alterações encontradas no documento actual e conta as diferenças que foram aplicadas. Para além disso, a barra de estado mostra o número global de documentos que contêm diferenças, bem como o número do documento actualmente seleccionado neste conjunto. Por exemplo, uma comparação efectuada sobre duas pastas poderá devolver 1890 ficheiros com diferenças. O documento actualmente seleccionado é o número 18 de 1890.

### Ver as Diferenças

#### Gerir o Espaço Livre do Ecrã

O &kompare; mostra o ficheiro de origem e de destino com uma percentagem igual à área de trabalho da interface principal. Esta área de visualização oferece algumas funcionalidades que ajudam a optimizar a utilização do espaço livre do ecrã, enquanto vê as diferenças, incluindo:

Barras de Posicionamento Duplas

  A funcionalidade mais óbvia é que as barras de posicionamento aparecem ambas nos extremos direitos e inferiores da área de visualização. Com as barras de posicionamento, é possível percorrer rapidamente a comparação.

Partilhar a Pega

  O espaço vertical entre a área de origem e de destino não só possibilita a visualização clara do início e fim da linhas em cada uma das áreas, assim como é também uma pega que permite o ajuste da percentagem ocupada pelas áreas de origem e destino que compõem a área de visualização. Para mudar o tamanho de uma das áreas, passe o cursor do rato pela pega e mantenha o botão do rato pressionado, deslocando depois o rato para a esquerda ou para a direita. Naturalmente, se aumentar a área de uma dessas zonas, irá diminuir a área disponível para a área oposta, dentro da área de visualização.

  Está disponível uma segunda pega horizontal entre o painel de navegação e a área de origem e de destino.

Acoplagem

  O painel de navegação pode ser destacado da interface principal, carregando para tal no botão que se encontra no canto superior direito do painel. Isto abre-o numa janela própria, permitindo movê-lo pelo ecrã. Pode até esconder o painel de navegação, carregando nesse caso no botão . Para mostrar uma barra de navegação escondida de novo, carregue com o &RMB; na barra de menu e escolha a Navegação no menu de contexto.

Comutar a Barra de Estado

  A barra de estado do painel de visualização poderá ser comutada se seleccionar a opção Configuração Mostrar a Barra de Estado.

#### Alternar entre as Janelas de Origem e Destino

Poderá ser útil algumas das vezes considerar que o ficheiro onde serão aplicadas as diferenças passe a ser o original. Por exemplo, ao comparar duas versões modificadas de um ficheiro, e se descobrir que um ficheiro tem muitas mais alterações que o outro. O ficheiro com mais alterações será melhor como original, dado que serão necessárias menos aplicações de diferenças.

Neste caso, seleccione a opção Ficheiro Trocar a Origem com o Destino. Isto irá trocar os ficheiros que aparecem nos painéis do &kompare;.

#### Mostrar as Estatísticas das Diferenças

Para uma visão geral das diferenças, seleccione a opção Ficheiro Mostrar as Estatísticas. Isto irá mostrar a janela de Estatísticas das Diferenças. Aparecerá então a seguinte informação:

Ficheiro antigo:

  O nome do ficheiro que é normalmente o ficheiro de origem ou o ficheiro que foi modificado.

Ficheiro novo:

  O nome do ficheiro normalmente usado como destino ou o ficheiro que não foi modificado, sobre o qual serão aplicadas as diferenças.

Formato:

  O formato de diferenças que é usado para mostrar as diferenças (veja em ).

Número de blocos:

  O número de blocos que foram encontrados na diferença.

  Um bloco é um conjunto de linhas que foram marcadas como diferentes, entre a origem e o destino, e que poderão incluir as linhas de contexto, dependendo do valor das Linhas de Contexto do formato de diferenças (veja em ).

Número de diferenças

  O número actual de diferenças encontradas, não os blocos. Um bloco poderá conter uma ou mais diferenças, quando a mudança de linhas e as linhas de contexto de duas ou mais alterações se sobrepõem.

#### Navegar na Área de Diferenças

O &kompare; activa a navegação rápida das diferenças, ao nível do ficheiro, e de vários ficheiros com diferenças, ao comparar árvores de pastas.

##### Seleccionar uma Diferença

Uma diferença poderá ser seleccionada se, para tal:

- carregar numa linha da área de Mudanças de Linha na Origem e no Destino (canto superior direito da janela principal).

- carregar na diferença seleccionada, na área de Visualização.

- percorrer as diferenças listadas numa comparação (ver em ).

Quando for seleccionada uma diferença, considera-se que esta fica em primeiro plano, pelo que aparecerá com uma cor mais clara que as diferenças não seleccionadas.

##### Percorrer as Diferenças

Quando uma comparação descobrir diversas diferenças, uma das melhores formas de as rever é percorrer as diferenças por ordem lógica, normalmente de cima para baixo.

Por omissão, o &kompare; selecciona a primeira diferença encontrada numa comparação. Ao seleccionar a opção Diferença Diferença Seguinte (&Ctrl;Baixo), a diferença a seguir à selecção actual ficará em primeiro plano. Para seleccionar a diferença anterior à actual, seleccione a opção Diferença Diferença Anterior (&Ctrl;Cima).

Desta forma, é possível percorrer as diferenças de forma ordeira, aplicando e revogando as diferenças em revisão.

##### Mudar de Ficheiros

Quando for efectuada uma comparação ao nível de uma pasta, poderão aparecer diversos ficheiros com diferenças. Aparecerá então uma lista completa dos ficheiros comparados, com as diferenças encontradas a aparecerem em Pastas de Origem e Destino e nos Ficheiros de Origem e Destino. Contudo, o &kompare; mostra as diferenças entre a origem e o destino, com uma comparação de cada vez.

Para mudar de documentos, neste cenário, estão disponíveis as seguintes opções:

- Seleccione a área de Pastas de Origem e Destino para mostrar as diferenças de ficheiros que aparecem na área de Ficheiros de Origem e Destino, seleccionando depois um ficheiro.

- Seleccione a opção Diferença Ficheiro Anterior (&Ctrl;PageUp) ou Diferença Ficheiro Seguinte (&Ctrl;PageDown) para mostrar o ficheiro com diferenças anterior ou seguinte, na área de Ficheiros de Origem e Destino.

### Juntar as Diferenças

O &kompare; torna a tarefa de aplicação e anulação das diferenças tão simples como 'apontar e carregar'. Poderá efectuar várias operações de aplicação e anulação de diferenças, dado que todas as operações são efectuadas em memória e não são gravadas nos ficheiros em disco, até que a operação de gravação seja efectuada.

#### Aplicar uma Diferença

Para aplicar uma diferença, carregue na região realçada da diferença, seleccionando depois a opção Diferença Aplicar a Diferença (Espaço).

#### Anular a Aplicação de uma Diferença

Para cancelar a aplicação de uma diferença, carregue na região previamente seleccionada para aplicação e escolha depois a opção Diferença Ignorar a Diferença (&Backspace;).

#### Aplicar Todas as Diferenças

Depois de rever as diferenças entre ficheiros e de ter descoberto todas as diferenças aceitáveis, é possível aplicá-las a todas com uma única operação, seleccionando a opção Diferença Aplicar Tudo (&Ctrl;A).

#### Ignorar Todas as Diferenças

Para reverter todas as diferenças que tenham sido aplicadas, seleccione a opção Diferença Ignorar Tudo (&Ctrl;U).

#### Gravar Alterações

Logo que as diferenças tenham sido aplicadas, poderão ser gravadas se seleccionar a opção Ficheiro Gravar ou Ficheiro Gravar Tudo.

As diferenças aplicadas são gravadas tanto no ficheiro de origem como no destino.

### Lidar com Ficheiros do 'Diff'

Os ficheiros do 'diff' contêm apenas as alterações feitas entre ficheiros, ou um conjunto de ficheiros dentro de um sistema de pastas, podendo ou não conter um número de linhas de contexto, antes e depois das alterações de linhas. O somatório de uma mudança de linha e das suas linhas de contexto chama-se 'bloco'. Um ficheiro do 'diff' contém deste modo diversos blocos de um ou mais ficheiros. Quando as linhas de contexto de dois ou mais blocos se sobreporem, são consideradas um único bloco. Os ficheiros do 'diff' poderão ser usados para:

- Aplicar as alterações contidas nos blocos sobre um ficheiro original.

- Aplicar as alterações contidas nos blocos num ficheiro ou conjunto de ficheiros, dentro de um sistema de pastas.

- Efectuar modificações, antes de aplicar as diferenças a um ficheiro ou conjunto de ficheiros originais, dentro de um sistema de pastas.

#### Criar as Diferenças

Para criar um ficheiro do 'diff', é necessário mostrar uma comparação no &kompare;. Assumindo que é este o caso, seleccione depois a opção Ficheiro Gravar o .diff.... Isto irá mostrar a janela de Opções do Diff (veja mais informações em sobre os formatos e opções do 'diff'). Depois de configurar estas opções, carregue no botão Gravar e grave as diferenças num ficheiro com a extensão `.diff`.

#### Mostrar as Diferenças

É possível mostrar o conteúdo de um ficheiro de diferenças no &kompare;, abrindo o ficheiro do 'diff' em Ficheiro Abrir o Diff....

Ao ver um ficheiro de diferenças, são apresentados os blocos entre o ficheiro de origem e de destino; lembre-se que só são apresentados esses blocos, as linhas não-modificadas não o são. Em alguns casos, um ficheiro do 'diff' é criado sem linhas de contexto. Nesse caso, só são apresentadas as linhas alteradas.

Quando um ficheiro de diferenças contiver blocos de vários ficheiros, o &kompare; mostra os blocos de cada ficheiro, um de cada vez, e você poderá mudar entre ficheiros, como se fossem ficheiros a sério, mesmo que esta informação só seja fornecida pelo conteúdo do ficheiro do 'diff'.

#### Aplicar as Diferenças num Ficheiro do 'Diff'

Ao ver as diferenças de um ficheiro do 'diff', é possível aplicar as diferenças, como o faria ao comparar os ficheiros de origem e de destino (veja em ).

#### Juntar um &URL; com um 'Diff'

Nos casos em que seja fornecido um ficheiro do 'diff', é possível comparar os blocos no 'diff' com um ficheiro ou pasta. Para o fazer, seleccione a opção Ficheiro Fundir o URL com o Diff.... Depois, introduza a localização do Ficheiro/Pasta e o Resultado do 'Diff'.

Ao ver as diferenças entre um ficheiro de origem e um ficheiro do 'diff', é possível aplicar as diferenças, como o faria ao comparar os ficheiros de origem e de destino (veja em ).

## Configurar as Preferências

O &kompare; permite aos utilizadores definirem as preferências de aparência, de modo a formatar as diferenças na interface principal, bem como definir propriedades de comportamento do programa' diff'. A janela de Preferências poderá ser acedida se seleccionar a opção Configuração Configurar o &kompare;....

Para configurar as preferências da aparência, seleccione o item do menu Ver (veja em ).

Para configurar as preferências do programa 'diff', seleccione o item de menu Diff (veja em ).

### Configuração da Visualização

O menu Ver, que aparece na janela de Preferências, mostra os formulários Aparência e Tipos de Letra.

#### Aparência

O formulário Aparência mostra controlos para gerir as Cores usadas para visualizar as diferenças na interface principal, o comportamento da Roda do Rato ao deslocá-la e como é gerida a conversão de Tabulações para Espaços.

Configuração da Aparência do &kompare;
Configuração da Aparência do &kompare;

Grupo de Cores

Para ajustar as preferências de cores, usadas ao mostrar as diferenças, carregue no botão de cores para mostrar a janela de Selecção de Cores para os seguintes estados:

Cor de removido

  As linhas que foram removidas ou não existem, entre a origem e o destino.

Cor de modificado

  As linhas que foram alteradas ou modificadas, entre a origem e o destino.

Cor de adicionado

  As linhas que foram adicionadas entre a origem e o destino.

Cor de aplicado

  Qualquer um dos estados anteriores, no caso de a diferença ter sido aplicada entre a origem e o destino.

Roda do Rato

Número de linhas

  O número de linhas a deslocar nas diferenças, ao avançar ou recuar a roda do rato.

TABS para Espaços

O número de espaços a usar na conversão das tabulações

  Converte cada tabulação para "n" espaços.

#### Tipos de Letra

Configuração dos Tipos de Letra do &kompare;
Configuração dos Tipos de Letra do &kompare;

Seleccione o tipo e tamanho da letra a mostrar, quando visualizar as diferenças.

### Opções do Diff

O menu de Diferenças, existente na janela de Preferências, mostra os formulários Diferença, Formato, Opções e Excluir. Estes formulários poderão ser usados para configurar as propriedades de comportamento do programa 'diff'.

#### Diferença

Configuração das Diferenças do &kompare;
Configuração das Diferenças do &kompare;

O comando executado para correr o programa 'diff' (por omissão, diff).

#### Formato

Configuração do Formato do &kompare;
Configuração do Formato do &kompare;

Ajusta as opções do Formato do Resultado e o número de Linhas de Contexto.

Formato de Saída

Contexto

  O formato do resultado do contexto adiciona várias linhas de contexto em torno das linhas que diferem.

Normal

  O formato de saída normal mostra as linhas diferentes sem quaisquer linhas de contexto envolvente.

Unificado

  O formato de saída unificado é uma variação do formato de contexto. É considerado melhor que o formato de contexto, porque o resultado é mais compacto, dado que omite as linhas de contexto redundantes.

Linhas de Contexto

O número de linhas de contexto

  Ao executar um 'diff' com o formato de saída unificado ou de contexto, use este parâmetro para controlar o número de linhas de contexto incluídas.

#### Opções

Configuração das Opções do &kompare;
Configuração das Opções do &kompare;

A página de Opções permite a configuração das opções suportadas pelo programa 'diff'.

Geral

Tratar os ficheiros novos como vazios

  Com esta opção activa, o 'diff' irá tratar um ficheiro que só exista numa das pastas como vazio na outra. Isto significa que o ficheiro é comparado com um ficheiro vazio, sendo que irá aparecer assim como uma enorme adição ou remoção.

Procurar alterações menores

  Obriga o 'diff' a mostrar as mudanças de capitalização, pontuação, espaços, &etc;, se estiver assinalada a opção.

Optimizar para ficheiros grandes

  Muda o 'diff' para processar os ficheiros a alta velocidade, quando estiver assinalada.

Ignorar as mudanças de capitalização

  As mudanças de maiúsculas para minúsculas e vice-versa são omitidas, quando esta opção estiver assinalada.

Ignorar a expressão regular

  Ignorar as linhas que correspondam a uma expressão regular.

Espaço em Branco

Expandir as tabulações para espaços no resultado

  Quando a opção estiver assinalada, o resultado do 'diff' irá converter as tabulações para o número de espaços definido na janela de Preferências, no menu Ver e opção Tabulações para Espaços.

Ignorar as linhas em branco adicionadas ou removidas

  As linhas com tamanho nulo, diferentes entre os ficheiros de origem e destino, são ignoradas se esta opção estiver assinalada.

Ignorar as alterações dos espaços em branco

  Os espaços em branco antes, depois e entre as linhas poderão alterar, dependendo dos diferentes editores. Quando esta opção estiver assinalada, estas alterações serão ignoradas.

Ignorar todos os espaços em branco

  Quando a opção estiver assinalada, as diferenças de espaços em branco são ignoradas por completo.

Ignorar as alterações devidas à expansão de tabulações

  Quando a opção estiver assinalada, os espaços em branco resultantes das tabulações são ignoradas por completo.

#### Excluir

O formulário Excluir activa a utilização das opções de filtragem, fornecidas pelo programa 'diff'.

Configuração da Exclusão do &kompare;
Configuração da Exclusão do &kompare;

Padrão de Ficheiros a Excluir

Padrão de Ficheiros a Excluir

  Excluir os ficheiros baseando-se na filtragem por caracteres especiais

Ficheiro com Nomes de Ficheiros a Excluir

Ficheiro com Nomes de Ficheiros a Excluir

  Define o filtro com base no conteúdo de um ficheiro gerido externamente.

## Referência de Comandos

### Opções do Menu

#### O Menu Ficheiro

&Ctrl;O Ficheiro Abrir o Diff...

  Abre a janela para Abrir Ficheiros.

&Ctrl;C Ficheiro Comparar os Ficheiros...

  Mostra a janela para Comparar Ficheiros ou Pastas.

&Ctrl;B Ficheiro Fundir o URL com o Diff...

  Mostra a janela para Fundir o Ficheiro/Pasta com o Resultado do Diff.

&Ctrl;S Ficheiro Gravar

  Grava as alterações aplicadas no ficheiro de origem e destino actuais.

Ficheiro Gravar Tudo

  Grava as diferenças aplicadas em todos os ficheiros de origem e destino.

Ficheiro Gravar o .diff...

  Mostra a janela de Opções do Diff para definir o formato e as opções do 'diff'.

F5 Ficheiro Actualizar as Diferenças

  Actualiza as diferenças entre os locais originais. É útil se tiver aplicado algumas alterações, tivesse gravado e quisesse ver o que sobra.

Ficheiro Trocar a Origem e o Destino

  Troca a origem e o destino de posição.

Ficheiro Mostrar as Estatísticas

  Mostra a janela para Mostrar as Estatísticas.

&Ctrl;Q Ficheiro Sair

  Sai do &kompare;.

#### O Menu Diferenças

&Ctrl;U Diferença Ignorar Tudo

  Ignora todas as diferenças aplicadas previamente entre a origem e o destino.

&Backspace; Diferença Ignorar a Diferença

  Anula uma diferença previamente aplicada.

Espaço Diferença Aplicar a Diferença

  Aplica uma diferença seleccionada.

&Ctrl;A Diferença Aplicar Tudo

  Aplica todas as diferenças entre o original e o destino.

&Ctrl;PageUp Diferença Ficheiro Anterior

  Coloca o ficheiro anterior, da lista de ficheiros com diferenças encontradas, como o ficheiro actual da área de visualização.

&Ctrl;PageDown Diferença Ficheiro Seguinte

  Coloca o ficheiro seguinte, da lista de ficheiros com diferenças encontradas, como o ficheiro actual da área de visualização.

&Ctrl;Cima Diferença Diferença Anterior

  Selecciona a diferença anterior à diferença actualmente seleccionada na lista.

&Ctrl;Baixo Diferença Diferença Seguinte

  Selecciona a diferença abaixo da diferença actualmente seleccionada.

#### Os Menus de Configuração e Ajuda

O &kompare; tem os itens dos menus de Configuração e Ajuda normais do &kde;; para mais informações, leia as secções sobre os menus de Configuração e Ajuda dos Fundamentos do &kde;.

### Opções da Linha de Comandos

-c

  Isto irá comparar o URL1 com o URL2.

``kompare` `-o``

  Isto irá abrir o URL1 e esperar que o mesmo seja o resultado do comando 'diff'. O URL1 também poderá ser um '-', onde irá ler os dados a partir do 'standard input'. Pode ser usado por exemplo para o comando ``cvs diff | kompare -o -``. O Kompare irá verificar se consegue encontrar os ficheiros originais, tentando depois misturar os ficheiros originais com o resultado das diferenças e mostrá-las no visualizador. O `-n` desactiva a verificação.

``kompare` `-b``

  Isto irá fundir o URL2 com o URL1, sendo que o URL2 se espera que seja o resultado das diferenças e o URL1 o ficheiro ou pasta com que o resultado das diferenças será reunido.

``kompare` `-n``

  Desactiva a verificação automática da pesquisa dos ficheiros originais ao usar '-' como URL com a opção `-o`.

``kompare` `-e` codificação`

  Use isto para seleccionar a codificação, quando o invocar a partir da linha de comandos. Irá usar a codificação local se não foi explicitamente indicada.

## Créditos e Licença

&kompare;

Programa com 'copyright' 2001-2004 de &John.Firebaugh; &John.Firebaugh.mail; e Otto Bruggeman otto.bruggeman@home.nl

Documentação com 'copyright' © 2007 de Sean Wheller sean@inwords.co.za

Tradução de José Nuno Pires zepires@gmail.com

&underFDL; &underGPL;
&documentation.index;