p. 1

tortoisesvn um aplicativo do subversion para windows versão 1.6.11 stefan küng lübbe onken simon large

[close]

p. 2

tortoisesvn um aplicativo do subversion para windows versão 1.6.11 por stefan küng lübbe onken e simon large tradutor-tradução tradudor-créditos publicado 2010/03/31 16:00:35 r19115

[close]

p. 3

Índice prefácio xi 1 público alvo xi 2 guia de leitura xi 3 tortoisesvn é grátis xii 4 comunidade xii 5 agradecimentos xii 6 termos usados neste documento xii 1 introdução 1 1.1 o que é o tortoisesvn 1 1.2 história do tortoisesvn 1 1.3 caracterísiticas do tortoisesvn 1 1.4 instalando tortoisesvn 3 1.4.1 requerimentos do sistema 3 1.4.2 instalação 3 1.4.3 pacotes de idioma 3 1.4.4 corretor ortográfico 3 2 conceitos básicos do controle de versão 5 2.1 o repositório 5 2.2 modelo de controles 6 2.2.1 o problema do compartilhamento de arquivo 6 2.2.2 a solução alocar-modificar-desalocar 6 2.2.3 a solução copiar-modificar-unificar 8 2.2.4 o que o subversion faz 10 2.3 subversion em ação 10 2.3.1 cópias de trabalho 10 2.3.2 urls do repositório 12 2.3.3 revisões 12 2.3.4 como cópia de trabalho acompanham o repositório 14 2.4 resumo 15 3 o repositório 16 3.1 criação do repositório 16 3.1.1 criando um repositório com a linha de comando do cliente 16 3.1.2 criando um repositório com o tortoisesvn 16 3.1.3 acesso local para o repositório 17 3.1.4 acessando um repositório em uma rede compartilhada 17 3.1.5 leiaute do repositório 18 3.2 cópia de segurança do repositório 19 3.3 rotinas de eventos no servidor 20 3.4 vínculos externos 20 3.5 acessando o repositório 21 3.6 svnserve baseado em servidor 21 3.6.1 introdução 21 3.6.2 instalando o svnserve 22 3.6.3 executando o svnserve 22 3.6.4 autenticação básica com svnserve 24 3.6.5 melhor segurança com sasl 25 3.6.6 autenticação com svn+ssh 26 3.6.7 path-based authorization with svnserve 26 3.7 servidor baseado no apache 27 3.7.1 introdução 27 3.7.2 instalando o apache 27 3.7.3 instalando o subversion 28 3.7.4 configurações 28 3.7.5 vários repositórios 30 3.7.6 autorização baseado nos caminhos 31 iii

[close]

p. 4

tortoisesvn 3.7.7 authentication with a windows domain 3.7.8 origem múltiplica de atenticação 3.7.9 autenticação no servidor com ssl 3.7.10 usango um certificados de cliente com servidor ssl virtual 4 guia do uso diário 4.1 começando 4.1.1 sobreposição dos Ícones 4.1.2 menus do contexto 4.1.3 arrastar e soltar 4.1.4 atalhos comuns 4.1.5 autenticação 4.1.6 maximizando janelas 4.2 importando dados para um repositório 4.2.1 importar 4.2.2 importando na pasta 4.2.3 arquivos especiais 4.3 obtendo uma cópia de trabalho 4.3.1 profundidade da obtenção 4.4 submetendo suas alterações para o repositório 4.4.1 a janela de submissão 4.4.2 lista de alterações 4.4.3 excluindo itens de uma lista de submissões 4.4.4 registro de mensagens de submissão 4.4.5 progresso da submissão 4.5 atualizar sua cópia de trabalho com mudanças feitas por outros 4.6 resolvendo conflitos 4.6.1 conflitos de arquivo 4.6.2 conflitos de estrutura 4.7 obtendo informações de estado 4.7.1 sobreposição dos Ícones 4.7.2 colunas do tortoisesvn no windows explorer 4.7.3 estado local e remoto 4.7.4 visualizar diferenças 4.8 lista de alterações 4.9 janela de revisão de registro 4.9.1 invocando a janela de histórico de revisão 4.9.2 histórico de ações de revisão 4.9.3 recuperando informações adicionais 4.9.4 obtendo mais mensagens de log 4.9.5 revisão da cópia de trabalho atual 4.9.6 merge tracking features 4.9.7 changing the log message and author 4.9.8 filtrando mensagens de log 4.9.9 statistical information 4.9.10 modo desconectado 4.9.11 atualizando a visualização 4.10 visualizando as diferenças 4.10.1 diferenças do arquivo 4.10.2 line-end and whitespace options 4.10.3 comparando diretórios 4.10.4 diffing images using tortoiseidiff 4.10.5 external diff/merge tools 4.11 adding new files and directories 4.12 copying/moving/renaming files and folders 4.13 ignorando arquivos e diretórios 4.13.1 padrões de filtro na lista de arquivos ignorados 4.14 apagando movendo e renomeando 4.14.1 apagando arquivos e diretórios 31 33 34 36 38 38 38 38 40 41 41 42 42 43 44 44 44 45 47 47 49 49 49 51 52 54 54 55 58 58 60 60 62 62 64 65 65 66 70 71 71 72 73 73 77 77 77 78 79 79 80 81 82 83 84 85 86 86 iv

