Mercurial > hg > easyhg-kdiff3
diff kdiff3/doc/pt/index.docbook @ 75:08ea9b86c12c
KDiff3-0.9.91
| author | joachim99 |
|---|---|
| date | Sat, 04 Nov 2006 00:05:00 +0000 |
| parents | f7dad0aa6146 |
| children | fcd146072e0c |
line wrap: on
line diff
--- a/kdiff3/doc/pt/index.docbook Sun May 14 20:12:21 2006 +0000 +++ b/kdiff3/doc/pt/index.docbook Sat Nov 04 00:05:00 2006 +0000 @@ -11,21 +11,26 @@ <book lang="&language;"> +<!-- This header contains all of the meta-information for the document such +as Authors, publish date, the abstract, and Keywords --> + <bookinfo> <title >O Manual do &kdiff3;</title> <authorgroup> <author -><personname -> <firstname +><firstname >Joachim</firstname > <surname >Eibl</surname -></personname +> <affiliation +><address > <email ->joachim.eibl at gmx.de</email -> </author> +>joachim.eibl at gmx.de</email> +</address +></affiliation> +</author> <othercredit role="translator" ><firstname >Pedro</firstname @@ -41,28 +46,36 @@ >Tradução</contrib ></othercredit > - </authorgroup> <copyright> <year ->2002</year -><year ->2005</year> +>2002-2006</year> <holder >Joachim Eibl</holder> </copyright> +<!-- Translators: put here the copyright notice of the translation --> +<!-- Put here the FDL notice. Read the explanation in fdl-notice.docbook + and in the FDL itself on how to use it. --> <legalnotice >&FDLNotice;</legalnotice> +<!-- Date and version information of the documentation +Don't forget to include this last date and this last revision number, we +need them for translation coordination ! +Please respect the format of the date (YYYY-MM-DD) and of the version +(V.MM.LL), it could be used by automation scripts. +Do NOT change these in the translation. --> + <date ->2005-01-30</date> +>2006-05-14</date> <releaseinfo ->0.9.87</releaseinfo> +>0.9.90</releaseinfo> + <abstract> <para ->&kdiff3; is a file and directory diff and merge tool which: <itemizedlist> +>O &kdiff3; é uma ferramenta de diferenças e junção das mesmas para ficheiros e pasta que <itemizedlist> <listitem ><para >compara e junta dois ou três ficheiros de texto ou pastas de entrada,</para @@ -89,12 +102,26 @@ ></listitem> <listitem ><para ->supports Unicode, UTF-8 and other file encodings.</para +>suporta o Unicode, o UTF-8 e outras codificações de ficheiros,</para +></listitem> +<listitem +><para +>imprime as diferenças,</para +></listitem> +<listitem +><para +>suporta as palavras-chave de controlo de versões e de junção do histórico.</para ></listitem> </itemizedlist> -</para> +</para +><para +>Este documento descreve o &kdiff3; versão 0.9.89. </para> </abstract> +<!-- This is a set of Keywords for indexing by search engines. +Please at least include KDE, the KDE package it is in, the name + of your application, and a few relevant keywords. --> + <keywordset> <keyword >KDE</keyword> @@ -147,35 +174,23 @@ ><title >Outra Interface para o Diff?</title> <para ->Existem várias ferramentas de detecção de diferenças. Porquê escolher o &kdiff3;? Deixe que o autor diga porque o escreveu.</para> - -<para ->&kdiff3; started because I had to do a difficult merge. Merging is necessary when several people work on the same files in a project. A merge can be somewhat automated, when the merge-tool not only has the new modified files (called <quote ->branches</quote ->), but also the original file (called <quote ->base</quote ->). The merge tool will automatically choose any modification that was only done in one branch. When several contributors change the same lines, then the merge tool detects a conflict which must be solved manually.</para> - -<para ->"A junção foi então difícil porque um dos colaboradores alterou várias coisas e corrigiu a indentação em vários sítios. Outro também alterou bastante texto, o que resultou em vários conflitos de junção".</para> - -<para ->"A ferramenta que usei então só mostrava as linhas modificadas, mas não o que tinha sido alterado dentro dessas linhas. E não havia nenhuma informação sobre os locais em que só a indentação tinha sido alterada. A junção foi um pequeno pesadelo por isso".</para> - -<para ->"Daí, foi este o início. A primeira versão podia mostrar as diferenças dentro de uma linha e mostrava as diferenças de espaços em branco. Depois, muitas outras funcionalidades foram adicionada para aumentar a utilidade".</para> - -<para ->"Por exemplo, se você quiser comparar algum texto rapidamente, então poderá copiá-lo para a área de transferência e colá-lo noutra janela de diferenças".</para> - -<para ->"Uma funcionalidade que necessitou de um grande esforço foi a comparação de pastas e a funcionalidade de junção, o que transformou o programa quase num navegador de ficheiros completo".</para> - -<para ->Espero que o &kdiff3; funcione para si também. Divirta-se!</para> - -<para ->Joachim Eibl (2003)</para> +>Existem várias ferramentas de detecção de diferenças. Porquê escolher o &kdiff3;? Deixe que o autor diga porque o escreveu. </para +><para +>O &kdiff3; começou porque eu tinha de fazer uma junção difícil. A junção é necessária quando várias pessoas trabalham nos mesmos ficheiros de um projecto. Uma junção poderá de alguma forma ser automatizada, quando a ferramenta de junção não só tem os novos ficheiros modificados (chamados de 'ramificações' ou 'branches'), mas também o ficheiro original (chamado de 'base'). A ferramenta de junção irá escolher automaticamente as modificações que só foram feitas numa das ramificações. Quando vários contribuintes alteram as mesmas linhas, então a ferramenta de junção detecta um conflito que terá de ser resolvido manualmente. </para +><para +>"A junção foi então difícil porque um dos colaboradores alterou várias coisas e corrigiu a indentação em vários sítios. Outro também alterou bastante texto, o que resultou em vários conflitos de junção". </para +><para +>"A ferramenta que usei então só mostrava as linhas modificadas, mas não o que tinha sido alterado dentro dessas linhas. E não havia nenhuma informação sobre os locais em que só a indentação tinha sido alterada. A junção foi um pequeno pesadelo por isso". </para +><para +>"Daí, foi este o início. A primeira versão podia mostrar as diferenças dentro de uma linha e mostrava as diferenças de espaços em branco. Depois, muitas outras funcionalidades foram adicionada para aumentar a utilidade". </para +><para +>"Por exemplo, se você quiser comparar algum texto rapidamente, então poderá copiá-lo para a área de transferência e colá-lo noutra janela de diferenças". </para +><para +>"Uma funcionalidade que necessitou de um grande esforço foi a comparação de pastas e a funcionalidade de junção, o que transformou o programa quase num navegador de ficheiros completo". </para +><para +>Espero que o &kdiff3; funcione para si também. Divirta-se! </para +><para +>Joachim Eibl (2003) </para> </sect1> <sect1 id="screenshots" @@ -193,34 +208,26 @@ ></screenshot> <para ->3-way-merging is fully supported. This is useful if two people change code independently.</para> -<para ->The original file (the base) is used to help &kdiff3; to automatically select the correct changes.</para> -<para ->The merge-editor below the diff-windows allows you to solve conflicts, while showing you the output you will get.</para> -<para ->You can even edit the output.</para> - -<para ->This screenshot shows three input files being merged:</para> - +>A junção por 3-vias é suportada por completo. Isto é útil se duas pessoas alterarem o código independentemente. O ficheiro original (a base) é usado para ajudar o &kdiff3; a seleccionar automaticamente as alterações correctas. O editor de junções por baixo das janelas de diferenças permite-lhe resolver os conflitos, enquanto lhe mostra o resultado que você irá obter. Até poderá editar o resultado. Esta imagem mostra três ficheiros de entrada a serem reunidos: </para +><para> <screenshot ><mediaobject> <imageobject ><imagedata fileref="screenshot_merge.png" format="PNG"/></imageobject> </mediaobject ></screenshot> +</para> <para id="dirmergebigscreenshot" ->O &kdiff3; também o ajuda a comparar e a juntar pastas completas. Esta imagem mostra o &kdiff3; durante a junção de pastas:</para> - +>O &kdiff3; também o ajuda a comparar e a juntar pastas completas. Esta imagem mostra o &kdiff3; durante a junção de pastas: </para +><para> <screenshot ><mediaobject> <imageobject ><imagedata fileref="dirmergebig.png" format="PNG"/></imageobject> </mediaobject ></screenshot> - +</para> </sect1> <sect1 id="features" @@ -229,10 +236,8 @@ <sect2 ><title >Visualizador de Diferenças Linha-a-Linha e Carácter-a-Carácter</title> - <para ->Usando as possibilidades de um ambiente gráfico a cores, o &kdiff3; mostra exactamente o que é a diferença. Quando tiver de fazer várias revisões de código, irá gostar disto.</para> - +>Usando as possibilidades de um ambiente gráfico a cores, o &kdiff3; mostra exactamente o que é a diferença. Quando tiver de fazer várias revisões de código, irá gostar disto. </para> <screenshot ><mediaobject> <imageobject @@ -246,7 +251,6 @@ >Ver as Diferenças de Espaços em Branco de uma Vez</title> <para >Os espaços e as tabulações que são diferentes aparecem visivelmente. Quando as linhas diferem apenas pelo número de espaços em branco, isto poderá ser visto num instante se olhar para a coluna do resumo do lado esquerdo. (Não há mais problemas quando as pessoas mudam a indentação). </para> - <screenshot ><mediaobject> <imageobject @@ -317,13 +321,7 @@ ></listitem> <listitem ><para ->Search for strings in all text windows. Find (<keycombo ->&Ctrl;<keycap ->F</keycap -></keycombo ->) and Find Next (<keycap ->F3</keycap ->)</para +>Procurar por sequências de texto em todas as janelas de texto. Procurar (Ctrl-F) e Procurar o Seguinte (F3).</para ></listitem> <listitem ><para @@ -353,6 +351,10 @@ ><para >Suporte para as línguas escritas da direita-para-esquerda.</para ></listitem> + <listitem +><para +>...</para +></listitem> </itemizedlist> </sect2> </sect1> @@ -360,7 +362,7 @@ <chapter id="documentation" ><title ->Documentation of File Comparison And Merge</title> +>Comparação e Junção de Ficheiros</title> <sect1 id="commandline" ><title @@ -374,7 +376,8 @@ >kdiff3</command > <replaceable >ficheiro1 ficheiro2</replaceable -></screen> +> +</screen> </sect2> <sect2 @@ -384,18 +387,19 @@ ><command >kdiff3</command > <replaceable ->file1 file2</replaceable +>ficheiro1 ficheiro2</replaceable > <option >-m</option> <command >kdiff3</command > <replaceable ->file1 file2</replaceable +>ficheiro1 ficheiro2</replaceable > <option >-o</option > <replaceable ->outputfile</replaceable -></screen> +>resultado</replaceable +> +</screen> </sect2> <sect2 @@ -406,7 +410,8 @@ >kdiff3</command > <replaceable >ficheiro1 ficheiro2 ficheiro3</replaceable -></screen> +> +</screen> </sect2> <sect2 @@ -416,18 +421,19 @@ ><command >kdiff3</command > <replaceable ->file1 file2 file3</replaceable +>ficheiro1 ficheiro2 ficheiro3</replaceable > <option >-m</option> <command >kdiff3</command > <replaceable ->file1 file2 file3</replaceable +>ficheiro1 ficheiro2 ficheiro3</replaceable > <option >-o</option > <replaceable ->outputfile</replaceable -></screen> +>resultado</replaceable +> +</screen> <para >Repare que o <replaceable >ficheiro1</replaceable @@ -442,13 +448,14 @@ ><title >Caso especial: Ficheiros com o mesmo nome </title> <para ->If all files have the same name but are in different directories, you can reduce typework by specifying the filename only for the first file. ⪚: </para> +>Se todos os ficheiros tiverem o mesmo nome mas estiverem em pastas diferentes, poderá reduzir o trabalho de escrita se indicar apenas o nome do ficheiro para o primeiro parâmetro. P.ex.: </para> <screen ><command >kdiff3</command > <replaceable >pasta1/ficheiro pasta2 pasta3</replaceable -></screen> +> +</screen> </sect2> <sect2 @@ -460,27 +467,27 @@ ><command >kdiff3</command > <replaceable ->dir1 dir2</replaceable> +>pasta1 pasta2</replaceable> <command >kdiff3</command > <replaceable ->dir1 dir2</replaceable +>pasta1 pasta2</replaceable > <option >-o</option > <replaceable ->destdir</replaceable> +>destino</replaceable> <command >kdiff3</command > <replaceable ->dir1 dir2 dir3</replaceable> +>pasta1 pasta2 pasta3</replaceable> <command >kdiff3</command > <replaceable ->dir1 dir2 dir3</replaceable +>pasta1 pasta2 pasta3</replaceable > <option >-o</option > <replaceable ->destdir</replaceable +>destino</replaceable > </screen> <para @@ -491,26 +498,70 @@ <sect2 ><title ->For more information on command line options use: </title> +>Outras opções da linha de comandos</title> +<para +>Para mais informações sobre as opções da linha de comandos use</para> <screen ><command >kdiff3</command -> <option ->--help</option> -<computeroutput ->Options: - -m, --merge Merge the input. - -b, --base file Explicit base file. For compatibility with certain tools. - -o, --output file Output file. Implies -m. E.g.: -o newfile.txt - --out file Output file, again. (For compatibility with certain tools.) - --auto No GUI if all conflicts are auto-solvable. (Needs -o file) - --qall Don't solve conflicts automatically. (For compatibility...) - --L1 alias1 Visible name replacement for input file 1 (base). - --L2 alias2 Visible name replacement for input file 2. - --L3 alias3 Visible name replacement for input file 3. - -L, --fname alias Alternative visible name replacement. Supply this once for every input. - -u Has no effect. For compatibility with certain tools.</computeroutput -></screen> +> --help +</screen> +<para +>Exemplo do resultado:</para> +<screen +><command +>kdiff3</command +> --help +Opções: + -m, --merge Junta o resultado. + -b, --base ficheiro Ficheiro de base explícito. Para compatibilidade com certas ferramentas. + -o, --output ficheiro Ficheiro de resultado. O -m é implícito. P.ex.: -o novo_ficheiro.txt + --out ficheiro O ficheiro de resultado, mais uma vez. (Para compatibilidade com certas ferramentas.) + --auto Sem interface gráfica se todos os conflitos são resolúveis. (Necessita do -o) + --qall Não resolve os conflitos automaticamente. (Para compatibilidade...) + --L1 nome1 Substituto visível do nome do ficheiro 1 (base). + --L2 nome2 Substituto visível do nome do ficheiro 2. + --L3 nome3 Substituto visível do nome do ficheiro 3. + -L, --fname nome Um substituto visível alternativo para o nome. Use este uma vez para cada ficheiro de entrada. + --cs texto Substitui uma opção de configuração. Use uma vez para cada opção. P.ex. --cs "AutoAdvance=1" + --confighelp Mostra uma lista com as opções de configuração e os valores actuais. + --config ficheiro Usa um ficheiro de configuração diferente. +</screen> +<para +>A opção <option +>--cs</option +> permite-lhe ajustar um valor de configuração que, de outro modo, só é ajustável através das janelas de configuração. Mas tenha em mente que, quando o &kdiff3; então terminar, o valor alterado será gravado com as outras opções. Com o <option +>--confighelp</option +>, poderá descobrir os nomes dos itens disponíveis e dos valores actuais.</para> +<para +>Através do <option +>--config</option +>, poderá indicar um ficheiro de configuração diferente. Quando usar frequentemente o &kdiff3; com opções completamente diferentes, isto permitir-lhe-á mudar rapidamente entre elas.</para> +</sect2> +<sect2 +><title +>Ignorar as opções da linha de comandos</title> +<para +>Muitas pessoas querem usar o &kdiff3; com alguns sistemas de controlos de versões. Mas quando esse sistema de controlo de versões chama o &kdiff3;, usando os parâmetros da linha de comandos que o &kdiff3; não reconhece, então o &kdiff3; termina com um erro. A configuração da integração permite indicar parâmetros da linha de comandos que deverão ser ignorados pelo &kdiff3;. Eles irão aparecer na ajuda de utilização, como neste exemplo:</para> +<screen +>--<replaceable +>xpto</replaceable +> Ignorado. (Definido pelo utilizador.) +</screen> +<variablelist> + <varlistentry +><term +><emphasis +>Opções da linha de comandos a ignorar:</emphasis +></term +><listitem +><para +>Uma lista de opções, separadas pelo ponto-e-vírgula ';'. Quando alguma destas opções aparecer na linha de comandos, então o &kdiff3; ignorá-la-á e irá executar sem indicar qualquer erro. (Por omissão é "u;query;html;abort").</para +></listitem +></varlistentry> +</variablelist> +<para +>Quando isto não for suficiente, então recomenda-se que crie um programa que faça a tradução das opções.</para> </sect2> </sect1> @@ -527,103 +578,79 @@ </mediaobject ></screenshot> <para ->The open dialog allows to edit the filenames by hand, selecting a file via the file-browser (<guilabel ->File...</guilabel ->) or allows to choose recent files from the drop-down lists. If you open the dialog again, then the current names still remain there. The third input file is not required. If the entry for <quote ->C</quote -> remains empty, then only a two file diff analysis will be done. </para +>A janela de abertura permite editar os nomes dos ficheiros à mão, seleccionando um ficheiro através do navegador dos ficheiros ("Ficheiro...") ou permite escolher os ficheiros recentes a partir das listas respectivas. Se abrir a janela de novo, então os nomes actuais irão nela permanecer. O terceiro ficheiro de entrada não é obrigatório. Se o item do "C" continuar em branco, então só será efectuada uma análise de diferenças com dois ficheiros. </para ><para ->You can also select a directory via <guilabel ->Dir...</guilabel ->. If for A a directory is specified then a directory-comparison/merge starts. If A specifies a file but B, C or the output specify a directory, then &kdiff3; uses the filename from A in the specified directories. </para +>Poderá também seleccionar uma pasta com o "Dir...". Se for indicado como A uma pasta, então será iniciada uma comparação/junção de pastas. Se o A se referir a um ficheiro, mas o B, o C ou o destino corresponderem a pastas, então o &kdiff3; usa o nome do ficheiro em A nas pastas indicadas. </para ><para ->If <guilabel ->Merge</guilabel -> is selected, then the <guilabel ->Output</guilabel -> line becomes editable. But it is not required to specify the output filename immediately. You can also postpone this until saving. </para +>Se a "Junção" estiver seleccionada, então o campo "Resultado" fica editável. Mas não é obrigatório indicar o nome do ficheiro do resultado imediatamente. Você poderá também adiar isto até à gravação. </para ><para ->The <guibutton ->Configure...</guibutton -> button opens the options-dialog, so that you can set the options before running the analysis. </para> +>O botão "Configurar..." abre a janela de opções, para que possa definir as opções antes de executar a análise. </para> </sect1> <sect1 id="pasteinput" ><title >Colar e Arrastar Dados</title> <para ->Sometimes you want to compare parts of a text that is not an own file. &kdiff3; also allows you to paste text from the clipboard into the diff input window that has the focus. The diff analysis happens immediately then. In the open dialog you need not specify files then, but just close it via <guibutton ->Cancel</guibutton ->. </para +>Em algumas ocasiões, você poderá querer comparar partes de um texto que não está em nenhum ficheiro próprio. O &kdiff3; também lhe permite colar texto da área de transferência para a janela de introdução de diferenças que esteja em primeiro plano. A análise de diferenças irá ocorrer então. Na janela de abertura, você não irá necessitar de indicar ficheiros, fechando-a então com o "Cancelar". </para ><para >O utilizador também poderá usar o 'drag and drop': Arraste um ficheiro de um gestor de ficheiros ou o texto seleccionado de um editor e arrastá-lo para uma janela de introdução de diferenças. </para ><para ->Qual é a ideia? Algumas vezes um ficheiro contém duas funções semelhantes, mas a verificação sobre as semelhanças entre elas é um grande esforço, se você precisar de criar primeiro dois ficheiros e depois carregá-los. Assim, poderá simplesmente copiar, colar e comparar as secções relevantes. </para> -<note +>Qual é a ideia? Algumas vezes um ficheiro contém duas funções semelhantes, mas a verificação sobre as semelhanças entre elas é um grande esforço, se você precisar de criar primeiro dois ficheiros e depois carregá-los. Assim, poderá simplesmente copiar, colar e comparar as secções relevantes. </para ><para ->Currently you can't drag anything from &kdiff3;. Only dropping in the diff input is supported. </para -></note> -<warning +>Nota: De momento, você não poderá arrastar nada a partir do &kdiff3;. Só é permitido largar dados nas janelas de introdução de diferenças. </para ><para ->Some editors still interpret the drag and drop into another program like cut (instead of copy) and paste. Your original data might be lost then. </para -></warning> +>Atenção: Alguns editores ainda interpretam à mesma o 'drag and drop' noutro programa como o Cortar (em vez do Copiar) e Colar. Os seus dados originais poderão deste modo perder-se. </para> </sect1> <sect1 id="interpretinginformation" ><title ->Interpreting The Information In The Input Windows</title> +>Comparar os Ficheiros e Interpretar a Informação nas Janelas de Entrada</title> <screenshot ><mediaobject> <imageobject ><imagedata fileref="screenshot_diff.png" format="PNG"/></imageobject> </mediaobject ></screenshot> -<para ->At the top of each text window is its <quote ->info line</quote ->. The info lines of the input windows contain a letter <guilabel ->A</guilabel ->, <guilabel ->B</guilabel -> or <guilabel ->C</guilabel ->, the filename and the line number of the first visible line in the window. (Note that window <guilabel ->C</guilabel -> is optional.) Each info line appears in a different color. (If the paths are too long to fit, then you can move the mouse onto the info line and a tooltip will show the complete name.) </para +<sect2 +><title +>Linha de Informação</title ><para ->The three input windows are assigned the letters <guilabel ->A</guilabel ->, <guilabel ->B</guilabel -> and <guilabel ->C</guilabel ->. <guilabel ->A</guilabel -> has color blue, <guilabel ->B</guilabel -> has green and <guilabel ->C</guilabel -> has magenta. (These are the defaults, but can be changed in the <guimenu ->Settings</guimenu -> menu.) </para +>No cimo de cada janela de texto existe a sua "linha de informação". As linhas de informação das janelas de introdução de diferenças contêm uma letra "A", "B" ou "C", o nome do ficheiro e o número da primeira linha visível da janela. (Lembre-se que a janela "C" é opcional). Cada linha de informação aparece com uma cor diferente. (Se as localizações forem demasiado extensas para caberem, poderá mover o cursor do rato para cima da linha de informação, de modo a que apareça uma dica com o nome completo). </para ><para ->When a difference is detected then the color shows which input file differs. When both other input files differ then the color used to express this is red by default (<guilabel ->Conflict color</guilabel -> in the settings). This colorscheme is especially useful in the case of three input files, which will be seen in the next section (<link linkend="merging" ->Merging</link +>Quando tiver seleccionado outro ficheiro através de navegação ou acabar de editar o nome do ficheiro aqui, carregando para tal em Enter, o novo ficheiro será carregado e comparado com os ficheiros já carregados previamente. </para +></sect2 +><sect2 +><title +>Coloração</title +><para +>As três janelas de entrada têm atribuídas as letras "A", "B" e "C". O "A" tem uma cor azul, o "B" tem uma verde e o "C" magenta. (Estas são as cores por omissão, mas podem ser alteradas no menu de configuração). </para +><para +>Quando é detectada uma diferença, então a cor mostra qual o ficheiro de entrada que é diferente. Quando os outros ficheiros de entrada diferem todos, então a cor usada para exprimir isto é a vermelha por omissão ("Cor do conflito" na Configuração). Este esquema de cores é particularmente útil no caso de três ficheiros de entrada, os quais serão vistos na próxima secção (<link linkend="merging" +>Juntar</link >). </para +></sect2 +><sect2 +><title +>Coluna de Resumo</title ><para ->Left of each text is the <quote ->summary column</quote ->. If differences occurred on a line then the summary column shows the respective color. For a white-space-only difference the summary is chequered. For programming languages where white space is not so important this is useful to see at one glance if anything of importance was modified. (In C/C++ white space is only interesting within strings, comments, for the preprocessor, and some only very esoteric situations.) </para +>À esquerda de cada texto está a "coluna de resumo". Se ocorrerem diferenças numa linha, então a coluna do resumo mostra a cor respectiva. Para uma diferença por espaços em branco, o resumo fica axadrezado. Para as linguagens de programação em que os espaços em branco não são muito importantes, isto é útil para ver de um modo geral se existe algo de importante modificado. (No C/C++, os espaços em branco só são importantes dentro de cadeias de caracteres, comentários, pré-processador e em algumas outras situações esotéricas. </para ><para >A linha vertical que separa a coluna do resumo e o texto é interrompida (tracejada), se o ficheiro de entrada não tiver aí nenhuma linha. Quando a mudança de linha estiver activa, então esta linha vertical aparece ponteada para as linhas repartidas. </para +></sect2 +><sect2 +><title +>Coluna de Resumo</title ><para ->On the right side a <quote ->overview</quote -> column is visible left of the vertical scrollbar. It shows the compressed summary column of input <guilabel ->A</guilabel ->. All the differences and conflicts are visible at one glance. When only two input windows are used, then all differences appear red here because every difference is also a conflict. A black rectangle frames the visible part of the inputs. For very long input files, when the number of input lines is bigger than the height of the overview column in pixels, then several input lines share one overview line. A conflict then has top priority over simple differences, which have priority over no change, so that no difference or conflict is lost here. By clicking into this overview column the corresponding text will be shown. </para> +>Do lado direito, aparece uma coluna de "resumo" à esquerda da barra de posicionamento vertical. Ela mostra a coluna de resumo comprimida dos dados de "A". Todas as diferenças e conflitos ficam visíveis numa vista rápida. Quando só são usadas duas janelas de entrada, então todas as diferenças aparecem a vermelho, dado que cada diferença é também um conflito. Um rectângulo preto delimita a parte visível dos dados de entrada. Para as linhas de dados bastante compridas, quando o número de linhas de dados é maior do que a altura da coluna de resumo em pixels, então várias linhas de dados de entrada irão partilhar uma linha de resumo. Um conflito, neste caso, terá então uma prioridade elevada sobre as diferenças simples, que por sua vez têm prioridade sobre a ausência de alterações, como tal não se perde nenhuma diferença ou conflito neste caso. Se carregar nesta coluna de resumo, será mostrado o texto correspondente. </para +></sect2 +><sect2 id="manualdiffhelp" +><title +>Alinhar Manualmente as Linhas</title +><para +>Em alguns casos, o algoritmo coloca as linhas erradas a seguir umas às outras. Ou se deseja comparar um pedaço de texto com outro que se encontra numa posição completamente diferente no outro ficheiro. Para esses casos, poderá indicar manualmente ao &kdiff3; para alinhar certas linhas. Marque o texto, com o qual deseja melhorar o alinhamento, com o rato como faria na cópia e colagem na primeira janela de diferenças e escolhe então o "Adicionar o Alinhamento Manual das Diferenças" na janela de "Diferenças" (atalho de teclado "Ctrl-Y") . Irá aparecer uma barra laranja na coluna do resumo, a seguir ao texto escolhido. Repita isto para a segunda e (se disponível) a terceira janela de diferenças. O &kdiff3; irá calcular imediatamente de novo as diferenças sempre que fizer isto, alinhando as linhas escolhidas. Obviamente, algumas das linhas anteriormente correspondentes poderão não corresponder mais de novo. </para +><para +>De momento, a junção não suporta a utilização da ajuda de diferenças manual. </para +></sect2> </sect1> @@ -637,262 +664,248 @@ </mediaobject ></screenshot> <para ->The merge output editor window (below the diff input windows) also has an info line at the top showing <guilabel ->Output:</guilabel ->, the filename and <guilabel ->[Modified]</guilabel -> if you edited something. Usually it will contain some text through the automatic merge facilities, but often it will also contain conflicts. </para +>A janela do editor do resultado da junção (por baixo das janelas de introdução de diferenças) também tem uma linha de informação no topo que mostra "Resultado:", o nome do ficheiro e "[Modificado]" se você tiver alterado alguma coisa. Normalmente irá conter algum texto resultante das funcionalidades de junção automática, mas frequentemente irá conter também conflitos. </para ><para ->Saving is disabled until all conflicts are resolved. (Use the <guibutton ->Go to prev/next unsolved conflicts</guibutton -> buttons to find the remaining conflicts.) </para +>A gravação está desactivada até que todos os conflitos estejam resolvidos. (Use os botões para "Ir para o Conflito por Resolver Anterior/Seguinte" para descobrir os conflitos que faltam.) </para ><para >Com apenas dois ficheiros de entrada, todas as diferenças são também conflitos que necessitam de ser resolvidos manualmente. </para ><para >Com três ficheiros de entrada, o primeiro ficheiro é tratado como a base, enquanto que o segundo e o terceiro contêm as modificações. Quando, em qualquer linha, só o ficheiro B ou o C tiverem sido alterados mas não ambos, então será seleccionada a origem alterada. Só quando o B e o C alteraram as mesmas linhas é que a ferramenta detecta um conflito que deverá ser resolvido manualmente. Quando o B e o C são iguais mas não são o mesmo que o A, é seleccionado o C. </para +><sect2 +><title +>A Coluna de Resumo</title ><para ->The merge output editor window also has a summary column on the left. It shows the letter of the input from which a line was selected or nothing if all three sources where equal on a line. For conflicts it shows a questionmark <guilabel ->?</guilabel -> and the line shows <guilabel -><Merge Conflict></guilabel ->, all in red. Because solving conflicts line by line would take very long, the lines are grouped into groups that have the same difference and conflict characteristics. But only-white-space-conflicts are separated from non-white-space-conflicts in order to ease the merging of files were the indentation changed for many lines. </para +>A janela do editor do resultado da junção também tem uma coluna de resumo à esquerda. Mostra a letra do ficheiro de entrada para o qual foi seleccionada a linha ou nada, se todas as três origens são iguais nessa linha. Para os conflitos, ela mostra um ponto de interrogação "?" e a linha mostra "<Conflito na Junção>", tudo a vermelho. Dado que a resolução de conflitos linha a linha poderá levar bastante tempo, as linhas são reunidas em grupos com as mesmas características de diferenças e conflitos. Mas os conflitos só com espaços em branco são separados dos outros conflitos para facilitar a junção dos ficheiros em que a indentação foi alterada em várias linhas. </para +></sect2 +><sect2 id="synchronise_views" +><title +>Configurar o Grupo Actual e Sincronizar a Posição de Visualização da Junção e Diferenças</title ><para ->When clicking into the summary column with the left mouse button in either window then the group belonging to that line will be selected in all windows and the beginning of that group will be shown. (This might involve an automatic position jump in the windows if the beginning of a group is not visible.) This group then becomes the <quote ->current group</quote ->. It is highlighted with the <quote ->Current range (diff) background color</quote -> and a black bar appears on the left side of the text. </para +>Ao carregar na coluna do resumo com o &LMB; em ambas as janelas, o grupo que pertença a essa linha será seleccionado em todas as janelas e o início desse grupo será mostrado. (Isto poderá envolver um salto de posição automático para a janelas se o início do grupo não estiver visível). Este grupo fica então o "grupo actual". Fica realçado com a "Cor de fundo do intervalo actual" e aparece uma barra preta do lado esquerdo do texto. </para +></sect2 +><sect2 +><title +>Escolher as Entras A, B ou C para os Conflitos e Edições Actuais</title ><para ->Note the input selector buttons containing the letters <guibutton ->A</guibutton ->, <guibutton ->B</guibutton -> and <guibutton ->C</guibutton -> in the button bar below the menu bar. When clicking on either input selector button, the lines from that input will be added at the end of the selected group if that group didn't contain that source before. Otherwise the lines from that input will be removed. </para +>A barra de botões por baixo do menu contém três botões de selecção que contêm as letras "A", "B" e "C". Carregue no selector de entrada para inserir (ou remover se já estiver inserido) as linhas da origem respectiva. Para escolher as linhas de várias entradas, carregue nos botões respectivos pela ordem necessária. Por exemplo, se quiser que as linhas de "B" apareçam antes das linhas de "A" no resultado, carregue primeiro em "B" e depois em "A". </para ><para ->Besides, you can directly edit any line. The summary column will show <guibutton ->m</guibutton -> for every line that was modified. </para +>Se usar a opção de avanço automático (<link linkend="autoadvance" +>"Ir automaticamente para o próximo conflito não resolvido após a selecção da fonte"</link +>), deverá desactivar isto antes de escolher as linhas de várias entradas ou se quiser editar as linhas após a sua escolha. Caso contrário, o &kdiff3; irá saltar para o próximo conflito após a selecção da primeira entrada. </para ><para ->Sometimes, when a line is removed either by automatic merge or by editing and no other lines remain in that group, then the text <computeroutput -><No src line></computeroutput -> will appear in that line. This is just a placeholder for the group for when you might change your mind and select some source again. This text won't appear in the saved file or in any selections you want to copy and paste. </para +>Normalmente é útil editar directamente o resultado da junção. A coluna de resumo irá mostrar "m" por cada linha modificada manualmente. Quando, por exemplo, as diferenças estão alinhadas de forma que não seja satisfatório escolher simplesmente as entradas, então poderá marcar o texto necessário e usar a <link linkend="selections" +>cópia e colagem</link +> normais para colocar no resultado da junção. </para ><para ->The text <quote -><Merge Conflict></quote -> will appear in the clipboard if you copy and paste some text containing such a line. </para +>Algumas das vezes, quando uma linha é removida tanto por junção automática como por edição e não ficam mais nenhumas linhas nesse grupo, então o texto "<Sem linha de origem>" irá aparecer nessa linha. Isto é apenas um substituto para o grupo, quando decidir mudar de ideias e seleccionar algum texto de origem de novo. Este texto não irá aparecer no ficheiro gravado ou em qualquer selecção que deseje copiar e colar. </para ><para ->The normal merge will start by solving simple conflicts automatically. But the <guimenu ->Merge</guimenu -> menu provides some actions for other common needs. If you have to select the same source for most conflicts, then you can choose <quote ->A</quote ->, <quote ->B</quote -> or <quote ->C</quote -> everywhere, or only for the remaining unsolved conflicts, or for unsolved whitespace conflicts. If you want to decide every single delta yourself, you can <guilabel ->Set deltas to conflicts</guilabel ->. Or if you want to return to the automatic choices of &kdiff3; then select <quote ->Automatically solve simple conflicts</quote ->. &kdiff3; then restarts the merge. For actions that change your previous modifications KDiff3 will ask for your confirmation before proceeding. </para> - -<note +>O texto "<Conflito na Junção>" irá aparecer na área de transferência se copiar e colar algum texto que tenha uma dessas linhas. Mas tenha à mesma cuidado ao fazê-lo. </para +></sect2 +><sect2 +><title +>Escolher a Entrada A, B ou C para Todos os Conflitos</title ><para ->When choosing either source for unsolved whitespace conflicts and the options <guilabel ->Ignore Numbers</guilabel -> or <guilabel ->Ignore C/C++ Comments</guilabel -> are used then changes in numbers or comments will be treated like whitespace too. </para -></note> +>A junção normal irá começar por resolver os conflitos simples automaticamente. Mas o menu "Juntar" oferece algumas acções para outros usos comuns. Se você tiver de seleccionar a mesma origem para a maioria dos conflitos, então poderá escolher "A", "B" ou "C" em qualquer lado ou apenas para os conflitos que continuem ainda por resolver ou então para os conflitos de espaços em branco por resolver. Se quiser decidir cada um dos deltas por si próprio, poderá "Passar os deltas para conflitos". Ou, se preferir voltar às escolhas automáticas do &kdiff3;, seleccione então a opção "Resolver automaticamente os conflitos simples". Nesse caso, o &kdiff3; irá reiniciar a junção. Para as acções que alteram as suas modificações anteriores, o &kdiff3; pedir-lhe-á uma confirmação antes de prosseguir. </para +><para +>Nota: Ao escolher uma das origens para os conflitos que não sejam de espaços em branco e as opções "Ignorar os Números" ou "Ignorar os Comentários de C/C++" forem usadas, então as alterações nos números ou comentários serão tratadas como espaços em branco também. </para +></sect2 +><sect2 id="vcskeywordsmergesupport" +><title +>Junção Automática das Palavras-Chave e do Histórico do Controlo de Versões (Registo)</title +><para +>Muitos sistemas de controlo de versões suportam palavras-chave especiais no ficheiro. (p.ex. "$Date: 2006-03-31 15:21:46 +0100 (Sex, 31 Mar 2006) $", "$Header$", "$Author: scripty $", "$Log$" etc.) Durante o envio de novas versões, o sistema de controlo de versões (SCV) muda essas linhas. Por exemplo, o "$Date: 2006-03-31 15:21:46 +0100 (Sex, 31 Mar 2006) $" passará a "$Date: 2006-03-30 17:52:41 +0200 (Thu, 30 Mar 2006) $". Dado que esta linha será diferente em cada versão do ficheiro, iria necessitar de intervenção manual durante a junção. </para +><para +>O &kdiff3; oferece a junção automática destes itens. Para as linhas simples que correspondam à opção da "Expressão regular da junção automática" para todos os ficheiros de entrada, o &kdiff3; irá escolher a linha do B ou - se disponível - do C. (Para além disso, é necessário que as linhas em questão se alinhem na comparação e a linha anterior não contenha conflitos). Esta junção automática pode tanto correr automaticamente após o início de uma junção (active a opção "Executar a junção automática da expressão regular no início da junção") como posteriormente, através do menu de junção "Executar a Junção Automática da Expressão Regular". </para +><para +>A junção automática para o histórico do controlo de versões (também chamado de "registo") é também suportada. A junção automática do histórico tanto poderá correr automaticamente quando iniciar a junção, activando para tal a opção "Juntar o histórico do controlo de versões no início da junção" ou mais tarde através do menu de junção "Resolver Automaticamente os Conflitos do Histórico". </para +><para +>Normalmente, o histórico do controlo de versões começa por uma linha que contém a palavra-chave "$Log$". Isto deverá corresponder à opção "Expressão regular do início do histórico". O &kdiff3; detecta quais as linhas subsequentes no histórico, analisando os caracteres iniciais que aparecem antes da palavra-chave "$Log$". Se também aparecer o mesmo "comentário inicial" nas linhas seguintes, então estas também serão incluídas no histórico. </para +><para +>Durante o envio de cada nova versão, o SCV grava uma linha única que indica a versão, a data e a hora, seguida de linhas com os comentários dos utilizadores. Essas linhas formam um item de histórico. Esta secção do histórico vai crescendo com o envio de versões novas e os itens mais recentes aparecem no topo (a seguir à linha inicial do histórico). </para +><para +>Quando, em desenvolvimentos paralelos, dois ou mais programadores enviam versões em ramificações diferentes, o histórico da junção irá conter vários itens que aparecem como conflitos na junção das ramificações. Dado que a junção destes se poderá tornar demasiado aborrecidas, o &kdiff3; oferece o suporte com duas estratégias possíveis: basta introduzir a informação de histórico de ambas as contribuições no topo ou ordenar a informação de histórico do utilizador, usando uma chave definida pelo mesmo. </para +><para +>O método basta-inserir-todos-os-itens é mais fácil de configurar. O &kdiff3; só precisa de um método para detectar as linhas que pertencem a um item de histórico. A maioria dos SCV inserem uma linha em branco, após cada item do histórico. Se não existirem mais linhas em branco, então este será um critério suficiente para o &kdiff3;. Basta introduzir uma "Expressão regular do início do item de histórico" em branco. Se o critério da linha vazia não for suficiente, poderá indicar uma expressão regular para detectar o início do item do histórico. </para +><para +>Lembre-se que o &kdiff3; irá remover os itens de histórico duplicados. Se um item de histórico aparecia várias vezes no histórico de um ficheiro de entra, só um irá aparecer no resultado. </para +><para +>Se quiser ordenar o histórico, então terá de indicar como deverá ser gerada a chave de ordenação. Use parêntesis na "Expressão regular do início do item de histórico" para agrupar as partes da expressão regular que deverão mais tarde ser usadas na chave de ordenação. Indique depois a "Ordem da chave de ordenação do início do item de histórico", indicando para tal uma lista de números separados por ",", referentes à posição do grupo na expressão regular. </para +><para +>Dado que isto não é tão simples de pôr a funcionar logo, poderá testar e melhorar as expressões regulares e gerar as chaves, numa janela dedicada, se carregar no botão "Testar as suas expressões regulares". </para +><para +>Exemplo: Assuma um histórico que se pareça ao seguinte: <screen> +/************************************************************************** +** HISTORY: $Log: \janela_do_ze\Aplicacao\src\algoritmo-complexo.cpp $ +** +** \principal\ramo_integracao_12 2 Abr 2001 10:45:41 ze +** Juntou-se a ramificação manel_versao_15. +** +** \principal\ramo_correccao_erros_7\1 30 Mar 2001 19:22:05 pedro +** Melhorias na velocidade da sub-rotina convertToMesh(). +** Correcção do estoiro. +**************************************************************************/ +</screen +> A linha inicial do histórico corresponde à expressão regular ".*\$Log.*\$.*". Depois, seguem-se os itens de histórico. </para +><para +>A linha com a palavra-chave "$Log$" começa com dois "*", após os quais se segue um espaço. O &kdiff3; usa o primeiro texto não-branco como "comentários iniciais" e assume que o histórico termina na primeira linha sem esse comentário inicial. Neste exemplo, a última linha termina com um texto que também começa por dois "*" mas, em vez de um espaço, seguem-se mais "*". Como tal, esta linha termina o histórico. </para +><para +>Se a ordenação do histórico não for necessária, então a expressão regular do início de linha do item de histórico poderá ser algo como se segue. (Esta linha está dividida em dois, por não caber de outra forma.) <screen> +\s*\\principal\\\S+\s+[0-9]+ (Jan|Fev|Mar|Abr|Mai|Jun|Jul|Ago|Set|Out|Nov|Dez) + [0-9][0-9][0-9][0-9] [0-9][0-9]:[0-9][0-9]:[0-9][0-9]\s+.* +</screen +> Para mais detalhes sobre as expressões regulares, veja por favor a <ulink url="http://doc.trolltech.com/3.3/qregexp.html#details" +>documentação da Trolltech sobre expressões regulares</ulink +>. Repare que o "\s" (com o "s" minúsculo) corresponde a qualquer espaço em branco e o "\S" (com o "S" maiúsculo) corresponde a qualquer carácter não-branco. No nosso exemplo, o início do item de histórico, contém primeiro a informação da versão com a expressão regular "\\principal\\\S+", a data consiste no dia "[0-9]+", mês "(Jan|Fev|Mar|Abr|Mai|Jun|Jul|Ago|Set|Out|Nov|Dez)" e no ano "[0-9][0-9][0-9][0-9]", a hora "[0-9][0-9]:[0-9][0-9]:[0-9][0-9]" e, finalmente, o nomes do programador ".*". Lembre-se que o comentário inicial (no exemplo "**") já será removido pelo &kdiff3; antes de tentar a correspondência, logo a expressão regular começa com uma correspondência para zero ou mais caracteres em branco "\s*". </para +><para +>Se precisar de um histórico ordenado, então deverá ser calculada a chave de ordenação. Para tal, as partes relevantes da expressão regular deverão ser agrupadas entre parêntesis. (os parêntesis extra poderão ficar à mesma, mesmo que a ordenação do histórico esteja desactivada.) <screen> +\s*\\principal\\(\S+)\s+([0-9]+) (Jan|Fev|Mar|Abr|Mai|Jun|Jul|Ago|Set|Out|Nov|Dez) + ([0-9][0-9][0-9][0-9]) ([0-9][0-9]:[0-9][0-9]:[0-9][0-9])\s+(.*) +</screen +> Os parêntesis contêm agora 1. a informação de versão, 2. dia, 3. mês, 4. ano, 5. hora, 6. nome. Mas, se pretender ordenar por data e hora, é necessário construir uma chave com os elementos por uma ordem de aparência diferente: Primeiro o ano, seguido do mês, dia, hora, informação de versão e nome. Daí, a ordem da chave de ordenação será "4,3,2,5,1,6". </para +><para +>Dado que os nomes dos meses não são bons para ordenar (o "Abr" viria em primeiro lugar), o &kdiff3; detecta em que ordem os nomes dos meses foram dados e usa esse número em alternativa ("Abr"->"04"). E, se for encontrado um número puro, será transformado num valor de 4 algarismos com zeros iniciais para ordenar. Finalmente, a chave de ordenação resultante da linha inicial do primeiro item de histórico será: <screen +>2001 04 0002 10:45:41 ramo_integracao_12 ze +</screen> +</para +><para +>Para mais informações, veja também a <link linkend="diffmergeoptions" +>Configuração de Diferenças e Junção</link +>. </para> +</sect2> </sect1> <sect1 id="navigation" ><title >Navegação e Edição</title> <para ->Much navigation will be done with the scroll bars and the mouse but you can also navigate with the keys. If you click into either window then you can use the cursor buttons <keycap ->Left Arrow</keycap ->, <keycap ->Right Arrow</keycap ->, <keycap ->Up Arrow</keycap ->, <keycap ->Down Arrow</keycap ->, <keycap ->Page Up</keycap ->, <keycap ->Page Down</keycap ->, <keycap ->Home</keycap ->, <keycap ->End</keycap ->, <keycombo action="simul" ->&Ctrl;<keycap ->Home</keycap -></keycombo ->, <keycombo action="simul" ->&Ctrl;<keycap ->End</keycap -></keycombo -> as you would in other programs. The overview-column next to the vertical scroll bar of the input files can also be used for navigating by clicking into it. </para +>Muita da navegação será feita com as barras de posicionamento e com o rato, mas você poderá também navegar com as teclas. Se carregar numa das janelas, então poderá usar as teclas de cursores, o Page Up, o Page Down, o Home, o End, o Ctrl-Home ou o Ctrl-End como iria usar noutros programas. A coluna de resumo ao lado da barra de posicionamento vertical dos ficheiros de entrada poderá também ser usada para navegar se carregar nela. </para ><para ->You can also use a wheel mouse to scroll up and down. </para +>Poderá também usar a roda do rato para subir ou descer. </para ><para ->In the merge output editor you can also use the other keys for editing. You can toggle between insert and overwrite mode with the <keycap ->Insert</keycap -> key. (Default is insert-mode.) </para +>No editor do resultado da junção, poderá também usar as outras teclas para editar. Poderá alternar entre o modo de inserção ou sobreposição com a tecla Insert. (Por omissão, está no modo de inserção). </para ><para ->A &LMB; click into any summary column will synchronise all windows to show the beginning of the same group of lines (as explained in section <link linkend="merging" ->"Merging"</link +>Um 'click' com o botão esquerdo do rato em qualquer coluna de resumo irá sincronizar todas as janelas para mostrar o início do mesmo grupo de linhas (tal como é explicado em <link linkend="synchronise_views" +>Configurar o Grupo Actual e Sincronizar a Posição da Janela de Junção e Diferença</link >). </para ><para ->The button bar also contains seven navigation buttons with which you can jump to the current/first/last difference, to the next/previous difference (<keycombo action="simul" ->&Ctrl;<keycap ->Down Arrow</keycap -></keycombo ->/<keycombo action="simul" ->&Ctrl;<keycap ->Up Arrow</keycap -></keycombo ->), to the next/previous conflict (<keycombo action="simul" ->&Ctrl;<keycap ->Page Down</keycap -></keycombo ->/<keycombo action="simul" ->&Ctrl;<keycap ->Page Up</keycap -></keycombo ->), or to the next/previous unsolved conflict. Note that for &kdiff3; a <quote ->conflict</quote -> that was not automatically solved at the start of the merge stays a <quote ->conflict</quote -> even if it is solved. Hence the necessity to distinguish <quote ->unsolved conflicts</quote ->. </para -><para ->There also is a button <guibutton ->Automatically go to next unsolved conflict after source selection</guibutton -> (Auto-Advance). If you enable this, then, when one source is selected, then &kdiff3; will jump to and select the next unsolved conflict automatically. This can help when you always want to choose one source only. When you need both sources, or you want to edit after selecting, then you probably want to switch this off. Before proceeding to the next unsolved conflict &kdiff3; shows you the effect of your choice for a short time. This delay is adjustable in the Diff & Merge Settings: You can specify the <guilabel ->Auto-Advance delay</guilabel -> in milli seconds between 0 and 2000.</para> -<tip -><para ->Tired of many clicks? Use a small Auto-Advance-delay and the shortcuts <keycombo action="simul" ->&Ctrl;<keycap ->1</keycap -></keycombo ->, <keycombo action="simul" ->&Ctrl;<keycap ->2</keycap -></keycombo -> and <keycombo action="simul" ->&Ctrl;<keycap ->3</keycap -></keycombo -> to select files A, B or C for many conflicts.</para -></tip> +>A barra de botões também contém sete botões de navegação com os quais poderá saltar para a primeira/última/actual diferença, para a diferença seguinte/anterior (Ctrl-Baixo/Ctrl-Cima), para o conflito seguinte/anterior (Ctrl-Pg Down/Ctrl-Pg Up) ou para o conflito seguinte/anterior por resolver. Repare que, para o &kdiff3;, um "conflito" que não foi resolvido automaticamente no início da junção irá permanecer como "conflito", mesmo que resolvido. Daí a necessidade de distinguir os "conflitos por resolver". </para> +<sect2 id="autoadvance" +><title +>Avanço Automático</title> +<para +>Existe também um botão "Ir automaticamente para o próximo conflito por resolver após a selecção do código" (Avanço Automático). Se activar esta opção, então sempre que seleccionar uma origem, o &kdiff3; irá saltar para o próximo conflito por resolver automaticamente. Isto poderá ajudar quando quiser sempre escolher apenas uma origem. Quando precisar de ambas as origens, ou se quiser editar depois de seleccionar, então provavelmente irá querer desligar esta opção. Antes de prosseguir para o próximo conflito por resolver, o &kdiff3; mostra-lhe o efeito da sua escolha durante algum tempo. Este atraso é ajustável na Configuração da Diferença & Junção: Poderá indicar o "Atraso no avanço automático" num valor entre 0 e 2 000 milisegundos. Sugestão: Cansado de muitos 'clicks'? - Use um atraso de avanço automático reduzido e os atalhos Ctrl-1/2/3 para seleccionar o A/B/C em muitos conflitos. </para> +</sect2> </sect1> <sect1 id="selections" ><title >Seleccionar, Copiar e Colar</title> <para ->The input windows don't show a cursor, so selections must be made with the mouse by clicking with the &LMB; at the start, holding down the mousebutton and moving to the end, where you release the mouse button again. You can also select a word by double clicking it. In the merge output editor you can also select via the keyboard by holding the &Shift; button and navigation with the cursor keys. </para +>As janelas de entrada não mostram nenhum cursor, como tal as selecções necessitam de ser feitas com o rato, ao carregar com o botão esquerdo do rato no início, mantendo o botão do rato carregado e indo até ao fim, momento em que larga o botão do rato de novo. Poderá também seleccionar uma palavra se fizer duplo-click nela. No editor do resultado da junção poderá também seleccionar com o teclado se mantiver a tecla Shift carregada enquanto navega com as teclas de cursores. </para ><para ->To copy to the clipboard you must press the <guibutton ->Copy</guibutton -> button (<keycombo action="simul" ->&Ctrl;<keycap ->C</keycap -></keycombo -> or <keycombo action="simul" ->&Ctrl;<keycap ->Insert</keycap -></keycombo ->). But there exists an option <quote ->Auto Copy Selection</quote ->. If this is enabled, then whatever you select is copied immediately and you don't need to explicitly copy. But pay attention when using this because the contents of the clipboard might then be destroyed accidentally. </para +>Se a selecção ultrapassar o intervalo visível, você poderá passar o rato por cima dos extremos da janela, o que fará com que o &kdiff3; se desloque nessa direcção. </para ><para -><guimenuitem ->Cut</guimenuitem -> (<keycombo action="simul" ->&Ctrl;<keycap ->X</keycap -></keycombo -> or <keycombo action="simul" ->&Shift;<keycap ->Delete</keycap -></keycombo ->) copies to the clipboard and deletes the selected text and <guimenuitem ->Paste</guimenuitem -> (<keycombo action="simul" ->&Ctrl;<keycap ->V</keycap -></keycombo -> or <keycombo action="simul" ->&Shift;<keycap ->Insert</keycap -></keycombo ->) inserts the text in the clipboard at the cursor position or over the current selection. </para> +>Para as selecções muito grandes, poderá também usar as teclas de navegação, enquanto mantém pressionado o rato. P. ex., use o Page Up e o Page Down para ir rapidamente para uma dada posição. Na posição final, largue o botão do rato. </para +><para +>Para seleccionar tudo na janela actual, use a opção do menu "Editar"->"Seleccionar Tudo" (Ctrl-A). </para +><para +>Para copiar para a área de transferência, precisa de carregar no botão "Copiar" (Ctrl-C ou Ctrl-Insert). Porém, existe uma opção para "Copiar Automaticamente a Selecção". Se esta estiver activa, então tudo o que seleccionar será copiado imediatamente, sem que você tenha de copiar explicitamente. Todavia, preste atenção ao usar isto, dado que o conteúdo da área de transferência poderá ficar assim destruído por acidente. </para +><para +>O "Cortar" (Ctrl-X ou Shift-Delete) copia para a área de transferência e apaga o texto seleccionado. </para +><para +>O "Colar" (Ctrl-V ou Shift-Insert) insere o texto da área de transferência na posição do cursor ou na selecção actual. Se colar numa das janelas de entrada de diferenças, o conteúdo da área de transferência será mostrado nessa janela e a comparação irá reiniciar imediatamente. Isto é útil se quiser pegar rapidamente num pedaço de texto de qualquer local e compará-lo com outra coisa, sem ter de criar ficheiros primeiro. </para> </sect1> <sect1 id="saving" ><title >Gravar</title> <para ->Saving will only be allowed, when all conflicts were solved. If the file already exists and the <quote ->Backup files</quote -> option is enabled then the existing file will be renamed with an <filename role="extension" ->.orig</filename -> extension, but if such a file exists it will be deleted. When you exit or start another diff-analysis and data wasn't saved yet, then &kdiff3; will ask if you want to <guibutton ->Save</guibutton ->, <guibutton ->Cancel</guibutton -> or <guibutton ->Proceed without saving</guibutton ->. &kdiff3; does not catch any signals. So if you <quote ->kill</quote -> &kdiff3; then your data will be lost.) </para +>A gravação só será permitida quando todos os conflitos tiverem sido resolvidos. Se o ficheiro já existir e a opção de "Salvaguarda dos ficheiros" estiver activa, então o ficheiro existente verá o seu nome mudado de modo a ter uma extensão ".orig", mas se existir um destes ficheiros será removido. Quando você sair ou iniciar outra análise de diferenças e os dados não tiverem sido gravados ainda, então o &kdiff3; irá perguntar se você deseja gravar, cancelar ou prosseguir sem gravar. (O &kdiff3; não lida com nenhuns sinais ('signals') do sistema. Por isso, se fizer um "kill" ao &kdiff3;, então os seus dados serão perdidos.) </para ><para ->Line endings are saved according to the normal method on the underlying operating system. For Unices each line ends with an linefeed-character <literal ->\n</literal ->, while for &Windows; based systems each line ends with a carriage-return + a linefeed <literal ->\r\n</literal ->. &kdiff3; does not preserve the line-endings of the input files, which also means that you shouldn't use &kdiff3; with binary files. </para> +>Os fins de linha são gravados de acordo com o método normal do sistema operativo subjacente. Para os UNIXes, cada linha terminada com um carácter de 'linefeed' "\n", enquanto que nos sistemas baseados em Win32, cada linha termina com um 'carriage-return' + um 'linefeed' "\r\n". O &kdiff3; não preserva os fins de linha dos ficheiros de entrada, o que também significa que você não deverá usar o &kdiff3; com ficheiros binários. </para> </sect1> <sect1 id="find" ><title >Procurar Sequências de Texto</title> <para ->You can search for a string in any text-window of &kdiff3;. The <guimenuitem ->Find ...</guimenuitem -> command (<keycombo action="simul" ->&Ctrl;<keycap ->F</keycap -></keycombo ->) in the <guimenu ->Edit</guimenu -> menu opens a dialog that lets you specify the string to search for. You can also select the windows which should be searched. Searching will always start at the top. Use the <guimenuitem ->Find Next</guimenuitem -> command (<keycap ->F3</keycap ->) to proceed to the next occurence. If you select to search several windows then the first window will be searched from top to bottom before the search starts in the next window at the top again, &etc; </para> +>Você poderá procurar por uma sequência de texto em qualquer janela de texto do &kdiff3;. O comando "Procurar ..." (Ctrl-F) no menu "Editar" abre uma janela que lhe permite indicar o texto a procurar. Poderá também seleccionar as janelas que deverão ser pesquisadas. A procura irá ter início sempre no topo do ficheiro. Use o comando "Procurar o Seguinte" (F3) para prosseguir com a próxima ocorrência. Se optar por procurar em várias janelas, então a primeira janela será percorrida de alto a baixo antes de a procura começar na próxima janela a partir do topo de novo, etc. </para> </sect1> +<sect1 id="printing" +><title +>Impressão</title> +<para +>O &kdiff3; suporta a impressão das diferenças do ficheiro de texto. O comando "Imprimir..." (Ctrl-P) no menu Ficheiro abre uma janela que lhe permite seleccionar a impressora e ajustar as outras opções. </para +><para +>Existem várias possibilidades para ajustar o intervalo. Devido às diferentes janelas de impressão nos diferentes sistemas operativos, o método para obter certas selecções de intervalos varia. </para> +<variablelist> + <varlistentry +><term +>Tudo:</term +><listitem +><para +>Imprime tudo.</para +></listitem +></varlistentry> + <varlistentry +><term +>Actual:</term +><listitem +><para +>Imprime uma página que começa na primeira linha visível da janela. (Nos sistemas sem esta opção, isto poderá ser obtido se indicar o número de página 10000 na impressão.)</para +></listitem +></varlistentry> + <varlistentry +><term +>Selecção:</term +><listitem +><para +>Antes de optar por imprimir, seleccione o texto com o rato (como acontece na cópia e colagem) numa das janelas de entrada das diferenças, para definir a linha inicial e final. Se não foi seleccionado nenhum texto numa das janelas de entrada, então esta opção não estará disponível. (Nos sistemas sem esta opção, isto poderá ser conseguido se indicar para imprimir a página 9999.)</para +></listitem +></varlistentry> + <varlistentry +><term +>Intervalo:</term +><listitem +><para +>Indica a primeira e última página. </para +></listitem +></varlistentry> +</variablelist> +<para +>As outras opções importantes serão retiradas das opções normais: </para +><itemizedlist> + <listitem +><para +>Tamanho e tipo de letra</para +></listitem> + <listitem +><para +>Mostrar os números de linha</para +></listitem> + <listitem +><para +>Mudança de linha</para +></listitem> + <listitem +><para +>Cores</para +></listitem> + <listitem +><para +>etc.</para +></listitem> +</itemizedlist> +<para +>A formatação em paisagem (na horizontal) também é recomendada na impressão. </para> +</sect1> <sect1 id="options" ><title >Opções</title> <para ->Options and the recent-file-list will be saved when you exit the program, and reloaded when you start it. (Menu <menuchoice -><guimenu ->Settings</guimenu -><guimenuitem ->Configure KDiff3</guimenuitem -></menuchoice -> ...) </para> +>As opções e a lista de ficheiros recentes serão gravadas quando você sair do programa e serão carregadas de novo quando o iniciar. (Menu Configuração->Configurar o &kdiff3;...) </para> <sect2 ><title >Tipo de Letra</title> @@ -901,8 +914,8 @@ <variablelist> <varlistentry ><term -><guilabel ->Texto Itálico para os Deltas:</guilabel +><emphasis +>Texto Itálico para os Deltas:</emphasis ></term ><listitem ><para @@ -914,12 +927,12 @@ <sect2 ><title ->Colors</title> +>Cores</title> <variablelist> <varlistentry ><term -><guilabel ->Cor principal:</guilabel +><emphasis +>Cor principal:</emphasis ></term ><listitem ><para @@ -928,8 +941,8 @@ ></varlistentry> <varlistentry ><term -><guilabel ->Cor de fundo:</guilabel +><emphasis +>Cor de fundo:</emphasis ></term ><listitem ><para @@ -938,8 +951,8 @@ ></varlistentry> <varlistentry ><term -><guilabel ->Cor de Fundo das Diferenças:</guilabel +><emphasis +>Cor de Fundo das Diferenças:</emphasis ></term ><listitem ><para @@ -948,8 +961,8 @@ ></varlistentry> <varlistentry ><term -><guilabel ->Cor A:</guilabel +><emphasis +>Cor A:</emphasis ></term ><listitem ><para @@ -958,8 +971,8 @@ ></varlistentry> <varlistentry ><term -><guilabel ->Cor B:</guilabel +><emphasis +>Cor B:</emphasis ></term ><listitem ><para @@ -968,8 +981,8 @@ ></varlistentry> <varlistentry ><term -><guilabel ->Cor C:</guilabel +><emphasis +>Cor C:</emphasis ></term ><listitem ><para @@ -978,8 +991,8 @@ ></varlistentry> <varlistentry ><term -><guilabel ->Cor do Conflito:</guilabel +><emphasis +>Cor do Conflito:</emphasis ></term ><listitem ><para @@ -988,8 +1001,8 @@ ></varlistentry> <varlistentry ><term -><guilabel ->Cor de fundo do intervalo actual:</guilabel +><emphasis +>Cor de fundo do intervalo actual:</emphasis ></term ><listitem ><para @@ -998,19 +1011,69 @@ ></varlistentry> <varlistentry ><term -><guilabel ->Cor de fundo da diferença do intervalo actual:</guilabel +><emphasis +>Cor de fundo da diferença do intervalo actual:</emphasis ></term ><listitem ><para >Normalmente a amarelo escuro.</para ></listitem ></varlistentry> + <varlistentry +><term +><emphasis +>Cor para os intervalos de diferenças seleccionados manualmente:</emphasis +></term +><listitem +><para +>Normalmente a laranja.</para +></listitem +></varlistentry> + <varlistentry +><term +><emphasis +>Cor dos ficheiros mais recentes na comparação de pastas:</emphasis +></term +><listitem +><para +>Normalmente a verde.</para +></listitem +></varlistentry> + <varlistentry +><term +><emphasis +>Cor dos ficheiros mais antigos na comparação de pastas:</emphasis +></term +><listitem +><para +>Normalmente a vermelho.</para +></listitem +></varlistentry> + <varlistentry +><term +><emphasis +>Cor dos ficheiros intermédios na comparação de pastas:</emphasis +></term +><listitem +><para +>Normalmente a amarelo escuro.</para +></listitem +></varlistentry> + <varlistentry +><term +><emphasis +>Cor dos ficheiros em falta na comparação de pastas:</emphasis +></term +><listitem +><para +>Normalmente preto.</para +></listitem +></varlistentry> </variablelist> <para ->On systems with only 16 or 256 colors some colors are not available in pure form. On such systems the <guibutton ->Defaults</guibutton -> button will choose a pure color. </para> +>A mudança das cores na comparação das pastas só fará efeito quando iniciar a próxima comparação de pastas. </para> +<para +>Nos sistemas com apenas 16 ou 256 cores, alguns dos tons acima descritos não estão disponíveis de forma pura. Nesses sistemas, o botão "Predefinições" irá escolher uma cor pura. </para> </sect2> <sect2 @@ -1019,8 +1082,8 @@ <variablelist> <varlistentry ><term -><guilabel ->O Tab insere espaços:</guilabel +><emphasis +>O Tab insere espaços:</emphasis ></term ><listitem ><para @@ -1029,8 +1092,8 @@ ></varlistentry> <varlistentry ><term -><guilabel ->Tamanho das tabulações:</guilabel +><emphasis +>Tamanho das tabulações:</emphasis ></term ><listitem ><para @@ -1039,20 +1102,18 @@ ></varlistentry> <varlistentry ><term -><guilabel ->Indentação automática:</guilabel +><emphasis +>Indentação automática:</emphasis ></term ><listitem ><para ->When pressing &Enter; or <keycap ->Return</keycap -> the indentation of the previous line is used for the new line. </para +>Ao carregar em Enter ou Return, a indentação da linha anterior é usada para uma nova linha. </para ></listitem ></varlistentry> <varlistentry ><term -><guilabel ->Copiar automaticamente a selecção:</guilabel +><emphasis +>Copiar automaticamente a selecção:</emphasis ></term ><listitem ><para @@ -1061,76 +1122,48 @@ ></varlistentry> <varlistentry ><term -><guilabel ->Estilo de fim de linha:</guilabel +><emphasis +>Estilo de fim de linha:</emphasis ></term ><listitem ><para >Ao gravar, o utilizador poderá seleccionar o estilo do fim de linha que prefere.O valor por omissão é a escolha comum para o sistema operativo usado. </para ></listitem ></varlistentry> - <varlistentry -><term -><guilabel ->Use locale encoding:</guilabel -></term -><listitem -><para ->For displaying foreign characters. Try changing this if some characters of your language aren't displayed correctly. </para -></listitem -></varlistentry> </variablelist> </sect2> -<sect2 +<sect2 id="diffmergeoptions" ><title ->Diff & Merge Settings</title> +>Configuração da Diferença e Junção</title> <para >Ao comparar os ficheiros, o &kdiff3; tenta primeiro corresponder as linhas iguais em todos os ficheiros de entrada. Só durante este passo é que poderá ignorar os espaços em branco. O segundo passo compara cada uma das linhas. Neste passo, os espaços em branco não serão ignorados. Também durante a junção os espaços em branco não serão ignorados. </para> <variablelist> <varlistentry ><term -><guilabel ->Manter o 'Carriage Return':</guilabel +><emphasis +>Manter o 'Carriage Return':</emphasis ></term ><listitem ><para ->Some editors (on some systems) save carriage return <literal ->\r</literal -> and linefeed <literal ->\n</literal -> characters at the end of line, while others will only save the linefeed <literal ->\n</literal ->. Usually &kdiff3; ignores the carriage return, but then files that don't have equal sizes, look equal in side by side comparison. When this option is on, then the carriage return characters are made visible but are treated as white space. This option must be off during a merge. Default is off.</para +>Alguns editores (em alguns sistemas) gravam os caracteres de 'carriage return' "\r" e 'linefeed' "\n" no fim da linha, enquanto que outros só irão gravar o 'linefeed' "\n". Normalmente o &kdiff3; ignora o 'carriage return', mas aí os ficheiros que não tenham tamanhos iguais pareçam de facto iguais numa comparação lado-a-lado. Quando esta opção estiver activa, então os caracteres de 'carriage return' ficarão visíveis mas serão tratados como espaços em branco. Ela necessita estar desligada durante uma junção. Por omissão, está desligada.</para ></listitem ></varlistentry> <varlistentry ><term -><guilabel ->Ignorar os números:</guilabel +><emphasis +>Ignorar os números:</emphasis ></term ><listitem ><para ->Default is off. Number characters (<quote -><literal ->0-9</literal -></quote ->, <quote -><literal ->.</literal -></quote ->, <quote -><literal ->-</literal -></quote ->) will be ignored in the first part of the analysis in which the line matching is done. In the result the differences will be shown nevertheless, but they are treated as white space. </para +>Por omissão está desligado. Os caracteres dos números ("0-9", ".", "-") serão ignorados na primeira parte da análise, na qual é feita a correspondência de linhas. No resultado, as diferenças serão mostradas de qualquer forma, mas serão tratadas como espaços em branco. </para ></listitem ></varlistentry> <varlistentry ><term -><guilabel ->Ignorar comentários de C/C++:</guilabel +><emphasis +>Ignorar comentários de C/C++:</emphasis ></term ><listitem ><para @@ -1139,26 +1172,18 @@ ></varlistentry> <varlistentry ><term -><guilabel ->Ignorar a capitalização:</guilabel +><emphasis +>Ignorar a capitalização:</emphasis ></term ><listitem ><para ->Default is off. Case-differences of characters (like <quote -><literal ->A</literal -></quote -> vs. <quote -><literal ->a</literal -></quote ->) will be treated like changes in white space. </para +>Por omissão está desligado. As diferenças de capitalização dos caracteres (como o 'A' vs. 'a') serão tratadas como alterações de espaços em branco. </para ></listitem ></varlistentry> <varlistentry ><term -><guilabel ->Comando do pré-processador:</guilabel +><emphasis +>Comando do pré-processador:</emphasis ></term ><listitem ><para @@ -1169,8 +1194,8 @@ ></varlistentry> <varlistentry ><term -><guilabel ->Comando do Pré-processador para a Correspondência de Linhas:</guilabel +><emphasis +>Comando do Pré-processador para a Correspondência de Linhas:</emphasis ></term ><listitem ><para @@ -1181,8 +1206,8 @@ ></varlistentry> <varlistentry ><term -><guilabel ->Tentar com Persistência:</guilabel +><emphasis +>Tentar com Persistência:</emphasis ></term ><listitem ><para @@ -1191,8 +1216,8 @@ ></varlistentry> <varlistentry ><term -><guilabel ->Atraso no Avanço Automático (ms):</guilabel +><emphasis +>Atraso no Avanço Automático (ms):</emphasis ></term ><listitem ><para @@ -1201,20 +1226,108 @@ ></varlistentry> <varlistentry ><term -><guilabel ->Predefinição da junção de espaço em branco com 2/3 ficheiros:</guilabel +><emphasis +>Predefinição da junção de espaço em branco com 2/3 ficheiros:</emphasis ></term ><listitem ><para ->Automatically solve all white-space conflict by choosing the specified file. (Default is manual choice.) Useful if white-space really isn't important in many files. If you need this only occasionally better use <guimenuitem ->Choose A/B/C For All Unsolved Whitespace Conflicts</guimenuitem -> in the <guimenu ->Merge</guimenu -> menu. Note that if you enable either <guilabel ->Ignore numbers</guilabel -> or <guilabel ->Ignore C/C++ comments</guilabel -> then this auto-choice also applies for conflicts in numbers or comments. </para +>Resolve automaticamente todos os conflitos de espaços em branco, seleccionando o ficheiro indicado. (Por omissão, é com uma escolha manual). É útil se os espaços em branco não serão importantes em muitos dos ficheiros. Se precisar disto apenas ocasionalmente, é melhor usar o "Escolher A/B/C nos Conflitos de Espaços em Branco Por Resolver" no menu "Junção". Lembre-se que, se activar o "Ignorar os Números" ou o "Ignorar os Comentários de C/C++", então esta escolha automática também se aplica para os conflitos nos números ou nos comentários. </para +></listitem +></varlistentry> + <varlistentry +><term +><emphasis +>Expressão regular de junção automática:</emphasis +></term +><listitem +><para +>A expressão regular para as linhas onde o &kdiff3; deverá escolher automaticamente uma origem. Veja também a <link linkend="vcskeywordsmergesupport" +>Junção Automática ...</link +> </para +></listitem +></varlistentry> + <varlistentry +><term +><emphasis +>Executar a junção automática da expressão regular no início da junção:</emphasis +></term +><listitem +><para +>Se for activado, o &kdiff3; executa a junção automática com a "Expressão regular da junção automática", quando for iniciada uma junção. </para +></listitem +></varlistentry> + <varlistentry +><term +><emphasis +>Expressão regular do início do histórico:</emphasis +></term +><listitem +><para +>A expressão regular do início do item de histórico. Normalmente, esta linha contém a palavra-chave "$Log$". Valor por omissão: ".*\$Log.*\$.*" </para +></listitem +></varlistentry> + <varlistentry +><term +><emphasis +>Expressão regular do início do item de histórico:</emphasis +></term +><listitem +><para +>Um item de junção do histórico consiste em várias linhas. Indique a expressão regular que detecta a primeira linha (sem o comentário inicial). Use os parêntesis para agrupar as chaves que deseja usar na ordenação. Se for deixado em branco, o &kdiff3; assume que as linhas em branco separam os itens de histórico. Veja também a <link linkend="vcskeywordsmergesupport" +>Junção Automática ...</link +> </para +></listitem +></varlistentry> + <varlistentry +><term +><emphasis +>Ordenação da junção do histórico:</emphasis +></term +><listitem +><para +>Activa a ordenação do histórico do controlo de versões. </para +></listitem +></varlistentry> + <varlistentry +><term +><emphasis +>Ordem da chave de ordenação do início do item de histórico:</emphasis +></term +><listitem +><para +>Cada grupo de parêntesis usado na expressão regular do item de início de histórico agrupa uma chave que poderá ser usada na ordenação. Indique a lista de chaves (que são numeradas por ordem de ocorrência, a começar em 1), usando o ',' como separador (p.ex., "4,5,6,1,2,3,7"). Se for deixado em branco, então não será feita nenhuma ordenação. Veja também a <link linkend="vcskeywordsmergesupport" +>Junção Automática ...</link +> </para +></listitem +></varlistentry> + <varlistentry +><term +><emphasis +>Juntar o histórico do controlo de versões no início da junção:</emphasis +></term +><listitem +><para +>Se estiver activado, o &kdiff3; executa a junção automática do histórico, usando as opções acima mencionadas, quando for iniciada uma junção. </para +></listitem +></varlistentry> + <varlistentry +><term +><emphasis +>Testar as suas expressões regulares</emphasis +></term +><listitem +><para +>Este botão mostra uma janela que lhe permite melhorar e testar as expressões regulares acima. Basta copiar os dados respectivos dos seus ficheiros para as linhas de exemplo. O "Resultados da correspondência" irá mostrar imediatamente se a correspondência é bem sucedida ou não. O "Resultado da chave de ordenação" irá mostrar a chave usada no histórico da junção do histórico. </para +></listitem +></varlistentry> + <varlistentry +><term +><emphasis +>Comando de junção irrelevante:</emphasis +></term +><listitem +><para +>Indique um comando próprio, que deverá ser chamado quando o &kdiff3; detectar que, numa junção de três ficheiros, o ficheiro de B não contribui com dados relevantes que não estivessem já contidos no ficheiro em C. O comando é chamado com os três nomes de ficheiros como parâmetros. Os dados correspondentes à "Expressão regular da junção automática" ou no histórico não são considerados relevantes. </para ></listitem ></varlistentry> </variablelist> @@ -1233,16 +1346,12 @@ <variablelist> <varlistentry ><term -><guilabel ->Ficheiros de segurança:</guilabel +><emphasis +>Ficheiros de segurança:</emphasis ></term ><listitem ><para ->When a file is saved and an older version already exists, then the original version will be renamed with an <filename role="extension" ->.orig</filename -> extension. If an old backup file with <filename role="extension" ->.orig</filename -> extension already exists then this will be deleted without backup. </para +>Quando um ficheiro é gravado e já existe uma versão anterior, então a versão original irá mudar para um nome com uma extensão ".orig". Se já existir um ficheiro de cópia de segurança antigo com uma extensão ".orig", então este será removido sem ficar nenhuma cópia de segurança. </para ></listitem ></varlistentry> </variablelist> @@ -1254,18 +1363,18 @@ <variablelist> <varlistentry ><term -><guilabel ->Língua:</guilabel +><emphasis +>Língua:</emphasis ></term ><listitem ><para ->Adjust the language of the user interface. Changing this option doesn't affect the running program. You have to exit and restart &kdiff3; so that the language is changed. (This option is not available in the &kde; version of &kdiff3; because the language is adjustable in the global &kde; settings.) </para +>Ajusta a língua da interface do utilizador. Se mudar esta opção não afectará o programa em execução. Terá de sair e reiniciar o &kdiff3; para que a língua seja alterada. (Esta opção não está disponível na versão para KDE do &kdiff3;, porque a língua é ajustável na configuração global do KDE). </para ></listitem ></varlistentry> <varlistentry ><term -><guilabel ->Utilizar a mesma codificação para tudo:</guilabel +><emphasis +>Utilizar a mesma codificação para tudo:</emphasis ></term ><listitem ><para @@ -1274,8 +1383,8 @@ ></varlistentry> <varlistentry ><term -><guilabel ->Codificação Local:</guilabel +><emphasis +>Codificação Local:</emphasis ></term ><listitem ><para @@ -1284,8 +1393,8 @@ ></varlistentry> <varlistentry ><term -><guilabel ->Codificação do Ficheiro para o A/B/C:</guilabel +><emphasis +>Codificação do Ficheiro para o A/B/C:</emphasis ></term ><listitem ><para @@ -1294,8 +1403,8 @@ ></varlistentry> <varlistentry ><term -><guilabel ->Codificação do Ficheiro para Junção de Resultado e Gravação:</guilabel +><emphasis +>Codificação do Ficheiro para Junção de Resultado e Gravação:</emphasis ></term ><listitem ><para @@ -1304,8 +1413,8 @@ ></varlistentry> <varlistentry ><term -><guilabel ->Codificação do Ficheiro dos Ficheiros de Pré-processador:</guilabel +><emphasis +>Codificação do Ficheiro dos Ficheiros de Pré-processador:</emphasis ></term ><listitem ><para @@ -1314,20 +1423,12 @@ ></varlistentry> <varlistentry ><term -><guilabel ->Língua da Esquerda-para-a-Direita:</guilabel +><emphasis +>Língua da Esquerda-para-a-Direita:</emphasis ></term ><listitem ><para ->Some languages are written right to left. When this option is enabled, &kdiff3; draws the text from right to left in the diff input windows and in the merge output window. Note that if you start &kdiff3; with the command line option <option ->--reverse</option -> then all layouting will be done right to left too. (This is a feature provided by &Qt;.) This handbook was written assuming that <quote ->Right To Left Language</quote -> or reverse layout are disabled. So some references to <quote ->left</quote -> or <quote ->right</quote -> must be replaced by their respective counterpart if you use these options. </para +>Algumas línguas são escritas da direita para a esquerda. Quando esta opção está activa, o &kdiff3; desenha o texto da direita para a esquerda nas janelas de diferenças dos ficheiros de entrada e na janela do resultado da junção. Repare que, se iniciar o &kdiff3; com a opção da linha de comandos "--reverse", então toda a disposição será feita também da direita para a esquerda. (Esta é uma funcionalidade oferecida pelo Qt.) Esta documentação foi escrita a assumir que a "Língua da direita-para-a-esquerda" ou a disposição inversa estão desactivadas. Por isso, algumas das referências a "esquerda" ou "direita" deverão ser substituídas pela versão inversa, se usar estas opções. </para ></listitem ></varlistentry> @@ -1338,12 +1439,12 @@ ><title >Diversos</title> <para ->These options and actions are available in menus or the buttonbar.</para> +>(Estas opções e acções estão disponíveis nos menus ou na barra de botões.)</para> <variablelist> <varlistentry ><term -><guilabel ->Mostrar os números de linha:</guilabel +><emphasis +>Mostrar os números de linha:</emphasis ></term ><listitem ><para @@ -1352,8 +1453,8 @@ ></varlistentry> <varlistentry ><term -><guilabel ->Mostrar as diferenças de espaços e tabulações:</guilabel +><emphasis +>Mostrar as diferenças de espaços e tabulações:</emphasis ></term ><listitem ><para @@ -1362,36 +1463,28 @@ ></varlistentry> <varlistentry ><term -><guilabel ->Mostrar os espaços em branco:</guilabel +><emphasis +>Mostrar os espaços em branco:</emphasis ></term ><listitem ><para ->Turn this off to suppress any highlighting of white-space-only changes in the text or overview-columns. (Note that this also applies to changes in numbers or comments if the options <guilabel ->Ignore numbers</guilabel -> or "Ignore C/C++ comments" are active.)</para +>Desligue isto para suprimir o realce das alterações apenas nos espaços em branco no texto ou nas colunas de vista geral. (Lembre-se que isto também se aplica às alterações nos números ou comentários se as opções "Ignorar os números" ou "Ignorar os Comentários de C/C++" estiverem activas.)</para ></listitem ></varlistentry> <varlistentry ><term -><guilabel ->Opções da vista geral:</guilabel +><emphasis +>Opções da vista geral:</emphasis ></term ><listitem ><para ->These choices are only available when you compare three files. In normal mode all differences are shown in one color-coded overview-column. But sometimes you are especially interested in the differences between only two of these three files. Selecting <guilabel ->A vs. B</guilabel ->, <guilabel ->A vs. C</guilabel -> or <guilabel ->B vs. C</guilabel -> overview will show a second overview column with the required information next to the normal overview. </para +>Estas opções só estão disponíveis quando você compara três ficheiros. No modo normal, todas as diferenças são mostradas na coluna de resumo codificada a cores. Mas, em alguns casos, você está especialmente interessado nas diferenças entre apenas dois desses três ficheiros. Se seleccionar "A vs. B", "A vs. C" ou "B vs. C" na coluna de resumo irá aparecer uma segunda coluna com a informação necessária ao lado do resumo normal. </para ></listitem ></varlistentry> <varlistentry ><term -><guilabel ->Quebrar linha nas janelas de diferenças:</guilabel +><emphasis +>Quebrar linha nas janelas de diferenças:</emphasis ></term ><listitem ><para @@ -1400,44 +1493,36 @@ ></varlistentry> <varlistentry ><term -><guimenuitem ->Mostrar a Janela A/B/C:</guimenuitem +><emphasis +>Mostrar a Janela A/B/C:</emphasis ></term ><listitem ><para ->Sometimes you want to use the space on the screen better for long lines. Hide the windows that are not important. (In the <guimenu ->Windows</guimenu -> menu.)</para +>Em algumas vezes, você poderá usar melhor o espaço no ecrã para as linhas compridas. Esconda as janelas que não são importantes. (No menu "Janelas".)</para ></listitem ></varlistentry> <varlistentry ><term -><guimenuitem ->Comutar a Orientação da Repartição:</guimenuitem +><emphasis +>Comutar a Orientação da Repartição:</emphasis ></term ><listitem ><para ->Switch between diff windows shown next to each other (A left of B left of C) or above each other (A above B above C). This should also help for long lines. (In the <guimenu ->Windows</guimenu -> menu.) </para +>Define se as janelas de diferenças são mostradas uma ao lado da outra (a A à esquerda da B, que está à esquerda da C) ou uma por cima da outra (a A sobre a B, que está sobre a C). Isto também deverá ajudar para as linhas compridas (No menu "Janelas"). </para ></listitem ></varlistentry> <varlistentry ><term -><guilabel ->Iniciar uma junção rapidamente:</guilabel +><emphasis +>Iniciar uma junção rapidamente:</emphasis ></term ><listitem ><para ->Sometimes you are viewing the deltas and decide to merge. <inlinemediaobject +>Às vezes, você está a ver os deltas e decide juntá-los. <inlinemediaobject ><imageobject ><imagedata fileref="merge_current.png" format="PNG"/></imageobject ></inlinemediaobject -> <guimenuitem ->Merge current file</guimenuitem -> in the <guimenu ->Directory</guimenu -> menu also works if you only compare two files. A single click starts the merge and uses the filename of the last input-file as the default output filename. (When this is used to restart a merge, then the output filename will be preserved.)</para +> O "Juntar o ficheiro actual" no menu "Directoria" também resulta se só comparar dois ficheiros. Um único 'click' começa a junção e usa o nome do último ficheiro de entrada como nome do ficheiro do resultado por omissão. (Quando isto for usado para reiniciar uma junção, então o nome do ficheiro do resultado será mantido.)</para ></listitem ></varlistentry> </variablelist> @@ -1447,13 +1532,7 @@ ><title >Configurar os Atalhos de Teclado</title> <para ->Currently only the &kde; version supports user-configurable keyboard-shortcuts. (<menuchoice -><guimenu ->Settings</guimenu -><guimenuitem ->Configure Shortcuts...</guimenuitem -></menuchoice ->) </para> +>De momento, só a versão para KDE suporta os atalhos de teclado configuráveis pelo utilizador. (No menu Configuração->Configurar os Atalhos...) </para> </sect2> </sect1> @@ -1466,18 +1545,18 @@ <variablelist> <varlistentry ><term -><guilabel ->Comando do pré-processador:</guilabel +><emphasis +>Comando do pré-processador:</emphasis ></term ><listitem ><para ->When any file is read, it will be piped through this external command. The output of this command will be visible instead of the original file. You can write your own preprocessor that fulfills your specific needs. Use this to cut away disturbing parts of the file, or to automatically correct the indentation &etc;. </para +>Quando for lido qualquer ficheiro, ele será encaminhado através deste comando externo. O resultado deste comando será visível em vez do ficheiro original. O utilizador poderá criar o seu próprio pré-processador que corresponda às suas necessidades específicas. Use isto para cortar partes desnecessárias do ficheiro ou para corrigir automaticamente a indentação, etc. </para ></listitem ></varlistentry> <varlistentry ><term -><guilabel ->Comando do Pré-processador para a Correspondência de Linhas:</guilabel +><emphasis +>Comando do Pré-processador para a Correspondência de Linhas:</emphasis ></term ><listitem ><para @@ -1493,63 +1572,41 @@ >perl</command > encarregar-se-ão disso. </para> <para ->Example: Simple testcase: Consider file <filename ->a.txt</filename -> (6 lines):</para> -<screen ->aa -ba -ca -da -eafa -</screen> - -<para ->And file <filename ->b.txt</filename -> (3 lines):</para> - -<screen ->cg -dg -eg</screen> - -<para ->Without a preprocessor the following lines would be placed next to each other:</para> - -<screen ->aa - cg -ba - dg -ca - eg -da -ea -fa</screen> - -<para ->This is probably not wanted since the first letter contains the actually interesting information. To help the matching algorithm to ignore the second letter we can use a line matching preprocessor command, that replaces <literal ->g</literal -> with <literal ->a</literal ->:</para> - -<screen -><command +>Exemplo: Caso de teste simples. Considere o ficheiro a.txt (6 linhas): <screen> + aa + ba + ca + da + ea + fa +</screen +> E o ficheiro b.txt (3 linhas): <screen> + cg + dg + eg +</screen +> Sem um pré-processador as seguintes linhas teriam sido colocadas lado a lado: <screen> + aa - cg + ba - dg + ca - eg + da + ea + fa +</screen +> Isto provavelmente não será o desejado, dado que a primeira letra contém a informação realmente interessante. Para ajudar o algoritmo de correspondência a ignorar aa segunda letra, poder-se-ia usar um comando de pré-processamento de correspondências de linhas que substituísse o 'g' pelo 'a': <screen> + <command >sed</command -> 's/g/a/'</screen> - -<para ->With this command the result of the comparison would be:</para> - -<screen ->aa -ba -ca - cg -da - dg -ea - eg -fa</screen> - -<para ->Internally the matching algorithm sees the files after running the line matching preprocessor, but on the screen the file is unchanged. (The normal preprocessor would change the data also on the screen.)</para> +> 's/g/a/' +</screen +> Com este comando, o resultado da comparação seria: <screen> + aa + ba + ca - cg + da - dg + ea - eg + fa +</screen +> Internamente, o algoritmo de correspondência vê os ficheiros depois de correr o pré-processador de correspondência de linhas, mas no ecrã o ficheiro fica inalterado. (O pré-processador normal iria alterar também os dados no ecrã.) </para> <sect2 id="sedbasics" ><title @@ -1557,96 +1614,71 @@ >sed</command ></title> <para ->This section only introduces some very basic features of <command +>Esta secção só introduz algumas funcionalidades muito básicas do <command >sed</command ->. For more information see <ulink url="info:/sed" +>. Para mais informações veja as páginas <ulink url="info:/sed" >info:/sed</ulink -> or <ulink url="http://www.gnu.org/software/sed/manual/html_mono/sed.html" +> ou <ulink url="http://www.gnu.org/software/sed/manual/html_mono/sed.html" > http://www.gnu.org/software/sed/manual/html_mono/sed.html</ulink ->. A precompiled version for &Windows; can be found at <ulink url="http://unxutils.sourceforge.net" +>. Existe uma versão pré-compilada para o Windows em <ulink url="http://unxutils.sourceforge.net" > http://unxutils.sourceforge.net</ulink ->. Note that the following examples assume that the <command +>. Repare no facto de que os exemplos seguintes assumem que o comando <command >sed</command -> command is in some directory in the <envar ->PATH</envar -> environment variable. If this is not the case, you have to specify the full absolute path for the command. Also note that the following examples use the single quotation mark (<literal ->'</literal ->) which won't work for &Windows;. On &Windows; you should use the double quotation marks (<literal ->"</literal ->) instead.</para> +> está numa pasta referida pela sua variável de ambiente PATH. Se não for este o caso, você terá de indicar a localização absoluta completa para o comando. </para> +<note +><para +>Lembre-se também que os exemplos seguintes usam a plica simples (') que não irá funcionar no Windows. No Windows, deverá usar as aspas (") em alternativa.</para +></note> <para ->In this context only the <command +>Neste contexto apenas o comando de substituição do <command >sed</command -> substitute command is used:</para> -<screen -><command +> será usado: <screen> + <command >sed</command > 's/<replaceable ->REGEXP</replaceable +>EXPREG</replaceable >/<replaceable ->REPLACEMENT</replaceable +>SUBSTITUTO</replaceable >/<replaceable ->FLAGS</replaceable ->'</screen> -<para ->Before you use a new command within &kdiff3;, you should first test it in a console. Here the <command +>OPÇÕES</replaceable +>' +</screen +> Antes de você usar um comando novo no &kdiff3;, deverá primeiro testá-lo numa consola. Aqui, o comando <command >echo</command ->-command is useful. Example:</para> - -<screen -><command +> é útil. Exemplo: <screen> + <command >echo</command -> abrakadabra | <command +> abracadabra | <command >sed</command > 's/a/o/' -<computeroutput ->obrakadabra</computeroutput -></screen> - -<para ->This example shows a very simple sed-command that replaces the first occurance of <quote ->a</quote -> with <quote ->o</quote ->. If you want to replace all occurances then you need the <parameter ->g</parameter -> flag:</para> - -<screen -><command + -> obracadabra +</screen +> Este exemplo mostra um comando 'sed' muito simples que substitui a primeira ocorrência do "a" por um "o". Se quiser substituir todas as ocorrências, então irá necessitar da opção "g": <screen> + <command >echo</command -> abrakadabra | <command +> abracadabra | <command >sed</command > 's/a/o/g' -<computeroutput ->obrokodobro</computeroutput -></screen> - -<para ->The <quote -><literal ->|</literal -></quote -> symbol is the pipe-command that transfers the output of the previous command to the input of the following command. If you want to test with a longer file then you can use <command + -> obrocodobro +</screen +> O símbolo "|" é o 'pipe' ou canal que transfere o resultado do comando anterior para os dados de entrada do comando seguinte. Se quiser testar com um ficheiro maior, então poderá usar o <command >cat</command -> on Unix-like systems or <command +> no sistemas do tipo do Unix ou o <command >type</command -> on &Windows;-like systems. <command +> nos sistemas do tipo Windows. O <command >sed</command -> will do the substitution for each line.</para> - -<screen +> irá fazer a substituição para cada linha. <screen ><command >cat</command > <replaceable ->filename</replaceable -> |<command +>ficheiro</replaceable +> | <command >sed</command > <replaceable ->options</replaceable -></screen> - - +>opções</replaceable +> +</screen> +</para> </sect2> <sect2 id="sedforkdiff3" ><title @@ -1657,106 +1689,71 @@ ><title >Ignorar Outros Tipos de Comentários</title> <para ->Currently &kdiff3; understands only C/C++ comments. Using the Line-Matching-Preprocessor-Command you can also ignore other types of comments, by converting them into C/C++-comments.</para> - -<informalexample> -<para ->To ignore comments starting with <literal +>De momento, o &kdiff3; só compreende comentários de C/C++. Se usar o comando "Pré-Processador de Correspondência de Linhas", poderá também ignorar outros tipos de comentários, convertendo-os em comentários de C/C++. Exemplo: Para ignorar comentários que comecem por "#", poderá convertê-los para "//". Lembre-se que terá também de activar a opção "Ignorar os Comentários de C/C++" para obter efeito. Um comando "Pré-Processador de Correspondência de Linhas" seria: <screen> + <command +>sed</command +> 's/#/\/\//' +</screen +> Dado que para o <command +>sed</command +> o carácter <literal +>/</literal +> tem um significado especial, é necessário colocar o carácter <literal +>\</literal +> antes de cada <literal +>/</literal +> no texto de substituição. Algumas das vezes o <literal +>\</literal +> é necessário para adicionar ou remover um significado especial para certos caracteres. As plicas simples (<literal +>'</literal +>) antes e depois do comando de substituição são importantes, caso contrário a linha de comandos iria tentar interpretar alguns caracteres especiais como o <literal >#</literal ->, you would like to convert them to <literal ->//</literal ->. Note that you also must enable the <guilabel ->Ignore C/C++-Comments</guilabel -> option to get an effect. An appropriate Line-Matching-Preprocessor-Command would be:</para> - -<screen -><command +>, o <literal +>$</literal +> ou o <literal +>\</literal +> antes de os passar para o <command >sed</command -> 's/#/\/\//'</screen> -</informalexample> - -<para ->Since for <command ->sed</command -> the <literal ->/</literal -> character has a special meaning, it is necessary to place the <literal ->\</literal -> character before each <literal ->/</literal -> in the replacement string. Sometimes the <literal ->\</literal -> is required to add or remove a special meaning of certain characters. The single quotation marks (<literal ->'</literal ->) before and after the substitution-command are important now, because otherwise the shell will try to interpret some special characters like <literal ->#</literal ->, <literal ->$</literal -> or <literal ->\</literal -> before passing them to <command ->sed</command ->. Note that on &Windows; you will need the double quotation marks (<literal +>. Lembre-se que no &Windows; irá necessitar aqui das aspas (<literal >"</literal ->) here. &Windows; substitutes other characters like <literal +>). O &Windows; substitui os outros caracteres como o <literal >%</literal ->, so you might have to experiment a little bit.</para> +>, por isso você terá de fazer algumas experiências. </para> </sect3> - <sect3 ><title >Diff sem Distinguir Capitalização</title> - <para ->Use the following Line-Matching-Preprocessor-Command to convert all input to uppercase:</para> - -<screen -><command +>Use o comando "Pré-Processador de Correspondência de Linhas" para converter todo o texto para maiúsculas: <screen> + <command >sed</command -> 's/\(.*\)/\U\1/'</screen> - -<para ->Here the <quote -><literal +> 's/\(.*\)/\U\1/' +</screen +> Aqui o <literal >.*</literal -></quote -> is a regular expression that matches any string and in this context matches all characters in the line. The <literal +> é uma expressão regular que corresponde a qualquer texto e, no seu contexto, irá corresponder a todos os caracteres da linha. O <literal >\1</literal -> in the replacement string refers to the matched text within the first pair of <literal +> no texto de substituição refere-se ao texto correspondente ao primeiro par de <literal >\(</literal -> and <literal +> e <literal >\)</literal ->. The <literal +>. O <literal >\U</literal -> converts the inserted text to uppercase. </para> +> converte o texto inserido para maiúsculas. </para> </sect3> <sect3 ><title >Ignorar as Palavras-Chave do Controlo de Versões</title> <para -><acronym ->CVS</acronym -> and other version control systems use several keywords to insert automatically generated strings (<ulink url="info:/cvs/Keyword substitution" +>O CVS e outros sistemas de controlo de versões usam várias palavras-chave para inserir texto gerado automaticamente (<ulink url="info:/cvs/Keyword substitution" >info:/cvs/Keyword substitution</ulink ->). All of them follow the pattern <literal ->$KEYWORD generated text$</literal ->. We now need a Line-Matching-Preprocessor-Command that removes only the generated text:</para> -<screen -><command +>). Todas elas seguem o padrão "$PALAVRACHAVE texto gerado$". É preciso agora um comando Pré-Processador de Correspondência de Linhas que remova apenas o texto gerado: <screen> + <command >sed</command -> 's/\$\(Revision\|Author\|Log\|Header\|Date\).*\$/\$\1\$/'</screen> - -<para ->The <literal ->\|</literal -> separates the possible keywords. You might want to modify this list according to your needs. The <literal ->\</literal -> before the <literal ->$</literal -> is necessary because otherwise the <literal ->$</literal -> matches the end of the line. </para> +> 's/\$\(Revision\|Author\|Log\|Header\|Date\).*\$/\$\1\$/' +</screen +> O "\|" separa as palavras-chave possíveis. Poderá querer modificar esta lista de acordo com as suas necessidades. O "\" antes do "$" é necessário, caso contrário o "$" irá corresponder ao fim da linha. </para> <para >Ao experimentar com o <command >sed</command @@ -1767,63 +1764,39 @@ ><title >Ignorar os Números</title> <para ->Ignoring numbers actually is a built-in option. But as another example, this is how it would look as a Line-Matching-Preprocessor-command.</para> -<screen -><command +>A indiferença em relação aos números é de facto uma opção incorporada. Mas, como outro exemplo, seria assim como iria ficar como um comando do Pré-Processador da Correspondência de Linhas. <screen> + <command >sed</command -> 's/[0123456789.-]//g'</screen> -<para ->Any character within <literal ->[</literal -> and <literal ->]</literal -> is a match and will be replaced with nothing. </para> +> 's/[0123456789.-]//g' +</screen +> Todos os caracteres dentro de '[' e ']' são uma correspondência e será substituído por nada. </para> </sect3> <sect3 ><title >Ignorar Certas Colunas</title> <para ->Sometimes a text is very strictly formatted, and contains columns that you always want to ignore, while there are other columns you want to preserve for analysis. In the following example the first five columns (characters) are ignored, the next ten columns are preserved, then again five columns are ignored and the rest of the line is preserved.</para> - -<screen -><command +>Em algumas ocasiões um determinado texto tem uma formatação demasiado restrita e contém colunas que deseja sempre ignorar, enquanto que existem outras colunas que deseje preservar para análise. No exemplo seguinte, as primeiras cinco colunas (caracteres) são ignoradas, as próximas dez são preservadas, depois as próximas cinco colunas serão ignoradas de novo e o resto da linha é preservada. <screen> + <command >sed</command -> 's/.....\(..........\).....\(.*\)/\1\2/'</screen> - -<para ->Each dot <literal ->.</literal -> matches any single character. The <literal ->\1</literal -> and <literal ->\2</literal -> in the replacement string refer to the matched text within the first and second pair of <literal ->\(</literal -> and <literal ->\)</literal -> denoting the text to be preserved.</para> +> 's/.....\(..........\).....\(.*\)/\1\2/' +</screen +> Cada ponto '.' corresponde a um único carácter. O "\1" e o "\2" no texto de substituição refere-se ao texto correspondente dentro do primeiro e segundo par de "\(" e "\)", demarcando o texto a ser preservado. </para> </sect3> <sect3 ><title >Combinar Várias Substituições</title> - <para ->Sometimes you want to apply several substitutions at once. You can then use the semicolon <literal ->;</literal -> to separate these from each other.</para> - -<screen +>Em algumas situações você deseja aplicar várias substituições de uma vez. Poderá então usar o ponto-e-vírgula ";" para separar uma da outra. Exemplo: <screen ><command >echo</command -> abrakadabra | <command +> abracadabra | <command >sed</command > 's/a/o/g;s/\(.*\)/\U\1/' -<computeroutput ->OBROKODOBRO</computeroutput -></screen> - + -> OBROCODOBRO +</screen> +</para> </sect3> <sect3 @@ -1834,48 +1807,36 @@ >sed</command ></title> <para ->Instead of <command +>Em vez do <command >sed</command -> you might want to use something else like <command +>, você poderá querer usar algo diferente como o <command >perl</command ->.</para> -<screen -><command +>. <screen> + <command >perl</command > -p -e 's/<replaceable ->REGEXP</replaceable +>EXPREG</replaceable >/<replaceable ->REPLACEMENT</replaceable +>SUBSTITUTO</replaceable >/<replaceable ->FLAGS</replaceable ->'</screen> -<para ->But some details are different in <command +>OPÇÕES</replaceable +>' +</screen +> Porém, alguns detalhes são diferentes no <command >perl</command ->. Note that where <command +>. Repare que, onde o <command >sed</command -> needed <literal ->\(</literal -> and <literal ->\)</literal -> <command +> necessitava do "\(" e do "\)", o <command >perl</command -> requires the simpler <literal ->(</literal -> and <literal ->)</literal -> without preceding <literal ->\</literal ->.</para> - -<screen +> necessita dos "(" e ")" mais simples e sem o '\' precedente. Exemplo: <screen ><command >sed</command > 's/\(.*\)/\U\1/' -<command + <command >perl</command -> -p -e 's/(.*)/\U\1/'</screen> - +> -p -e 's/(.*)/\U\1/' +</screen> +</para> </sect3> </sect2> @@ -1922,15 +1883,7 @@ <para >Os comandos do pré-processador são normalmente muito úteis, mas como acontece com qualquer opção que modifica os seus textos ou esconde algumas diferenças automaticamente, você poderá saltar por cima de certas diferenças e, no pior dos casos, destruir dados importantes. </para ><para ->For this reason during a merge if a normal preprocessor-command is being used &kdiff3; will tell you so and ask you if it should be disabled or not. But it won't warn you if a Line-Matching-Preprocessor-command is active. The merge will not complete until all conflicts are solved. If you disabled <guilabel ->Show White Space</guilabel -> then the differences that were removed with the Line-Matching-Preprocessor-command will also be invisible. If the Save-button remains disabled during a merge (because of remaining conflicts), make sure to enable <guilabel ->Show White Space</guilabel ->. If you don't wan't to merge these less important differences manually you can select <guimenuitem ->Choose [A|B|C] For All Unsolved Whitespace Conflicts</guimenuitem -> in the <guimenu ->Merge</guimenu -> menu. </para> +>Por esta razão, durante uma junção, se for usado um comando pré-processador normal, o &kdiff3; dizer-lhe-á isso e perguntar-lhe-á se deverá ser desactivado ou não. Mas não o irá avisar se estiver um Pré-Processador de Correspondência de Linhas activo. A junção não irá ficar completa até que todos os conflitos tenham sido resolvidos. Se tiver desactivado o "Mostrar os Espaços em Branco", então as diferenças que foram removidas com o Pré-Processador de Correspondência de Linhas ficarão também invisíveis. Se o botão para Gravar continuar inactivo durante uma junção (devido a conflitos por resolver), verifique se activa o "Mostrar os Espaços em Branco". Se não quiser juntar essas diferenças menos importantes poderá escolher a opção "Escolher [A|B|C] nos Conflitos de Espaço em Branco por Resolver" no menu "Juntar". </para> </sect2> </sect1> </chapter> @@ -1941,11 +1894,11 @@ >Comparação e Junção de Directorias com o &kdiff3;</title> <sect1 id="dirmergeintro" ><title ->Introdução</title> +>Introdução à Comparação ou Junção de Pastas</title> <para >Normalmente, os programadores precisam de modificar vários ficheiros numa pasta para atingir os seus fins. Para isso, o &kdiff3; também lhe permite comparar e juntar várias pastas de forma recursiva! </para ><para ->Even though comparing and merging directories seems to be quite obvious, there are several details that you should know about. Most important is of course the fact that now many files might be affected by each operation. If you don't have backups of your original data, then it can be very hard or even impossible to return to the original state. So before starting a merge, make sure that your data is safe, and going back is possible. If you make an archive or use some version control system is your decision, but even experienced programmers and integrators need the old sources now and then. And note that even though I (the author of &kdiff3;) try to do my best, I can't guarantee that there are no bugs. According to the GNU GPL there is NO WARRANTY whatsoever for this program. So be humble and always keep in mind: </para> +>Ainda que a comparação e junção de pastas pareça ser bastante óbvia, existem vários detalhes que o utilizador deverá conhecer. O mais importante é, obviamente, o facto de que vários ficheiros poderão ser afectados por cada operação. Se não tiver cópias de segurança dos seus dados originais, então poderá ser bastante difícil ou mesmo impossível de voltar ao estado original. Por isso, antes de começar uma junção, certifique-se que os seus dados estão a salvo e que é possível voltar atrás. Se cria um pacote ou usa um sistema de controlo de versões é uma decisão sua, mas mesmo os programadores experientes e os integradores precisam do código antigo e do novo. E repare que até ao autor do &kdiff3; tenta fazer o seu melhor, mas não pode garantir que não existam erros. De acordo com a GPL da GNU, não existe NENHUMA GARANTIA de qualquer forma para este programa. Por isso, seja humilde e tenha sempre em mente: </para> <blockquote ><para> <emphasis @@ -1981,23 +1934,15 @@ ></listitem> <listitem ><para ->... lets you run the selected operation for all items (key <keycap ->F7</keycap ->) or the selected item (key <keycap ->F6</keycap ->),</para +>... permite-lhe executar a operação seleccionada para todos os itens (tecla F7) ou para o item seleccionado (tecla F6),</para ></listitem> <listitem ><para ->... lets you continue the merge after manual interaction with key <keycap ->F7</keycap ->,</para +>... permite-lhe continuar a junção depois de uma interacção manual com a tecla F7,</para ></listitem> <listitem ><para ->... optionally creates backups, with the <filename role="extension" ->.orig</filename -> extension,</para +>... cria opcionalmente cópias de segurança com a extensão ".orig",</para ></listitem> <listitem ><para @@ -2018,15 +1963,13 @@ ><command >kdiff3</command > <replaceable ->dir1 dir2</replaceable> +>pasta1 pasta2</replaceable> <command >kdiff3</command > <replaceable ->dir1 dir2</replaceable -> <option ->-o</option -> <replaceable ->destdir</replaceable +>pasta1 pasta2</replaceable +> -o <replaceable +>destino</replaceable > </screen> <para @@ -2042,15 +1985,13 @@ ><command >kdiff3</command > <replaceable ->dir1 dir2 dir3</replaceable> +>pasta1 pasta2 pasta3</replaceable> <command >kdiff3</command > <replaceable ->dir1 dir2 dir3</replaceable -> <option ->-o</option -> <replaceable ->destdir</replaceable +>pasta1 pasta2 pasta3</replaceable +> -o <replaceable +>destino</replaceable > </screen> <para @@ -2061,15 +2002,13 @@ > como pasta de destino para a junção. </para> <para ->Note that only the comparison starts automatically, not the merge. For this you first must select a menu entry or the key <keycap ->F7</keycap ->. (More details later.) </para> +>Repare que só a comparação é que começa automaticamente, não a junção. Para tal, terá de seleccionar primeiro um item do menu ou a tecla F7. (Mais detalhes posteriormente.) </para> </sect2> </sect1> <sect1 id="dirmergevisible" ><title ->Visible Information</title> +>Informação Visível da Junção de Pastas</title> <para >Ao ler as pastas, aparece uma mensagem que o informa do progresso. Se você interromper a pesquisa das pastas, então só os ficheiros que tenham sido comparados até então serão listados. </para ><para @@ -2097,27 +2036,11 @@ <para >Cada ficheiro e pasta encontrado durante a pesquisa é aqui mostrado numa árvore. Você poderá seleccionar um item se carregar nele uma vez com o rato. </para ><para ->The directories are collapsed by default. You can expand and collapse them by clicking on the <guiicon ->+</guiicon ->/<guiicon ->-</guiicon -> or by double-clicking the item or by using the <keycap ->Left Arrow</keycap -> or <keycap ->Right Arrow</keycap -> keys. The <guimenu ->Directory</guimenu -> menu also contains two actions <guimenuitem ->Fold all subdirs</guimenuitem -> and <guimenuitem ->Unfold all subdirs</guimenuitem -> with which you can collapse or expand all directories at once. </para +>As pastas estão fechadas por omissão. Você poderá expandi-las e fechá-las se carregar no "+"/"-" ou se fizer duplo-click no item ou ainda usando as teclas de cursores esquerda/direita. O menu "Directoria" também contém duas acções "Fechar Todas as Sub-Directorias" e "Expandir Todas as Sub-Directorias", com as quais poderá fechar ou abrir todas as subpastas de uma vez. </para ><para >Se fizer duplo-click num item de um ficheiro, então a comparação do ficheiro irá começar e irá aparecer a janela de diferenças do ficheiro. </para> <para ->The image in the name column reflects the file type in the first directory (<quote ->A</quote ->). It can be one of these: </para> +>A imagem na coluna do nome reflecte o tio de ficheiro na primeira pasta ("A"). Poderá ser um dos seguintes: </para> <itemizedlist> <listitem ><para @@ -2177,15 +2100,11 @@ ><title >A Coluna de Operação</title> <para ->After comparing the directories &kdiff3; also evaluates a proposal for a merge operation. This is shown in the <guilabel ->Operation</guilabel -> column. You can modify the operation by clicking on the operation you want to change. A small menu will popup and allows you to select an operation for that item. (You can also select the most needed operations via keyboard. Ctrl+1/2/3/4/Del will select A/B/C/Merge/Delete respectively if available.) This operation will be executed during the merge. It depends on the item and on the merge-mode you are in, what operations are available. The merge-mode is one of </para> +>Depois de comparar as patas, o &kdiff3; avalia também uma proposta para uma operação de junção. Esta é mostrada na coluna de "Operação". O utilizador poderá modificar a operação se carregar na operação que deseja alterar. Irá aparecer um pequeno menu que lhe permite seleccionar uma operação para esse item (Poderá também seleccionar as operações mais necessárias através do teclado. O Ctrl+1/2/3/4/Del irá seleccionar o A/B/C/Juntar/Remover, respectivamente, se estiver disponível.) Esta operação será executada durante a junção. Depende do item e do modo de junção em que se encontra e de que operações estão disponíveis. O modo de junção é um dos seguintes </para> <itemizedlist> <listitem ><para ->Three directory-merge (<quote ->A</quote -> is treated as older base of both).</para +>Junção de três pastas (a "A" é tratada como a base mais antiga de ambas).</para ></listitem> <listitem ><para @@ -2193,9 +2112,7 @@ ></listitem> <listitem ><para ->Two directory-sync-mode (activate via option <guimenuitem ->Synchronize Directories</guimenuitem ->).</para +>Modo de sincronização de duas pastas (activado com a opção "Sincronizar as Directorias").</para ></listitem> </itemizedlist> <para @@ -2203,41 +2120,39 @@ <itemizedlist> <listitem ><para ->all three directories are equal: Copy from C</para +>... todas as três pastas forem iguais: Copiar do C</para ></listitem> <listitem ><para ->A and C are equal but B is not: Copy from B (or if B does not exist, delete the destination if exists)</para +>... o A e o C são iguais mas o B não: Copiar a partir do B (ou se o B não existir, remover o destino se existir)</para ></listitem> <listitem ><para ->A and B are equal but C is not: Copy from C (or if C does not exist, delete the destination if exists)</para +>... o A e o B são iguais mas o C não: Copiar a partir do C (ou se o C não existir, remover o destino se existir)</para ></listitem> <listitem ><para ->B and C are equal but A is not: Copy from C (or if C does not exist, delete the destination if exists)</para +>... o B e o C são iguais mas o A não: Copiar a partir do C (ou se o C não existir, remover o destino se existir)</para ></listitem> <listitem ><para ->only A exists: Delete the destination (if exists)</para +>... só o A existir: Remover o destino (se existir)</para ></listitem> <listitem ><para ->only B exists: Copy from B</para +>... só o B existir: Copiar a partir do B</para ></listitem> <listitem ><para ->only C exists: Copy from C</para +>... só o C existir: Copiar a partir do C</para ></listitem> <listitem ><para ->A, B and C are not equal: Merge</para +>... o A, o B e o C não são iguais: Juntar</para ></listitem> <listitem ><para ->A, B and C don't have the same file type (⪚ A is a directory, B is a file): <errorname ->Error: Conflicting File Types</errorname ->. While such items exist the directory merge cannot start.</para +>... o A, o B e o C não tiverem o mesmo tipo de ficheiro (⪚ o A é uma pasta e o B um ficheiro): "Erro: Tipo de Ficheiros em Conflito". Enquanto existirem itens nesta situação, a junção de pastas não poderá começar.</para ></listitem> </itemizedlist> <para @@ -2245,79 +2160,104 @@ <itemizedlist> <listitem ><para ->both directories are equal: Copy from B</para +>... ambas as pastas forem iguais: Copiar do B</para ></listitem> <listitem ><para ->A exists, but not B: Copy from A</para +>... o A existir, mas o B não: Copiar a partir do A</para ></listitem> <listitem ><para ->B exists, but not A: Copy from B</para +>... o B existir, mas o A não: Copiar a partir do B</para ></listitem> <listitem ><para ->A and B exist but are not equal: Merge</para +>... o A e o B existirem mas não forem iguais: Juntar</para ></listitem> <listitem ><para ->A and B don't have the same file type (⪚ A is a directory, B is a file): <errorname ->Error: Conflicting File Types</errorname ->. While such items exist the directory merge cannot start.</para +>... o A e o B não tiverem o mesmo tipo de ficheiro (p.ex., o A é uma pasta e o B um ficheiro): "Erro: Tipo de Ficheiros em Conflito". Enquanto existirem itens nesta situação, a junção de pastas não poderá começar.</para ></listitem> </itemizedlist> <para ->Sync-mode is active if only two directories and no explicit destination were specified and if the option <guilabel ->Synchronize directories</guilabel -> is active. &kdiff3; then selects a default operation so that both directories are the same afterwards. If for an item </para> +>O modo de sincronização só está activo se forem indicadas duas pastas e não se não for indicado nenhum destino explícito, assim como a opção "Sincronizar as directorias" terá de estar activa. Nesse caso, o &kdiff3; irá seleccionar uma operação por omissão, de modo a que ambas as pastas fiquem iguais no fim. Se, para um item ... </para> <itemizedlist> <listitem ><para ->both directories are equal: Nothing will be done.</para +>... ambas as pastas forem iguais: Não será feito nada.</para ></listitem> <listitem ><para ->A exists, but not B: Copy A to B</para +>... o A existir mas o B não: Copiar o A para o B</para ></listitem> <listitem ><para ->B exists, but not A: Copy B to A</para +>... o B existir mas o A não: Copiar o B para o A</para ></listitem> <listitem ><para ->A and B exist, but are not equal: Merge and store the result in both directories. (For the user the visible save-filename is B, but then &kdiff3; copies B also to A.)</para +>... o A e o B existirem, mas não forem iguais: Juntar e guardar o resultado em ambas as pastas. (Para o utilizador, o nome do ficheiro gravado visível será o B, mas o &kdiff3; irá copiar o B também para o A.)</para ></listitem> <listitem ><para ->A and B don't have the same file type (⪚ A is a directory, B is a file): <errorname ->Error: Conflicting File Types</errorname ->. While such items exist the directory merge cannot start.</para +>... o A e o B não tiverem o mesmo tipo de ficheiro (p.ex., o A é uma pasta e o B um ficheiro): "Erro: Tipo de Ficheiros em Conflito". Enquanto existirem itens nesta situação, a junção de pastas não poderá começar.</para ></listitem> </itemizedlist> <para ->When two directories are merged and the option <guilabel ->Copy newer instead of merging</guilabel -> is selected, then &kdiff3; looks at the dates and proposes to choose the newer file. If the files are not equal but have equal dates, then the operation will contain <errorname ->Error: Dates are equal but files are not.</errorname -> While such items exist the directory merge cannot start. </para> +>Quando duas pastas forem reunidas e a opção "Copiar o mais recente em vez de juntar" estiver seleccionada, então o &kdiff3; irá olhar para as datas e irá optar por escolher o ficheiro mais recente. Se os ficheiros não forem iguais mas tiverem datas iguais, então a operação irá conter "Erro: As datas são iguais mas os ficheiros não.". Enquanto esses itens existirem a junção de pastas não poderá começar. </para> </sect2> <sect2 id="status" ><title >A Coluna de Estado</title> <para ->During the merge one file after the other will be processed. The status column will show <computeroutput ->Done</computeroutput -> for items where the merge operation has succeeded, and other texts if something unexpected happened. When a merge is complete, then you should make a last check to see if the status for all items is agreeable. </para> +>Durante a junção, os ficheiros serão processados um a seguir ao outro. A coluna de estado irá mostrar "Terminado" para os itens em que a operação de junção foi bem sucedida e outros textos se algo ocorreu de inesperado. Quando se terminar uma junção, o utilizador deverá então fazer uma última verificação para confirmar se o estado de todos os itens é aceitável. </para> </sect2> <sect2 id="statisticscolulmns" ><title >Colunas de Estatísticas</title> <para ->When the file comparison mode <guilabel ->Full Analysis</guilabel -> is enabled in the options, then &kdiff3; will show extra columns containing the numbers of unsolved, solved, nonwhite and whitespace conflicts. (The solved-column will only show when comparing or merging three directories.) </para> +>Quando o modo de comparação de ficheiros "Análise Completa" estiver activo nas opções, então o &kdiff3; irá mostrar colunas extra que contêm o número de conflitos não resolvidos, resolvidos, de espaços em branco e dos outros conflitos. (A coluna de resolvidos só irá aparecer ao comparar ou ao juntar três pastas.) </para> +</sect2> + +<sect2 id="selectingvisiblefiles" +><title +>Seleccionar os Ficheiros Listados</title> +<para +>Diversas opções influenciam os ficheiros que são listados aqui. Algumas estão acessíveis na <link linkend="dirmergeoptions" +>janela de configuração</link +>. O menu Directoria contém os itens: </para +><para +><itemizedlist> + <listitem +><para +>"Mostrar os Ficheiros Idênticos": Os ficheiros que foram detectados como iguais em todas as pastas de entrada.</para +></listitem> + <listitem +><para +>"Mostrar os Ficheiros Diferentes": Os ficheiros que existem em duas ou mais pastas, mas que não são iguais entre si.</para +></listitem> + <listitem +><para +>"Mostrar os Ficheiros Apenas em A": Os ficheiros que existem apenas em A, mas não em B ou C.</para +></listitem> + <listitem +><para +>"Mostrar os Ficheiros Apenas em B": Os ficheiros que existem apenas em B, mas não em A ou C.</para +></listitem> + <listitem +><para +>"Mostrar os Ficheiros Apenas em C": Os ficheiros que existem apenas em C, mas não em A ou B.</para +></listitem> +</itemizedlist +></para> +<para +>Active apenas as opções "Mostrar" para os itens que deseja listar. Se, por exemplo, quiser listar apenas os itens que existem ou em A ou em B, mas não em ambos, terá de activar o "Mostrar os Ficheiros Apenas em A" e "Mostrar os Ficheiros Apenas em B" e desactivar todos os outros ("Mostrar os Ficheiros Idênticos", "Mostrar os Ficheiros Diferentes", "Mostrar os Ficheiros Apenas em C"). A lista será actualizada imediatamente para reflectir as alterações. </para +><para +>Estas opções também se aplicam nas pastas, com uma excepção: Se desactivar o "Mostrar os Ficheiros Diferentes" não irá esconder as pastas por completo. Isto só irá funcionar para os ficheiros dentro delas. </para +><para +>Lembre-se que, destas opções, só a "Mostrar os Ficheiros Idênticos" é persistente. As outras ficam activas ao iniciar o &kdiff3;. </para> </sect2> </sect1> @@ -2325,93 +2265,53 @@ <sect1 id="dothemerge" ><title ->Doing A Merge</title> +>Fazer uma Junção de Pastas</title> <para >O utilizador tanto poderá reunir o item seleccionado de momento (ficheiro ou pasta) ou todos os itens. Quando tiver feito todas as suas opções de operação (em todas as subpastas também), aí então poderá iniciar a junção. </para ><para ->Be aware that if you didn't specify a destination directory explicitely, then the destination will be <quote ->C</quote -> in three directory mode, <quote ->B</quote -> in two directory merge mode, and in sync-mode it will be <quote ->A</quote -> and/or <quote ->B</quote ->. </para +>Tenha em atenção que, se não tiver indicado explicitamente uma pasta de destino, então o destino será o "C" no modo de três pastas, o "B" no modo de junção de duas pastas e no modo de sincronização será o "A" e/ou o "B". </para ><para >Se tiver indicado uma pasta de destino, verifique também que todos os itens que deverão estar no resultado, estão na árvore respectiva. Existem algumas opções que fazem com que certos itens sejam omitidos na comparação e junção de pastas. Assinale estas opções para evitar surpresas desagradáveis: </para> <itemizedlist> <listitem ><para -><guilabel ->Recursive Directories</guilabel ->: If this is off, then items in subdirectories will not be found.</para +>"Directorias Recursivas": Se estiver desligada, então os itens em todas as subpastas não serão tratados.</para ></listitem> <listitem ><para -><guilabel ->Pattern</guilabel ->/<guilabel ->Anti-Pattern</guilabel ->: Include/exclude items that match</para +>"Padrão"/"Anti-Padrão": Inclui/exclui os itens que correspondam ao padrão</para ></listitem> <listitem ><para -><guilabel ->Exclude Hidden Files</guilabel -></para +>"Excluir os Ficheiros Escondidos"</para ></listitem> <listitem ><para -><guilabel ->List only Deltas</guilabel ->: Files that match in all directories don't appear in the tree, and hence also not in the destination.</para +>As <link linkend="selectingvisiblefiles" +>opções "Mostrar"</link +> (Mostrar os Ficheiros Iguais/Diferentes, Ficheiros apenas em A/B/C)</para ></listitem> </itemizedlist> <para ->(In the current version, you must do a rescan via menu <menuchoice -><guimenu ->Directory</guimenu -><guimenuitem ->Rescan</guimenuitem -></menuchoice -> yourself, after changing options affecting the directory scan.) </para +>Se mudar a configuração, para mostrar mais ficheiros, é preciso fazer uma nova pesquisa, com a opção "Directoria"->"Pesquisar de Novo". (A razão para tal é que o &kdiff3; omite a comparação dos ficheiros suprimidos por estes critérios.) Se mudou os seus padrões de ficheiros e pastas para excluir os ficheiros, então a lista de ficheiros será imediatamente actualizada, ao fechar a janela de opções. </para +><para +>Lembre-se que, quando gravar numa pasta completamente nova, normalmente também irá querer copiar os ficheiros iguais. Nesse caso, active a opção "Mostrar os Ficheiros Iguais". Se a sua pasta de destino é uma das entradas, então não será necessário, porque o ficheiro já estará lá. </para ><para >Se estiver satisfeito até agora, o resto é simples. </para ><para ->To merge all items: Select <guimenuitem ->Start/Continue directory merge</guimenuitem -> in the <guimenu ->Directory</guimenu -> menu or press <keycap ->F7</keycap -> (which is the shortcut). To merge only the current item: Select <guimenuitem ->Run Operation For Current Item</guimenuitem -> or press <keycap ->F6</keycap ->. </para +>Para juntar todos os itens: Seleccione "Iniciar/Continuar a junção da directoria" no menu "Directoria" ou carregue em F7 (que é o atalho). Para juntar apenas o item actual: Seleccione "Executar a Operação no Item Actual" ou carregue em F6. </para ><para >Se, devido à existência de tipos de ficheiro em conflito, ainda permanecerem alguns itens com operações inválidas, então irá aparecer uma mensagem onde serão evidenciados esses itens, para que possa seleccionar uma operação válida para cada item. </para ><para ->If you merge all items a dialog will appear giving you the options <guibutton ->Do it</guibutton ->, <guibutton ->Simulate it</guibutton -> and <guibutton ->Cancel</guibutton ->. </para> +>Se juntar todos os itens, irá aparecer uma janela que lhe apresenta as opções "Fazê-lo", "Simulá-lo" e "Cancelar". </para> <itemizedlist> <listitem ><para ->Select <guibutton ->Simulate it</guibutton -> if you want to see what would be done without actually doing it. A verbose list of all operations will be shown.</para +>Seleccione "Simulá-lo" se quiser ver o que seria feito sobre o item sem aplicar de facto as modificações. Será apresentada uma lista descritiva com todas as operações.</para ></listitem> <listitem ><para ->Otherwise select <guibutton ->Do it</guibutton -> to really start merging.</para +>Caso contrário, seleccione "Fazê-lo" para iniciar de facto a junção.</para ></listitem> </itemizedlist> <para @@ -2419,40 +2319,26 @@ >ver a imagem grande</link >). </para ><para ->When you have finished with a file, again select <guimenuitem ->Start/Continue directory merge</guimenuitem -> or the key <keycap ->F7</keycap ->. If you haven't saved yet, a dialog will ask you to do so. Then &kdiff3; will continue with the next item. </para +>Quando tiver terminado um ficheiro, seleccione de novo "Iniciar/Continuar a junção da directoria" ou a tecla F7. Se não tiver ainda gravado nada, irá aparecer uma janela a pedir-lhe isso. Aí, o &kdiff3; irá passar ao próximo item. </para ><para ->When &kdiff3; encounters an error, it will tell you so and will show the verbose-status-information. At the bottom of this list, there will be some error messages which should help you to understand the cause of the problem. When you continue merging (<keycap ->F7</keycap -> key) &kdiff3; will give you the choice to retry or skip the item that caused the problem. This means that before continuing you can choose another operation or solve the problem by other means. </para +>Quando o &kdiff3; encontrar um erro, indicar-lhe-á tal facto e irá mostrar a informação descritiva do estado. No fundo desta lista, existirão algumas mensagens de erro que o deverão ajudar a compreender a causa do problema. Quando continuar a junção (com a tecla F7), o &kdiff3; indicar-lhe-á a opção para repetir ou saltar o item que causou o problema. Isto significa que, antes de continuar, poderá escolher outra operação ou resolver o problema por outros meios. </para ><para >Quando a junção estiver completa, o &kdiff3; informá-lo-á então com uma mensagem. </para ><para ->If some items were merged individually then &kdiff3; remembers this (while this merge-session goes on), and doesn't merge them again when later the merge for all items is run. Even when the merge was skipped or nothing was saved these items count as completed. Only when you change the merge operation the item will be merged again. </para> +>Se alguns dos itens foram reunidos individualmente, então o &kdiff3; irá recordar isto (enquanto esta sessão de junção prosseguir) e não os juntará de novo, até que a junção para todos os itens tenha sido executada. Mesmo quando a junção tenha sido ignorada ou não tenha sido gravado nada, estes itens irão contar como completos. Só quando tiver alterado a operação de junção é que o estado de "Pronto" do item será removido e este poderá ser reunido de novo. </para> </sect1> <sect1 id="dirmergeoptions" ><title >Opções para Comparar e Juntar Pastas</title> <para ->The &kdiff3; preferences (menu <menuchoice -><guimenu ->Settings</guimenu -><guimenuitem ->Configure KDiff3</guimenuitem -></menuchoice ->) now has a section called <guilabel ->Directory Merge</guilabel -> with these options: </para> +>As preferências do &kdiff3; (no menu "Configuração"->"Configurar o &kdiff3;") têm agora uma secção intitulada "Junção de Directorias" com as seguintes opções: </para> <variablelist> <varlistentry ><term -><guilabel ->Directorias Recursivas:</guilabel +><emphasis +>Directorias Recursivas:</emphasis ></term ><listitem ><para @@ -2461,78 +2347,60 @@ ></varlistentry> <varlistentry ><term -><guilabel ->Padrões de Ficheiros:</guilabel +><emphasis +>Padrões de Ficheiros:</emphasis ></term ><listitem ><para ->Only files that match any pattern here will be put in the tree. More than one pattern may be specified here via using the semicolon <literal ->;</literal -> as separator. Valid wildcards: <literal ->*</literal -> and <literal ->?</literal ->. (⪚ <literal ->*.cpp;*.h</literal ->). Default is <literal ->*</literal ->. Directories need not match this pattern.</para +>Só os ficheiros que correspondam ao padrão ou padrões aqui indicados é que serão colocados na árvore. Poderá ser indicado mais do que um padrão através do separador ponto-e-vírgula ";". São considerados caracteres especiais válidos o "*" e o "?". (⪚ "*.cpp;*.h"). Por omissão, este campo é igual a "*". As pastas não precisam de corresponder a este padrão.</para ></listitem ></varlistentry> <varlistentry ><term -><guilabel ->Anti-Pattern(s):</guilabel +><emphasis +>Anti-Padrões de Ficheiros:</emphasis ></term ><listitem ><para ->Files and directories that match this pattern will be excluded from the tree. More than one pattern may be specified here via using the semicolon <literal ->;</literal -> as separator. Valid wildcards: <literal ->*</literal -> and <literal ->?</literal ->. Default is <literal ->*.orig;*.o</literal ->.</para +>Os ficheiros que correspondam ao padrão ou padrões aqui indicados serão excluídos da árvore. Poderá ser indicado mais do que um padrão através do separador ponto-e-vírgula ";". São considerados caracteres especiais válidos o "*" e o "?". Por omissão, este campo é igual a "*.orig;*.o;*.obj".</para ></listitem ></varlistentry> <varlistentry ><term -><guilabel ->Usar CVS-Ignore:</guilabel +><emphasis +>Anti-Padrões da Directoria:</emphasis ></term ><listitem ><para ->Ignore files and directories that would also be ignored by <acronym ->CVS</acronym ->. Many automatically generated files are ignored by <acronym ->CVS</acronym ->. The big advantage is that this can be directory specific via a local <filename ->.cvsignore</filename -> file. (See <ulink url="info:/cvs/cvsignore" +>As pastas que correspondam ao padrão ou padrões aqui indicados serão excluídas da árvore. Poderá ser indicado mais do que um padrão através do separador ponto-e-vírgula ";". São considerados caracteres especiais válidos o "*" e o "?". Por omissão, este campo é igual a "CVS;deps;.svn".</para +></listitem +></varlistentry> + <varlistentry +><term +><emphasis +>Usar CVS-Ignore:</emphasis +></term +><listitem +><para +>Ignora os ficheiros e pastas que são também ignorados pelo CVS. Muitos dos ficheiros gerados automaticamente são ignorados pelo CVS. A grande vantagem é que esta funcionalidade é específica para cada pasta através de um ficheiro ".cvsignore" local. (Veja em <ulink url="info:/cvs/cvsignore" >info:/cvs/cvsignore</ulink >.)</para ></listitem ></varlistentry> <varlistentry ><term -><guilabel ->Procurar os Ficheiros e Directorias Escondidos:</guilabel +><emphasis +>Procurar os Ficheiros e Directorias Escondidos:</emphasis ></term ><listitem ><para ->On some filesystems files have an <quote ->Hidden</quote -> attribute. On other systems a filename starting with a dot (<literal ->.</literal ->) causes it to be hidden. This option allows you to decide whether to include these files in the tree or not. Default is on.</para +>Em alguns sistemas de ficheiros, existe um atributo "Escondido". Em outros sistemas, um nome de ficheiro que comece por "." faz com que este seja considerados escondido. Esta opção permite-lhe decidir se deve incluir estes ficheiros na árvore ou não. Por omissão, são incluídos.</para ></listitem ></varlistentry> <varlistentry ><term -><guilabel ->Seguir as Ligações de Ficheiros:</guilabel +><emphasis +>Seguir as Ligações de Ficheiros:</emphasis ></term ><listitem ><para @@ -2541,32 +2409,28 @@ ></varlistentry> <varlistentry ><term -><guilabel ->Seguir as Ligações de Directorias:</guilabel +><emphasis +>Seguir as Ligações de Directorias:</emphasis ></term ><listitem ><para ->For links to directories: When disabled, then the symbolic links will be compared. When enabled then the link will be treated like a directory and it will be scanned recursively. (Note that the program doesn't check if the link is <quote ->recursive</quote ->. So for example a directory that contains a link to the directory would cause an infinite loop, and after some time when the stack overflows or all memory is used up, crash the program.) Default is off.</para +>Para as ligações a pastas: Quando a opção estiver desactivada, as ligações simbólicas serão comparadas. Se estiver activa, então a ligação será tratada como uma pasta e será pesquisada recursivamente. (Lembre-se que o programa não verifica se a ligação é "recursiva". Por isso, se uma pasta contiver por exemplo uma ligação para ela própria irá causar um ciclo infinito, pelo que ao fim de algum tempo a pilha estoira ou toda a memória será usada e o programa irá estoirar deste modo). Por omissão, a opção está desligada.</para ></listitem -></varlistentry -> +></varlistentry> <varlistentry ><term -><guilabel ->List only deltas:</guilabel +><emphasis +>Comparação de Nomes de Ficheiros com Distinção de Maiúsculas:</emphasis ></term ><listitem ><para ->Only items that are not equal in all input directories will be listed and only the changed files are visible. Hence files that are equal in all directories won't be copied during a merge and if the destination dir does not contain the files before the merge, you might miss some files later. (This option is likely to be changed in a later version.) Default is off.</para +>Por omissão, é falso no Windows e verdadeiro nos outros sistemas operativos.</para ></listitem ></varlistentry> - <varlistentry ><term -><guilabel ->Modo de Comparação de Ficheiros:</guilabel +><emphasis +>Modo de Comparação de Ficheiros:</emphasis ></term ><listitem ><para> @@ -2574,8 +2438,8 @@ > <varlistentry ><term -><guilabel ->Comparação Binária:</guilabel +><emphasis +>Comparação Binária:</emphasis ></term ><listitem ><para @@ -2585,8 +2449,8 @@ > <varlistentry ><term -><guilabel ->Análise Completa:</guilabel +><emphasis +>Análise Completa:</emphasis ></term ><listitem ><para @@ -2596,8 +2460,8 @@ > <varlistentry ><term -><guilabel ->Confiar na data de modificação:</guilabel +><emphasis +>Confiar na data de modificação:</emphasis ></term ><listitem ><para @@ -2606,8 +2470,8 @@ ></varlistentry> <varlistentry ><term -><guilabel ->Confiar no tamanho:</guilabel +><emphasis +>Confiar no tamanho:</emphasis ></term ><listitem ><para @@ -2621,8 +2485,8 @@ <varlistentry ><term -><guilabel ->Sincronizar as Directorias:</guilabel +><emphasis +>Sincronizar as Directorias:</emphasis ></term ><listitem ><para @@ -2631,26 +2495,22 @@ ></varlistentry> <varlistentry ><term -><guilabel ->Copiar o mais recente em vez de juntar:</guilabel +><emphasis +>Copiar o mais recente em vez de juntar:</emphasis ></term ><listitem ><para ->Instead of merging the proposed operation will copy the newer source if changes happened. (Considered unsafe, because it implies that the knowledge, that the other file hasn't been edited too. Check to make sure in every case.) Default is off.</para +>Em vez de juntar, a operação proposta irá copiar os ficheiros mais recentes se ocorreram algumas alterações. (É considerado inseguro, porque implica saber se o outro ficheiro não foi também alterado. Verifique para se certificar em qualquer um dos casos.). Por omissão, a opção está desligada.</para ></listitem ></varlistentry> <varlistentry ><term -><guilabel ->Ficheiros de segurança:</guilabel +><emphasis +>Ficheiros de segurança:</emphasis ></term ><listitem ><para ->If a file or complete directory is replaced by another or is deleted then the original version will be renamed with an <literal role="extension" ->.orig</literal -> extension. If an old backup file with <literal role="extension" ->.orig</literal -> extension already exists then this will be deleted without backup. This also affects the normal merging of single files, not only in directory-merge mode. Default is on.</para +>Se um ficheiro ou uma pasta completa for substituído por outro ou for removido, então a versão original mudará para um nome com uma extensão ".orig". Se já existir um ficheiro antigo com uma extensão ".orig", então este será removido sem ser criada nenhuma cópia de segurança. Isto também afecta a junção normal de ficheiros simples, não só no modo de junção de pastas. Por omissão, a opção está activa.</para ></listitem ></varlistentry> </variablelist> @@ -2658,41 +2518,33 @@ <sect1 id="other" ><title ->Other Functions</title> +>Outras Funções na Janela de Junção de Pastas</title> <sect2 ><title >Modo de Ecrã Repartido/Completo</title> <para ->Usually the directory merge list view remains visible while a single file is compared or merged. With the mouse you can move the the splitter bar that separates the file list from the text-diff windows. If you don't want this, you can disable <guimenuitem ->Split Screen View</guimenuitem -> in the <guimenu ->Directory</guimenu -> menu. Then you can use <guimenuitem ->Toggle View</guimenuitem -> in the <guimenu ->Directory</guimenu -> menu to switch between the file list and the text-diff view that then occupy the full screen. </para> +>Normalmente a lista de junção da pasta fica visível enquanto um único ficheiro é comparado ou reunido. Com o rato, o utilizador poderá mover a barra separadora que delimita a lista de ficheiros das janelas de diferenças do texto. Se não a quiser, poderá desactivar a "Janela Repartida" no menu "Directoria". Aí, poderá usar a opção "Comutar a Vista" no menu "Directoria" para alternar entre a lista de ficheiros e a janela de diferenças no texto que irá então ocupar o ecrã completo. </para> </sect2> <sect2 ><title >Comparar ou Juntar um Único Ficheiro</title> <para ->Probably you will prefer a simple double mouse click on a file in order to compare it. Nevertheless there also exists an entry in the <guimenu ->Directory</guimenu -> menu. You can also directly merge a single file, without starting the directory merge via the <guimenuitem ->Merge single file</guimenuitem -> in the <guimenu ->Directory</guimenu -> Menu. On saving the result, the status will be set to done, and the file will not be merged again if a directory merge is started. </para +>Provavelmente, você irá preferir um duplo-click do rato simples sobre um ficheiro para o poder comparar. Contudo, existe também um item no menu "Directoria". Poderá também juntar directamente um único ficheiro sem iniciar a junção de pastas, através da opção "Juntar o ficheiro actual" do menu "Juntar". Ao gravar o resultado, o estado ficará como terminado e o ficheiro não será reunido de novo se for iniciada uma junção de pastas. </para ><para ->But note that this status information will be lost when you rerun a directory scan: <menuchoice -><guimenu ->Directory</guimenu -><guimenuitem ->Rescan</guimenuitem -></menuchoice -> </para> +>Mas repare que esta informação de estado será perdida quando voltar a executar uma pesquisa de pastas: menu "Directoria"->"Pesquisar de novo" </para> </sect2> +<sect2 +><title +>Comparar ou Juntar Ficheiros com Nomes Diferentes</title> +<para +>Em alguns casos, terá de comparar ou juntar ficheiros com nomes diferentes (p.ex., o ficheiro actual e a cópia de segurança na mesma pasta). </para +><para +>Seleccione o ficheiro exacto, carregando no ícone na coluna A, B ou C. O primeiro ficheiro seleccionado será então marcado com um "A", enquanto o segundo e o terceiro ficará com um "B" e um "C", independentemente da coluna em que se encontram. Só poderá escolher até três ficheiros desta forma. </para +><para +>Siga com a escolha de "Comparar os Ficheiros Explicitamente Seleccionados" ou "Juntar os Ficheiros Explicitamente Seleccionados" no menu "Pasta". Por conveniência, estes itens de menu também aparecem como um menu de contexto, quando carregar com o botão direito no último ficheiro seleccionado. </para +><para +>A comparação ou junção de um ficheiro irá acontecer na mesma janela. Se este método for usado para as pastas, será aberta uma nova janela. </para +></sect2> </sect1> </chapter> @@ -2701,12 +2553,12 @@ >Tópicos Diversos</title> <sect1 id="networktransparency"> <title ->Network Transparency via KIO</title> +>Transparência na rede através do KIO</title> <sect2 ><title >KIO-Slaves</title> <para ->&kde; supports networktransparency via KIO-slaves. &kdiff3; uses this for reading input files and for scanning directories. This means that you can specify files and directories on local and remote resources via &URL;s. </para +>O KDE suporta a transparência na rede através dos 'KIO-slaves'. O &kdiff3; usa isto para ler os ficheiros de entrada e para pesquisar as pastas. Isto significa que você poderá indicar ficheiros e pastas em recursos locais e remotos através dos URLs. </para ><para >Exemplo: </para ><para> @@ -2720,7 +2572,7 @@ </screen> </para> <para ->The first line compares a local file with a file on an &FTP; server. The second line compares a directory within an compressed archive with a local directory. </para +>A primeira linha compara um ficheiro local com outro ficheiro num servidor de FTP. A segunda linha compara uma pasta dentro de um pacote comprimido com uma pasta local. </para ><para >Outros 'KIO-slaves' que serão interessantes: </para> <itemizedlist> @@ -2738,7 +2590,7 @@ ></listitem> <listitem ><para ->Windows-resources (smb:),</para +>Recursos do Windows (smb:),</para ></listitem> <listitem ><para @@ -2761,37 +2613,21 @@ <sect2 ><title ->How To Write &URL;s</title> +>Como Escrever URLs</title> <para ->A &URL; has a different syntax compared with paths for local files and directories. Some things should be considered: </para> +>Um dado URL tem uma sintaxe diferente, em comparação com as localizações dos ficheiros e pastas locais. Alguns factores terão de ser tidos em consideração: </para> <itemizedlist> <listitem ><para ->A path can be relative and can contain <literal ->.</literal -> or <literal ->..</literal ->. This is not possible for &URL;s which are always absolute. </para +>Uma localização poderá ser relativa e conter "." ou "..". Isto não é possível para os URLs, dado que estes são sempre absolutos. </para ></listitem ><listitem ><para ->Special characters must be written with <quote ->escaping</quote ->. (<quote ->#</quote -> becomes <quote ->%23</quote ->, spaces become <quote ->%20</quote -> and so on.) ⪚ A file with the name <quote ->/#foo#</quote -> would have the &URL; <literal ->file:///%23foo%23</literal ->. </para +>Os caracteres especiais têm de ser escritos "escapados". ("#"->"%23", espaço->"%20", etc.) ⪚ Um ficheiro com o nome "/#xpto#" iria ter o URL "file:/%23xpto%23". </para ></listitem ><listitem ><para ->When &URL;s don't work as expected, try to open them in &konqueror; first. </para +>Quando os URLs não funcionarem como seria de esperar, tente abri-los primeiro no Konqueror. </para ></listitem> </itemizedlist> @@ -2801,9 +2637,9 @@ ><title >Capacidades dos 'KIO-Slaves'</title> <para ->Network transparency has one drawback: Not all ressources have the same capabilities. </para +>A transparência na rede tem um senão: nem todos os recursos têm as mesmas capacidades. </para ><para ->Sometimes this is due to the filesystem of the server, sometimes due to the protocol. Here is a short list of restrictions: </para> +>Algumas das vezes estas são devidas ao sistema de ficheiros do servidor, enquanto que noutras ocasiões poderá ser devido ao protocolo. Aqui está uma pequena lista das restrições: </para> <itemizedlist> <listitem ><para @@ -2833,31 +2669,17 @@ <title >Usar o &kdiff3; como uma KPart</title> <para ->&kdiff3; is a KPart. Currently it implements the <interface ->KParts::ReadOnlyPart</interface -> interface. </para +>O &kdiff3; é uma KPart. De momento, implementa a interface "KParts::ReadOnlyPart". </para ><para ->It's main use is as difference-viewer in <application ->KDevelop</application ->. <application ->Kdevelop</application -> always starts the internal difference viewer first. To invoke &kdiff3; press the &RMB; on the difference viewer window and select <guimenuitem ->Show in KDiff3Part</guimenuitem -> from the contextmenu. </para +>A sua utilização principal é como visualizador de diferenças no KDevelop. O KDevelop inicia sempre o visualizador de diferenças interno em primeiro lugar. Para invocar o &kdiff3;, carregue com o botão direito do rato na janela do visualizador de diferenças e seleccionar "Mostrar no KDiff3Part" no menu de contexto. </para ><para >O &kdiff3; necessita normalmente de dois ficheiros completos como entrada. Se for usado como componente KPart, o &kdiff3; irá assumir que o ficheiro de entrada é um ficheiro de 'patch' no formato unificado. O &kdiff3; irá então obter os nomes dos ficheiros originais do ficheiro de 'patch'. Pelo menos um dos dois ficheiros terá de estar disponível. O &kdiff3; irá então invocar o <command >patch</command > para criar de novo o segundo ficheiro. </para ><para ->In &konqueror; you can select a patch file and select <menuchoice -><guisubmenu ->Preview in</guisubmenu -><guimenuitem ->KDiff3Part</guimenuitem -></menuchoice -> from the contextmenu. Be aware that this won't work if none of the original files are available, and it is not reliable if the original file(s) have changed since the patch-file was generated. </para +>No Konqueror;, o utilizador poderá seleccionar um ficheiro de 'patch' e seleccionar "Antevisão em"-"KDiff3Part" no menu de contexto. Tenha em atenção que isto não irá funcionar se nenhum dos ficheiros originais estiver disponível e não é fiável se os ficheiros originais tiverem sido alterados desde que o ficheiro de 'patch' foi gerado. </para ><para ->When run as a part &kdiff3; only provides the a two file diff, a very small toolbar and menu. Merging or directory comparison are not supported. </para> +>Quando é executado como um componente, o &kdiff3; só oferece uma diferença de dois ficheiros, uma barra de ferramentas muito pequena e um menu. A junção ou a comparação de pastas não é suportada nesse caso. </para> </sect1> </chapter> @@ -2869,34 +2691,22 @@ <qandaentry ><question ><para ->Why is it called &kdiff3;? </para +>Porque é que se chama "&kdiff3;"? </para ></question ><answer ><para ->Tools named <application ->KDiff</application -> and <application ->KDiff2</application -> (now called &kompare;) already exist. Also &kdiff3; should suggest that it can merge like the <command ->diff3</command -> tool in the Diff-Tool collection. </para +>As ferramentas "KDiff" e "KDiff2" (agora chamada Kompare;) já existiam. Para além disso, o &kdiff3; deveria sugerir que consegue juntar ficheiros como a ferramenta "diff3" da colecção de ferramentas do Diff. </para ></answer ></qandaentry> <qandaentry ><question ><para ->Why did I release it under <acronym ->GPL</acronym ->? </para +>Porque é que é lançado segundo a GPL? </para ></question ><answer ><para ->I'm using <acronym ->GPL</acronym -> programs for a very long time now and learned very much by having a look at many of the sources. Hence this is my <quote ->Thank You</quote -> to all programmers that also did so or will do the same. </para +>O autor usou programas GPL durante bastante tempo até agora e aprendeu bastante ao olhar para bastante código. Daí, este é o "Muito Obrigado" para todos os programadores que também o fizeram ou irão fazer no futuro. </para ></answer ></qandaentry> @@ -2907,15 +2717,7 @@ ></question ><answer ><para ->You compiled from source but you probably didn't specify the correct &kde; prefix with <command ->configure</command ->. By default configure wants to install in <filename class="directory" ->/usr/local</filename -> but then &kde; can't find the user interface ressource file (&ie; <filename ->kdiff3ui.rc</filename ->). The <filename ->README</filename -> file contains more information about the correct prefix. </para +>Você compilou a partir do código mas não indicou provavelmente o prefixo correcto do KDE com o "configure". Por omissão, o "configure" deseja instalar no "/usr/local", mas aí o KDE não consegue encontrar o ficheiro de recursos da interface do utilizador (isto é, o "kdiff3ui.rc"). O ficheiro README contém mais informações sobre o prefixo correcto. </para ></answer ></qandaentry> @@ -2926,11 +2728,9 @@ ></question ><answer ><para ->Lines where only the amount of white space characters is different are treated as <quote ->equal</quote ->at first, while just one different non-white character causes the lines to be <quote ->different</quote ->. If similar lines appear next to each other, this actually is coincidence but this fortunately is often the case. </para +>As linhas em que apenas a quantidade de espaços em branco é diferente são tratadas como "iguais" à primeira vista, embora apenas um carácter que não seja um espaço em branco faça com que as linhas sejam "diferentes". Se as linhas semelhantes aparecerem uma ao lado da outra, isto poderá ser de facto uma coincidência, mas é felizmente o caso mais frequente. Veja também em <link linkend="manualdiffhelp" +>Ajuda das Diferenças Manuais</link +>. </para ></answer ></qandaentry> @@ -2948,9 +2748,20 @@ <qandaentry ><question ><para ->Why does the editor in the merge result window not have an <quote ->undo</quote -> function? </para +>Como é que posso sincronizar as janelas de diferenças e junção, de modo que todas mostrem a mesma posição de texto? </para +></question +><answer +><para +>Carregue na coluna de resumo à esquerda do texto. (<link linkend="synchronise_views" +>Veja também aqui.</link +>) </para +></answer +></qandaentry> + +<qandaentry +><question +><para +>Porque é que o editor na janela do resultado da junção não tem uma função para "desfazer"? </para ></question ><answer ><para @@ -2961,15 +2772,11 @@ <qandaentry ><question ><para ->When I removed some text, then suddenly <quote -><No src line></quote -> appeared and can't be deleted. What does that mean and how can one remove this? </para +>Quando eu removi algum texto, apareceu de repente "<Sem linha de origem>" e esta não pode ser removida. O que é que significa e como é que se poderá removê-la? </para ></question ><answer ><para ->For each equal or different section the editor in the merge result window remembers where it begins or ends. <quote -><No src line></quote -> means that there is nothing left in a section, not even a new line character. This can happen either while merging automatically or by editing. This is no problem, since this hint won't appear in the saved file. If you want the orignal source back just select the section (click on the left summary column) and then click the source button with the needed contents (A/B or C). </para +>Para cada secção igual ou diferente, o editor na janela do resultado da junção recorda onde é que esta começa ou termina. O "<Sem linha de origem>" significa que não existe mais nada livre numa secção, nem mesmo um carácter de mudança de linha. Isto poderá acontecer durante a junção automática ou durante a edição. Isto não é nenhum problema, dado que esta dica não irá aparecer no ficheiro gravado. Se você quiser os dados originais de volta, basta seleccionar a secção (carregue na coluna de resumo à esquerda) e depois no botão da origem com o conteúdo necessário (A/B ou C). </para ></answer ></qandaentry> @@ -2987,6 +2794,51 @@ <qandaentry ><question ><para +>Posso usar o &kdiff3; para comparar ficheiros do OpenOffice.Org, Word, Excel, PDF, &etc;? </para +></question +><answer +><para +>Ainda que o &kdiff3; analise qualquer tipo de ficheiro, o resultado poderá não ser muito satisfatório para si. </para +><para +>O &kdiff3; foi feito para comparar ficheiros de texto puros. O OpenOffice, Word, Excel etc. gravam muito mais informação nos ficheiros (acerca dos tipos de letra, imagens, páginas, cores, etc.), que o &kdiff3; não conhece. Deste modo, o &kdiff3; mostrar-lhe-á o conteúdo do ficheiro interpretado como texto puro, mas este poderá estar ilegível ou, pelo menos, ficará muito esquisito. </para +><para +>Dado que a maioria dos programas, nos dias de hoje, gravam o seu conteúdo no formato XML, poderá ser capaz de os ler como texto puro. Por isso, se a alteração foi pequena, o &kdiff3; podê-lo-á ajudar à mesma. </para +><para +>A melhor solução, se quiser apenas comparar o texto (sem as imagens incorporadas, como as imagens), é usar o "Seleccionar Tudo" e o "Copiar" no seu programa, para copiar o texto interessante para a área de transferência e depois, no &kdiff3;, colar o texto em qualquer uma das janelas de entrada. (Veja também o <link linkend="selections" +>Seleccionar, Copiar e Colar</link +>.) </para +></answer +></qandaentry> + +<qandaentry +><question +><para +>Para onde foi a opção de pastas "Listar apenas os deltas"? </para +></question +><answer +><para +>Existem agora várias <link linkend="selectingvisiblefiles" +>opções "Mostrar"</link +> no menu de pastas. Se desactivar o "Mostrar os ficheiros iguais", irá obter o resultado que o "Listar apenas os deltas" fazia. </para +></answer +></qandaentry> + +<qandaentry +><question +><para +>Como é que faço uma grande selecção na janela de entrada de diferenças, dado que o deslocamento leva tanto tempo? </para +></question +><answer +><para +>Comece a selecção da forma normal (carregue e mantenha o botão esquerdo do rato carregado). Depois, use as teclas de navegação (p.ex., o Page Up, Page Down), enquanto mantém carregado o botão esquerdo do rato. (Veja também em <link linkend="selections" +>Seleccionar, Copiar e Colar</link +>.) </para +></answer +></qandaentry> + +<qandaentry +><question +><para >Existe demasiada informação aqui, mas a sua dúvida ainda não foi respondida? </para ></question ><answer @@ -3006,14 +2858,14 @@ <para >&kdiff3; - Ferramenta de Comparação e Junção de Ficheiros e Pastas </para> <para ->Program copyright 2002-2005 Joachim Eibl <email ->joachim.eibl@gmx.de</email +>Programa com 'copyright' 2002-2006 de Joachim Eibl <email +>joachim.eibl at gmx.de</email > </para> <para >Vieram várias ideias giras e relatórios de erros dos colegas do autor e de pessoas da Wild Wild Web. Muito obrigado! </para> <para ->Documentação Copyright © 2002-2005 Joachim Eibl <email +>Documentação Copyright © 2002-2006 Joachim Eibl <email >joachim.eibl at gmx.de</email > </para> @@ -3047,23 +2899,64 @@ >Requisitos</title> <para ->In order to successfully use all features of &kdiff3;, you need &kde; 3.1 or greater. </para +>Para poder usar todas as funcionalidades com sucesso do &kdiff3;, precisa do &kde; 3.1 ou posterior. </para ><para ->For information about how to run &kdiff3; on other platforms without &kde; please see the <ulink url="http://kdiff3.sourceforge.net" ->homepage</ulink +>Para mais informações sobre como correr o &kdiff3; noutras plataformas sem o KDE, veja por favor a <ulink url="http://kdiff3.sourceforge.net" +>página pessoal</ulink >. </para ><para ->You can find a list of changes at <ulink url="http://kdiff3.sourceforge.net/ChangeLog" +>O utilizador poderá encontrar uma lista das alterações em <ulink url="http://kdiff3.sourceforge.net/ChangeLog" >http://kdiff3.sourceforge.net/ChangeLog</ulink -> or in the <filename ->ChangeLog</filename -> file of the source package. </para> +> ou no ficheiro "ChangeLog" do pacote de código. </para> </sect1> <sect1 id="compilation"> <title >Compilação e Instalação</title> -&install.compile.documentation; </sect1> + +<para +>Para poder compilar e instalar o &kdiff3; num sistema com o KDE, escreva o seguinte na pasta de base da distribuição do &kdiff3;:</para> + +<screen +><prompt +>%</prompt +> <userinput +><command +>./configure --prefix=<replaceable +>kde-dir</replaceable +></command +></userinput> +<prompt +>%</prompt +> <userinput +><command +>make</command +></userinput> +<prompt +>%</prompt +> <userinput +><command +>make</command +> install</userinput +> +</screen> +<para +>O <replaceable +>kde-dir</replaceable +> corresponde à pasta que contém o KDE no seu sistema. Se não tiver a certeza, leia o ficheiro README para mais detalhes. </para> +<para +>Se não usar o KDE, não use o <command +>configure</command +>, mas siga sim as instruções dos sistemas apenas em Qt, no ficheiro README.</para> +<para +>Dado que o &kdiff3; usa o <command +>autoconf</command +> e o <command +>automake</command +>, você não deverá ter problemas a compilá-lo. No caso de ter alguns problemas, por favor comunique-os nas listas de correio do &kde;.</para> + +</sect1> + </appendix> &documentation.index;