O TortoiseSVN correm em Windows Vista ou mais recente e está disponível para 32-bit e 64-bit. O instalador para Windows 64-bit também incluir as partes da extensão de 32-bit. O que significa que não tem de instalar a versão 32-bits separadamente para obter o menu de contexto do TortoiseSVN e sobreposições em programas 32-bit.

O suporte para Windows 98, Windows ME e Windows NT4 foi descontinuado na versão 1.2.0, e o suporte ao Windows 2000 e XP até ao SP2 foi descontinuado na versão 1.7.0. O suporte ao para Windows XP com SP3 foi descontinuado na versão 1.9.0. Ainda pode descarregar e instalar versões antigas se precisar.

O TortoiseSVN vem com um instalador fácil de usar. Faça duplo clique no ficheiro de instalação e siga as instruções. O instalador deverá tomar conta do resto do processo de instalação. Não se esqueça de reiniciar após a instalação.

Estão disponíveis pacotes de linguagens que traduzem o interface de utilizador do TortoiseSVN em muitas línguas diferentes. Consulte Apêndice G, Pacotes de Linguagens e Verificadores de Sintaxe para mais informações em como instalá-las.

Se tiver problemas durante ou após a instalação do TortoiseSVN por favor veja a nossa página de perguntas frequentes disponível em https://tortoisesvn.net/faq.html.

Para um projeto real, terá um repositório instalado algures num local seguro e com um servidor Subversion a controlá-lo. Para os objetivos deste tutorial iremos utilizar a funcionalidade do repositório Subversion local, que te permitirá acesso direto a um repositório criado no seu disco duro, sem nenhuma necessidade de servidor.

Primeiro crie una nova pasta vazia no seu PC. Poderá ir para qualquer lado, mas neste tutorial vamos dar-lhe o nome C:\svn_repos. Agora clique com o botão direito do rato na nova pasta e a partir do menu de contexto escolha TortoiseSVN → Criar repositório aqui.... É então criado o repositório dentro da pasta, pronto a usar. Iremos também criar a estrutura interna de pastas por defeito, clicando no botão Criar estrutura de pastas.

Na caixa de diálogo limpar, existem também outra opções úteis para colocar a cópia de trabalho num estado mais limpo.

Figura 1.2. Caixa de diálogo Importar

A outra funcionalidade importante desta caixa de diálogo é a caixa Importar mensagem, que lhe permite introduzir uma mensagem descrevendo o que está a fazer. Quando voltar a olhar para a história do projeto, essas mensagens de submissão serão um guia valioso para as alterações que foram feitas e o porquê. Neste caso podemos dizer algo como “Importar o projeto Widget1”. Clique em OK e a pasta é adicionada ao seu repositório.

Agora que há um projeto em nosso repositório, precisamos criar uma cópia de trabalho para usar nas tarefas do dia-a-dia. Note que o ato de importar uma pasta não a transforma automaticamente em uma cópia de trabalho. O termo do Subversion para criar uma nova cópia de trabalho é Checkout. Vamos fazer o checkout da pasta Widget1 do nosso repositório para uma pasta de desenvolvimento chamada C:\Projects\Widget1-Dev. Crie essa pasta, depois clique com o botão direito do mouse sobre ela e selecione TortoiseSVNCheckout...

Irá notar que a aparência desta pasta é diferente da nossa original. Cada ficheiro tem uma marca de verificação verde no quanto inferior esquerdo. Isso são ícones de estado do TortoiseSVN que apenas estão presentes numa cópia de trabalho. O estado verde indica que o ficheiro está inalterado em relação à versão do repositório.

Hora de trabalhar. Digamos que os arquivos 2Componente1.c2 e 3ReadMe.txt3da pasta Componente1-Dev foram editados. Note que a sobreposição de ícones nestes arquivos estão agora em cor vermelha, indicando que há alterações locais nos mesmos.

Mas quais são as alterações? Clique com o botão direito num dos ficheiros alterados e selecione TortoiseSVN → Comparar. A ferramenta de comparação de ficheiros do TortoiseSVN arranca mostrando exatamente quais as linhas que foram alteradas.

Figura 1.3. Visualizador de diferenças em ficheiros

OK, agora estamos satisfeitos com as alterações e vamos atualizar o repositório. Esta cação é conhecida como a Submissão das alterações. Clique com o botão direito na pasta Widget1-Dev e selecione TortoiseSVN → Submeter. A caixa de diálogo submeter irá listar os ficheiros alterados, cada um com a sua caixa de verificação. Poderá querer escolher um sub-grupo desses ficheiros, mas neste caso iremos submeter as alterações de ambos os ficheiros. Introduza uma mensagem, descrevendo a razão da alteração e clique no botão OK. A caixa de diálogo de progresso mostrará os ficheiros a serem carregados para o repositório, e está terminado.

À medida que o projeto se desenvolve irá necessitar de adicionar novos ficheiros - digamos que adiciona novas funcionalidades em Extras.c e adiciona uma referência no Makefile, já existente. Clique com o botão direito na pasta e TortoiseSVN → Adicionar. A caixa de diálogo Adicionar mostra agora todos os ficheiros não versionados e pode escolher quais quer adicionar. Outra maneira de adicionar ficheiros é clicar no próprio ficheiro e selecionar TortoiseSVN → Adicionar.

Agora quando for submeter a pasta, o novo ficheiros aparecerá como Adicionado e o ficheiro existente como Alterado. Observe que poderá fazer um clique duplo no ficheiro alterado para verificar quais foram exatamente as alterações feitas.

Uma das características mais úteis do TortoiseSVN é a janela de Auditoria. A janela mostra a você a lista de todos os commits feitos para um arquivo ou diretório, e mostra detalhadamente as mensagens que você digitou (você digitou uma mensagem para o commit como sugerido? Se não, agora você vê porque isso é importante).

Figura 1.4. A caixa de diálogo Registo

Bem, então eu manipulei um pouco aqui e usei uma imagem do repositório do TortoiseSVN.

O painel de topo mostra a lista de revisões submetidas juntamente com o início da mensagem de submissão. Se selecionar uma das revisões, o painel do meio irá mostra a mensagem de registo completa para essa revisão, e o painel do fundo mostrará a lista de ficheiros e pastas alterados.

Cada um desses painéis tem um menu de contexto que lhe fornece muitas mais maneiras de usar a informação. No painel do fundo poderá fazer um clique duplo num ficheiro para ver exatamente que alterações foram feitas nessa revisão. Consulte “Caixa de Diálogo Registo de Revisões” para obter toda a informação.

Uma funcionalidade comum a todos os sistemas de controlo de versões, é deixarem-lhe desfazer as alterações que fez anteriormente. Como poderia esperar, o TortoiseSVN faz com que seja de fácil acesso.

Se quiser livrar-se das alterações que ainda não submeteu e voltar a ter o seu ficheiro como estava, antes de o começar a editar, o TortoiseSVN → Reverter será o seu melhor amigo. Este descarta as suas alterações (para o lixo, por precaução) e reverte para a revisão submetida com que iniciou a edição.

Se quere desfazer os efeitos de uma revisão em particular, inicie a caixa de diálogo de registo e encontre a revisão comprometida. Selecione Menu de contexto → Reverter as alterações desta revisão e essas alterações serão desfeitas.

Considera o seguinte cenário: supõem que temos dois colegas, Harry e Sally. Cada um decide editar o mesmo ficheiro do repositório, ao mesmo tempo. Se o Harry guardar primeiro as suas alterações no repositório, é possível que (momentos depois) a Sally possa as substituir com a sua versão do ficheiro. Enquanto que a versão do Harry não se perderá definitivamente (porque o sistema recorda-se de cada alteração), qualquer alteração feita pelo Harry não estará presente na nova versão do ficheiro da Sally porque, para começar, ela nunca viu as alterações do Harry. O trabalho do Harry estará efectivamente perdido - ou pelo menos ausente da última versão do ficheiro - e provavelmente por acidente. Esta é definitivamente uma situação que queremos evitar!

Figura 2.2. O Problema a Evitar

Muitos sistemas de controlo de versões usam o modelo bloquear-modificar-desbloquear para resolver este problema, o que é uma solução muito simples. Em tal sistema, o repositório apenas permite que uma pessoa de cada vez possa modificar um ficheiro. Primeiro o Harry tem de bloquear o ficheiro, antes de poder editar o ficheiro. Bloquear um ficheiro é um pouco como requisitar um livro da biblioteca; se o Harry tem o ficheiro bloqueado, então a Sally não pode efectuar alterações nele. Se eia tentar bloquear o ficheiro, o repositório ir-lhe-á negar o pedido. Tudo o que ela pode fazer é apenas ler o ficheiro, e esperar que o Harry termine as suas alterações e liberte o bloqueio. Após o Harry desbloquear o ficheiro, termina a sua vez, e agora a Sally pode ter a sua vez ao bloquear e editar o ficheiro.

Figura 2.3. A Solução Bloquear-Modificar-Desbloquear

O problema com o modelo bloquear-modificar-desbloquear é que é um pouco restritivo, e torna-se muitas vezes um bloqueio para os utilizadores:

Subversion, CVS, and other version control systems use a copy-modify-merge model as an alternative to locking. In this model, each user's client reads the repository and creates a personal working copy of the file or project. Users then work in parallel, modifying their private copies. Finally, the private copies are merged together into a new, final version. The version control system often assists with the merging, but ultimately a human being is responsible for making it happen correctly.

Eis um exemplo. Digamos que o Harry e a Sally criaram cada um, cópias de trabalho do mesmo projecto, copiadas do repositório. Eles trabalharão concorrentemente e efectuaram alterações no mesmo ficheiro A, em suas cópias. A Sally guarda as suas alterações no repositório, primeiro. Então o Harry tenta guardar as suas alterações mais tarde o repositório informa-o que o seu ficheiro A está desactualizado. Noutras palavras, o ficheiro A do repositório foi de algum modo alterado desde a última vez que o copiaste. Então o Harry pede ao seu cliente para integrar quaisquer novas alterações do repositório na sua cópia de trabalho do ficheiro A. Há probabilidades que as alterações da Sally não se sobreponham com as suas; pelo que uma vez que ambos os conjuntos de alterações estejam integrados, ele guardará a sua cópia de trabalho de volta para o repositório.

Figura 2.4. A solução Copiar-Modificar-Integrar

Figura 2.5. ...Continuação do Copiar-Modificar-Integrar

Mas se as alterações da Sally se sobrepuserem as do Harry? E depois? Esta situação é chamada de conflito, e não é normalmente um grande problema. Quando o Harry pede ao seu cliente para integrar as últimas alterações do repositório para a sua cópia de trabalho, a sua cópia do ficheiro A e de alguma maneira sinalizada como estando em conflito: poderemos observar ambos os conjuntos de alterações, e escolher manualmente entre elas. Ter em atenção que o software não pode resolver automaticamente os conflitos: só os humanos são capazes de compreender e efectuar as necessárias escolhas inteligentes. Uma vez que o Harry tenha resolvido manualmente a sobreposição das alterações (talvez ao discutir o conflito com a Sally), ele pode salvaguardar com segurança o ficheiro integrado de volta para o repositório.

O modelo copiar-modificar-integrar pode soar um pouco caótico, mas na prática funciona de um modo muito fluido. Os utilizadores podem trabalhar em paralelo, nunca esperando uns pelos outros. Quando trabalham nos mesmos ficheiros, acontece que a, a maior parte das suas alterações concorrentes não se sobrepõem; conflitos são raros. E a quantidade de tempo levada a resolver conflitos é muito inferior ao tempo perdido com o sistema de bloqueio

No final tudo se resume a um factor critico: comunicação com o utilizador. Quando os utilizadores não comunicam bem, aumentam os conflitos sintácticos e semânticos. Nenhum sistema pode forçar os utilizadores a comunicar na perfeição, e nenhum sistema pode detectar conflitos semânticos. Portanto não existe vantagens em ser iludido por uma falsa promessa de que o sistema de bloqueio irá evitar conflitos; na prática os sistemas bloqueantes parecem inibir mais a produtividade que qualquer outra coisa.

Existe uma situação particular onde o modelo bloquear-modificar-desbloquear funciona melhor, que é quando tens ficheiros não integráveis. Por exemplo, se o teu repositório contém algumas imagens, e duas pessoas alteram a imagem ao mesmo tempo, não existe forma de integrar essas alterações. Ou o Harry ou a Sally irão perder as suas alterações.

O Subversion usa por defeito a solução copiar-modificar-integrar, e em muitos casos, isto será tudo o que alguma vez irás precisar. No entanto, tal como na versão 1.2, o Subversion também suporta o bloqueio de ficheiros, pelo que se tiveres ficheiros não integráveis, ou simplesmente, fores forçado pela administração a usar uma política de bloqueio, o Subversion poderá ainda te fornecer as funcionalidades de que necessitas.

Tu já ouviste falar em cópias de trabalho; agora vamos demonstrar como o cliente Subversion as cria e usa.

Uma cópia de trabalho do Subversion é uma normal árvore de pastas no teu sistema local contendo uma colecção de ficheiros. Tu podes editar esses ficheiros como desejares, e no caso de serem ficheiros de código fonte, poderás compilar o teu programa a partir deles da forma habitual. A tua cópia de trabalho é a tua área de trabalho privada: o Subversion nunca irá incorporar alterações de outras pessoas, nem tornar as tuas alterações disponíveis a outros, até tu explicitamente lhe indicares para o fazer.

Após efectuares algumas alterações nos ficheiros da tua cópia de trabalho, e verificares que elas estão correctas, o Subversion ir-te-á fornecer comandos para publicares as tuas alterações para as outras pessoas que trabalham contigo no projecto (escrevendo para o repositório). Se outras pessoas publicarem as suas próprias alterações, o Subversion fornece-te comandos para integrar essas alterações na tua cópia de trabalho (ao ler do repositório).

A working copy also contains some extra files, created and maintained by Subversion, to help it carry out these commands. In particular, your working copy contains a subdirectory named .svn, also known as the working copy administrative directory . The files in this administrative directory help Subversion recognize which files contain unpublished changes, and which files are out-of-date with respect to others' work. Prior to 1.7 Subversion maintained .svn administrative subdirectories in every versioned directory of your working copy. Subversion 1.7 takes a completely different approach and each working copy now has only one administrative subdirectory which is an immediate child of the root of that working copy.

Um repositório típico do Subversion armazena com frequência os ficheiros (ou código fonte) de vários projectos; normalmente, cada projecto é uma subpasta no sistema de ficheiros do repositório. Nesta configuração, a cópia de trabalho do utilizador corresponde normalmente a uma sub-árvore em particular do repositório.

Por exemplo, supõem que tens um repositório que contém dois projectos de software.

Figura 2.6. O Sistema de Ficheiros do Repositório

Noutras palavras, a pasta raiz do repositório terá duas subpastas: paint e calc.

