Você está na página 1de 28

TortoiseMerge

Uma ferramenta de diff/


unificao para Windows
Version 1.8
Stefan Kng
Lbbe Onken
Simon Large
TortoiseMerge: Uma ferramenta de diff/unificao para Windows:
Version 1.8
por Stefan Kng, Lbbe Onken, e Simon Large
Traduo: tradudor-crditos
data de publicao 2013/11/11 21:33:57 (r24944)
iii
ndice
Prefcio ....................................................................................................................................... vi
1. TortoiseMerge gratuito! ................................................................................................... vi
2. Agradecimentos ................................................................................................................ vi
1. Introduo ................................................................................................................................ 1
1.1. Viso Geral .................................................................................................................... 1
1.2. Histria do TortoiseMerge ................................................................................................ 2
2. Conceitos Bsicos ...................................................................................................................... 3
2.1. Visualizando e Unificando as Diferenas ............................................................................. 3
2.2. Editando Conflitos ........................................................................................................... 3
2.3. Aplicando Correes ........................................................................................................ 4
3. Usando TortoiseMerge ................................................................................................................ 6
3.1. Visualizando Modos ........................................................................................................ 6
3.1.1. Visualizando / Unificando ....................................................................................... 6
3.1.2. Aplicando Correes ............................................................................................. 8
3.2. Botes e Outros Controles ................................................................................................ 9
3.3. cones da Situao da Linha ............................................................................................ 10
3.4. Unificando / Editando Conflitos ....................................................................................... 10
3.5. Arquivos Abertos ........................................................................................................... 11
3.5.1. Visualizando / Unificando ..................................................................................... 12
3.5.2. Aplicando Correes ............................................................................................ 12
3.6. Configuraes ............................................................................................................... 13
3.6.1. Pginas das Configuraes Principais ...................................................................... 13
3.6.2. Pginas de Configurao de Cores ......................................................................... 14
A. atalhos do teclado .................................................................................................................... 16
A.1. Atalhos do teclado ........................................................................................................ 16
B. Automatizando TortoiseMerge ................................................................................................... 18
B.1. Opes da Linha de Comando do TortoiseMerge ................................................................ 18
Glossrio .................................................................................................................................... 19
iv
Lista de Figuras
1.1. Conflito do Arquivo ................................................................................................................. 1
2.1. Conflito do Arquivo ................................................................................................................. 4
3.1. Uma Painel de Visualizao ...................................................................................................... 6
3.2. Dois Painis de Visualizao ..................................................................................................... 7
3.3. Trs Painis de Visualizao ..................................................................................................... 8
3.4. Lista de Arquivo de Correo .................................................................................................... 9
3.5. A Janela para Abrir Arquivos .................................................................................................. 11
3.6. A Princpal Pgina de Configuraes ......................................................................................... 13
3.7. A Pgina de Configurao de Cores .......................................................................................... 14
v
Lista de Tabelas
B.1. Lista de opes disponveis na linha de comando ........................................................................ 18
vi
Prefcio
Quando trabalhando em um projeto, mesmo em um projeto de cdigo aberto onde vrias pessoas revisam seu
cdigo, ou em um projeto comercial onde voc vende um componente com seu cdigo fonte, existiro pessoas
e clientes que encontraro problemas ou querem melhorias no seu projeto. Para fazer isso eles podem enviar as
correes e voc pode ento revisar e decidir o que gostaria de aplicar.
TortoiseMerge ajuda voc com estas tarefas:
Revisando correes
Aplicando correes
TortoiseMerge tambm ajuda voc a resolver conflitos que podem ocorrer se voc estiver trabalhando com um
sistema de controle de verso e outras pessoas esto trabalhando nos mesmos arquivos que voc.
1. TortoiseMerge gratuito!
TortoiseMerge gratuito. Voc no precisa pagar nada por ele, voc pode usar da maneira que quiser. Ele foi
desenvolvido sobre a licena GP (GPL).
TortoiseMerge um projeto de Cdigo Aberto. Isto significa que voc tem total acesso para ver o
cdigo deste programa. Voc pode v-lo no stio http://code.google.com/p/tortoisesvn/source/browse/ [http://
tortoisesvn.tigris.org/svn/tortoisesvn/]. A verso mais recente (a que est sendo trabalhada) est localizada em /
trunk/, e as verses liberadas esto localizadas em /tags/.
Doe!
Even though TortoiseSVN and TortoiseMerge are free, you can support the developers by sending in patches
and playing an active role in the development. You can also help to cheer us up during the endless hours
we spend in front of our computers.
While working on TortoiseSVN we love to listen to music. And since we spend many hours on the project
we need a lot of music. Therefore we have set up some wish-lists with our favourite music CDs and DVDs:
http://tortoisesvn.net/donate.html Please also have a look at the list of people who contributed to the project
by sending in patches or translations.
2. Agradecimentos
Stefan Kng
pelo trabalho duro com o TortoiseMerge
Lbbe Onken
pelos belos cones, logomarca, encontrar erros e cuidar da documentao
O estilo de projeto Tigris
pelos estilos da documentao de onde copiamos
Nossos Colaboradores
pelas correes, reporte de problemas e novas idias, e por ajudar aos outros respondendo perguntas na nossa
lista de discusso.
Prefcio
vii
Nossos Contribuidores
por muitas horas de diverso com as msicas que nos enviaram
1
Captulo 1. Introduo
1.1. Viso Geral
TortoiseMerge uma aplicaao gratuita/cdigo aberto. Ele lhe permite ver as diferenas em arquivos textos,
unificar estas alteraes e at revisar e aplicar arquivos de diferenas unificados, tambm chamados correes.
Quando se trabalha com arquivos textos, por exemplo, cdigo fonte em sua linguagem de programao favorita,
ou arquivos html/xml de documentao ou do seu stio, voc muitas vezes precisar comparar diferentes verses
destes arquivos. Algumas vezes voc receber uma verso diferente de algum, outras vezes voc apenas quer ver
as mudanas que voc tem feito.
Se voc estiver trabalhando com um sistema de controle de verso (ex: Subversion) ento voc algumas vezes
encontrar conflitos quando atualizar sua cpia de trabalho. Isto acontece se algum faz uma alterao em partes do
arquivo que voc atualmente est trabalhando e alterou. Ento voc precisa resolver estes conflitos manualmente.
neste ponto que TortoiseMerge pode lhe ajudar.
O seguinte diagrama mostra a relao o relacionamento entre os arquivos envolvidos no conflitro:
Figura 1.1. Conflito do Arquivo
Introduo
2
Um conflito pode acontecer se voc tentar aplicar uma correo desatualizada. Nestes casos, sem o TortoiseMerge,
voc poderia pedir a pessoa que lhe enviou a correo uma verso mais atualizada ou tentar aplicar a correo
manualmente.
Mas agora com o TortoiseMerge isto no mais necessrio - pelo menos no se voc estiver trabalhando com
um sistema de controle de verso como o Subversion. TortoiseMerge analisa o arquivo de correo pela reviso/
verso que a correo foi criado e automaticamente tenta aplicar a correo nesta verso especfica. Ento ele
aplica a correo e permite que voc revise as suas mudanas e as mudanas da correo. Ento voc pode decidir
quais alteraes deseja manter.
1.2. Histria do TortoiseMerge
Durante o trabalho com o TortoiseSVN [http://tortoisesvn.net] descobrimos que sempre que os usurios nos
enviavam melhorias para o projeto ou apenas correes, ns gastavamos muito tempo s aplicando essas correes
e melhorias. E muitas vezes as correes eram enviadas de cdigo desatualizados e que no poderiam ser
aplicandos usando a ferramenta de correo na linha de comando http://unxutils.sourceforge.net/ porque ns
estvamos trabalhando nos arquivos e algumas vezes j havamos alterado os arquivos.
Esta foi tambm a principal razo pela qual TortoiseSVN originalmente no tem um TortoiseSVN Criar
Correo implementada: ns preferiamos que os usurios nos enviassem os arquivos inteiros pois assim ficava
mais fcil aplicar a correo.
Ento ns gastamos um tempo, procurando na internet por uma ferramenta visual que permitisse aplicar os arquivos
de correo, mas descobrimos que tal ferramenta no existia. Ento para encutar a histria: Ns decidimos que se
ningum poderia prover tal ferramenta ns deveramos fazer a nossa prpria. Foi quando TortoiseMerge nasceu.
J que TortoiseSVN j usava as bibliotecas do Subversion, da qual possuia uma boa ferramenta de diferenas
construida, era natual usarmos tal biblioteca ao invs da biblioteca GNU.
3
Captulo 2. Conceitos Bsicos
TortoiseMerge tem uma poro de diferentes utilidades:
Visualizando as diferenas entre dois arquivos e unificando as alteraes em um nico, ou removendo alteraes
indesejadas.
Editando conflitos entre alteraes locais e alteraes no repositrio do Subversion vindas de uma atualizao.
Aplicando arquivos de correes. Esta a razo pelo qual TortoiseMerge foi criado :)
2.1. Visualizando e Unificando as Diferenas
Neste modo voc est comparando dois arquivos. O arquivo no lado esquerdo considerado o arquivo original
(algumas vezes referenciado como Deles, e o arquivo do lado direito o arquivo modificado (algumas vezes
referenciado como Meu).
Vc pode fazer apenas simples alteraes na linha-base no arquivo do painel direito o qual inclui:
Revertendo linhas alteradas para o mostrado no painel esquerdo
Usando uma combinao de ambos os blocos, ou Deles antes Meu ou Meu antes Deles.
Voc pode tambm editar o arquivo no painel direito como se voc estivesse em um editor de texto. Assim as
linhas so marcadas usando o cone de um lpis. Por favor note que se voc quer fazer qualquer alterao de linha/
bloco-base descrita abaixo, melhor estas alteraes primeiro j que uma vez que comeou a editar o arquivo se
torna impossvel para o TortoiseMerge rastrear o relacionamento com o arquivo original.
2.2. Editando Conflitos
Isto algumas vezes se refere a unificao de trs arquivos, e neste caso mostra trs painis. Entretando existem
quatro arquivos envolvidos. O arquivo que no mostrado o arquivo base comum, o ltimo ancestral comum
de dois dos arquivos que esto em conflito. O relacionamento entre os trs arquivos explicado no diagrama que
segue:
Conceitos Bsicos
4
Figura 2.1. Conflito do Arquivo
O arquivo base representa a verso mais antiga do arquivo, de onde Voc e Eles comearam as modificaes. Meu
representa o arquivo base com todas as mudanas que voc fez, e Deles o arquivo com todas as alteraes que
algum fez no arquivo. O painel da esquerda mostra as modificaes Deles relativo ao arquivo base, e o painel
direito mostra as alteraes no Meu arquivo em relao ao arquivo base. O painel inferior o arquivo de sada
onde voc est tentando resolver os conflitos.
Na janela de resoluo do conflito, voc pode escolher usar blocos do Meu ou do Deles ou ambos. Mas neste caso,
as alteraes sero mostradas no painel inferior.
2.3. Aplicando Correes
Um arquivo de correo um arquivo de diferenas unificadas do Subversion, o qual contm a informao
necessria para aplicar as alteraes nos arquivos. A correo pode ter sido enviada por outro desenvolvedor ento
voc pode ver as alteraes feitas e possivelmente submeter elas para o repositrio. Ou o arquivo de correo pode
ter sido gerado internamente pelo TortoiseSVN quando comparando dois diretrios. Isto acontece quando voc
compara uma reviso do repositrio com a sua cpia de trabalho, ou se voc compara duas revises diferentes do
repositrio, ou se voc compara dois caminhos diferentes no repositrio.
Em cada caso TortoiseMerge vai mostrar uma pequena janela listando os arquivos incluidos na correo. Um duplo
clique em um desses arquivos buscar o arquivo em questo e aplicar as mudanas. O painel da esquerda mostra
o contedo do arquivo original e o painel da direita mostra o arquivo depois que as mudanas foram aplicadas.
Conceitos Bsicos
5
Voc pode editar o arquivo no painel direito exatamente como voc faria em modo de comparao/edio.
6
Captulo 3. Usando TortoiseMerge
3.1. Visualizando Modos
TortoiseMerge tem trs principais modos de visualizao: um painel, dois painis e trs painis de visualizao.
Um/Dois painis de visualizao so usados para ver alteraes e o terceiro painel usado para resolver conflitos.
3.1.1. Visualizando / Unificando
Figura 3.1. Uma Painel de Visualizao
Usando TortoiseMerge
7
Figura 3.2. Dois Painis de Visualizao
A visualizao com dois painis tem algumas caractersticas que no esto disponveis na visualizao de um
painel:
As linhas modificadas so apresentadas em cores diferentes. Partes adicionadas so apresentadas com cores
claras, mas claro que voc pode configurar as cores que voc quer usar. Partes removidas so mostradas com
uma linha vertical marrom escura. Confira a imagem acima para entender como isso funciona.
Reorganizao de cdigio geralmente significa uma poro de modificaes com espaos em branco (espaos,
tabulaes, linhas novas) mas sem realmente alterao de cdigo. Por exemplo, voc dividiu uma linha extensa
em vrias linhas, ou voc algumas vezes compactou vrias linhas em uma s.
Cada uma dessas alteraes so marcadas com um smbolo branco em forma de crculo no lado esquerdo
do painel. Se voc ve esse crculo branco, voc sabe imediatamente que nenhuma modificao no cdigo
propriamente dito foi feita e voc no precisa verificar todo o bloco alterado.
Hand editing of the file in the right pane is possible in two-pane view. Such changes are marked with a pencil
symbol. Hand editing of the file in the left pane is also possible, only when Enable Edit is pressed when the
left pane is active.
Se voc quer comparar/unificar trs arquivos, TortoiseMerge vai mostrar para voc as diferenas em trs painis.
Esta visualizao tambm usado se voc precisar resolver conflitos entre os arquivos.
Usando TortoiseMerge
8
Figura 3.3. Trs Painis de Visualizao
O painel da esquerda mostra as diferenas entre o arquivo Deles e o arquivo Base, enquanto o painel direito mostra
para voc as diferenas entre o arquivo Meu e o arquivo Base. O painel inferior mostra a voc o resultado da
unificao dos arquivos Base, Meu e Deles com possveis conflitos.
Se voc colocar o mouse sobre o ttulo do painel, um balo ser mostrado com o nome do arquivo usado para
gerar as diferenas em cada painel.
Hand editing of the file in the left pane or right pane is also possible, only when Enable Edit is pressed when
that pane is active.
3.1.2. Aplicando Correes
Depois que TortoiseMerge analisar o arquivo de correo ele ir mostrar a voc uma pequena janela com todos
os arquivos que possuem alteraes conforme o arquivo de correo.
Usando TortoiseMerge
9
Figura 3.4. Lista de Arquivo de Correo
Se o nome do arquivo mostrado em preto, ento o arquivo de correo pode ser aplicado sem problemas. Isto
significa que o arquivo no est desatualizado em relao correo. Entretanto, se o nome do arquivo aparecer
em vermelho, ento a correo no pode ser aplicada diretamente porque voc j tem alterado o arquivo.
A janela do arquivo de correo tem um menu flutuante que permite a voc visualizar o resultado da correo
sobre o arquivo atual (aplicar sem salvar), para aplicar e salvar as alteraes para o arquivo selecionado, ou para
aplicar e salvar as alteraes para todos os arquivos da lista. Um duplo clique mostrar a visualizao.
3.2. Botes e Outros Controles
Depending on your setting, you either see a toolbar or a ribbon with many buttons. The buttons all show a tooltip
explaining their function when you hover the mouse pointer over them.
No lado esquerdo da janela est a barra de localizao. Ela prov uma referncia visual rpida como onde as
alteraes foram feitas no arquivo. A barra possui trs colunas. A coluna da esquerda refere-se ao painel esquerdo,
a coluna direito refere-se ao painel esquerdo, e a coluna do meio refere-se ao painel inferior (se estiver presente).
Ao visualizar apenas um painel somente a coluna da esquerda usada. A barra de localizao pode tambm ser
usada com uma barra de rolagem para se mover em todos os painis simultaneamente.
If you double click on a word then every occurrence of that word will be highlighted throughout the document,
both in the main panes and the locator bar. Double click on the word again to remove the highlighting.
If you click in the left margin, or if you triple click within a line, that whole line will be selected.
Usando TortoiseMerge
10
Below the bottom window is the status bar. This shows the number of lines added and deleted in Theirs and
Mine, and the number of unresolved conflicts remaining. You can also see which line-ending style is in use,
what encoding (ASCII, UTF-8, etc) is assumed by TortoiseMerge, and whether there is a byte-order-mark (BOM)
present in UTF-8 files. You can change line-ending style and encoding by double-clicking the corresponding
column of that view. A dialog box will be displayed. The left side of the status bar is used to display hints when
you hover the mouse over a control.
3.3. cones da Situao da Linha
Linhas alteradas so marcadas com um cone para indicar que tipo de alterao sofreu.
Uma linhas foi adicionada.
Uma linha foi removida.
Uma alterao foi desfeita usando a opo de reverter para o contedo original da linha.
Esta linha possui somente alteraes de espaos. Onde vrias linhas esto marcadas, o pargrafo deve ter sido
remanejado, causado alguma mistura nas linhas adjacentes.
Uma linha foi editada manualmente, usando o TortoiseMerge como editor de texto.
Esta linha est em conflito.
Esta linha est em conflito, mas o efeito est escondido por causa de configuraes de espao em branco e fim-
de-linha.
This line is detected as being moved from / to another location.
3.4. Unificando / Editando Conflitos
TortoiseMerge no somente mostra a voc as diferenas entre os arquivos como tambm permite a voc resolver
os conflitos ou aplicar as alteraes.
Se voc est visualizando dois painis, ento voc pode somente editar o arquivo do painel direito (Meu). Para
aplicar alteraes feitas no arquivo do painel esquerdo (Deles), clique-direito sobre a linha alterada e ento
escolha Menu do Contexto Usar o bloco de texto 'deles'. Ento as alteraes do arquivo do painel esquerdo
sero adicionadas para o arquivo do painel direito.
Algumas vezes voc quer usar ambos os blocos de texto, e o menu do contexto tambm oferece a voc Menu
do Contexto Usar ambos os blocos de texto (este primeiro) e Menu do Contexto Usar ambos os
blocos de texto (este depois).
Voc pode tambm editar o arquivo como voc faria em um editor de texto. Cada uma das linhas so marcadas
com um cone em forma de lpis. Por favor note que se voc quer fazer qualquer alterao nas linhas/blocos base
Usando TortoiseMerge
11
descritas acima, melhor fazer isso primeiro j que uma vez que voc comear a editar o arquivo voc mesmo se
torna impossvel para o TortoiseMerge manter a relao com o arquivo original.
Se voc est visualizando trs painis (algumas vezes chamado visualizao combinada) voc pode somente editar
o arquivo no painel inferior (Combinado). Como numa visualizao com dois painis, voc pode clique-direito
sobre as linhas conflitantes e ento selecionar Menu do Contexto Usar o bloco de texto 'deles' ou Menu
do Contexto Usar o bloco de texto 'meu'. Para complementar, se voc quer ambos os blocos, voc pode
selecionar Menu do Contexto Usar bloco de texto 'meu' antes 'deles' ou Menu do ContextoUsar bloco
de texto 'deles' antes 'meu'. De acordo com o comando que vocCombinado.
Algumas vezes um arquivo ser marcado como conflitante no Subversion, mesmo quando voc v-lo usando o
TortoiseMerge sem nenhum conflito. Isto acontece por causa das configuraes de espao em branco. Se voc
escolhe ignorar alteraes de fim-de-linha ou espao em branco, essas linhas sero marcadas usando o cone de
Conflito Ignorado. Para resolver esse conflito voc precisar escolher qual verso voc quer usar.
Importante
Note que se voc est usando TortoiseMerge num mesmo arquivo novamente, qualquer alterao
feita em sua cpia de trabalho, seja ela feita no TortoiseMerge seja em outro editor, ser discarda e
o arquivo vai aparecer como ele era quando a edio do conflito foi iniciada.
3.5. Arquivos Abertos
Quando voc iniciar o TortoiseMerge sem qualquer opo na linha de comando voc ter de abrir os arquivos
manualmente, usando Arquivo Abrir.
Figura 3.5. A Janela para Abrir Arquivos
Usando TortoiseMerge
12
A primeira coisa que voc precisa fazer decidir se voc apenas quer comparar/combinar arquivos, ou se voc
quer aplicar uma arquivo de correo. Dependendo da sua escolha, as caixas de edio e botes correspondentes
sero ativados.
3.5.1. Visualizando / Unificando
Se voc quer comparar/combinar arquivos voc tem que definir pelo menos dois de trs possveis caminhos
para Base, Meu e Deles. Se voc selecionar apenas dois arquivos, ento TortoiseMerge vai mostrar a voc as
diferenas entre os dois arquivos, cada um em um painel ou em um nico painel.
Se voc quer combinar trs arquivos, TortoiseMerge vai mostrar a voc as diferenas em trs painis. Est
visualizao geralmente usada se voc precisa resolver arquivos conflitantes. O arquivo de sada no possui
nome, no caso, e voc ter que usar o Arquivo Salvar como...
3.5.2. Aplicando Correes
Se voc quer aplicar um arquivo de correo voc precisa definir ambos os caminhos para o arquivo de correo
e para o diretrio onde o arquivo de correo dever ser aplicado.
Cuidado
Atualmente, apenas arquivos de correo no formato Unified Diff so suportados. E somente arquivos
que foram gerados em uma cpia de trabalho do Subversion. Outros formatos como arquivos de
correes gerados pelo CVS no so atualmente suportados!
Usando TortoiseMerge
13
3.6. Configuraes
3.6.1. Pginas das Configuraes Principais
Figura 3.6. A Princpal Pgina de Configuraes
Muitas das opes aqui so auto-explicativas, mas alguns pontos precisam ser explicados.
Cpia de Segurana do arquivo original renomeia o arquivo original na CT para nomearquivo.bak antes
de salvar o arquivo modificado.
Default to UTF-8 encoding when set, ANSI files are loaded as UTF-8 encoded and saved as such when edited.
Usando TortoiseMerge
14
Max line length for inline diffs TortoiseMerge can get slow when showing inline diffs for very long lines. Because
of that only lines that are shorter than 3000 chars are shown with inline diffs. You can change this value here.
Ignorar fim-de-linha oculta alteraes feitas apenas na forma usada para indicar fim de linha.
Ignorar alteraes na caixa da fonte esconde alteraes que so apenas na caixa da fonte. Isto pode ser prtico
em aplicaes como Visual Basic, no caso de alteraes de caixa em variveis sem qualquer aviso.
3.6.2. Pginas de Configurao de Cores
Figura 3.7. A Pgina de Configurao de Cores
Esta janela permite a voc selecionar a cor de fundo do cdigo usada para destacar as diferentes alteraes de linha.
Usando TortoiseMerge
15
Normal
Todas as linhas das quais no esto modificadas, ou onde as alteraes esto ocultas.
Adicionado
Linhas que foram adicionadas
Removidas
Linhas que foram removidas
Modificadas
Linhas das quais possuem relativamente pequenas mudanas, so mostradas com as diferenas do contudo
da linha. Esta cor usada para o no modificadas parte do contedo da linha. Partes alteradas sero mostradas
usando as cores de contedo de linha adicionado ou excludo descritos abaixo. Se no modificadas no est
habilitado, esta cor no ser usada e as alteraes da linha sero sempre apresentadas como substituidas.
Conflitantes
Onde a mesma linha foi alterada em ambos os arquivos.
Conflito resolvido
Onde a mesma linha foi alterada em ambos os arquivos, e voc precisa agora selecionar qual verso dever
ser usada.
Vazio
Onde as linhas foram adicionadas no painel oposto, e nenhuma linha existe neste painel.
Texto adiciona na linha
Quando as diferenas do contedo da linha so apresentados, o texto adicionado mostrado neste cor.
Texto removido da linha
Quando as diferenas na linha so apresentadas, textos removidos so mostrados nesta cor.
Espaos em branco
Caracteres usados para indicar Espaos em Branco so mostrados com cores diferentes da cor do texto normal.
16
Apndice A. atalhos do teclado
Lista de atalhos do teclado e comandos.
A.1. Atalhos do teclado
Ctrl-Q, Ctrl-W, Escape
Fechar o programa
Ctrl-C
Copiar o texto selecionado para a rea de transferncia
Ctrl-X, Shift-Del
Recortar o texto selecionado para a rea de transferncia
Ctrl-V, Shift-Insert
Colar o texto selecionado da rea de transferncia
Ctrl-Z, Alt-Backspace
Desfaz a ltima edio
Ctrl-F
Abrir a janela de Busca para procurar textos
Ctrl-O
Abrir arquivos para diferenas/unificao
Ctrl-S
Salvar as alteraes
Ctrl-Shift-S
Salvar como..
F7
Ir para a prxima diferena
Shift-F7
Ir para a diferena anterior
F8
Ir para o prximo conflito
Shift-F8
Ir para o conflito anterior
Ctrl-D
Anternar entre um painel com diferenas e dois painis com diferenas
Ctrl-R
Recarregar os arquivos e reverter todas as alteraes feitas
Ctrl-T
Alterna entre mostrar os espaos em branco ou no
Ctrl-L
Alterna entre contrair as sees no alteradas ou no
Ctrl-P
Alterna entre quebrar a linha ou no
atalhos do teclado
17
Ctrl-G
Ir para linha
Ctrl-A
Selecionar todo o texto
Ctrl-P
Alterna entre quebrar a linha ou no
Ctrl-U
Alternar vises
Ctrl-boto rolagem
Rolar a tela esquerda/diretia
Ctrl-Tab
Alternar entre visualizao a esquerda/direita/inferior
18
Apndice B. Automatizando
TortoiseMerge
TortoiseMergepode ser executado com parmetros a partir da linha de comando evitando que voc mesmo precise
selecionar o arquivo atravs da janela Abrir. Isto tambm til se voc quer usar TortoiseMerge atravs de outra
aplicao.
B.1. Opes da Linha de Comando do TortoiseMerge
A maioria dos parmetros requer informaes adicionais como caminhos ou algum outro texto. Nestes casos,
concatena um ':' ao parmetro e coloque o texto/caminho depois do sinal. Exemplo:
/base:"c:\diretorio\meu arquivo base.txt"
Comando Descrio
/? Mostra uma janela com as opes mais importantes da linha de comando
Tabela B.1. Lista de opes disponveis na linha de comando
Voc pode tambm fornecer apenas nomes de arquivos na linha de comando para compatibilidade com outros
programas de diferenas. Esta a forma simples de linha de comando
TortoiseMerge CaminhoArquivoBase CaminhoMeuArquivo [ CaminhoArquivoDeles ]
Se dois arquivos so informados eles vo ser comparados um com o outro. Se trs arquivos so informados,
o primeiro usado como arquivo BASE, e os outros dois so comparados com este e apresentados usando a
visualizao com trs painis.
19
Glossrio
Adicionar Um comando do Subversion que usado para adicionar um arquivo ou
diretrio para a sua cpia de trabalho. Os novos itens so adicionados para o
repositrio quando voc submet-los.
Alternar Assim como Atualizar para a reviso altera a verso de uma cpia de
trabalho apontando para um ponto diferente no histrico, assim tambm
Alternar altera o espao de uma cpia de trabalho que aponta para uma parte
diferente do repositrio. Isto particularmente til quando se est trabalhando
no tronco e na ramificao e apenas poucos arquivos so diferentes. Voc pode
alternar sua cpia de trabalho entre os dois e somente os arquivos diferentes
sero transferidos.
Apagar Quando voc excluir um item controlado (e submeter a alterao) este item
no existir mais no repositrio depois da reviso submetida. Mas claro
que continuar a existir em revises anteriores no repositrio, logo voc pode
continuar acessando o arquivo. Se necessrio, voc pode copiar um item
excludo e recuperar o mesmo completamente com o histrico.
Atualizar Este comando do Subversion baixa as ltimas alteraes do repositrio para a
sua cpia de trabalho, combinando qualquer alterao feita por outros usurios
com suas alteraes locais na cpia de trabalho.
Autoria Este comando apenas para arquivos texto, e ele apresenta para cada lista a
reviso do repositrio a qual pertence a ltima alterao, e o autor que fez
a alterao. Nossa implementao de interface chamada TortoiseBlame e
tambm mostra a data/hora da submisso e a mensagem de log quando voc
passar o mouse sobre o nmero da reviso.
BDB Berkeley DB. Uma base de dados bem testada para repositrios, que no pode
ser usada em uma rede compartilhada. Padro para repositrios anteriores a
verso 1.2.
Bloquear Quando voc bloqueia um item controlado, voc marca o item no repositrio
como um arquivo no atualizvel, exceto para a cpia de trabalho que
bloqueiou o arquivo.
Combinar O processo pelo qual as mudanas do repositrio so adicionadas na sua cpia
de trabalho sem perder qualquer alterao que voc tenha feita localmente.
Algumas vezes essas alteraes no podem ser combinar automaticamente e
a cpia de trabalho indicar que h conflito.
Combinar acontece automaticamente quando voc atualiza sua cpia de
trabalho. Voc pode tambm combinar mudanas especficas de outra
ramificao usando o comando Combinar do TortoiseSVN.
Conflito Quando as alteraes do repositrio so combinadas com as alteraes locais,
algumas vezes estas alteraes ocorrem nas mesmas linhas. Neste caso
Subversion no pode decidir automaticamente qual verso usar e o arquivo
marcado como em conflito. Voc precisa editar este arquivo manualmente
e resolver o conflito antes que voc possa submeter qualquer alterao
adicional.
Cpia de Trabalho Est a sua estrutura local isolada, e onde voc vai trabalhar sobre os
arquivos controlados, e isto normalmente ficar em seu disco local. Voc cria
uma cpia de trabalho executando um Obter de um repositrio, e voc envia
suas alteraes de volta para o repositrio executando um Submeter.
Glossrio
20
Copiar Em um repositrio do Subversion voc pode criar uma cpia de de um
arquivo apenas ou de uma estrutura inteira. Estas cpias so feitas como
cpias levess> que funcionam mais ou menos como um atalho para o arquivo
original, e que consome quase nenhum espa
Correo Se uma cpia de trabalho possui alteraes apenas em arquivos texto,
possvel usar o comando Diferenas do Subversion para gerar um arquivo
simples de resumo dessas alteraes no formato Unified Diff. Um arquivo
deste tipo oferecido como Correo, e ele pode ser enviado por e-mail
para algum (ou para uma lista de discusso) e ser aplicado em outra cpia de
trabalho. Algum sem acesso para submisso pode fazer alteraes e enviar
um arquivo de correo para algum com permisso de escrita submeter as
alteraes. Ou se voc no tem certeza sobre a alterao voc pode enviar o
arquivo de correo para outros revisarem.
Diff Atalho para Mostrar Diferenas. Muito prtico quando voc quer ver
exatamente as alteraes que foram feitas.
Exportar Este comando produz uma cpia de uma diretrio controlado, assim como
uma cpia de trabalho, mas sem os diretrios locais .svn.
FSFS Um sistema de arquivo proprietrio do Subversion para repositrios. Pode ser
usado em uma rede compartilhada. O padro para a verso do repositrio 1.2
ou posterior.
GPO Objeto da poltica do grupo.
Histrico Mostra o histrico de revises de um arquivo ou diretrio. Tambm conhecido
como Log.
Importar Comando do Subversion para importar um diretrio e sua subestrutura inteira
para o repositrio em uma nica reviso.
Limpar Uma citao do livro do Subversion: Limpar recursivamente a cpia de
trabalho, removendo travas e encerrando operao no finalizadas. Se voc
sempre recebe o erro cpia de trabalho travada, execute este comando para
remove travas obsoletas e voltar a sua cpia de trabalho para o estado normal
novamente. Note que neste contexto, trava refere-se ao travamento do
sistema de arquivos, e no ao bloqueio no repositrio.
Log Mostra o histrico de reviso de um arquivo ou diretrio. Tambm conhecido
como Histrico.
Obter Um comando do Subversion que cria uma cpia local em uma diretrio vazio
baixando os arquivos controlados do repositrio.
Propriedade Como complemento para versionamento de diretrios e arquivos, Subversion
permite adicionar metadados controlados - referenciado como propriedades
para cada diretrio ou arquivo controlado. Cada propriedade tem um nome
e um valor, assim como uma chave de registro. Subversion tem algumas
propriedades especiais que so usadas internamente, tal como svn:eol-
style. TortoiseSVN tem algumas tambm, tal como tsvn:logminsize.
Voc pode adicionar suas prprias propriedades com qualquer nome ou valor
que voc queira.
Propriedade da Reviso
(revprop)
Assim como os arquivo possuem propriedades, assim tambm para
cada reviso no repositrio. Algumas revprops especiais so adicionadas
automaticamente quando a reviso criada, chamadas: svn:date
svn:author svn:log que representam a data/hora, o autor e a mensagem
de log da submisso respectivamente. Estas propriedades podem ser editadas,
Glossrio
21
mas elas no so controladas, ento qualquer alterao permanente e no
pode ser desfeita.
Ramificao Um termo frequentemente usado em sistemas de controle de verso descreve
o que acontece quando o desenvolvimento se ramifica num ponto em
particular e segue dois caminhos diferentes. Voc pode criar uma ramificao
desligada da linha principal de desenvolvimento, logo, pode desenvolver
novas funcionalidades sem desestabilizar a linha principal. Ou voc pode criar
uma ramificao da verso estvel para a qual voc apenas far correes
de erros, enquanto insere novas funcionalidades em uma verso instvel no
tronco. No Subversion uma ramificao criada como uma cpia leve.
Reposicionar Se seu repositrio for movido, talvez porque voc precisou mov-lo para um
diretrio diferente no servidor, ou porque o nome do domnio do servidor foi
alterado, voc precisa realocar sua cpia de trabalho para a nova URL onde
o seu repositrio est localizado.
Nota: voc dever somente usar este comando se sua cpia de trabalho aponta
para o mesmo local no mesmo repositrio, mas o repositrio foi movido. Em
qualquer outra circustncia voc provavelmente dever usar Alternar ao
invs deste comando.
Repositrio Um repositrio um lugar central onde os dados so guardados e mantidos.
Um repositrio pode ser um lugar onde vrias bases de dados ou arquivos so
localizados para distribuir pela rede, ou um repositrio pode ser um local que
diretamente acessado pelos usurios sem ter que atravessar uma rede.
Resolver Quando os arquivos na cpia de trabalho so deixados em estado de conflito
logo depois de serem unificados, estes conflitos devem ser resolvidos por um
ser humano usando um editor (ou talvez o TortoiseMerge). Este processo
referenciado como Resolvendo Conflitos. Quando tudo foi resolvido voc
pode marcar os arquivos conflitantes como resolvidos, e ento ser permtido
submeter estes arquivos.
Reverter Subversion mantm uma cpia local original de cada arquivo de como ele
era quando foi feita a ltima atualizao da cpia de trabalho. Se voc fez
alteraes e decidir que quer desfaz-las, voc pode usar o comando reverter
para voltar para a reviso original.
Reviso Cada vez que voc submete um conjunto de alteraes, voc cria uma nova
reviso no repositrio. Cada reviso representa um estado da estrutura do
repositrio em um certo ponto de sua histria. Se voc quer voltar no tempo
voc pode examiar o repositrio como ele era na reviso N.
De outro ponto de vista, uma reviso pode referenciar um conjunto de
mudanas que foram feitas quando a reviso foi criada.
Reviso BASE A reviso base atual de um arquivo ou diretrio na sua cpia de trabalho.
Est a reviso que o arquivo ou diretrio est, quando a ltima obteno,
atualizao ou submisso foi feita. A reviso BASE normalmente no igual
a LTIMA reviso.
Submeter Este comando do Subversion usado para passar as alteraes da sua cpia de
trabalho de volta para o repositrio, criando uma nova reviso no repositrio.
SVN Uma abreviao frequentemente usada para Subversion.
O nome do protocolo personalizado do Subversion usado pelo servidor de
respotrio svnserve.
ltima Reviso A ltima reviso do arquivo ou diretrio no repositrio.