[close]

p. 5

tortoisesvn 4.14.2 movendo arquivos e diretórios 87 4.14.3 alterando a caixa do nome do arquivo 88 4.14.4 procedimento em caso de conflito com o nome do arquivo 88 4.14.5 reparando renomeação de arquivos 89 4.14.6 apagando arquivos não controlados 89 4.15 desfazendo alterações 89 4.16 limpar 90 4.17 configurações do projeto 91 4.17.1 propriedades do subversion 92 4.17.2 tortoisesvn project properties 95 4.18 itens externos 97 4.18.1 diretórios externos 97 4.18.2 arquivos externos 100 4.19 ramificando rotulando 100 4.19.1 criando um ramo ou rótulo 100 4.19.2 para obter ou alternar 102 4.20 unificando 103 4.20.1 unificar um intervalo de revisões 104 4.20.2 reintegrar um ramo 106 4.20.3 combinando duas Árvores diferentes 107 4.20.4 opções de combinação 108 4.20.5 reviewing the merge results 109 4.20.6 histórico de combinações 110 4.20.7 handling conflicts during merge 110 4.20.8 merge a completed branch 111 4.20.9 feature branch maintenance 112 4.21 bloqueando 112 4.21.1 how locking works in subversion 112 4.21.2 obtendo uma trava 113 4.21.3 liberando uma trava 114 4.21.4 checking lock status 114 4.21.5 making non-locked files read-only 115 4.21.6 the locking hook scripts 115 4.22 creating and applying patches 115 4.22.1 creating a patch file 115 4.22.2 applying a patch file 116 4.23 who changed which line 117 4.23.1 blame for files 117 4.23.2 diferenças de autoria 119 4.24 o navegador de repositório 119 4.25 gráfico de revisões 121 4.25.1 nós do gráfico de revisões 122 4.25.2 changing the view 123 4.25.3 using the graph 125 4.25.4 atualizando a visualização 125 4.25.5 pruning trees 126 4.26 exporting a subversion working copy 126 4.26.1 removing a working copy from version control 128 4.27 relocating a working copy 128 4.28 integration with bug tracking systems issue trackers 129 4.28.1 adding issue numbers to log messages 129 4.28.2 getting information from the issue tracker 132 4.29 integration with web-based repository viewers 133 4.30 configurações do tortoisesvn 133 4.30.1 configurações gerais 134 4.30.2 revision graph settings 141 4.30.3 icon overlay settings 143 4.30.4 network settings 146 v

[close]

p. 6

