=== Mini Tutorial Subversion ===

Pode-se acessar o repositório através de comandos via terminal ou
através da GUI rapidsvn.

Para fazer uma cópia dos arquivos do repositório por linha de comando:

  svn checkout svn://guaja.est.ufpr.br/DriverTeSQLite/ /caminho/da/sua/copia

Se o diretório de destino não for especificado, o nome base da URL
será usado como destino (no exemplo acima, se o caminho da sua cópia não tivesse sido especificado, seria criado um diretório chamado DriverTeSQLite).

Usando o rapidsvn, primeiro deve-se adicionar o repositório aos
bookmarks. Para isso clique com o botão direito em ''Bookmarks'' e
selecione ''Add Existing Repository'', então digite o endereço do
repositório: ''%%svn://guaja.est.ufpr.br/DriverTeSQLite/%%'' (não se esqueça
do ''%%svn://%%'') e clique em ''OK''. Agora clique com o botão direito na
entrada do repositório criada e selecione ''Checkout New Working
Copy...'', preencha o caminho do diretório onde você deseja armazenar a
cópia dos arquivos e clique em ''OK''.

Agora você pode editar normalmente os arquivos salvos no seu computador.

Para submeter as alterações feitas por você no repostório:

  svn commit /caminho/da/sua/copia -m "mensagem de log sobre o commit que você esta realizando"

A mensagem de log deve ser fornecida mas pode ser vazia. Se não for
fornecida um editor será aberto para que você a escreva. Você pode
dizer nesta mensagem quais as principais alterações feitas ou coisas
do gênero.

Pelo rapidsvn, quando você visualizar sua cópia você verá que após
alguma edição os arquivos modificados aparecerão destacados pelo
rapidsvn por um ícone avermelhado. Para enviar suas alterações para o
repositório, primeiro selecione nos ''Bookmarks'' a cópia que você quer
atualizar e então clique no menu ''Modify'' e selecione ''Commit...''.
Aparecerá então uma janela com um espaço para você inserir sua
mensagem de log. Digite-a e clique em ''OK''. Pronto. Perceba que na
parte inferior da interface principal do rapidsvn existe um campo de
log sobre as operações realizadas no repositório. Fique de olho nele
pois ele lhe dirá se as operações que você esta fazendo foram
realizadas com sucesso ou não.

Para manter sua cópia atualizada e receber quaisquer alterações feitas
por outros usuários desde seu último checkout ou atualização faça:

  svn update /caminho/da/sua/copia

No rapidsvn, selecione nos ''Bookmarks'' a cópia que você quer atualizar e
então clique no menu ''Modify'' e selecione ''Update...''. O rapidsvn irá
te perguntar qual revisão você deseja atualizar e se ele deve varrer
os diretórios recursivamente. Comumente deverão ser mantidas as opções
default (usar a revisão mais nova [última] e percorrer
recursivamente). Defina suas opções de atualização e clique em ''OK''.

Estes são os comandos principais. Para fazer alterações na sua cópia
do repositório outros comandos podem ser úteis. Alguns deles são:

  svn add foo
  svn delete foo
  svn copy foo bar
  svn move foo bar
  svn mkdir foo

Estes comandos são bem intuitivos.
Em qualquer comando pode-se especificar a opção ''-h'' para uma descrição
rápida de como utilizar um comando svn. Por exemplo digite no terminal
''svn add -h''.
Outros comandos que podem ser úteis são o ''status'' e o ''diff''. Geralmente
é uma boa idéia utilizar o primeiro (''svn status'') para conferir
exatamente o que você alterou e o segundo (''svn diff'') para ver os
detalhes destas alterações.
Em geral, todos estes comandos (excetuando-se os onde é necessária a
especificação de um diretório) são utilizados no diretório de sua
cópia (aquele que você especificou ao fazer o //checkout// do
repositório).


=== Ciclo Básico de Trabalho ===

Um típico ciclo de trabalho dá-se como a seguir:
  * Atualize sua cópia de trabalho
    * svn update
  * Faça as alterações
    * svn add
    * svn delete
    * svn copy
    * svn move
  * Examine suas alterações
    * svn status
    * svn diff
  * Possivelmente desfaça algumas delas
    * svn revert
  * Resolva conflitos (unir (//merge//) as alterações de terceiros)
    * svn update
    * svn resolved
  * Faça o //commit// de suas alterações (efetiva suas alterações no repositório)
    * svn commit

\\
\\
\\

Para maiores detalhes sobre estes comandos, comandos mais avançados ou ajuda em geral, uma consulta ao {{http://www.leg.ufpr.br/~bsoliveira/tutoriais/svn-book.pdf|livro do svn}} pode ser interessante.

\\

 --- //[[bsoliveira@leg.ufpr.br|Bruno Silva de Oliveira]] 2007/06/24 20:04//