To get a working copy, you must check out some subtree of the repository. (The term check out may sound like it has something to do with locking or reserving resources, but it doesn't; it simply creates a private copy of the project for you.)

Suppose you make changes to button.c. Since the .svn directory remembers the file's modification date and original contents, Subversion can tell that you've changed the file. However, Subversion does not make your changes public until you explicitly tell it to. The act of publishing your changes is more commonly known as committing (or checking in ) changes to the repository.

Para publicar as tuas alterações para outros, podes usar o comando submeter do Subversion.

Agora as tuas alterações no button.c foram submetidas para o repositório; se outro utilizador efectuar um checkout de uma cópia de trabalho do /calc, irá ver as tuas alterações na última versão do ficheiro.

Supõem que tens um colaborador, Sally, que efectuou checkout a uma cópia de trabalho do /calc ao mesmo tempo que tu. Quando tu submeteres a tua alteração ao button.c, a cópia de trabalho da Sally irá ficar inalterada; o Subversion só modifica as cópias de trabalho a pedido do utilizador.

Para actualizar o seu projecto, a Sally pode pedir ao Subversion para actualizar a sua cópia de trabalho, usando o comando actualizar do Subversion. Isto irá incorporar as tuas alterações na sua cópia de trabalho, tal como quaisquer outras que tenham sido submetidas desde que a criou (checkout).

Note-se que a Sally não precisou de especificar quais os ficheiros a actualizar; o Subversion usa a informação na pasta .svn, e informação posterior no repositório, para decidir que ficheiros precisam de ser actualizados.

Os repositórios do Subversion podem ser acedidos através de vários métodos diferentes - no disco local, ou através de vários protocolos de rede. No entanto, a localização do repositório será sempre um URL. O esquema do URL indica o método de acesso:

Na maioria dos casos, os URLs do Subversion usam a sintaxe padrão, permitindo a especificação de nomes de servidor e números de porto, como parte do URL. O método de acesso file:// é normalmente usado para acessos locais, embora possa ser usado em caminhos UNC para um hospedeiro de rede. Portanto o URL toma a forma de file://hostname/path/to/repos. Para a máquina local, a parcela do URL hostname pode ser localhost ou ausente. Por esta razão os caminhos locais aparecem normalmente com três barras, file:///path/to/repos.

Igualmente, os utilizadores do esquema file:// nas plataformas Windows, irão precisar de usar uma sintaxe “padrão” não oficial para aceder aos repositórios que estão na mesma máquina, mas numa unidade diferente da unidade de trabalho do utilizador. Qualquer uma da duas seguintes sintaxes de caminhos URL irão funcionar aqui, X é a unidade onde reside o repositório:

file:///X:/path/to/repos
...
file:///X|/path/to/repos
...
      

Observa que o URL usa barras comuns, mesmo que a forma nativa de um caminho (sem-URL) no Windows utilize barras invertidas.

Você pode acessar um repositorio FSFS via uma rede compartilhada, mas isso não é recomendado por várias razões:

Uma operação svn submeter pode publicar alterações de qualquer número de ficheiros e pastas, como uma transacção atómica. Na tua cópia de trabalho, tu podes alterar o conteúdo dos ficheiros, criar, remover, alterar o nome e copiar ficheiros e pastas, e então submeter o conjunto completo de alterações como uma unidade.

No repositório, cada submissão é tratada como uma transacção atómica: ou todas as alterações da submissão ocorrem, ou nenhuma ocorrerá. O Subversion mantém a sua atomicidade em caso de estoiro do programa, problemas de rede, ou outras acções dos utilizadores.

Cada vez que o repositório aceita uma submissão, este cria um novo estado da árvore do sistema de ficheiros chamado revisão. A cada revisão é atribuído um número natural, uma unidade acima à da revisão prévia. A revisão inicial de um repositório recém-criado é zero, e consiste em nada mais que uma pasta raiz vazia.

Uma maneira agradável de visualizar o repositório é como uma série de árvores. Imagina um array de números de revisão, a começar no 0, alinhados da esquerda para a direita. Cada número de revisão tem uma árvore de revisão por baixo, e cada árvore é uma “fotografia” do aspecto do repositório após cada submissão.

Figura 2.7. O repositório

É importante observar que as cópias de trabalho nem sempre correspondem a um única revisão do repositório; Elas podem conter ficheiros de várias revisões diferentes. Por exemplo, supõe que efectuas o checkout de um repositório para uma cópia de trabalho, cuja revisão mais recente é 4:

calc/Makefile:4
integer.c:4
button.c:4
      

Neste momento, esta cópia de trabalho corresponde exactamente à revisão 4 do repositório. No entanto, supõe que fizeste uma alteração ao button.c, e submetes essa alteração. Assumindo que não foram efectuadas outras submissões, a tua submissão irá criar a revisão 5, e a tua cópia de trabalho irá ficar assim:

calc/Makefile:4
integer.c:4
button.c:5
      

Supõe que, neste momento, a Sally submete uma alteração ao integer.c, criando a revisão 6. Se usares o svn actualizar para actualizares a tua cópia de trabalho, ela irá ficar do seguinte modo:

calc/Makefile:6
integer.c:6
button.c:6
      

As alterações da Sally ao integer.c irão aparecer na tua cópia de trabalho e a tua alteração no button.c ainda estará presente. Neste exemplo, o texto do Makefile será identico nas revisões 4,5,6 mas o Subversion irá marcar a tua cópia de trabalho do Makefile com a revisão 6, para indicar que esta é ainda a corrente. Então, após uma actualização de limpeza no topo da tua cópia de trabalho, esta irá corresponder a exactamente uma revisão do repositório.

Para cada ficheiro na pasta de trabalho, o Subversion guarda duas partes essenciais de informação na área administrativa .svn/:

Dada esta informação, comunicando com o repositório, o Subversion pode dizer em qual dos seguintes quatro estados está o ficheiro de trabalho:

Agora tens um novo repositório localizado em D:\SVN\MyNewRepository.

Para aceder ao teu repositório local, precisas do caminho para essa pasta. Lembra-te que o Subversion está à espera que todos os caminhos estejam na forma file:///C:/SVNRepository/. Observa o uso de barras por todo o lado.

Para aceder a um repositório localizado numa partilha de rede, podes usar o mapeamento de unidades, ou podes usar um caminho UNC. Para caminhos UNC a forma é file://ServerName/path/to/repos/. Observa que só existem aqui 2 barras dianteiras.

Antes do SVN 1.2, os caminhos UNC tinham de ser especificados numa forma mais obscura, file:///\ServerName/path/to/repos. Esta forma é ainda suportada, mas não recomendada.

Although in theory it is possible to put a FSFS repository on a network share and have multiple users access it using file:// protocol, this is most definitely not recommended. In fact we would strongly discourage it, and do not support such use for various reasons:

O acesso file:// é dirigido para acesso local e de utilizador único, em particular para testes e depuração de problemas. Quando tu queres partilhar o repositório, precisarás realmente de instalar correctamente um servidor, e não é tão difícil como pensas. Consulta o “Aceder ao Repositório” para guias orientadoras na escolha e instalação de um servidor.

Antes de tu importares os teus dados para o repositório, deverás primeiro pensar em como o queres organizar. Se tu usares uma das estruturas recomendadas, mais tarde terás a tudo muito mais facilitado.

Existem alguns métodos padrão e recomendados de organizar o repositório. A maioria das pessoas a pasta trunk para guardar a “linha principal” de desenvolvimento, uma pasta ramos para conter as cópias de ramos, e a pasta etiquetas para guardas as cópias etiquetas. Se o repositório tiver só um projecto, então frequentemente as pessoas criaram essas pastas de nível de topo:

/trunk
/branches
/tags
    

Porque sendo tão normalmente usado este formato, ao criares um novo repositório através do TortoiseSVN este irá também se oferecer para criar por ti a estrutura de pastas.

Se o repositório conter vários projectos, as pessoas normalmente indexarão a sua estrutura por ramo:

/trunk/paint
/trunk/calc
/branches/paint
/branches/calc
/tags/paint
/tags/calc
    

...ou por projecto:

/paint/trunk
/paint/branches
/paint/tags
/calc/trunk
/calc/branches
/calc/tags
    

Indexar por projecto faz sentido, se os projectos não estão intimamente relacionados, e cada um é obtido individualmente por checkout. Para projectos relacionados onde poderás querer efectuar o checkout de todos os projectos de uma só vez, ou onde os projectos estão todos ligados num único pacote de distribuição. É normalmente melhor indexar por ramo. Deste modo tu podes ter um trunk para efectuar checkout e as relações entre subprojectos são mais facilmente visível.

Se adoptares por uma abordagem de um nível de topo /trunk /tags /branches, não é necessário referir que terás de copiar o trunk inteiro para cada ramo e etiqueta, e de algum modo esta estrutura oferece a maior flexibilidade.

Para projectos não relacionados, poderás preferir o uso de repositórios separados. Quando submetes as alterações, é o número de revisão do repositório inteiro que muda, e não o número de revisão do projecto. Ter 2 projectos não relacionados a partilhar o repositório, pode significar grandes falhas nos números de revisões. Os projectos Subversion e TortoiseSVN aparecem no mesmo endereço de hospedeiro, mas estão completamente separados, permitindo desenvolvimentos separados, e sem confusão sobre números de construção.

Está claro que és livre para ignorar essas estruturas comuns. Tu podes criar qualquer género de variação, e o que funcionar melhor para ti e para a tua equipa. Lembra-te que o que escolheres não será um comprometimento permanente. Tu podes reorganizar, em qualquer altura, o teu repositório. Porque ramos e etiquetas são pastas comuns, o TortoiseSVN pode mover ou alterar o seu nome, quando assim o desejares.

Trocar de uma estrutura para outra é só uma questão de executar uma série de movimentos do lado do servidor. Se não gostares do modo como as coisas estão organizadas no repositório, poderás manipular as pastas a teu modo.

Então, se ainda não criaste a estrutura de pastas básica dentro do teu repositório, deverás faze-lo agora. Existem duas maneiras para o obteres. Se queres simplesmente criar a estrutura /trunk /tags /branches, tu podes usar para isso o navegador de repositório, para criar as três pastas (em três submissões separadas). Se queres criar uma hierarquia mais profunda, então é mais simples criar primeiro a estrutura de pastas em disco e importá-la numa simples submissão, assim:

Note that the name of the folder you are importing does not appear in the repository, only its contents. For example, create the following folder structure:

C:\Temp\New\trunk
C:\Temp\New\branches
C:\Temp\New\tags
      

Import C:\Temp\New into the repository root, which will then look like this:

/trunk
/branches
/tags
      

Figura 4.1. O explorador mostrando os ícones sobrepostos

Uma das funcionalidades mais visíveis do TortoiseSVN são os ícones sobrepostos que aparecem nos ficheiros na tua cópia de trabalho. Estes dão-te uma vista geral dos ficheiros que foram modificados. Consultar “Sobreposição de Ícones” para saber mais sobre o que cada ícone sobreposto representa.

Figura 4.2. Menu de Contexto de uma pasta sob controlo de versões.

Todos os comandos do TortoiseSVN são invocados a partir do menu de contexto no explorador do Windows. A maioria estão directamente visíveis quando clicas com o botão direito numa pasta ou ficheiro. A lista de comandos disponíveis dependem do caso de se tratar de uma pasta ou um ficheiro, ou se o ficheiro pai se encontra sob controlo de versões, ou não. Podes também ver o menu do TortoiseSVN como uma parte do menu ficheiro do Explorador.

Em alguns casos verás várias entradas TortoiseSVN, o que não representa um bug!

Figura 4.3. Menu de ficheiro do Explorador para um atalho numa pasta versionada.

Neste exemplo está um atalho não versionado dentro de uma pasta versionada, e no menu ficheiro do Explorador estão três entradas para o TortoiseSVN. Uma é para a pasta, outra para o atalho em si e a terceira é para o objecto para o qual o atalho aponta. Para ajudar a distinguir entre eles, os ícones têm um indicador no canto inferior direito, para distinguir se a entrada de menu é para um ficheiro, pasta ou atalho para múltiplos itens seleccionados.

Figura 4.4. Menu arrastar com o botão direito para uma pasta sob controlo de versões.

Outros comandos estão disponíveis como opções de arrasto quando arrastas com o botão direito ficheiros ou pastas para uma nova localização dentro da cópia de trabalho, ou quando arrastas com o botão direito um ficheiro não versionado ou uma pasta para outra pasta sob o controlo de versões.

Algumas operações comuns têm atalhos no Windows, mas não aparecem em botões ou menus. Se não consegues descobrir como fazer alguma coisa óbvia, como refrescar uma vista, vê aqui.

Se o repositório a que tentas aceder está protegido por palavra-passe, uma caixa de diálogo de autenticação irá surgir.

Figura 4.5. Caixa de diálogo de autenticação

Introduzir o teu nome de utilizador e palavra-passe. A caixa de verificação irá fazer com que o TortoiseSVN guarde as credenciais na pasta por defeito do Subversion: %APPDATA%\Subversion\auth em três subpastas:

If you want to clear the authentication cache, you can do so from the Saved Data page of TortoiseSVN's settings dialog. The button Clear all will clear the cached authentication data for all repositories. The button Clear... however will show a dialog where you can chose which cached authentication data should be deleted. Refer to “Preferências de Dados Guardados”.

Some people like to have the authentication data deleted when they log off Windows, or on shutdown. The way to do that is to use a shutdown script to delete the %APPDATA%\Subversion\auth directory, e.g.

@echo off
rmdir /s /q "%APPDATA%\Subversion\auth"
      

You can find a description of how to install such scripts at http://www.windows-help-central.com/windows-shutdown-script.html.

Para mais informações em como configurar o teu servidor para autenticação e controlo de acessos, consulta “Aceder ao Repositório”.

Muitas das caixas de diálogos do TortoiseSVN têm muita informação para visualizar, pelo que é normalmente útil maximizar só a altura ou largura, em vez de maximizar para preencher o ecran. Como conveniência existem atalhos para este caso no botão Maximizar. Utilizar o botão do meio do rato para maximizar verticalmente e o do direito do rato para maximizar horizontalmente

Se estás a importar um repositório existente, que já contém alguns projectos então a sua estrutura já está definida. Se estás a importar dados para um novo repositório, então vale a pena tirar algum tempo para pensar no modo em como será organizado. Ler “Estrutura do Repositório” para aconselhamento posterior.

Esta secção descreve o comando importar do Subversion, que foi desenhado para importar uma hierarquia de pastas para o repositório de uma só vez. Apesar de efectuar o trabalho, tem algumas deficiências:

Por essas razões recomendamos que não uses de modo algum o comando importar mas em alternativa segue o metodo de dois-passos descrito em “Importar no local”,a não ser que estejas a executar o único passo de criar uma estrutura inicial /trunk /tags /branches no teu repositório. Uma vez que aqui estás, é assim como funciona o importar básico...

Antes de importares o teu projecto para o repositório deverás:

Agora seleccionar a pasta de topo da estrutura de pastas do teu projecto no windows explorer e, clica c/ o botão direito para abrir o menu de contexto. Selecciona o comando TortoiseSVN → Importar... que mostrará a caixa de diálogo:

Figura 4.6. Caixa de diálogo Importar

In this dialog you have to enter the URL of the repository location where you want to import your project. It is very important to realise that the local folder you are importing does not itself appear in the repository, only its content. For example if you have a structure:

C:\Projects\Widget\source
C:\Projects\Widget\doc
C:\Projects\Widget\images
      

and you import C:\Projects\Widget into http://mydomain.com/svn/trunk then you may be surprised to find that your subdirectories go straight into trunk rather than being in a Widget subdirectory. You need to specify the subdirectory as part of the URL, http://mydomain.com/svn/trunk/Widget-X. Note that the import command will automatically create subdirectories within the repository if they do not exist.

A mensagem de importar é utilizada como mensagem de registo.

Por defeito, ficheiros e pastas que correspondem aos padrões globais para ignorar arquivos não são importados. Para substituir este comportamento, poderás usar a caixa de verificação Incluir arquivos ignorados. Consultar em “Preferências Gerais”, para mais informações em como introduzir um padrão de arquivos a ignorar.

Assim que premires OK TortoiseSVN importa a arvore de pastas completa, íncluindo todos ficheiros, para o repositório. O projecto está agora armazenado, sob controlo de versões, no repositório. Note-se que a pasta que importaste NÃO está sob controlo de versões. Para obter uma cópia de trabalhocom controle de versões, necessitarás de efectuar um SVN Exportar da versão que acabaste de importar. Ou lê, para descobrir como importar uma pasta no local.

Assumindo que já tens um repositório e queres adicionar uma pasta á sua estrutura, segue estes passos:

Às vezes é necessário ter um ficheiro sob o controlo de versões que contém dados específicos, isto é, tens um ficheiro que cada desenvolvedor/utilizador necessita modificar para satisfazer o seu/sua configuração. Mas o versionamento de tal ficheiro é difícil porque, cada utilizador iria, a todo o momento, submeter as suas alterações ao repositório.

Em alguns casos sugerimos o uso de ficheiros template. Cria um ficheiro que contém os dados que os teus desenvolvedores precisam, adiciona este ficheiro ao controlo de versões e deixa os desenvolvedores exportar este ficheiro. Então, cada desenvolvedor tem que fazer uma cópia desse ficheiro e renomear essa cópia. Após isto, modificar a cópia já não é um problema.

As an example, you can have a look at TortoiseSVN's build script. It calls a file named default.build.user which doesn't exist in the repository. Only the file default.build.user.tmpl. default.build.user.tmpl is the template file which every developer has to create a copy from and rename that file to default.build.user. Inside that file, we added comments so that the users will see which lines they have to edit and change according to their local setup to get it working.

So as not to disturb the users, we also added the file default.build.user to the ignore list of its parent folder, i.e. we've set the Subversion property svn:ignore to include that filename. That way it won't show up as unversioned on every commit.

Podes escolher 0 nível que queres para o checkout, o que te permite especificar o nível da recursividade nas pastas filho. Se quiseres apenas algumas secções de uma grande árvore, podes efectuar checkout apenas da pasta de topo e depois actualizar recursivamente pastas seleccionadas.

Para facilmente seleccionar apenas os itens que pretendes para o checkout e forçar a cópia de trabalho a manter apenas esses itens, clica no botão Escolher itens.... Isto abre uma nova caixa de diálogo onde podes verificar todos os itens que pretendes da tua cópia de trabalho e desseleccionar todos os itens que não pretendes. A cópia de trabalho resultante é conhecida como um checkout disperso. Uma actualização a tal cópia de trabalho não irá obter os ficheiros e pastas em falta, mas apernas actualizar o que já tens actualmente na tua cópia de trabalho.

If you check out a sparse working copy (i.e., by choosing something other than fully recursive for the checkout depth), you can easily add or remove sub-folders later using one of the following methods.

Esta funcionalidade é muito útil quando só queres SVN exportar partes de uma árvore grande, mas desejas a conveniência de actualizar uma só cópia de trabalho. Supõem que tens uma grande árvore árvore que tem as subpastas Project01 até Project99, e só queres SVN exportar Project03, Project25 e Project76/SubProj. Utiliza estes passos:

Se a tua cópia de trabalho se encontra actualizada e não existem conflitos, então estás em condições para submeter as tuas alterações. Seleccionar os ficheiros e/ou pastas que queres submeter e, TortoiseSVN → Submeter....

Figura 4.8. A Caixa de Diálogo Submeter

A caixa de diálogo submeter mostra-te cada ficheiro alterado, incluindo os adicionados, apagados e não versionados. Se não queres que um ficheiro alterado seja submetido, limpa a caixa de verificação desse ficheiro. Se quiseres adicionar um ficheiro não versionado, então verifica esse ficheiro, para o adicionar á submissão.

To quickly check or uncheck types of files like all versioned files or all modified files, click the link items just above the list of shown items.

Para informação sobre as colorações das sobreposições de itens de acordo com o seu estado, por favor consulta “Estado Remoto e Local”.

Itens que foram comutados para um repositório diferente são também indicados com o uso do marcador (s). Poderás ter comutado algo enquanto trabalhavas num ramo, e esquecido de comutar de novo para o trunk. Isto é um sinal de aviso!

O Duplo clique na caixa de diálogo submeter, em qualquer ficheiro alterado, irá lançar a ferramenta externa diff para mostrar as tuas alterações. O menu de contexto irá dar-te mais opções, como pode ser visto no screenshot. Poderás também arrastar ficheiros daqui para outra aplicação, como um editor de texto ou um IDE.

Poderás seleccionar ou desseleccionar items clicando na caixa de verificação à esquerda do item. Para pastas poderás usar Shift-Seleccionar para tornar essa acção recursiva.

As colunas mostradas no painel de fundo são customizáveis. Se clicares com o botão direito em qualquer cabeçalho de coluna verás um menu de contexto, que te permitirá seleccionar quais as colunas que serão mostradas. Poderás também alterar a largura da coluna utilizando um indicador de arrasto, que aparecerá quando moveres o rato sobre os limites da coluna. Estas customizações são conservadas para que as vejas os mesmos cabeçalhos da próxima vez.

Por defeito ao submeteres as tuas alterações, são libertados automaticamente quaisquer bloqueios que tiveres sobre ficheiros após o sucesso da submissão. Se desejares mater esses bloqueios tem a certeza que a caixa de verificação Manter bloqueios. Por defeito o estado dessa caixa de verificação é retirada a partir da opção no_unlock, no ficheiro de configuração do Subversion. Ler “Preferências Gerais” para mais informações em como editar o ficheiro de configuração do Subversion.

A caixa de diálogo de submissão suporta a funcionalidade listas de alterações, para ajudar a agrupar ficheiros. Sabes mais acerca desta funcionalidade em “Listas de Alterações”.

Às vezes, poderás querer efectuar a submissão de apenas uma parte das alterações que efectuaste num ficheiro. Essa situação acontece com frequência quando estás a trabalhar em algo, e surge uma correcção urgente para ser submetida, e essa correcção calha estar no mesmo ficheiro em que estás a trabalhar.

right click on the file and use Context Menu → Restore after commit. This will create a copy of the file as it is. Then you can edit the file, e.g. in a text editor and undo all the changes you don't want to commit. After saving those changes you can commit the file.

Após submeter, a cópia do ficheiro é automaticamente restaurada e terás o ficheiro com todas as tuas modificações que não foram ainda submetidas.

Por vezes, tens ficheiros versionados que são alterados frequentemente mas que não desejas submeter. Por vezes isso indica uma falha no processo de construção - porque são estes ficheiros versionados? devias ter usado ficheiros template? Mas por vezes é inevitável. A razão clássica é a mudança, pelo IDE, da marca temporal do ficheiro de projecto, de cada vez que o constróis. O ficheiro de projecto tem de ser versionado pois inclui todas as configurações de construção, mas no entanto não precisa de ser submetido só porque a sua marca temporal foi alterada.

Para ajudar em casos estranhos como este, temos reservada uma lista de alterações chamada ignore-on-commit. Qualquer ficheiro adicionado a esta lista de alterações será automaticamente não seleccionada na caixa de diálogo de submissão. Poderás ainda submeter as alterações mas, terás de as seleccionar manualmente na caixa de diálogo de submissão.

Tem a certeza de, inserir uma mensagem de registo que descreve as alterações que vais submeter. Isto ir-te-á ajudar a visualizar o que aconteceu e quando, enquanto navegas através das mensagens de registo do projecto, numa data posterior. A mensagem pode longa ou breve, conforme o desejares; muitos projectos têm guias para o que deverá ser incluído, a linguagem a usar, e por vezes até um formato rígido.

Podes aplicar um formato simples às tuas mensagens de registo, usando uma convenção similar à usada nos emails. Para aplicar estilo ao texto usar; *text* para negrito, _text_ para sublinhado, e ^text^ para itálico.

Figura 4.9. A Verificação de Sintaxe na Caixa de Diálogo Submeter

O TortoiseSVN inclui um verificador de sintaxe que te ajuda a conseguir obter mensagens de registo bem escritas. Este irá sobressair qualquer palavra mal escrita. Usa o menu de contexto para aceder às correcções sugeridas. É claro que ele não conhece todos os termos técnicos que utilizas, podendo aparecer como erros termos correctamente escritos. Não te preocupes, poderás os adicionar ao teu dicionário pessoal, usando o menu de contexto.

The log message window also includes a filename and function auto-completion facility. This uses regular expressions to extract class and function names from the (text) files you are committing, as well as the filenames themselves. If a word you are typing matches anything in the list (after you have typed at least 3 characters, or pressed Ctrl+Space), a drop-down appears allowing you to select the full name. The regular expressions supplied with TortoiseSVN are held in the TortoiseSVN installation bin folder. You can also define your own regexes and store them in %APPDATA%\TortoiseSVN\autolist.txt. Of course your private autolist will not be overwritten when you update your installation of TortoiseSVN. If you are unfamiliar with regular expressions, take a look at the introduction at https://en.wikipedia.org/wiki/Regular_expression, and the online documentation and tutorial at http://www.regular-expressions.info/.

Acertar com a regex correcta pode ser um bocado complicado, pelo que para te ajudar a descobrir qual a expressão mais indicada, existe uma caixa de diálogo de teste que te permite introduzir uma expressão e então digitar nomes de ficheiros para a testar. Arranca-a a partir da linha de comandos, com o comando TortoiseProc.exe /command:autotexttest.

The log message window also includes a commit message snippet facility. These snippets are shown in the autocomplete dropdown once you type a snippet shortcut, and selecting the snippet in the autocomplete dropdown then inserts the full text of the snippet. The snippets supplied with TortoiseSVN are held in the TortoiseSVN installation bin folder. You can also define your own snippets and store them in %APPDATA%\TortoiseSVN\snippet.txt. # is the comment character. Newlines can be inserted by escaping them like this: \n and \r. To insert a backslash, escape it like this: \\.

Podes reutilizar mensagens inseridas previamente. clica apenas em Mensagens recentes para ver a lista de algumas das últimas mensagens que inseriste, nesta cópia de trabalho. O número de mensagens guardadas pode ser customizável na caixa de diálogo de configuração do TortoiseSVN.

Podes limpar todas a mensagens de registo de submissão armazenadas na página Dados Guardados de configurações do TortoiseSVN, ou poderás limpar mensagens individuais a partir da caixa de registo Mensagens recentes usando a tecla Delete.

Se queres incluir, na mensagem de registo, os caminhos seleccionados, podes usar no controlo de edição o comando Context Menu de Contexto → Colar lista de nomes de arquivos.

Outra maneira para inserir caminhos na mensagem de registo é simplesmente, arrastar os ficheiros da lista de ficheiros para o controlo de edição.

Após premir o OK, aparece a caixa de diálogo que mostra o progresso da submissão.

Figura 4.10. A caixa de dialogo de Progresso, mostrando a submissão em progresso

A caixa de diálogo de progresso usa um código de cores para evidenciar as acções de submissão

Este é o esquema de cores por defeito, mas podes alterar essas cores usando a caixa de diálogo configurações. Ler “Preferências de cor do TortoiseSVN” para mais informação.

A file conflict occurs when two or more developers have changed the same few lines of a file. As Subversion knows nothing of your project, it leaves resolving the conflicts to the developers. The conflicting area in a text file is marked like this:

<<<<<<< filename
your changes
=======
code merged from repository
>>>>>>> revision
      

Also, for every conflicted file Subversion places three additional files in your directory:

Podes lançar uma ferramenta externa de integração/ editor de conflitos com TortoiseSVN → Editar Conflitos ou poderás utilizar um qualquer editor de texto para resolver o conflito manualmente. Deverás decidir como é que irá ficar o código, efectua as alterações necessárias e guarda o ficheiro. Usando uma ferramenta de integração como o TortoiseMerge ou uma das outras ferramentas populares, é na generalidade a opção mais fácil já que apresentam na generalidade os ficheiros envolvidos numa painel de 3 vistas e não têm de se preocupar com os marcadores de conflitos. Se usares um editor de ficheiro terás então de pesquisar por linhas começadas pela string <<<<<<<.

Posteriormente executa o comando TortoiseSVN → Resolvido e submete as tuas modificações para o repositório. Toma nota que o comando Resolvido, na realidade, não resolve o conflito. Apenas remove os ficheiros filename.ext.mine and filename.ext.r*, para te permitir submeter as tuas alterações.

Se tens conflitos com os teus ficheiros binários, o Subversion não tenta fundir os ficheiros. O ficheiro local permanece intocável (exactamente como o alteraste) e obtens os ficheiros filename.ext.r*. Se queres descartar as tuas alterações e manter a versão do repositório, usa o comando Reverter. Se queres manter a tua versão e reescrever a versão do repositório, usa o comando Resolvido e submete a tua versão.

Podes usar o comando Resolvido para ficheiros múltiplos, se clicares na pasta pai e seleccionares TortoiseSVN → Resolvido... Isto irá mostrar a caixa de diálogo listando todos os ficheiros em conflito nessa pasta, e podes seleccionar quais é queres marcar como resolvidos.

Um conflito de propriedade ocorre quando dois (ou mais) programadores alteraram a mesma propriedade. Tal como no caso dos ficheiros, deve-se exclusivamente aos programadores a resolução do conflito.

Se uma das alterações tiver de se sobrepor a outra, então escolhe a opção para Resolver usando a propriedade local ou Resolver usando a propriedade remota. Se as alterações tem de ser integradas selecciona então Edita manualmente a propiedade, decide o valor que a propriedade deve ter e marca como resolvido.

Um conflito de árvore ocorre quando, um programador moveu/renomeou/apagou um ficheiro ou pasta que outro programador também moveu/renomeou/apagou ou apenas modificou. Existem muitas e variadas situações que podem gerar um conflito de árvore, e todas elas requerem diferentes passos para a sua resolução.

Quando no Subversion, um ficheiro é apagado localmente esse ficheiro também é apagado no sistema de ficheiros local e, mesmo que este seja parte de um conflito de árvore não poderá mostrar um ícone de conflito sobreposto, e tu não poderás clicar nele com o botão direito do rato para resolver o conflito. Usa então a caixa de diálogo Verificar alterações para aceder à opção Editar conflito.

O TortoiseSVN pode ajudar a encontrar o sítio correcto para fundir as alterações mas, poderá ser necessário trabalho adicional para resolver os conflitos. Lembra-te que após a actualização a revisão BASE de trabalho irá conter sempre a revisão de cada item como estava no repositório, na altura da actualização. Se reverteres uma alteração após a actualização esta voltará ao estado do repositório e não, à versão que estava quando começaste a efectuar as tuas alterações locais.

Figura 4.12. O explorador mostrando os ícones sobrepostos

Agora que SVN exportaste uma cópia de trabalho de um repositório Subversion, podes ver que os teus ficheiros com os ícones alterados no explorador do Windows. Esta é uma das razões porque o TortoiseSVN é tão popular. O TortoiseSVN adiciona a chamada sobreposição de ícone a cada ficheiro e que se sobrepõem ao ícone original do mesmo. Dependendo do estado Subversion do ficheiro a sobreposição do ícone será diferente.

Uma cópia de trabalho exportada de fresco possui uma marca de verificação verde como sobreposição. Isto significa que o estado Subversion é normal.

Assim que inicias a edição do ficheiro, o estado altera-se para modificado e o ícone de sobreposição muda para um ponto de exclamação vermelho. Desse modo podes facilmente ver que ficheiros foram alterados desde a última vez que actualizaste a tua cópia de trabalho e necessitam ser submetidos.

Se durante uma actualização ocorre um conflito o ícone de sobreposição altera-se para um ponto de exclamação amarelo.

Se colocaste a propriedade svn:needs-lock num ficheiro, o Subversion marca esse ficheiro como apenas-de-leitura até obteres um bloqueio nesse mesmo ficheiro. Ficheiros como esses têm essa sobreposição para indicar que tens de obter um bloqueio antes de editares esse ficheiro.

Se mantiveres um bloqueio num ficheiro e o estado Subversion é normal, esta sobreposição de ícone lembra-te que deves libertar o bloqueio se não o estás a usar, para permitir que outros possam submeter as suas alterações para o ficheiro.

Este ícone mostra que alguns ficheiros ou pastas no interior da pasta corrente foram escalonados para serem apagados do controlo de versões ou que, um ficheiro sob o controlo de versões está desaparecido na pasta.

O sinal se soma diz-te que um ficheiro ou pasta foi escalonado para ser adicionado ao controlo de versões.

O sinal de barra diz que um ficheiro ou pasta é ignorado para efeitos de controlo de versão. Esta sobreposição é opcional.

Este ícone mostra os ficheiros e pastas que não estão sob controle de versões, mas não foram ignorados. Esta sobreposição é opcional.

De facto, podes descobrir que nem todos esses ícones são usados no teu sistema. Isto ocorre porque o número de sobreposições permitidas pelo Windows é muito limitada e, se estiveres a utilizar uma versão antiga do TortoiseCVS, não existem suficientes slots para sobreposições disponíveis. O TortoiseSVN tenta ser um “Bom Cidadão (TM)” e limita o seu uso se sobreposições para também dar a oportunidade a outras aplicações.

Agora que existem vários clientes Tortoise (TortoiseCVS, TortoiseHg, ...) a limitação do ícone torna-se um problema real. Para contornar isso, o projecto TortoiseSVN introduziu um conjunto de ícones comuns e partilhados, carregados como uma DLL, que podem ser usados por todos os clientes Tortoise. Verifique com o seu provedor de cliente para ver se isso já foi integrado :-)