tortoisesvn 4.30.5 external program settings 4.30.6 saved data settings 4.30.7 log caching 4.30.8 client side hook scripts 4.30.9 configurações tortoiseblame 4.30.10 registry settings 4.30.11 pastas de trabalho do subversion 4.31 final step 5 the subwcrev program 5.1 the subwcrev command line 5.2 keyword substitution 5.3 keyword example 5.4 com interface 6 ibugtraqprovider interface 6.1 the ibugtraqprovider interface 6.2 the ibugtraqprovider2 interface a frequently asked questions faq b como eu faço b.1 move/copy a lot of files at once b.2 force users to enter a log message b.2.1 hook-script on the server b.2.2 project properties b.3 update selected files from the repository b.4 roll back undo revisions in the repository b.4.1 use the revision log dialog b.4.2 use the merge dialog b.4.3 use svndumpfilter b.5 compare two revisions of a file or folder b.6 include a common sub-project b.6.1 use svn:externals b.6.2 use a nested working copy b.6.3 use a relative location b.7 create a shortcut to a repository b.8 ignore files which are already versioned b.9 unversion a working copy b.10 remove a working copy c useful tips for administrators c.1 deploy tortoisesvn via group policies c.2 redirect the upgrade check c.3 setting the svn_asp_dot_net_hack environment variable c.4 desabilitar opções do menu de contexto d automatizando o tortoisesvn d.1 comandos do tortoisesvn d.2 comandos do tortoiseidiff e command line interface cross reference e.1 conventions and basic rules e.2 comandos do tortoisesvn e.2.1 obter e.2.2 atualizar e.2.3 atualizar para revisão e.2.4 submeter e.2.5 diff e.2.6 log e.2.7 procurar por modificações e.2.8 gráfico de revisões e.2.9 navegador de e.2.10 conflitos e.2.11 resolvido 148 151 152 155 159 159 161 161 162 162 162 163 164 167 167 168 171 172 172 172 172 172 173 173 173 173 174 174 174 174 175 175 175 176 176 176 177 177 177 178 178 180 180 183 184 184 184 184 184 185 185 185 185 186 186 186 186 186 vi

[close]

p. 7

tortoisesvn e.2.12 renomear e.2.13 apagar e.2.14 reverter e.2.15 limpar e.2.16 obter bloqueio e.2.17 liberar bloqueio e.2.18 ramificar/rotular e.2.19 switch e.2.20 combinar e.2.21 exportar e.2.22 reposicionar e.2.23 criar repositó aqui e.2.24 adicionar e.2.25 importar e.2.26 autoria e.2.27 adicionar à lista de ignorados e.2.28 criar correção e.2.29 aplicar correção f detalhes da implementação f.1 sobreposição dos Ícones g securing svnserve using ssh g.1 setting up a linux server g.2 configurando um servidor windows g.3 ssh client tools for use with tortoisesvn g.4 criando certificados openssh g.4.1 create keys using ssh-keygen g.4.2 create keys using puttygen g.5 teste usando putty g.6 testando ssh com tortoisesvn g.7 variantes da configuração ssh glossary Índice remissivo 186 187 187 187 187 187 187 188 188 188 188 188 188 188 189 189 189 189 190 190 192 192 192 193 193 193 193 193 194 195 196 199 vii

[close]

p. 8

lista de figuras 2.1 um típico sistema cliente/servidor 5 2.2 o problema a ser evitado 6 2.3 a solução alocar-modificar-desalocar 7 2.4 a solução copiar-modificar-unificar 8 2.5 continuando com copiar-modificar-unificar 9 2.6 o sistema de arquivos do repositório 11 2.7 o repositório 13 3.1 o menu do tortoisesvn para diretórios não controlados 16 4.1 explorer mostra os ícones sobrepostos 38 4.2 menu do contexto para diretórios controlados 39 4.3 atalho no menu arquivo do explorer em um diretório controlado 40 4.4 menu de quando se clica com o botão direito e se arrasta um diretório que está sob o controle de versão 41 4.5 janela de autenticação 42 4.6 a janela de obtenção 45 4.7 a janela de submissão 47 4.8 a janela de submissão com corretor ortográfico 50 4.9 the progress dialog showing a commit in progress 51 4.10 janela de progresso mostrando atualização terminada 52 4.11 explorer mostra os ícones sobrepostos 58 4.12 procurar por modificações 60 4.13 janela de submissão com lista de alterações 63 4.14 a janela de histórico de revisão 65 4.15 the revision log dialog top pane with context menu 66 4.16 top pane context menu for 2 selected revisions 68 4.17 the log dialog bottom pane with context menu 69 4.18 the log dialog showing merge tracking revisions 72 4.19 histograma de submissões-por-autor 74 4.20 gráfico de pizza das submissões-por-autor 75 4.21 gráfico de submissões-por-data 76 4.22 ir para janela de desconectado 77 4.23 a janela de comparação de revisões 80 4.24 the image difference viewer 81 4.25 explorer context menu for unversioned files 82 4.26 menu de quando se clica com o botão direito e se arrasta um diretório que está sob o controle de versão 83 4.27 explorer context menu for unversioned files 84 4.28 menu de contexto do explorerer para arquivos controlados 86 4.29 janela de reversão 90 4.30 explorer property page subversion tab 92 4.31 página de propriedades do subversion 93 4.32 adicionando propriedades 94 4.33 a janela de ramificação/rotulação 101 4.34 a janela de troca 103 4.35 the merge wizard select revision range 105 4.36 the merge wizard reintegrate merge 107 4.37 the merge wizard tree merge 108 4.38 the merge conflict callback dialog 111 4.39 the merge reintegrate dialog 112 4.40 the locking dialog 113 4.41 the check for modifications dialog 114 4.42 the create patch dialog 116 4.43 the annotate blame dialog 117 4.44 tortoiseblame 118 4.45 o navegador de repositório 120 viii

