====== Usando o RapidSVN ======
Este tutorial irá auxiliá-lo a utilizar algumas funções básicas do //client// para Subversion, RapidSVN.

===== Checkout =====
Para fazer o Checkout de arquivos:
  - Abra o RapidSVN;
  - Clique com o botão direito em **Bookmarks**, localizado no painel esquerdo, e então em **Add Existing Working Copy...**;
    - Indique o diretório. Se o diretório não existir, o RapidSVN irá perguntar se deseja criá-lo;
    - Isso irá criar um local de trabalho para um projeto do Subversion, chamado no RapidSVN de **Bookmark**.
  - Feito o bookmark, clique com o botão direito nele, e então **Checkout New Working Copy..**;
  - Na **URL**, indique o que se deseja baixar do Subversion. Em **Destination Directory** indique o local para onde os arquivos baixados irão;
    - Se for solicitado, informe o seu usuário e senha do Subversion, e depois OK;

Com isso o Checkout já está pronto. Se quiser manter a sincronização com o Subversion (para, por exemplo, editar e executar "COMMIT" depois), então mantenha o bookmark. Caso contrário é recomendável apagá-lo. Veremos mais abaixo como apagar o Bookmark.

===== Apagando o Bookmark =====
  - Clique com o botão direito no **bookmark** que se deseja apagar e escolha a opção **Remove bookmark**;
    - Note que isso irá apagar apenas o **bookmark** dele no RapidSVN. Isso não irá apagar os arquivos que foram baixados nele.

===== Lock e Unlock =====
O **Lock** e **Unlock** no RapidSVN não podem ser feitos recursivamente indicando apenas o diretório. Sendo assim, o **Lock** e **Unlock** devem ser feitos por arquivo.

Para fazê-lo:
  - Após realizar o **Checkout**, selecione o(s) arquivo(s) no painel da direita que deseja travar, e então execute o comando **Lock**;
  - Será solicitada uma descrição do porquê da trava. Essa descrição é opcional;
    - Há também a opção **Steal lock if it belongs to another user**, que pode ser usada para "roubar" a trava. Isso pode ser útil para o caso de algum outro usuário ter travado o(s) arquivo(s) e esquecido de destravá-lo(s), ou mesmo se os arquivos foram excluídos antes de liberar a trava.

O comando **Unlock** tem o efeito inverso. Ele destrava um arquivo que esteja travado por você.
  - Para executá-lo, simplesmente clique no arquivo com o botão direito e execute o comando **Unlock**;
    - Ao realizar o **Unlock** será apresentada uma tela de confirmação. Nessa mesma tela existe a opção **Force unlocking even if you are not the lock owner**. Essa opção executa o destravamento do(s) arquivo(s) mesmo que você não seja a pessoa quem o travou.

===== Editando o projeto =====

Se você fez o Checkout de algum projeto e manteve o **bookmark**, os arquivos do bookmark estarão visíveis no painel direito do RapidSVN.

Quando um arquivo é editado, o mesmo arquivo fica marcado com cor vermelha no RapidSVN, indicando que ele foi editado.

Veremos aqui mais detalhadamente como trabalhar com edições no projeto.

==== Commit ====
O **commit** é o comando que envia os arquivos e o projeto de volta para o Subversion, confirmando qualquer alteração que tenha sido feita nele. 

No RapidSVN o **commit** pode ser feito individualmente por arquivo, ou então pelo **bookmark**, onde ele envia para o Subversion todos os arquivos que foram alterados naquele **bookmark**.

Para fazê-lo, clique com o botão direito sobre o **bookmark** ou o arquivo e execute o comando **commit**. Será apresentada uma tela para indicar a descrição daquele **commit**. 
Nessa mesma tela existe a opção **Keep Locks**, que mantém a(s) trava(s) feita(s) no(s) arquivo(s), se houver alguma.

Ao fazer o commit, na tela inferior do RapidSVN (A tela que indica os status e as operações) irão aparecer algumas informações. Uma das informações é a **Committed revision** que indica qual é o número da revisão que está indo no **commit** feito. Para esse parâmetro, o valor -1 indica que nada foi alterado, portanto, nenhuma revisão foi armazenada no Subversion. 



==== Adicionando arquivos ao projeto ====
Quando um arquivo é adicionado ao projeto, o ícone dele fica com um ponto de interrogação (?) no RapidSVN. 

Este passo merece atenção, pois o RapidSVN não inclui arquivos para o controle de versão no Subversion automáticamente. Sendo assim, sempre que arquivos novos forem adicionados no projeto, é necessário adicioná-los no controle de versão manualmente.

Para fazê-lo, clique com o botão direito sobre o arquivo desejado, e então escolha a opção **Add**.

==== Apagando arquivos do projeto ====
Do mesmo modo que o RapidSVN não adiciona arquivos ao projeto automáticamente, ele também não os exclui do projeto.

Quando um arquivo do projeto é apagado no HD do cliente, o mesmo fica com um ícone semelhante à um papel rasgado no RapidSVN e com o status de **missing**. Isso, no entanto, não quer dizer que irá apagá-lo do projeto no Subversion.
  - Para apagá-lo do projeto no Subversion, clique sobre o arquivo com o botão direito e escolha a opção **Delete**;
    - Ao fazê-lo, aparecerá uma tela de confirmação com a opção **Force removal**. Se marcada, ao apagar do controle de versão do Subversion o arquivo também será apagado da máquina do cliente.