Para uma descrição de como as sobreposições de ícones correspondem aos estados do Subversion e outros detalhes tecnicos, lê “Sobreposição de Ícones”.

Figura 4.13. Página de propriedades do explorador, aba do Subversion

Por vezes tu queres obter informação mais detalhada sobre um ficheiro/pasta do que a da sobreposição do ícone. Podes obter toda a informação que o Subversion providencia, na caixa de diálogo de propriedades do explorador. Apenas selecciona o ficheiro ou pasta e selecciona no menu de contexto Menu do Windows → propriedades (nota: esta é a entrada normal do menu de propriedades que o explorador providência, e não a do submenu TortoiseSVN!). Na caixa de diálogo de propriedades o TortoiseSVN adicionou uma nova página de propriedades para ficheiros/pastas, sob o controlo do Subversion, onde podes ver toda a informação relevante sobre o ficheiro/pasta.

Figura 4.14. Verificar Modificações

É normalmente muito útil conhecer que ficheiros foram alterados e também quais os ficheiros que foram alterados e submetidos por outros. Isto é onde o comando TortoiseSVN → Verificar alterações... vem à mão. Esta caixa de diálogo irá mostrar-te cada ficheiro que foi alterado de algum modo na tua cópia de trabalho, tal como qualquer ficheiro não versionado que lá tiveres.