[close]

p. 9

tortoisesvn 4.46 um gráfico de revisão 4.47 the export-from-url dialog 4.48 the relocate dialog 4.49 example issue tracker query dialog 4.50 the settings dialog general page 4.51 the settings dialog context menu page 4.52 the settings dialog dialogs 1 page 4.53 the settings dialog dialogs 2 page 4.54 the settings dialog colours page 4.55 the settings dialog revision graph page 4.56 the settings dialog revision graph colors page 4.57 the settings dialog icon overlays page 4.58 the settings dialog icon set page 4.59 the settings dialog network page 4.60 the settings dialog diff viewer page 4.61 the settings dialog diff/merge advanced dialog 4.62 the settings dialog saved data page 4.63 the settings dialog log cache page 4.64 the settings dialog log cache statistics 4.65 the settings dialog hook scripts page 4.66 the settings dialog configure hook scripts 4.67 the settings dialog issue tracker integration page 4.68 the settings dialog tortoiseblame page c.1 a janela de atualização 122 127 128 132 134 136 137 138 140 141 142 143 146 147 148 150 151 152 154 155 156 158 159 177 ix

[close]

p. 10

lista de tabelas 2.1 urls de acesso ao repositório 12 3.1 configuração do apache para httpd.conf 29 5.1 list of available command line switches 162 5.2 list of available command line switches 163 5.3 com/automation methods supported 164 c.1 menu entries and their values 178 d.1 list of available commands and options 180 d.2 lista de opções disponíveis 183 x

[close]

p. 11

prefácio · você trabalha com uma equipe · você tem trabalhado em um arquivo e outra pessoa também tem trabalhado no mesmo arquivo ao mesmo tempo você perdeu as modificações que fez por causa disso · você modificou o arquivo e depois quis desfazer as modificações que fez você já desejou ver como era o arquivo tempos atrás · você encontrou um erro em seu projeto e quer saber quando o erro foi inserido em seus arquivos se você respondeu sim para alguma dessas questões então tortoisesvn é para você simplesmente leia e descubra sobre como tortoisesvn pode lhe ajudar no trabalho isto não é difícil 1 público alvo this book is written for computer literate folk who want to use subversion to manage their data but are uncomfortable using the command line client to do so since tortoisesvn is a windows shell extension it s assumed that the user is familiar with the windows explorer and knows how to use it 2 guia de leitura this prefácio explains a little about the tortoisesvn project the community of people who work on it and the licensing conditions for using it and distributing it o capítulo 1 introdução explica o que é o tortoisesvn o que faz de onde vem e o básico para instalar no computador em capítulo 2 conceitos básicos do controle de versão damos uma introdução sobre o controle de revisão subversion que é a base do tortoisesvn isto é uma cópia da documentação do projeto subversion e explica as diferentes formas de controlar versão e como subversion funciona o capítulo capítulo 3 o repositório explica como carregar um repositório local que é vantajoso para testar subversion e tortoisesvn em um único computador também explica um pouco sobre o gerenciamento de um repositório que é relevante para repositórios localizados em um servidor existe também um capítulo sobre como configurar um servidor caso você precise de um o capítulo 4 guia do uso diário é a parte mais importante pois explica todas as principais características do tortoisesvn e como usá-las com o formato de tutorial inicia explicando a função de obter uma cópia de trabalho depois como modificar a cópia de trabalho então submeter as modificações etc e então continua com os tópicos avançados capítulo 5 the subwcrev program é um outro aplicativo que acompanha tortoisesvn que permite extrair informações da cópia de trabalho e escrever isto em arquivos isto é útil para incluir informações sobre a construção dos seus projetos a seção apêndice b como eu faço responde as dúvidas comuns sobre a execução das tarefas que não estão explicitamente descritas em outras seções a parte apêndice d automatizando o tortoisesvn mostra como a as janelas do tortoisesvn podem ser chamadas através da linha de comando isso pode ser útil em scripts que precisam da interação do usuário xi