Se clicares em Verificar repositório podes então também procurar por alterações no repositório. Desse modo podes verificar, antes de uma actualização, se existe um possível conflito. Podes também actualizar ficheiros seleccionados do repositório, sem actualizar a pasta inteira. Por defeito o botão Verificar repositório só procura o estado remoto com a profundidade de exportação da cópia de trabalho. Se queres ver todos os ficheiros e pastas no repositório, mesmos aqueles que não SVN exportaste, então tens de premir continuamente a tecla Shift enquanto clicas no botão Verificar repositório.

A caixa de diálogo usa código de cores para evidenciar o estado.

Este é o esquema de cores por defeito, mas podes alterar essas cores usando a caixa de diálogo configurações. Ler “Preferências de cor do TortoiseSVN” para mais informação.

Ícones de sobreposição são usados para indicar também outros estados. A captura de ecrã abaixo mostra todas as sobreposições possíveis que poderão ser mostradas se necessário.

São mostradas sobreposições para os seguintes estados:

Itens que foram trocados para um caminho diferente no repositório são também sinalizados com um marcador (s). Podes ter trocado algo enquanto trabalhavas num ramo e te esqueceste de trocar de novo para o trunk. Isto é o teu sinal de aviso! O menu de contexto permite-te trocar de volta para o caminho normal mas uma vez.

A partir do menu de contexto da caixa de diálogo podes ver uma comparação das alterações. Marca as alterações locais que tu fizeste usando Context Menu → Comparar com a Base. Marca as alterações no repositório feitas por outros usando Menu Contexto → Mostrar diferenças como uma comparação unificada.

Podes também reverter alterações em ficheiro individuais. Se apagaste um ficheiro acidentalmente, irá aparecer como Desaparecido e podes usar Reverter para o recuperar.

Ficheiros não versionados e ignorados podem ser enviados daqui para o cesto de reciclagem usando Menu Contexto → Remover. Se quiseres remover permanentemente os ficheiros ( ignorando o cesto de reciclagem) mantém premido a tecla Shift enquanto clicas no Remover.

Se tu quiseres examinar um ficheiro em detalhe, podes arrastá-lo daqui para outro aplicativo, como um editor de texto ou IDE, ou podes salvar uma cópia simplesmente arrastando-o para uma pasta do navegador.

As colunas são costumizáveis. Se clicares com o botão direito em qualquer cabeçalho de coluna verás um menu de contexto, que te permitirá seleccionar quais as colunas a mostrar. Podes também alterar a largura da coluna usando o manípulo de arrasto que aparece quando moves o rato sobre o limite da coluna. Estas customizações são preservados para que vejas os mesmos cabeçalhos da próxima vez.

Se tiveres a trabalhar ao mesmo tempo em várias tarefas, não relacionadas, podes também agrupar os ficheiros em listas de alterações. Ler “Listas de Alterações” para mais informação.

No fundo da caixa de diálogo podes ver um sumário do intervalo de revisões do repositório em uso na tua cópia de trabalho. Essas são as revisões submetidas, não as revisões de actualizadas; Estas representam o intervalo de revisões onde esses ficheiros foram submetidas por último, e não as revisões a que foram actualizadas. De notarque o intervalo de revisões mostrada só se aplica aos itens mostrados, e não, à totalidade da cópia de trabalho. Se queres ver essa informação para a totalidade da cópia de trabalho, deves verificar a caixa de verificação Não modificado.

Muitas vezes tu queres ver os teus ficheiros por dentro para observar o que alteraste. Podes conseguir isso ao seleccionar o ficheiro que foi alterado e, seleccionando Comparar a partir do menu de contexto do TortoiseSVN. Isso arranca o visualizador de comparações externo, que então irá comparar o ficheiro corrente com a cópia pura (revisão BASE), que foi armazenada depois da última exportação SVN ou actualização.

Figura 4.18. A Caixa de Diálogo Registo de Revisão

Existem vários locais a partir dos quais podes mostrar a caixa de diálogo de Registo:

Se o repositório não está disponível, verás a caixa de diálogo Queres ficar fora de linha? descrita em “Modo Fora de Linha”.

O painel de topo tem uma coluna Acções contendo ícones que sumarizam o que foi feito na revisão. Existem quatro diferentes ícones, cada mostrada na sua coluna.

Se uma revisão modificou um ficheiro ou pasta, o ícone modificado é mostrado na primeira coluna.

Se a revisão adicionou um ficheiro ou pasta, o ícone adicionado é mostrado na segunda coluna.

Se a revisão removeu um ficheiro ou pasta, o ícone removido é mostrado na terceira coluna.

Se a revisão substituiu um ficheiro ou pasta, o ícone substituido é mostrado na quarta coluna.

If a revision moved or renamed a file or directory, the moved icon is shown in the fourth column.

If a revision replaced a file or directory by moving/renaming it, the move replaced icon is shown in the fourth column.

If a revision merged a file or directory, the merged icon is shown in the fourth column.

If a revision reverse merged a file or directory, the reverse merged icon is shown in the fourth column.

Figura 4.19. O Painel de Topo da Caixa de Diálogo Registo de Revisões com Menu de Contexto

The top pane of the Log dialog has a context menu that allows you to access much more information. Some of these menu entries appear only when the log is shown for a file, and some only when the log is shown for a folder.

Figura 4.20. A Janela de Configurações do Colaborador de Código

Figura 4.21. Menu de Contexto do Painel Superior para 2 revisões seleccionadas

Se seleccionares duas revisões de uma vez (usando o modificador usual Ctrl), o menu de contexto muda e disponibiliza menos opções:

Se seleccionares duas ou mais revisões (usando os modificadores usuais Ctrl ou Shift), o menu de contexto irá incluir uma entrada para reverter todas as alterações que foram feitas nas revisões seleccionadas. Esta é a maneira mais fácil para rebobinar um grupo de revisões de uma vez só.

Podes também escolher integrar as revisões seleccionadas noutra cópia de trabalho, como descrito acima.

Se todas as revisões seleccionadas têm o mesmo autor, podes editar o autor de todas essas revisões de uma vez só.

Figura 4.22. O Painel de fundo da Caixa de Diálogo Registo com o Menu de Contexto

The bottom pane of the Log dialog also has a context menu that allows you to

When multiple files are selected in the bottom pane of the Log dialog, the context menu changes to the following:

Figura 4.23. The Log Dialog Bottom Pane with Context Menu When Multiple Files Selected.

A caixa de diálogo de Registo não mostra sempre todas as alterações jamais feitas por um número de razões:

Se queres ver mais mensagens de registo, clica Próximos 100 para trazer as próximas 100 mensagens de registo. Podes repetir este procedimento quantas vezes necessitares.

Próximo a este botão está um botão multifunções que lembra a última opção para que o usaste. Clica na seta, para ver as outras opções disponíveis.

Usa Mostrar Intervalo... se queres ver um intervalo de revisões específica. A caixa de diálogo irá então pedir-te para introduzir a revisão de início e fim.

Usa Mostrar Tudo se queres ver todas as mensagens de registo a partir da revisão HEAD de volta até à revisão 1.

Para refrescar a última versão, no caso de ter ocorrido outras submissões enquanto a caixa de diálogo de registo estava aberta, prime a tecla F5.

Para refrescar a cache de registo, prime as teclas Ctrl-F5.

Porque a caixa de diálogo de registo te mostra o registo a partir da HEAD, e não da revisão corrente da cópia de trabalho, acontece frequentemente que são mostradas mensagens de registo para conteúdo que ainda não foi actualizado, na tua cópia de trabalho. Para ajudar a tornar isto mais claro, a mensagem de submissão que corresponde à revisão que tens na tua cópia de trabalho, é mostrada a negrito.

Quando mostras o registo para uma pasta, a revisão realçada é a mais alta revisão encontrada em qualquer ponto dentro dessa pasta, o que requere o rastreamento da cópia de trabalho. O rastreamenteo é feito numa thread separada, para que não atrase a visualização do registo, mas como resultado o realce para pastas poderá não aparecer imediatamente.

O Subversion 1.5 e superior mantém o registo das integrações recorrendo ao uso de propriedades. Isto permite-te obter um histórico mais detalhado das alterações integradas. Por exemplo, se desenvolveres uma nova funcionalidade num ramo e a seguir integras esse ramo de volta para o trunk, a funcionalidade desenvolvida irá ser mostrada no registo do trunk, como uma única submissão para a integração, mesmo que tenha havido 1000 submissões durante o desenvolvimento do ramo.

Figura 4.24. A Caixa de Diálogo Registo Mostra Rasto das Revisões de Integração

Se quiseres ver o detalhe de quais revisões que foram integradas como parte dessa submissão, usa a caixa de verificação Incluir revisões integradas. Isto irá outra vez buscar as mensagens de registo, mas também irá colocar entrefolhas as mensagens de registo das revisões que foram submetidas. Revisões integradas são mostradas a cinzento, porque representam alterações feitas numa parte diferente da árvore.

É claro que integrar nunca é simples! Durante o desenvolvimento da funcionalidade no ramo, irão provavelmente ocorrer integrações ocasionais de volta para o trunk, de modo a manter o ramo em sincronismo com a linha de código principal.

As propriedades de revisão são completamente diferentes das propriedades do Subversion de cada item. Revprops são itens descritivos que são associados a um número de revisão específico no repositório, como as mensagens de registo, data de submissão e autor da submissão (autor).

Por vezes poderás querer modificar a mensagem de registo que anteriormente introduziste, talvez porque contêm o erro de ortografia, ou queres melhorar a mensagem, ou muda-la por outras razões. Ou queres alterar o autor da submissão porque de esqueces-te de activar a autenticação, ou...

Subversion lets you change revision properties any time you want. But since such changes can't be undone (those changes are not versioned) this feature is disabled by default. To make this work, you must set up a pre-revprop-change hook. Please refer to the chapter on Hook Scripts in the Subversion Book for details about how to do that. Read “Scripts de gancho de servidor” to find some further notes on implementing hooks on a Windows machine.

Uma vez que tenhas configurado o teu servidor com os ganchos pretendidos, podes mudar o autor e a mensagem de registo ( ou qualquer outra revprop) de qualquer revisão, usando o menu de contexto do painel de topo da caixa de diálogo Registo. Podes também editar a mensagem de registo usando o menu de contexto no painel do meio.

Se queres restringir as mensagens de registo, para mostrar só as que estás interessado em vez de percorreres uma lista de centenas, podes usar os controlos de filtros no topo da caixa de diálogo Registo. Os controlos de início e fim de data permite-te restringir a visualização a um intervalo de datas. A caixa de pesquisa permite-te mostrar só mensagens que contêm uma frase particular.

Clica no ícone de pesquisa para seleccionar qual a informação que queres procurar, e para escolher o modo regex. Normalmente só precisarás uma simples procura de uma sub-cadeia de caracteres, mas se precisas de termos de pesquisa mais flexíveis podes usar expressões regulares. Se mantiveres o rato sobre a caixa, uma etiqueta dar-te-á palpites em como usar as funções regex, ou as funções de sub-cadeias de caracteres. O filtro funciona verificando se a tua frase de pesquisa condiz com as entradas do registo, então só as entradas que condizem com a frase do filtro são mostradas.

Simple sub-string search works in a manner similar to a search engine. Strings to search for are separated by spaces, and all strings must match. You can use a leading - to specify that a particular sub-string is not found (invert matching for that term), and you can use ! at the start of the expression to invert matching for the entire expression. You can use a leading + to specify that a sub-string should be included, even if previously excluded with a -. Note that the order of inclusion/exclusion is significant here. You can use quote marks to surround a string which must contain spaces, and if you want to search for a literal quotation mark you can use two quotation marks together as a self-escaping sequence. Note that the backslash character is not used as an escape character and has no special significance in simple sub-string searches. Examples will make this easier:

Alice Bob -Eve
      

searches for strings containing both Alice and Bob but not Eve

Alice -Bob +Eve
      

searches for strings containing both Alice but not Bob, or strings which contain Eve.

-Case +SpecialCase
      

searches for strings which do not contain Case, but still include strings which contain SpecialCase.

!Alice Bob
      

searches for strings which do not contain both Alice and Bob

!-Alice -Bob
      

do you remember De Morgan's theorem? NOT(NOT Alice AND NOT Bob) reduces to (Alice OR Bob).

"Alice and Bob"
      

searches for the literal expression “Alice and Bob”

""
      

searches for a double-quote anywhere in the text

"Alice says ""hi"" to Bob"
      

searches for the literal expression “Alice says "hi" to Bob”.

Descrever o uso de expressões regulares em buscas está para além do âmbito deste manual, mas podes encontrar documentação em linha e um tutorial em http://www.regular-expressions.info/.

De salientar que esses filtros actuam nas mensagens já adquiridas. Eles não controlam o descarregamento de mensagens do repositório.

Podes também filtrar os nomes de caminhos, no painel de fundo, usando a caixa de verificação Mostrar só caminhos afectados. Caminhos afectados são aqueles que contêm o caminho usado para mostrar o registo. Se fores buscar o registo para uma pasta, isso significa qulquer coisa nessa pasta ou abaixo. Para um ficheiro isso significa só um ficheiro. Normalmente a lista de caminhos mostra qualqueis outros caminhos que foram afectados pela mesma submissão, mas a cinzento. Se a caixa estiver verificada esses caminhos são escondidos.

Por vezes as tuas práticas de trabalho iram requerer que as tuas mensagens de registo sigam um formato particular, o que significa que o texto que descreve as alterações não é visível no sumário abreviado mostrado no painel de topo. A propriedade tsvn:logsummary pode ser utilizada para extrair uma parte da mensagem de registo para ser mostrada no painel de topo. Ler “Propriedades de Projecto TortoiseSVN” para descobrir como usar esta propriedade.

O botão Estatísticas abre uma caixa que, mostra alguma informação interessante sobre as revisões mostradas na caixa de diálogo Registo. Essa mostra quantos autores estiveram a trabalhar, quantas submissões eles fizeram, o progresso por semana e muito mais. Agora podes ver por alto que trabalhou mais arduamente e quem esteve na balda ;-)

Página de Submissões por Autor

Figura 4.25. Histograma de Submissões-por-Autor

Este grafo mostra quais os autores que têm estado activos no projecto como um simples histograma, histograma empilhado ou gráfico de queijo.

Figura 4.26. Gráfico de queijo Submissões-por-Autor

onde há alguns grandes autores e muitos pequenos contribuidores, o número de pequenos segmentos pode tornar o gráfico mais difícil de ler. O controlo deslizante no fundo permite-te colocar um limite (como precentagem do total de submissões) abaixo do qual, qualquer actividade é agrupado na categoria Outros.

Página de Submissões por data

Figura 4.27. Gráfico de Submissões-por-data

Esta página dá-te uma representação gráfica da actividade do projecto em termos de, número de submissões e autor. Isto dá alguma ideia de quando um projecto está a ser trabalhado, quem esteve a trabalhar a que altura.

Quando existem vários autores irás obter muitas linhas no gráfico. Existem duas vistas disponíveis aqui: normal, onde a actividade de cada autor é relativa à linha base e, empilhada, onde a actividade de cada autor é relativa à linha de baixo. A última opção evita o cruzamento de linhas que pode tornar o gráfico mais fácil de ler, mas menos fácil para ver a produção de um determinado autor.

Por defeito, a analise é sensível a maiúsculas e minúsculas, pelo que os utilizadores PeterEgan e PeteRegan são tratados como autores diferentes. No entanto, em muitos casos, os nomes de utilizadores não são sensíveis a maiúsculas e minúsculas, e são por vezes introduzidos inconsistentemente, pelo que poderás querer que o DavidMorgan e o davidmorgan sejam tratados como a mesma pessoa. Usar a caixa de verificação Autores sensíveis a maiúsculas e minúsculas para controlar como este caso é tratado.

Ter em atenção que as estatísticas cobrem o mesmo período que a caixa de diálogo Registo. Se esta só mostra uma revisão então as estatísticas não te dirão muito.

Figura 4.28. Caixa de diálogo Colocar-se em Fora de Linha

Se o servidor não está disponível e tens a cache de registo activada, podes usar a caixa de diálogo e o navegador de revisões no modo fora de linha. Usando dados da cache que te permite continuar a trabalhar, apesar de a informação não estar actualizada ou mesmo completa.

Aqui tens três opcões:

A caixa de verificação Tornar isto por defeito previne esta caixa de diálogo de reaparecer, e escolhe sempre a opção que escolheres a seguir. Podes ainda mudar (ou remover) a opção por defeito, após a teres efectuado, a partir de TortoiseSVN → Preferências.

Se queres verificar o servidor novamente por novas mensagens de registo, podes simplesmente refrescar a vista usando F5. Se tiveres a usar a cache de registo (disponível por defeito), esta irá verificar o repositório por novas mensagens e trazer só as novas. Se a cache de registo estava em modo fora-de-linha esta irá também tentar voltar a estar em linha.

Se está a utilizar a cache de registo e pensas que o conteúdo da mensagem ou o autor tenha mudado, podes usar Shift-F5 ou Ctrl-F5 para rebuscar as mensagens mostradas a partir do servidor e actualizar a cache de registo. De notar que isto só afecta as mensagens mostradas correntemente, e não invalida a totalidade da cache para esse repositório.

Se tens configurada uma ferramenta de comparação de terceiros, podes usar Shift quando seleccionares o comando de Comparação, para usar a ferramenta alternativa. Consulta “Preferências de Programas Externos” para descobrires como configurar outras ferramentas de comparação.

Por vezes no tempo de vida do projecto poderás alterar os fim-de-linha de CRLF para LF, ou poderás alterar a indentação de uma secção. Infelizmente isto irá marcar um grande número de linhas como alteradas, mesmo que não haja alterações de significado no código. Estas opções te irão ajudar a gerir essas alterações quando for altura de comparar e aplicar as diferenças. Irás ver essas definições nas caixas de diálogo Integrar e Responsabilizar, tal como nas definições para o TortoiseMerge.

Ignorar fins-de-linha exclui alterações que são exclusivamente devidas a diferenças no estilo de fim-de-linha.

Comparar espaços em branco inclui todas as alterações na indentação e espaços-em-branco em linha, como linhas adicionadas/removidas.

Ignorar alterações de espaços em branco exclui alterações que são exclusivamente devidas à mudança na quantidade ou tipo de espaços em branco, e.g. alterando a indentação ou alterando tabulações para espaços. Adicionando espaços em branco onde antes nenhum existia, ou remover completamente um espaço em branco, será sempre mostrado como uma alteração.

Ignorar todos os espaços em branco exclui todas as alterações relacionadas só com espaços em branco.

Naturalmente qualquer linha com conteúdo alterado será sempre incluída na comparação.

Figura 4.29. A Caixa de Diálogo Comparar Revisões

Quando seleccionas duas árvores no interior do navegador de repositório ou quando seleccionas duas revisões de uma pasta na caixa de diálogo, podes Context menu → Comparar revisões.

Esta caixa de diálogo mostra a lista de todos os ficheiros que foram alterados, permitindo-te compará-los ou responsabiliza-los individualmente, usando o menu de contexto.

Podes exportar uma árvore de alterações, que é útil se necessitas de enviar a alguém a estrutura da árvore do teu projecto, mas contendo apenas aqueles ficheiros que foram alterados. Esta operação funciona só em ficheiros alterados, pelo que só precisas de seleccionar os ficheiros de interesse - o que normalmente significa todos - e depois Menu de contexto → Exportar selecção para.... Serás solicitado a introduzir uma localização para guardar a árvove de alterações.

Podes também exportar a lista de ficheiros alterados para um ficheiro de texto, usando Menu de contexto → Guardar lista de ficheiros seleccionados para....

Se queres exportar a lista de ficheiros e também as acções (modificada, adicionada,removida), poderás faze-lo usando Menu de contexto → Copiar selecção para a área de transferência.

O botão no topo permite-te alterar a direcção da comparação. Podes mostrar as alterações necessárias para ir de A a B, ou se preferires, de B a A.

Os botões com os números de revisão podem ser usados para mudar para um intervalo de revisões diferentes. Quando alteras o intevalo, a lista de itens, que diferem entre revisões, será actualizada automaticamente.

Se a lista de nomes de ficheiros é muito extensa podes utilizar a caixa de pesquisa, para assim reduzir a lista para ficheiros cujo nome contêm um texto específico. Ter em atenção que é usada uma pesquisa de texto simples, e se queres restringir a lista a ficheiro de fonte de C, deverás introduzir .c em vez de *.c.

Existem muitas ferramentas disponíveis para comparar ficheiros de texto, incluindo o nosso TortoiseMerge, mas com frequência estamos também à espera de ver como um ficheiro de imagem foi alterado. É por isso que criámos o TortoiseIDiff.

Figura 4.30. O leitor de diferenças de imagem

TortoiseSVN → Comparar para qualquer formato de imagem comum, irá arrancar o TortoiseIDiff para mostrar diferenças de imagem. Por defeito as imagens são mostradas lado-a-lado, mas em vez de, podes usar o menu Vista ou a barra de ferramentas para comutar para uma vista cima-baixo, ou se preferires podes sobrepor as imagens e fingir que estás a usar uma mesa de luz.

Naturalmente que podes aplicar mais ou menos zoom e posicionar a imagem. Podes também posicionar a imagem apenas por arrastá-la com o botão direito do rato. Se seleccionares a opção Ligar posições das imagens, os controlos de posicionamento (barras e rolar, roda do rato) ficaram ligados.

Uma caixa de informação de imagem mostra os detalhes sobre a mesma, como o tamanho em píxeis, resolução e nível de cor. Se esta caixa está a atrapalhar usa View → Image Info para a esconder. Podes obter a mesma informação numa etiqueta, se mantiveres o rato sobre a barra de título da imagem.

Quando as imagens estão sobrepostas, a intensidade relativa das mesmas (mistura alfa) é controlada por um controlo de deslocamento no lado esquerdo. Podes clicar em qualquer ponto do controlo de deslocamento para configurares a mistura directamente, ou podes arrastá-lo para alterares a mistura iterativamente. Ctrl+Shift-Rodal para alterar a mistura.

O botão por cima do controlo de deslocamento alterna entre as misturas de 0% e 100%, e se efectuares duplo clique no botão, a mistura alterna automaticamente a cada segundo até clicares no botão novamente. Isto pode ser útil quando olhamos para pequenas alterações múltiplas.

Por vezes queres ver uma diferença em vez de uma mistura. Poderás ter os ficheiros de imagem de duas revisões de um placa de circuito impresso e querer ver quais as pistas que foram alteradas. Se desactivares o modo mistura alfa, a diferença irá ser mostrada como uma XOR dos valores de cor dos píxeis. Áreas inalteradas serão brancas e as alterações coloridas.

Quando queres comparar documentos não-textuais normalmente terás de utilizar o software usado para criar o documento, já que ele entende o formato do ficheiro.Para as suites do Microsoft Office e Open Office, normalmente usadas, existe realmente algum suporte para a visualização das diferenças e o TortoiseSVN inclui scripts para os invocar com as definições correctas ao comparar ficheiros com essas extensões bem conhecidas. Podes verificar que extensões de ficheiros são suportadas e adicionar a tua própria indo à secção TortoiseSVN → Definições e clicar Avançado em Programas Externos

Se as ferramentas fornecidas não fazem o que precisas, experimenta uma das muitas ferramentas comerciais ou open-source disponíveis. Toda a gente tem as suas favoritas e esta lista está longe de estar completa, no entando, aqui estão algumas que poderás levar em consideração:

Consultar “Preferências de Programas Externos” para mais informações em como configurar o TortoiseSVN para usar essas ferramentas.

O ignorar padrões no Subversion usa caracteres de substituição do nome de ficheiro, uma técnica usada no Unix para especificar ficheiros recorrendo a meta-caracteres e wildcards (caracteres de substituição). Os seguintes caracteres têm significado especial:

Correspondência de padrões é sensível a maiúsculas e minúsculas, o que pode causar problemas no Windows. Podes forçar a insensibilidade a maiúsculas e minúsculas à bruta ao emparelhar caracteres, e.g. para ignorar *.tmp, independentemente do tamanho de letra, podes usar um padrão como *.[Tt][Mm][Pp].

Se queres uma definição oficial para caracters de substituição de nome de ficheiro, podes encontrá-la nas especificações do IEEE para a linguagem de comando da da linha de comandos (shell) Pattern Matching Notation.

Para remover ficheiros ou pastas do Subversion usa TortoiseSVN → Remover.

Quando TortoiseSVNRemover

Se queres remover um tem do repositório, mas mantê-lo localmente como um ficheiro/pasta não versionado, usa Menu de Contexto Extendido → Remover (manter local). Tens de manter premida a tecla Shift enquanto clicas com o botão direito no item, no painel lista do explorador (painel direito), de modo a veres isto no menu de contexto estendido.

If an item is deleted via the explorer instead of using the TortoiseSVN context menu, the commit dialog shows those items as missing and lets you remove them from version control too before the commit. However, if you update your working copy, Subversion will spot the missing item and replace it with the latest version from the repository. If you need to delete a version-controlled file, always use TortoiseSVN → Delete so that Subversion doesn't have to guess what you really want to do.

Se queres fazer um simples renomear no lugar de um ficheiro ou pasta, usa Context Menu → Alterar nome... Insere o novo nome para o item e está feito.

Se pretendes mover ficheiros dentro da tua cópia de trabalho, talvez para uma subpasta diferente, usa o manípulo de arrastar-e-largar do botão direito do rato:

Outra maneira de mover ou copiar ficheiros, é usar os comandos de copiar/cortar do Windows. Selecciona os ficheiros que queres copiar, clica com o botão direito e escolhe a partir do menu de contexto do explorador Menu de Contexto → Copiar. Então navega para a pasta destino, clica com o botão direito e escolhe TortoiseSVN → Colar. Para mover ficheiros, escolhe Menu de Contexto → Cortar em vez de Menu de Contexto → Copiar.

Podes também usar o navegador de repositório para mover itens no mesmo. Consultar “O Navegador de Repositório” para saberes mais.

Se o repositório já contém dois ficheiros com o mesmo nome, diferindo apenas nas miúsculas e minúsculas (e.g. TEST.TXT e test.txt), não conseguirás actualizar ou SVN exportar a pasta pai num cliente Windows. Enquanto o Subversion suporta nomes de ficheiros sensíveis a miúsculas e minúsculas, o Windows não.

Isto por vezes acontece quando duas pessoas submetem, a partir de cópias de trabalho separadas, ficheiros que por acaso têm o mesmo nome mas com uma diferença de maiúsculas e minúsculas. Pode também acontecer quando os ficheiros são submetidos a partir de um sistema, com um sistema de ficheiros sensível a maiúsculas e minúsculas, como o Linux.

Nesse caso tens de decidir qual o que queres manter e remover (ou alterar o nome) do outro no repositório.

Por vezes o teu IDE amigável irá renomear ficheiros por ti como parte de um processo de refactoração, e claro não irá avisar o Subversion. Se tentares submeter as tuas alterações, o Subversion irá ver o velho ficheiro como desaparecido e o novo como ficheiro não versionado. Poderias apenas adicionar o ficheiro ao controlo de versões, mas assim perderias a sua história, já que o Subversion não sabe que ambos os ficheiros estão relacionados.

Uma melhor maneira será, notificar o Subversion de que esta alteração é na realidade uma alteração de nome, e poderás faze-lo dentro das caixas de diálogo Submeter e Verificar alterações. Simplesmente selecciona ambos os ficheiros, o com nome antigo (em falta) e o com o novo nome (não versionado), e usa Context Menu → Reparar movimento para emparelhar os dois ficheiros como uma renomeação.

Normalmente tu configuras a tua lista de ignorados tal que todos os ficheiros gerados sejam ignorados pelo Subversion. Mas se queres limpar todos esse itens ignorados de modo a produzir uma versão limpa? Por norma tu inserias isso na tua makefile, mas se quiseres depurar a tua makefile ou alterar o sistema de build, será útil ter uma maneira de limpar a casa.

O TortoiseSVN disponibiliza tal opção usando Menu de Contexto Estendido → Remover itens sem controle de versão.... Tens de manter premida a tecla Shift enquanto clicas com o botão direito na pasta, no painel de lista do explorador (painel direito) de modo a veres isto no menu de contexto estendido. Esta acção irá abrir uma caixa de diálogo que listará todos os ficheiros não versionados em qualquer ponto da tua cópia de trabalho. Podes então seleccionar ou desseleccionar os itens a remover.

Quando tais itens são removidos é usando o cesto de reciclagem para que no caso de te enganares e removeres um ficheiro que deveria estar versionado, poderes ainda recuperá-lo.

Figura 4.37. Página de propriedades do Subversion

Podes ler e acertar as propriedades do Subversion a partir da caixa de diálogo das propriedades do Windows, mas também a partir de TortoiseSVN → propriedades e do interior das listas de estado do TortoiseSVN, ou seja Menu de contexto → propriedades.

Podes adicionar as tuas próprias propriedades, ou algumas propriedades com significado especial para o Subversion. Essas começam com svn:. svn:externals é uma dessas propriedades; Descobre como lidar com externos em “Itens Externos”.

For more information about properties in Subversion see the Special Properties.

Adicionando e Editando Propriedades

Figura 4.38. Adicionando propriedades

Para adicionar uma nova propriedade, clica primeiro em Nova.... Selecciona o nome da propriedade pretendida a partir do menu, e preenche então a informação pretendida na caixa de diálogo específica da propriedade. Essas caixas de diálogo específicas das propriedades são descritas em maior detalhe em “Editores de Propriedades”.

Para adicionar uma propriedade que não tem a sua própria caixa de diálogo, selecciona Avançado a partir do menu Novo....

Se queres aplicar uma propriedade a vários itens de uma só vez, selecciona os ficheiros/pastas no explorador e então selecciona Menu de contexto → propriedades.

Se queres aplicar a propriedade a cada ficheiro e pasta na hierarquia abaixo da pasta corrente, verifica a caixa de verificação Recursiva.

Se desejas editar uma propriedade que já exista, selecciona essa propriedade a partir da lista das propriedades existentes e clica em Editar....

Se desejas remover uma propriedade que já exista, seleciona essa propriedade da lista de propriedades existentes e clica em Remover.

A propriedade svn:externals pode ser usada para puxar outros projectos do mesmo repositório ou de um repositório completamente diferente. Para mais informação, consultar “Itens Externos”.

Edita propriedades na revisão HEAD

Porque as propriedades são versionadas, não poderás editar as propriedades das versões anteriores. Se olhares para as propriedades a partir da caixa de diálogo de registo, ou a partir de uma revisão não-HEAD no navegador de repositório, irás ver uma lista de propriedades e valores, mas sem controlos de edição.

O TortoiseSVN tem algumas propriedades próprias, e essas começam por tsvn:.

O TortoiseSVN pode-se integrar com algumas ferramentas de controlo de problemas. Isto usa as propriedades de projecto que começam com bugtraq:. Consulta “Integração com Sistemas de controlo de problemas/Gestores de Problemas” para mais informação.

Podes ainda integrar com alguns navegadores de repositório web-based, usando as propriedades de projecto que começam por webviewer:. Consulta “Integração com visualizadores de repositório Web-based” para mais informação.

Quando adicionas novas subpastas a uma cópia de trabalho, usando o TortoiseSVN, quaisquer propriedades de projecto presentes na pasta pai serão automaticamente adicionadas à nova pasta filho também.

Algumas propriedades têm de usar valores específicos, ou estarem formatadas de uma determinada maneira de modo a serem usadas para automação. Para ajudar a obter a formatação correcta, o TortoiseSVN apresenta caixas de edição para certas propriedades em particular que mostram os valores possíveis, ou quebram a propriedade em componentes individuais.

Conteúdo Externo

Figura 4.41. Página de propriedade svn:externals

A propriedade svn:externals pode ser usada para introduzir outros projectos do mesmo repositório ou de um repositório totalmente diferente, como descrito em “Itens Externos”.

You need to define the name of the sub-folder that the external folder is checked out as, and the Subversion URL of the external item. You can check out an external at its HEAD revision, so when the external item changes in the repository, your working copy will receive those changes on update. However, if you want the external to reference a particular stable point then you can specify the specific revision to use. IN this case you may also want to specify the same revision as a peg revision. If the external item is renamed at some point in the future then Subversion will not be able to update this item in your working copy. By specifying a peg revision you tell Subversion to look for an item that had that name at the peg revision rather than at HEAD.