[close]

p. 12

prefácio o apêndice e command line interface cross reference mostra a relação entre os comandos do tortoisesvn e seus equivalentes na linha de comando do aplicativo subversion svn.exe 3 tortoisesvn é grátis tortoisesvn é grátis você não precisa pagar nada para usar e vocë pode usar da maneira que quiser É um projeto desenvolvido sobre a licença pública genérica gnu general public licence gpl tortoisesvn is an open source project that means you have full read access to the source code of this program you can browse it on this link http code.google.com/p/tortoisesvn/source/browse you will be prompted to enter username and password the username is guest and the password must be left blank the most recent version where we re currently working is located under /trunk and the released versions are located under /tags 4 comunidade both tortoisesvn and subversion are developed by a community of people who are working on those projects they come from different countries all over the world and work together to create wonderful programs 5 agradecimentos tim kemp por iniciar o projeto tortoisesvn stefan küng for the hard work to get tortoisesvn to what it is now lübbe onken pelos belos ícones logomarca encontrar erros traduções e gerenciar as traduções simon large for helping with the documentation and bug hunting o livro subversion por ensinar sobre o subversion e pelo capítulo 2 de onde copiamos o estilo de projeto tigris pelos estilos da documentação de onde copiamos nossos colaboradores for the patches bug reports and new ideas and for helping others by answering questions on our mailing list nossos contribuidores por muitas horas de diversão com a música que nos enviaram 6 termos usados neste documento para facilitar a leitura do documento o nome de todas as telas e menus do tortoisesvn estão em destaque a janela de log por exemplo as opções de menu estão indicadas com uma seta tortoisesvn mostrar log significa selecionar mostrar log no menu tortoisesvn quando referenciar um menu específico dentro de uma das janelas do tortoisesvn será usado algo como menu específico salvar como os botões da interface do usuário são indicados como clique em ok para continuar xii

[close]

p. 13

prefácio as ações do usuário são indicados com a fonte em negrito alt+a mantenha a tecla alt pressionada no teclado até pressionar a tecla a right-drag clique com o botão direito do mouse e mantenha pressionado arrastando o item até o novo local saídas de vídeo e entradas de dados são indicadas com uma fonte different importante detalhes importantes são indicados com um ícone dica dicas tornam sua vida mais fácil cuidado lugares onde você deve tomar cuidado com o que faz atenção where extreme care has to be taken data corruption or other nasty things may occur if these warnings are ignored xiii

[close]

p. 14