The button Find HEAD-Revision fetches the HEAD revision of every external URL and shows that HEAD revision in the rightmost column. After the HEAD revision is known, a simple right click on an external gives you the command to peg the selected externals to their explicit HEAD revision. In case the HEAD revision is not known yet, the right click command will fetch the HEAD revision first.

Palavras-chave SVN

Figura 4.42. Página de propriedade svn:keywords

Selecciona as palavras-chave que gostarias de ver expandidas no teu ficheiro.

Estilo EOL

Figura 4.43. Página de propriedade svn:eol-style

Selecciona o estilo de fim-de-linha que desejas usar e o TortoiseSVN irá utilizar o valor correcto da propriedade.

Integração do Controlador de Problemas

Figura 4.44. Página de propriedade tsvn:bugtraq

Tamanhos das mensagens de registo

Figura 4.45. Página de propriedade do tamanho das mensagens de registo

These 3 properties control the formatting of log messages. The first 2 disable the OK in the commit or lock dialogs until the message meets the minimum length. The border position shows a marker at the given column width as a guide for projects which have width limits on their log messages. Setting a value to zero will delete the property.

Língua do Projecto

Figura 4.46. Página de propriedade da Língua

Escolhe a linguagem a usar para verificar ortografia nas mensagens de registona caixa de diálogo submeter. A caixa de verificação de lista de ficheiros têm utilidade quando clicas à direita no painel de mensagem e seleccionas Colar lista de ficheiros. Por defeito o estado do Subversion será mostrado na lingua local. Quando esta caixa está sinalizada o estado é sempre dado em Inglês, para projectos que requerem mensagens de registo apenas em Inglês.

MIME-type

Figura 4.47. Página de propriedade svn:mime-type

svn:needs-lock

Figura 4.48. Página de propriedade svn:needs-lock

Esta propriedade simplesmente controla quando um ficheiro será obtido (checkout) como apenas de leitura, se não existir nenhum bloqueio detido para ele na cópia de trabalho.

svn:executable

Figura 4.49. Página de propriedade svn:executable

Esta propriedade controla se será dado o estado de executável a um ficheiro, quando for obtido (checkout) num sistema Unix/Linux. Não tem efeito num checkout em Windows.

Templates de mensagens de registo

Quando são integradas as revisões na cópia de trabalho, o TortoiseSVN gera uma mensagem de registo para todas as revisões integradas. Essas ficam então disponíveis a partir do botão Mensagens recentes na janela de diálogo submeter.

Podes personalizar essa mensagem gerada com as seguintes propriedades:

Figura 4.50. Caixa de propriedades integra templates de mensagens de registo

tsvn:mergelogtemplatetitle, tsvn:mergelogtemplatereversetitle

Esta propriedade específica a primeira parte da mensagem de registo gerada. As próximas palavras-chave podem ser usadas:

{revisions}

Lista de revisões integradas, separadas por virgulas, e.g., 3, 5, 6, 7

{revisionsr}

Como {revisions},mas com cada revisão precedida com um r, e.g., r3, r5, r6, r7

{revrange}

Lista de revisões integradas separadas por virgulas, se possivel agrupadas em intervalos, e.g., 3, 5-7

{mergeurl}

O URL fonte da integração, i.e., de onde são integradas as revisões.

O valor por defeito para esta string é Merged revision(s) {revrange} from {mergeurl}: com uma linha nova no fim.

tsvn:mergelogtemplatemsg

Esta propriedade especifica como o texto em cada revisão integrada deve ficar formatado. Podem ser usadas as seguintes palavras chave:

{msg}

A mensagem de registo da revisão integrada, como foi introduzida.

{msgoneline}

Como o {msg}, mas todas as linhas novas são substituídas por um espaço, para que toda a mensagem de registo apareça numa única linha.

{author}

O autor da revisão integrada.

{rev}

A própria revisão integrada.

{bugids}

Os IDs dos problemas da revisão integrada, se existirem.

tsvn:mergelogtemplatemsgtitlebottom

This property specifies the position of the title string specified with the tsvn:mergelogtemplatetitle or tsvn:mergelogtemplatereversetitle. If the property is set to yes or true, then the title string is appended at the bottom instead of the top.

Importante

Isto só funciona se as revisões integradas já estão na cache de registo. Se desactivaste a cache de registo ou não indicaste o registo antes do merge, a mensagem gerada não irá então conter qualquer informação sobre as revisões integradas.

Digamos que efectuas o checkout da cópia de trabalho do /project1 para D:\dev\project1. Selecciona a pasta D:\dev\project1, clica à direita e a partir do menu de contexto selecciona Menu Windows → Propriedades. Aparecerá a caixa de diálogo Propriedades. Vai então à aba Subversion. Aqui podes colocar propriedades. Clica Properties.... Na caixa de diálogo propriedades, ou efectuas duplo clique na svn:externals se já existir, ou clicas no botão Novo... e seleccionas externos a partir do menu. Para adicionar um novo externo, clica Novo... e então preenche a informação requerida na caixa de diálogo mostrada.

Se queres que o caminho local inclua espaços ou outro caracter especial, tens rodeá-lo em aspas, ou usar o caracter \ (barra invertida), como um caracter de escape, ao estilo da linha de comandos do linux, precedendo cada caracter especial. É claro que isto também significa que tens de necessáriamente usar / (barra), como delimitador de caminho. De notar que este comportamento é novo no Subversion 1.6 e, não funcionará com clientes mais antigos.

Se o projecto externo está no mesmo repositório, qualquer alteração que lá fizeres, será incluida na lista de submissões, quando submeteres o teu projecto principal.

If the external project is in a different repository, any changes you make to the external project will be shown or indicated when you commit the main project, but you have to commit those external changes separately.

Se usares URLs absolutos nas definições svn:externals, e tiveres de transferir a tua cópia de trabalho (i.e., se o URL do teu repositório se alterar), então os teus externos não se alterarão e poderão não mais funcionar.

Para evitar tais problemas, o cliente Subversion, na versão 1.5 ou superior, suporta URLs externos relativos. São suportados quatro diferentes métodos de especificar um URL relativo . Nos exemplos seguintes assume-se que temos dois repositórios: um em http://example.com/svn/repos-1 e outro em http://example.com/svn/repos-2. Temos um SVN exportado do http://example.com/svn/repos-1/project/trunk em C:\Working e a propriedade svn:externals está colocada no trunk.

You can also specify a peg and operative revision for the URL if required. To learn more about peg and operative revisions, please read the corresponding chapter in the Subversion book.

Se necessitas de mais informação em como o TortoiseSVN lida com Propriedades, consulta “Configurações de Projecto”.

Para saberes mais sobre os diferentes métodos de aceder a subprojectos comuns, consulta “Incluir um subprojecto comum”.

A partir do Subversion 1.6 podes adicionar um ficheiro único externo, à tua cópia de trabalho, usando a mesma sintaxe que as pastas. No entanto, existem algumas restrições.

Um ficheiro externo comporta-se apenas como qualquer outro ficheiro versionado em vários aspectos, mas eles não podem ser movidos ou apagados, usando os comandos normais; a propriedade svn:externals terá de ser então modificada.

If you already have a working copy of the files or folders you want to include as externals in another working copy, you can simply add those via drag and drop from the windows explorer.

Simply right drag the file or folder from one working copy to where you want those to be included as externals. A context menu appears when you release the mouse button: SVN Add as externals here if you click on that context menu entry, the svn:externals property is automatically added. All you have to do after that is commit the property changes and update to get those externals properly included in your working copy.

Se importaste o teu projecto com a estrutura de pastas recomendada, criar uma versão ramo ou etiqueta é muito simples:

Figura 4.51. A Caixa de Diálogo de Ramificar/Etiquetar

Selecciona na tua cópia de trabalho a pasta para que queres copiar o ramo ou etiqueta, então selecciona o comando TortoiseSVN → Ramificar/Etiquetar....

The default destination URL for the new branch will be the source URL on which your working copy is based. You will need to edit that URL to the new path for your branch/tag. So instead of

http://svn.collab.net/repos/ProjectName/trunk
      

you might now use something like

http://svn.collab.net/repos/ProjectName/tags/Release_1.10
      

If you can't remember the naming convention you used last time, click the button on the right to open the repository browser so you can view the existing repository structure.

Agora tens de seleccionar a fonte da cópia. Aqui tens três opções:

Se queres que a tua cópia de trabalho seja automaticamente trocada para o ramo recentemente criado, usa a caixa de verificação Trocar a cópia de trabalho para o novo ramo/etiqueta. Mas se o fizeres, tem primeiro a certeza de que a tua cópia de trabalho não contém alterações. Se tiver, essas alterações serão fundidas na CT do ramo, quando fizeres a troca.

If your working copy has other projects included with svn:externals properties, those externals will be listed at the bottom of the branch/tag dialog. For each external, the target path and the source URL is shown.

If you want to make sure that the new tag always is in a consistent state, check all the externals to have their revisions pinned. If you don't check the externals and those externals point to a HEAD revision which might change in the future, checking out the new tag will check out that HEAD revision of the external and your tag might not compile anymore. So it's always a good idea to set the externals to an explicit revision when creating a tag.

The externals are automatically pinned to either the current HEAD revision or the working copy BASE revision, depending on the source of the branch/tag:

Prime OK para submeter a nova cópia para o repositório. Não te esqueças de introduzir uma mensagem de registo. De notar que a cópia é criada dentro do repositorio.

Ter em atenção que, a não ser que troques a tua cópia de trabalho para o ramo recentemente criado, a criação de um ramo ou etiqueta não afecta a tua cópia de trabalho. Mesmo que cries o ramo a partir da tua cópia de trabalho, essas alterações são submetidas para o novo ramo, e não para o trunk, no entanto a tua CT será ainda marcada como modificada em relação ao trunk.

Tu também podes criar um ramo ou etiqueta sem ter uma cópia de trabalho. Para o fazeres, abre o navegador de repositório. Aí podes arrastar pastas para uma nova localização. Terás de manter premida a tecla Ctrl enquanto arrastas de modo a criar uma cópia, de outro modo a pasta é movida, e não copiada.

Podes também arrastar uma pasta com o botão direito do rato. Uma vez que libertes o botão, poderás escolher, a partir do menu de contexto, o que quererás fazer com a pasta a ser movida ou copiada. é claro que para criar um ramo ou etiqueta, tu tens de copiar a pasta e não movê-la.

No entanto, a outra maneira é a partir da caixa de diálogo registo. Podes visualizar a caixa de diálogo registo para o e.g. trunk, selecciona a revisão (a revisao HEAD no topo ou uma revisão anterior), clica com o botão direito e escolhe criar ramo/etiqueta a partir da revisão....

...essa não é (realmente) a questão. Enquanto um SVN exportar descarrega tudo a partir de um ramo do repositório para a tua cópia de trabalho, TortoiseSVN → Trocar... apenas transfere os dados alterados, para a tua cópia de trabalho. Óptimo para a carga na tua rede e bom para a tua paciência. :-)

Para poderes trabalhar com o teu ramo ou etiqueta criado de fresco tens várias opções:

Figura 4.52. A Caixa de Diálogo Trocar

Apesar de o próprio Subversion não fazer distinção entre etiquetas e ramos, a maneira como eles tipicamente são usados difere um pouco.

Figura 4.53. O Assistente de Integração - Seleciona o Intervalo de Revisões

No campo De: introduz o URL completo da pasta, do ramo ou etiqueta que contêm as alterações que queres portar para a tua cópia de trabalho. Podes também clicar ... para navegar no repositório e encontrar o ramo desejado. Se já integraste anteriormente deste ramo, usa apenas a lista drop down que mostra o histórico dos URLs previamente utilizados.

If you are merging from a renamed or deleted branch then you will have to go back to a revision where that branch still existed. In this case you will also need to specify that revision as a peg revision in the range of revisions being merged (see below), otherwise the merge will fail when it can't find that path at HEAD.

No campo Intervalo de revisões a integrar introduz a lista de revisões que desejas integrar. poderá ser uma única revisão, uma lista de revisões específicas separadas por virgulas, ou um intervalo de revisões separadas por um hífen, ou uma qualquer combinação destes.

Se precisas de especificar uma revisão cavilha para a integração, adiciona a revisão cavilha no fim das revisões, e.g. 5-7,10@3. No exemplo acima, as revisões 5,6,7 e 10 seriam integradas, sendo a 3 a revisão cavilha.

A maneira mais fácil para seleccionar o intervalo de revisões que precisas é clicar no Mostrar registo, já que este irá listar as alterações mais recentes com os teus comentários de registo. Se queres integrar as alterações a partir de uma única revisão, selecciona apenas essa revisão. Se queres integrar as alterações de várias revisões então, selecciona esse intervalo (usando o modificador usual Shift). Clica no OK e o números da lista de revisões a integrar serão preenchidas por ti.

Se queres remover alterações integradas, da tua cópia de trabalho, para reverter uma alteração que já foi submetida, selecciona as revisões a reverter e tem a certeza que a caixa de verificação Reverter integração está verificada.

Se já integraste algumas alterações deste ramo, espera-se que tenhas introduzido, uma nota da última revisão integrada, na mensagem de registo quando submeteste a alteração. Nesse caso podes usar o Mostrar Registo na cópia de trabalho para seguir essa mensagem de registo. Relembrando que estamos a pensar nas revisões como listas-de-alterações, deverás usar a revisão depois do ponto de chegada da última integração, como ponto de partida para esta integração. Por exemplo, se integraste as revisões de 37 a 39 da última vez, então o ponto de partida para esta integração deverá ser a revisão 40.

Se estás a usar as funcionalidades de rastreamento de integração, do Subversion, não precisas de te lembrares quais as revisões que já foram integradas - o Subversion irá recordar-se disso por ti. Se deixas o intervalo de revisões em branco, todas as revisões que não foram ainda integradas serão incluídas. Consulta “Rastreamento de Integração” para saberes mais.

Quando o seguimento de integração é usado, a caixa de diálogo de registo irá mostrar as revisões previamente integradas e as revisões antecedentes ao ponto do antecessor comum, i.e. antes do ramo ser copiado, a cinzento. A caixa de verificação Ocultar revisões não.integráveis permite-te filtrar completamente essas revisões, para que vejas apenas as revisões que podem ser integradas.

Se podem estar outras pessoas a submeter alterações então tem cuidado no uso da revisão HEAD. Poderá não se referir à revisão que estás a pensar se alguém efectuou uma submissão após a tua última actualização.

If you leave the range of revisions empty or have the radio button all revisions checked, then Subversion merges all not-yet merged revisions. This is known as a reintegrate or automatic merge.

Existem algumas condições que se aplicam a uma integração de reintegração. Primeiramente, o servidor deverá suportar o rastreamento de integração. A cópia de trabalho deverá ser de nível infinito (sem checkouts dispersos), e não deverá ter nenhumas alterações, itens trocados ou itens que foram actualizadas para revisões diferentes da HEAD. Todas as alterações para o trunk feitas durante o desenvolvimento do ramo, deverão ter sido já integradas transversalmente para o ramo (ou marcadas como tendo sido feitas). O intervalo de revisões a integrar será então calculado automaticamente.

Clica Seguinte e segue para “Opções de Integração”.

Figura 4.54. O Assistente de Integração - Integração de Árvores

Se estás a usar este método para integrar um ramo de funcionalidade de volta para o trunk, necessitas de arrancar o assistente de integração de dentro da cópia de trabalho do trunk.

No campo De: introduz o URL completo da pasta trunk. Isto pode soar errado, mas lembra-te que o trunk é o ponto de partida para o qual queres adicionar as alterações do ramo. Podes também clicar ... para navegar o repositório.

No campo Para: introduz o URL completo da pasta do ramo de desenvolvimento.

Em ambos os campos Da Revisão e Para Revisão, introduz o número da última revisão em que as duas árvores estiveram sincronizadas. Se tens a certeza que ninguém está a fazer submissões, podes usar a revisão HEAD em ambos os casos. Se existe uma hipotese de alguém ter feito uma submissão desde essa sincronização, deves usar números de revisões específicas para evitar perder submissões mais recentes.

Podes também usar o Mostrar Registo para seleccionar a revisão.

Esta página do assistente deixa-te especificar opções avançadas antes de começar o processo de integração. Na maior parte do tempo tu podes apenas usar as opções por defeito.

Tu podes especificar o nível a usar na integração, i.e. até que ponto deverá a integração penetrar na tua cópia de trabalho. Os termos do nível usados estão descritos em “Profundidade do Checkout”. O nível por defeito é a Cópia de trabalho, e é quase sempre o que precisas.

Most of the time you want merge to take account of the file's history, so that changes relative to a common ancestor are merged. Sometimes you may need to merge files which are perhaps related, but not in your repository. For example you may have imported versions 1 and 2 of a third party library into two separate directories. Although they are logically related, Subversion has no knowledge of this because it only sees the tarballs you imported. If you attempt to merge the difference between these two trees you would see a complete removal followed by a complete add. To make Subversion use only path-based differences rather than history-based differences, check the Ignore ancestry box. Read more about this topic in the Subversion book, Noticing or Ignoring Ancestry.

Tu podes especificar a forma como os fins-de-linha e espaços-em-branco são lidados. Essas opções são descritas em “Opções de Fim-de-Linha e Espaços-Brancos”. O comportamento por defeito é tratar todos os espaços-em-branco e os fins-de-linha como alterações a serem integradas.

A caixa de verificação Force the merge é usada para evitar um conflito de árvore quando um remover afectar um ficheiro que foi modificado localmente ou não está versionado. Se o ficheiro foi removido então não há maneira de o recuperar, sendo por isso que essa opção não está marcada por defeito.

Se estás a usar o rastreamento de integração, e queres marcar a revisão como tendo sido integrada, sem actualmente efectuar essa integração aqui, verifica a caixa de verificação Só regista a integração. Existem duas razões possíveis para que tu queiras fazer isto. Poderá ser que a integração seja muito complicada para os algoritmos de integração, pelo que inseres as alterações manualmente, e então marcas como integrada, para que o rastreador de integração conheça esse facto. Ou queiras evitar que uma revisão particular seja integrada. Considerando-a como já integrada, irá evitar que a integração ocorra com clientes sensíveis ao seguimento.

Agora tudo está configurado, tudo o que tens de fazer é clicar no botão Integrar. Se queres pré-visualizar os resultados o Testar Integração simula a operação de integração, mas não modifica de todo a cópia de trabalho. Mostra-te uma lista de ficheiros que serão alterados por uma integração real, e anota os ficheiros onde os conflitos podem ocorrer. Porque o rastreador de integração torna o processo de integração muito mais complexo, não existe maneira garantida de determinar em avanço se uma integração irá ser concluída sem conflitos, pelo que os ficheiros marcados como em conflito numa integração de teste, poderão de facto integrar-se sem qualquer problema.

The merge progress dialog shows each stage of the merge, with the revision ranges involved. This may indicate one more revision than you were expecting. For example if you asked to merge revision 123 the progress dialog will report “ Merging revisions 122 through 123 ”. To understand this you need to remember that Merge is closely related to Diff. The merge process works by generating a list of differences between two points in the repository, and applying those differences to your working copy. The progress dialog is simply showing the start and end points for the diff.

A integração está agora completa. É uma boa ideia dar uma vista de olhos na integração e ver se está como o esperado. Integrar é normalmente algo complicado. Os conflitos surgem com frequência se o ramo divergiu bastante do trunk.

Para clientes e servidores Subversion, anteriores à versão 1.5, nenhuma informação sobre integração é armazenada e as revisões tem de ser seguidas manualmente. Quando tiveres testado as alterações e fores então submeter esta revisão, a tua mensagem de registo deverá incluir sempre os números das revisões que foram portadas na integração. Se queres aplicar posteriormente outra integração, necessitarás de conhecer o que já integraste, já que não queres portar uma alteração mais do que uma vez. Para mais informação, consulta Best Practices for Merging no livro do Subversion.

Se o teu servidor e todos os clientes estão a correr o Subversion 1.5, ou versão superior, a funcionalidade de rastreamento de integração irá registar as revisões integradas e evitar que uma revisão seja integrada mais que uma vez. Isto torna a tua vida muito mais simples, já que podes simplesmente integrar o intervalo completo de revisões de cada vez, e saber que só as novas revisões serão realmente integradas.

A gestão de ramos é importante. Se queres manter este ramo actualizado com o trunk deverás ter o cuidado de integrar com frequência, para que o ramo e o trunk não divirjam muito. É claro que deverás evitar ainda a integração repetida de alterações, como descrito acima.

O Subversion 1.5 introduz facilidades para rastreamento da integração. Quando tu integras alterações de uma árvore para outra, os números de revisões integradas são armazenadas e esta informação pode ser usada para vários propósitos diferentes.

A informação de rastreamento de integração é armazenada na propriedade svn:mergeinfo pelo cliente, quando executa uma integração. Quando a integração é submetida, o servidor armazena essa informação numa base de dados, e quando tu requisitas a informação de integração, registo ou responsabilidade, o servidor possa responder de acordo. Para o sistema funcionar correctamente deves assegurar que o servidor, repositório e todos os clientes estejam actualizados. Clientes antigos não irão armazenar a propriedade svn:mergeinfo e servidores antigos não irão fornecer essa mesma informação, requisitada pelos novos clientes.

Mais informações sobre o controlo de integração do Subversion em; Merge tracking documentation.

Merging does not always go smoothly. Sometimes there is a conflict. TortoiseSVN helps you through this process by showing the merge conflict dialog.

Figura 4.55. The Merge Conflict Dialog

It is likely that some of the changes will have merged smoothly, while other local changes conflict with changes already committed to the repository. All changes which can be merged are merged. The Merge Conflict dialog gives you different ways of handling the lines which are in conflict.

For normal conflicts that happen due to changes in the file content or its properties, the dialog shows buttons which allow you to chose which of the conflicting parts to keep or reject.

If there's a tree conflict, please first see “Conflitos de Árvore” about the various types of tree conflicts and how and why they can happen.

To resolve tree conflicts after a merge, a dialog is shown with various options on how to resolve the conflict:

Figura 4.56. The Merge Tree Conflict Dialog

Since there are various possible tree conflict situations, the dialog will show buttons to resolve those depending on the specific conflict. The button texts and labels explain what the option to resolve the conflict does. If you're not sure, either cancel the dialog or use the Postpone button to resolve the conflict later.

Quando desenvolves uma nova funcionalidade num ramo separado, é uma boa ideia definir uma política para reintegração quando a funcionalidade estiver completa. Se outro trabalho está a decorrer no trunk ao mesmo tempo, poderás descobrir que as diferenças tornar-se-ão significativas ao longo do tempo, e integrar de volta pode-se tornar um pesadelo.

Se a funcionalidade é relativamente simples e o desenvolvimento não será muito longo, então poderás adoptar uma abordagem simples, que é manter o ramo inteiramente separado até a funcionalidade estar completa, então integras as alterações do ramo de volta para o trunk. No assistente de integração isto deverá ser um simples Integrar um intervalo de revisões, com o intervalo de revisões sendo o intervalo completo de revisões do ramo.

Se a funcionalidade irá demorar mais tempo e tu precisas de ter em conta todas as alterações no trunk, então tu necessitas de manter o ramo sincronizado. Isto significa simplesmente que periodicamente integras as alterações do trunk no ramo, para que o ramo contenha todas as alterações do trunk mais a nova funcionalidade. O processo de sincronização usa Integrar um intervalo de revisões. Quando a funcionalidade estiver completa, então podes integrá-la de volta para o trunk usando Reintegrar um ramo or Integrar duas árvores diferentes.

Another (fast) way to merge all changes from trunk to the feature branch is to use the TortoiseSVN → Merge all... from the extended context menu (hold down the Shift key while you right click on the file).

Figura 4.57. The Merge-All Dialog

This dialog is very easy. All you have to do is set the options for the merge, as described in “Opções de Integração”. The rest is done by TortoiseSVN automatically using merge tracking.

Por defeito nada é bloqueado, e qualquer um que tenha acesso para submeter, pode submeter alterações em qualquer ficheiro a qualquer altura. Outros irão actualizar a sua cópia de trabalho periodicamente e as alterações no repositório serão integradas com as alterações locais.

Se tu Obteres o bloqueio num ficheiro, então só podes submeter esse ficheiro. Submissões de outros utilizadores serão bloqueados até libertares o bloqueio. Um ficheiro bloqueado não pode ser modificado de forma alguma no repositório, pelo que não poderá ser apagado ou também renomeado, à excepção do autor do bloqueio.

No entanto outros utilizadores não terão necessariamente conhecimento de que tu obtiveste um bloqueio. A não ser que verifiquem o estado de bloqueio regularmente, a primeira vez que terão conhecimento será quando ao submeterem a operação falhar, o que na maior parte dos caso não será muito útil. Para tornar mais fácil a gestão de bloqueios, existe uma propriedade nova no Subversion svn:needs-lock. Quando esta propriedade está configurada num ficheiro (para qualquer valor), quando o ficheiro é SVN exportado ou actualizado a cópia local é colocada em estado de só de leitura, a não ser que essa cópia tenha o bloqueio desse ficheiro. Isto actua como um aviso que não deverás alterar esse ficheiro a não ser que primeiro obtenhas o seu bloqueio. Os ficheiros que são, versionados e só de leitura, são marcados com uma sobreposição especial do TortoiseSVN, que indica que necessitas de obter um bloqueio antes de editares.

Os bloqueios são registados por localização da cópia de trabalho tal como por autor. Se tiveres várias cópias de trabalho (em casa, no trabalho) então só poderás obter um bloqueio numa dessas cópias de trabalho.

Se um dos teus colegas adquire um bloqueio e vai de férias sem o libertar, o que farás? O Subversion providência um meio de forçar bloqueios. Libertar um bloqueio detido por outro é referido como Quebrar o bloqueio, e forçar aquisição de um bloqueio detido por outrém é referido como Roubar o bloqueio. Naturalmente essas são acções que não deverás efectuar de ânimo leve, se queres manter a amizade com os teus colegas de trabalho.

Os bloqueios são registados no repositório e um testemunho de bloqueio é criado na tua cópia de trabalho. Se existe uma discrepância, por exemplo se alguém quebrou o bloqueio, o testemunho local do bloqueio fica inválido. O repositório é sempre a referência definitiva.

Selecciona o ficheiro(s) na tua cópia de trabalho, para o qual queres adquirir um bloqueio, e então selecciona o comando TortoiseSVN → Obter Bloqueio....

Figura 4.58. A Caixa de Diálogo Bloquear

Uma caixa de diálogo aparece para permitir introduzir um comentário, para que os outros possam ver porquê bloqueaste o ficheiro. O comentário é opcional só é usado correntemente com repositórios baseados em Svnserve. Se (e só se) necessitas de roubar o bloqueio de alguém, verifica a caixa Roubar bloqueio, e clica no OK.

Poderás configurar a propriedade de projecto tsvn:logtemplatelock para fornecer aos utilizadores uma mensagem de modelo (template), para que a preencham como mensagem de bloqueio. Consultar a secção “Configurações de Projecto” para instruções em como configurar propriedades.

Se seleccionas um ficheiro e então usas TortoiseSVN → Obter bloqueio..., a caixa de diálogo bloquear irá abrir com todos os ficheiros em todas as subpastas seleccionadas para bloquear. Se realmente queres bloquear uma hierarquia inteira, esta é a maneira de o fazer, mas podes-te tornar muito impopular junto dos teus colegas de trabalho se bloqueias todo o projecto. Usa com moderação...

Para ter a certeza que não te esqueces de libertar um bloqueio que não precisas mais, os ficheiros bloqueados são mostrados na caixa de diálogo submeter e seleccionados por defeito. Se continuares com a submissão, os bloqueios são removidos nos ficheiros seleccionados, mesmos se os ficheiros não foram modificados. Se não queres libertar o bloqueio em certos ficheiros, podes desseleccioná-las (se não foram modificadas). Se queres manter um bloqueio num ficheiro que modificaste, tens de activar a caixa de verificação Manter bloqueios, antes de submeteres as tuas alterações.

Para libertar manualmente um bloqueio, selecciona o(s) ficheiro(s) na tua cópia de trabalho, para os quais queres libertar os bloqueios e selecciona o comando TortoiseSVN → Libertar bloqueio Não há mais nada a introduzir pelo que o TortoiseSVN irá contactar o repositório e libertar os bloqueios. Podes também usar este comando numa pasta, para libertar recursivamente, todos os bloqueios.

Figura 4.59. A Caixa de Diálogo Verificar Alterações

Para ver os bloqueios que tu e os outros têm, podes usar TortoiseSVN → Verificar alterações.... Testemunhos de bloqueios locais aparecerão imediatamente. Para verificar os bloqueios detidos por outros (e para ver se algum dos teus bloqueios estão quebrados ou roubados) necessitas de clicar em Verificar Repositório.

A partir daqui, do menu de contexto, podes também obter e libertar bloqueios tal como quebrar ou roubar bloqueios detidos por outros.

Como mencionado acima, a maneira mais eficaz de usar os bloqueios é configurar a propriedade svn:needs-lock em ficheiros. Consultar “Configurações de Projecto” para instruções em como configurar propriedades. Ficheiros com esta propriedade configurada serão sempre SVN exportadas e actualizadas com a bandeira só-de-leitura levantada, a não ser que a tua cópia de trabalho tenha um bloqueio.

Como lembrete o TortoiseSVN usa uma sobreposição especial para indicar isto.

Se aplicas uma política em que todo o ficheiro tem de ser bloqueado, então acharás mais fácil usar a funcionalidade auto-props do Subversion para fixar automáticamente a propriedade, de cada vez que adicionas novos ficheiros. Consulta “Configuração automática de propriedades” para mais informações.

Quando crias um repositório novo com o Subversion 1.2 ou superior, são criados quatro templates de gancho na pasta hooks do repositório. Esses são invocados antes e depois de obter um bloqueio, e antes e depois de libertar um bloqueio.

Será uma boa ideia instalar no servidor um script de gancho post-lock e post-unlock, que envia um email indicando que ficheiro foi bloqueado. Com tal script instalado todos os teus utilizadores podem ser notificados se alguém bloqueia/desbloqueia um ficheiro. Podes encontrar um exemplo de um script de gancho hooks/post-lock.tmpl na pasta do teu repositório.

Podes também utilizar ganchos para proibir quebrar ou roubar bloqueios, ou talvez limitá-lo a um administrador nomeado. Ou talvez quererás enviar um email ao dono, quando um dos seus bloqueios é quebrado ou roubado.

Consulta “Scripts de gancho de servidor” para saberes mais.

Primeiro tu precisas de construir e testar as tuas alterações. Então em vez de usares TortoiseSVN → Submeter... na pasta pai, seleccionas TortoiseSVN → Criar correcção...

Figura 4.60. A caixa de diálogo de Criar Correcção

Agora podes seleccionar os ficheiros que queres incluir na correcção, tal como tu farias numa submissão completa. Isto irá produzir um ficheiro simples contendo um sumário de todas as alterações que efectuaste nos ficheiros seleccionados, desde a última actualização do repositório.

As colunas nesta caixa de diálogo podem ser customizadas da mesma maneira que as colunas na caixa de diálogo Verificar alterações. Consulta “Estado Remoto e Local” para mais detalhes.

Ao clicar no botão de Opções, podes especificar como o caminho é criado. Por exemplo, podes especificar que as mudanças no final da linha ou espaços em branco não são incluídas no arquivo do caminho final.

Tu podes produzir correcções separadas, contendo alterações em diferentes conjuntos de ficheiros. É claro que se criaste um ficheiro de correcção, e efectuaste mais alterações aos mesmos ficheiros, criando uma segunda correcção, o segundo ficheiro de correcção irá incluir ambos os conjuntos de alterações.

Grava apenas o ficheiro usando um nome da tua escolha. Ficheiros de correcções podem ter a extensão que desejes, mas por convenção eles dever usar a extensão .patch ou .diff. Agora estás pronto para submeter o teu ficheiro de correcção.

Tu podes também guardar a correcção na área de transferência em vez de o fazer para um ficheiro. Poderás fazer isto para que possas colá-lo num email para ser revisto por outros. Ou se tiveres duas cópias de trabalho numa máquina e quiseres transferir alterações de uma para outra, a correcção na área de transferência é a maneira conveniente de o fazer.

Se preferires podes criar um ficheiro correcção a partir das caixas de diálogo Submeter ou Verificar alterações. Selecciona apenas os ficheiros e usa o item do menu de contexto para criar a correcção a partir desses ficheiros. Se quiseres ver a caixa de diálogo Opções terás de manter premida a tecla shift quando clicares à direita.