capítulo 1 introdução controle de versão é a arte de administrar as mudanças das informações isto é uma ferramenta crítica para programadores que normalmente gastam horas fazendo pequenas modificações em seus aplicativos e então desfazem ou verificam algumas dessas modificações no dia seguinte imagine uma equipe de várias desenvolvedores trabalhando juntos e talvez simultaneamente em mesmos arquivos e você precisa ver porque um bom controle é necessário para controlar uma possível desordem 1.1 o que é o tortoisesvn tortoisesvn is a free open-source client for the subversion version control system that is tortoisesvn manages files and directories over time files are stored in a central repository the repository is much like an ordinary file server except that it remembers every change ever made to your files and directories this allows you to recover older versions of your files and examine the history of how and when your data changed and who changed it this is why many people think of subversion and version control systems in general as a sort of time machine alguns sistemas de controle de versão também são um aplicativo de gerenciamento de configuração scm esses sistemas são especificamente adaptados para controlar estruturas de código fonte e tem muitas características de um aplicativo específico de desenvolvimento como um aplicativo para uma linguagem de programação específica or fornecendo ferramentas de construção de software subversion entretanto não é um desses sistemas é um sistema genérico que pode ser usado para administrar qualquer conjunto de arquivos incluindo código fonte 1.2 história do tortoisesvn in 2002 tim kemp found that subversion was a very good version control system but it lacked a good gui client the idea for a subversion client as a windows shell integration was inspired by the similar client for cvs named tortoisecvs tim studied the source code of tortoisecvs and used it as a base for tortoisesvn he then started the project registered the domain tortoisesvn.org and put the source code online during that time stefan küng was looking for a good and free version control system and found subversion and the source for tortoisesvn since tortoisesvn was still not ready for use then he joined the project and started programming soon he rewrote most of the existing code and started adding commands and features up to a point where nothing of the original code remained as subversion became more stable it attracted more and more users who also started using tortoisesvn as their subversion client the user base grew quickly and is still growing every day that s when lübbe onken offered to help out with some nice icons and a logo for tortoisesvn and he takes care of the website and manages the translation 1.3 caracterísiticas do tortoisesvn o que faz do tortoisesvn um bom aplicativo cliente para subversion aqui está uma pequena lista de recursos interface integrada tortoisesvn integrates seamlessly into the windows shell i.e the explorer this means you can keep working with the tools you re already familiar with and you do not have to change into a different application each time you need functions of the version control and you are not even forced to use the windows explorer tortoisesvn s context menus work in many other file managers and in the file/open dialog which is common to most standard windows 1

[close]

p. 15

introdução applications you should however bear in mind that tortoisesvn is intentionally developed as extension for the windows explorer thus it is possible that in other applications the integration is not as complete and e.g the icon overlays may not be shown sobreposição dos ícones a situação de cada arquivo e diretório controlado é indicado por uma pequena sobreposição de ícones o que permite a você ver rapidamente qual é a situação da sua cópia de trabalho fácil acesso aos comandos do subversion todos os comandos do subversion estão disponíveis nos menus do explorer tortoisesvn adiciona seu próprio submenu uma vez que tortoisesvn é um aplicativo cliente do subversion também gostaríamos de mostrar a você algumas das funcionalidades do subversion controle de diretório cvs somente mantém o histórico de alterações de arquivos individuais mas subversion usa um controle virtual de sistema de arquivos que mantém o histórico de toda a estrutura de diretório ao longo do tempo arquivos e diretórios são controlados e como resultado temos verdadeiros comandos para mover e copiar arquivos e diretórios submissão atômica cada submissão é enviada completamente para o repositório ou não é enviado nada isto permite aos desenvolvedores construir e submeter as alterações em partes coesas metadados controlados cada arquivo e diretório possue um conjunto de propriedades invisíveis você pode inventar e gravar qualquer conjunto de chave/valor que desejar propriedades são controladas ao longo do tempo exatamente como o conteúdo dos arquivos escolha das camadas da rede subversion tem uma noção abstrata de acesso ao repositório tornando fácil para as pessoas desenvolverem novos mecanismos de rede o servidor de rede avançado do subversion é um módulo para o servidor web apache do qual expõe uma variante do http chamada webdav/deltav isto dá ao subversion uma grande vantagem em estabilidade e interoperabilidade e provê várias funcionalidades chave de graça autenticação autorização compressão e navegação no repositório por exemplo uma característica menor um processo servidor autônomo do subversion também está disponível este servidor exterioriza um protocolo específico que pode ser facilmente encapsulado sobre o protocolo ssh manipulação consiste de dados subversion apresenta as diferenças de arquivos usando um algoritmo de comparação binária que funciona igualmente para arquivos texto compreensíveis and binários ilegíveis ambos os tipos de arquivos são gravados compactados da mesma forma no repositório e as diferenças são trasmitidas em ambas as direções através da rede ramificação e rotulação eficiente os recursos necessários para ramificar e rotular não é propocional ao tamanho do projeto subversion cria ramos e rótulos simplesmente copiando o projeto usando um mecanismo parecido ao hard-link deste modo estas operações são realizadas rapidamente sem variação de tempo e consomem muito pouco espaço no repositório hackability subversion não tem uma bagagem histórica ele foi desenvolvido como uma coleção de bibliotecas compartilhas em c com apis bem definidas isto torna o subversion de fácil manutenção e utilizável por outras aplicações e linguagens 2

[close]