Os ficheiros de correcção são aplicados na tua cópia de trabalho. Isto deverá ser feito a partir de uma pasta do mesmo nível da que foi usada para criar a correcção. Se não tens a certeza de qual é, olha apenas para a primeira linha do ficheiro de correcção. Por exemplo, se o primeiro ficheiro a ser trabalhado era doc/source/english/chapter1.xml e a primeira linha no ficheiro de correcção Index: english/chapter1.xml, então precisas de aplicar a correcção na pasta doc/source/. No entanto, mesmo que estejas na cópia de trabalho correcta, se escolheres o nível de pastas errado, o TortoiseSVN irá dar conta e sugere o nível correcto.

De modo a aplicar um ficheiro de correcção à tua cópia de trabalho, necessitas de pelo menos, ter acesso de leitura ao repositório. A razão para isto é que, o programa de integração tem de referenciar as alterações até à revisão em que elas foram efectuadas pelo programador remoto.

A partir do menu de contexto desse ficheiro, clica em TortoiseSVN → Aplicar correcção... Isto fará aparecer uma uma caixa de diálogo abrir ficheiro, que te permitirá seleccionar o ficheiro de correcção a aplicar. Por defeito, só são mostrado ficheiros .patch ou .diff, mas tu podes optar por “Todos ficheiros”. Se guardaste previamente uma correcção na área de transferência, podes usar o Abrir da área de transferência... a partir da caixa de diálogo, abrir ficheiro. Ter em atenção que esta opção só aparece se guardaste uma correcção na área de transferência usando TortoiseSVN → Criar correcção.... Copiar uma correcção para a área de transferência, a partir de outra aplicação, não fará o botão aparecer.

Alternativamente, se o ficheiro de correcção tem uma extensão .patch ou .diff, podes clicar directamente nele com o botão direito e seleccionar TortoiseSVN → Aplicar correcção.... Neste caso serás solicitado a introduzir a localização da cópia de trabalho.

Estes dois métodos apenas diferem no modo de fazer a mesma coisa. Com o primeiro método, tu seleccionas a CT e navegas até ao ficheiro de correcção. Com o segundo, seleccionas o ficheiro de correcção e navegas até à CT.

Uma vez que tenhas seleccionado o ficheiro de correcção e a localização da cópia de trabalho, o TortoiseMerge irá correr, integrando as alterações do ficheiro de correcção com a tua cópia de trabalho. Uma pequena janela lista os ficheiros que foram alterados. Efectua duplo clique em cada uma de cada vez, para reveres as alterações e guardares os ficheiros integrados.

A correcção do programador remoto foi agora aplicada na tua cópia de trabalho, então precisas agora de submeter de modo a permitir que todos possam aceder às alterações a partir do repositório.

Figura 4.61. A Caixa de Diálogo de Anotar/Responsabilizar

Se não estás interessado nas alterações em revisões anteriores, podes fixar a revisão a partir da qual a responsabilização deve começar. Fixa para 1, se queres a responsabilização para cada revisão.

Por defeito, o ficheiro responsabilizado é visualizado usando o TortoiseBlame, que salienta as diferentes revisões de forma a tornar mais fácil a sua leitura. Se desejares imprimir ou editar o ficheiro de responsabilidade, selecciona Usar visualizador de Texto para ver responsabilidades.

Tu podes especificar a forma como são lidados os fim-de-linha e os espaços em branco. Essas opções estão descritas em “Opções de Fim-de-Linha e Espaços-Brancos”. O comportamento por defeito é tratar todas as diferenças de espaços-em-branco e fim-de-linha como alterações reais, mas se queres ignorar uma alteração de indentação e encontrar o autor original, podes escolher uma opção apropriada aqui.

Ter em atenção que se uma etiqueta é usada como origem para uma cópia, talvez um novo ramo baseado numa etiqueta, então essa etiqueta será mostrada como um nó separado em vez de dobrada.

Once you press OK TortoiseSVN starts retrieving the data to create the blame file. Once the blame process has finished the result is written into a temporary file and you can view the results.

Figura 4.62. TortoiseBlame

O TortoiseBlame, que está incluído com o TortoiseSVN torna o ficheiro de responsabilidade mais fácil de ler. Quando passas com o rato sobre uma linha, na coluna de informação da responsabilidade, todas as linhas com a mesma revisão são mostradas com um fundo mais escuro. Linhas de outras revisões que foram alteradas pelo mesmo autor, são mostradas com um fundo mais claro. A coloração poderá não funcionar tão bem se o teu écran estiver configurado para o modo de 256 cores.

Se clicares com o botão direito numa linha, todas as linhas com a mesma revisão serão destacadas, e todas as linhas de outras revisões com o mesmo autor serão destacadas numa cor mais clara. Este destaque é persistente permitindo-te mover o rato sem perder os destaques. clica outra vez nessa revisão para remover o destaque.

Os comentários de revisão (mensagem de registo) são mostrados numa caixa de dica, quando passas com o rato sobre a coluna de informação de responsabilidade. Se queres copiar a mensagem de registo dessa revisão usa o menu de contexto, que aparece quando clicas com o botão direito na coluna de informação de responsabilidade.

Tu podes pesquisar no relatório de responsabilidade usando Editar → Localizar.... Isto permite-te procurar por números de revisões, autores e o conteúdo das próprias mensagens. Mensagens de registo não são incluídas na pesquisa - tu deverás usar a caixa de diálogo de Registo para efectuar essa pesquisa.

Podes também saltar para uma número de linha específica usando, Editar → Ir Para Linha....

Quando o rato está sobre as colunas de informação de responsabilidade, um menu de contexto está disponível, que te ajudará a comparar revisões e examinar o histórico, usando o número de revisão da linha sobre o rato, como referência. Menu de contexto → Responsabilizar pela revisão anterior gera um relatório de responsabilidade para o mesmo ficheiro, mas usando a revisão anterior como o limite superior. Isto dá-te o relatório de responsabilidade para o estado do ficheiro, imediatamente antes da linha que estás a ver ter sido alterada. Menu de contexto → Mostrar alteações arranca o teu leitor de comparações, mostrando-te o que foi alterado na revisão referenciada. Menu de contexto → Mostrar registo mostra a caixa de diálogo de registo de revisões, a começar na revisão referenciada.

Se precisas um melhor indicador visual de onde estão as mais antigas e mais recentes alterações, selecciona Ver → Colorir idade das linhas. Isto irá usar um gradiente de cores para mostrar linhas mais recentes a vermelho e linhas mais antigas em azul. A coloração por defeito é algo clara, mas podes alterá-lo usando as preferências do TrotoiseBlame.

Se estás a usar o rastreamento de integração e pediste info. de integração ao iniciar a responsabilização, então as linhas integradas são mostradas de um modo ligeiramente diferente. Onde foi alterada uma linha como resultado de uma integração de outro ramo, o TortoiseBlame irá mostrar a revisão e o autor da última alteração no ficheiro original em vez da revisão onde foi efectuada a integração. Essas linhas são identificadas ao mostrar a revisão e o autor em itálico. A revisão onde foi efectuada a integração é mostrada em separado na tooltip quando passas o rato sobre as colunas de info. de responsabilidade. Se não pretenderes que as linhas integradas sejam mostradas desta maneira, desselecciona a caixa Incluir info de integração ao iniciar a responsabilização.

Se quiseres ver os caminhos envolvidos na mesclagem, selecciona Ver → Mesclar caminhos. Isso irá mostrar o caminho onde a linha foi modificada pela última vez, excluindo as variações resultantes de uma fusão.

A revisão mostrada na informação de responsabilidade representa a última revisão onde o conteúdo dessa linha foi alterado. Se o ficherio foi criado ao copiar outro ficheiro, então até alterares a linha, a sua revisão de responsabilidade irá mostrar a última alteração no ficheiro fonte original, e não a revisão onde a cópia foi efectuada. Isto também se aplica aos caminhos mostrados com a informação de integração. O caminho mostra a localização do repositório onde a última alteração foi efectuada a essa linha.

As preferências para o TortoiseBlame podem ser acedidas usando TortoiseSVN → Preferências... na aba TortoiseBlame. Consultar “Preferências do TortoiseBlame”.

Limpa o estado da cópia de trabalho

A caixa de diálogo registo de revisão inclui várias opções que te permite fazer isto.

Cada nó do grafo de revisões representa uma revisão no repositório onde algo foi alterado, na árvore que estás a observar. Diferentes tipos de nós podem ser distinguidos através da forma e cor. As formas são fixas, mas as cores podem ser alteradas usando TortoiseSVN → preferências

De notar que por defeito, o grafo só mostra os pontos onde itens foram adicionados, copiados ou removidos. Mostrando cada revisão do projecto irá gerar um grafo muito extenso para casos não triviais. Se queres realmente ver todas as revisões onde foram feitas alterações, existe uma opção para o fazer no menu Ver e na barra de ferramentas.

A vista por defeito (sem agrupamento) coloca os nós de modo que a sua posição vertical fique na ordem estrita de revisões, para que tenhas uma dica visual da ordem em que as coisas foram feitas. Quando estão na mesma coluna dois nós, a ordem é muito óbvia. Quando estão em colunas adjacentes dois nós, o deslocamento é muito menor porque não há necessidade de evitar que os nós se sobreponham, e como resultado a ordem é um pouco menos óbvia. Tais optimizações são necessárias de modo a manter a complexidade dos grafos numa dimensão aceitável. Ter em atenção que esta ordenação usa o canto do nó no lado mais antigo como referência, i.e. o canto inferior do nó, quando o grafo é mostrado com os nós mais antigos no fundo. O canto de referência é significativo porque todas as formas de nós não são da mesma altura.

Porque o gráfico de revisões é normalmente bastante complexo, existem um número de funcionalidades que podem ser usadas para moldar a vista á tua maneira. Estas estão disponiveis no menu Ver e a partir da barra de ferramentas.

Usa a janela de vista global para tornar mais fácil a navegação em grandes gráficos. Este mostra o gráfico inteiro numa janela pequena, com a parcela correntemente mostrada salientada. Podes arrastar a área salientada de forma a alterar a região visualizada.

A data da revisão, o autor e os comentários são mostrados numa caixa de dica, quando o rato passa sobre a caixa de revisão.

Se seleccionares duas revisões ( Usa Ctrl-clique com o botão direito), podes usar o menu de contexto para mostrar as diferenças entre estas revisões. Podes optar por mostrar as diferenças nos pontos de criação de ramos, mas usualmente quererás mostrar as alterações nas pontas dos ramos, i.e. na revisão HEAD.

Podes ver as diferenças como um ficheiro de Comparação-Unificada que mostra todas as diferenças num único ficheiro com contexto mínimo. Se optares por Menu de contexto → Comparar Revisões serás presenteado com uma lista de ficheiros alterados. Efectua duplo clique num nome de ficheiro de modo a obter ambas as revisões do ficheiro e compará-las recorrendo à ferramenta de comparação visual.

Se tu clicas com o botão direito numa revisão, podes usar Menu de contexto → Mostrar registo para ver o histórico.

Podes também integrar as alterações nas revisões seleccionadas, numa cópia de trabalho diferente. A caixa de diálogo selecção de pasta, permite-te escolher a cópia de trabalho para onde integrar, mas após esta não existe caixa de confirmação nem uma oportunidade para tentar uma integração de teste. Será uma boa ideia integrar numa cópia de trabalho não modificada, para que possas reverter as alterações se não resultar! Esta é uma funcionalidade útil se pretendes integrar as revisões seleccionadas, de um ramo para outro.

Se quiseres consultar novamente o servidor por nova informação poderás simplesmente refrescar a vista usando o F5. Se estiveres a usar a cache de registo (activada por defeito) o repositório será consultado para verificar novas submissões e buscará somente as novas. Se a cache de registo está em modo fora-de-linha, esta operação irá também tentar retornar ao modo em-linha.

Se estás a usar a cache de registo, e desconfias que o conteúdo da mensagem ou o autor foram alterados, então deverás recorrer à caixa de diálogo de registo para refrescar as mensagens de que necessitas. Desde que o gráfico de revisões funciona a partir da raiz do repositório, teríamos de invalidar toda a cache de registo, e uma recarga poderia levar um tempo muito longo.

Uma árvore grande pode-se tornar difícil de navegar e por vezes tu quererás esconder algumas partes, ou parti-la numa floresta de árvores mais pequenas. Se manteres o rato sobre o ponto onde um nó de ligação entra ou sai do nó, irás ver um ou mais botões de aparição que te permitiram fazer isso.

Clica no botão de subtracção para colapsar a sub-árvore anexada.

Clica no botão de adição para expandir a árvore colapsada. Quando uma árvore está colapsada este botão mantém-se visível para sinalizar a sub-árvore escondida.

Clica no botão da cruz para dividir a sub-árvore anexada e mostrá-la no gráfico como uma árvore separada.

Clica no botão com o círculo para re-anexar a árvore dividida. Quando uma árvore foi dividida este botão permanece visível para indicar que existe uma sub-árvore separada.

Clica no fundo do gráfico para obteres o menu de contexto que te oferece opções para Expandir todosl e Juntar todos. Se não existem nenhum ramo colapsado ou dividido, o menu de contexto não será mostrado.

Por vezes terás uma cópia de trabalho que pretendes converter de volta para uma pasta normal, ou seja, sem a pasta .svn. Tudo o que precisarás de fazer é apagar a pasta .svn da raiz da tua cópia de trabalho.

Alternatively you can export the folder to itself. In Windows Explorer right drag the working copy root folder from the file pane onto itself in the folder pane. TortoiseSVN detects this special case and asks if you want to make the working copy unversioned. If you answer yes the control directory will be removed and you will have a plain, unversioned directory tree.

Tu podes integrar a ferramenta de controlo de problemas da tua escolha com o TortoiseSVN. Para o fazer, terás de definir algumas propriedades que começam por bugtraq:. Estas deverão ser colocadas nas pastas: (“Configurações de Projecto”)

Figura 4.67. Caixa de diálogo de Propriedades do Bugtraq

Quando editas qualquer uma das propriedades do bugtraq, um editor de propriedade especial será usado para tornar mais fácil definir os valores adequados.

Existem duas maneiras de integrar o TortoiseSVN com os gestores de problemas. Um é baseado em cadeias de caracteres simples, a outra é baseado em expressões regulares. As propriedades usadas em ambas as abordagens são:

Se ambas as propriedades bugtraq:message e bugtraq:logregex estão configuradas, toma precedência a logregex

Algumas propriedades tsvn: requerem um valor true/false. O TortoiseSVN também entende yes como sinónimo para true e no como sinonimo para false.

Quando adicionas novas subpastas a uma cópia de trabalho, usando o TortoiseSVN, quaisquer propriedades de projecto presentes na pasta pai serão automaticamente adicionadas à nova pasta filho também.

This issue tracker integration is not restricted to TortoiseSVN; it can be used with any Subversion client. For more information, read the full Issue Tracker Integration Specification in the TortoiseSVN source repository. (“Licença” explains how to access the repository.)

A secção anterior ocupa-se com a adição da informação do problema nas mensagens de registo. Mas se tu precisares de obter informações do teu gestor de problemas? A caixa de diálogo submeter tem um interface COM que permite a integração com um programa externo, que consegue comunicar com o teu gestor. Tipicamente tu poderás querer consultar o gestor para obter a lista de problemas abertos atribuídos a ti, de modo a que possas seleccionar os problemas que estarão a ser tratados nesta submissão.

Any such interface is of course highly specific to your issue tracker system, so we cannot provide this part, and describing how to create such a program is beyond the scope of this manual. The interface definition and sample plugins in C# and C++/ATL can be obtained from the contrib folder in the TortoiseSVN repository. (“Licença” explains how to access the repository.) A summary of the API is also given in Capítulo 7, Interface IBugtraqProvider. Another (working) example plugin in C# is Gurtle which implements the required COM interface to interact with the Google Code issue tracker.

Para efeitos de demonstração, vamos supor que o teu administrador de sistemas providenciou-te um plugin de gestor de problemas que tu instalaste, e entretanto configuraste algumas das tuas cópias de trabalho para usar o plugin, na caixa de diálogo de preferências do TortoiseSVN. Quando abres a caixa de diálogo Submeter a partir de uma cópia de trabalho para a qual o plugin foi atribuído, verás um novo botão no topo da caixa de diálogo.

Figura 4.68. Caixa de diálogo de exemplo da consulta ao gestor de problemas

Neste exemplo tu podes seleccionar um ou mais problemas abertos. O plugin pode então gerar um texto, especialmente formatado, que adicionará à tua mensagem de registo.