Lista de comandos

Se na seguinte visão geral for passado o parâmetro possível -r versão, esta mesma versão poderá ser definida como url?rev=a-versão.

Tabela 4.1. Comandos do Subversion

ComandoSignificadoOpções aceites
commit (ou ci)envia as modificações do item para o repositório 
logImprime o histórico do item-r ver-inicial:ver-final -l limitar_visualização
catApresenta o conteúdo do item-r versão
copy (ou cp)Copia o item dentro da cópia local ou do repositório. Se não for indicado o destino, o kdesvn pedi-lo-á. 
move (ou mv, rename)Move/muda o nome do item dentro da cópia local ou repositório. Se não for indicado o destino, o kdesvn pedi-lo-á. 
getObtém o conteúdo do item e grava-o-r versão -o <ficheiro-saída> (este parâmetro é obrigatório!)
blame (ou annotate)mostra o ficheiro anotado-r ver-inicial:ver-final
actualizarActualiza o item na cópia local-r versão
diffMostra as diferenças entre duas versões do item ou entre dois itens numa dada versão-r ver-inicial:ver-final
infoInformações detalhadas sobre o item-r versão
checkout (ou co)Extrai o conteúdo de 'local-repositório' para uma nova cópia local. Poderão ser pedidos o local de destino e a versão original. 
checkoutto (ou coto)Extrai o conteúdo do 'local-repositório' para uma nova cópia local. A diferença é que serão questionados o local de origem e a versão de origem. 
exportExporta o repositório ou a cópia local para uma dada pasta. Serão pedidos o local de destino e a versão de origem. 
exporttoExporta o repositório ou a cópia local para uma dada pasta. Serão pedidos o local de origem e a versão de origem. 
delete (del, remove, rm)apaga os URL's indicados do repositório ou da cópia local. 
addadiciona o URL à cópia local. O URL deverá pertencer a uma cópia local (não é uma importação!) 
revert (ou undo)anula as alterações efectuadas sobre a cópia local. Poderá ser usado apenas para URL's de da cópia local! 
checknew (ou addnew)procura no URL indicado por itens novos ou não-adicionados, adicionando-os à cópia local se o desejar. 
treemostra uma árvore de versões do item (só o primeiro argumento); se for indicado um URL com “?rev=xxx”, esta versão será a versão de referência.-r ver-inicial:ver-final
lockbloquear os URL's indicados; se for indicado -f, então serão libertados os bloqueios existentes.-f
unlockdesbloquear os URL's indicados; se for indicado -f, então serão libertados os bloqueios não pertencentes ao utilizador e os bloqueios inexistentes serão ignorados.-f
helpmostra esta página 


Tabela 4.2. Parâmetro dos comandos do Subversion

ParâmetroValores possíveispermitido para
-rversão ou ver-inicial:ver-finaltodos excepto o 'commit'
-R(nenhuma)todos excepto o 'commit'
-oficheiroget
-lnúmerolog
-f(nenhuma)(un-)lock


O comando “log”

Este comando mostra uma janela que contém o histórico do URL indicado. Com o Subversion 1.2 ou posterior, poderá aceitar um limite isto é quantos itens terá para apresentar.

Dentro desta janela, poderá seleccionar os itens do histórico e obter as diferenças entre eles.

Exemplo 4.1. Mostrar os últimos 20 registos do histórico

kdesvn exec log -l 20 -r HEAD:1 o-meu-ficheiro.c

Tenha em atenção a ordem das versões: se desejar ir de HEAD para START, terá de indicar a versão HEAD como ponto inicial, caso contrário irá obter os primeiros 20 itens.


O comando “diff”

Irá obter as diferenças entre as versões de um item ou entre dois itens dentro da mesma cópia local ou repositório. Ao determinar as diferenças entre versões de um item, essas versões poderão ser indicadas como -r VERSÃO-INICIAL:VERSÃO-FINAL. Ao ver as diferenças entre um item numa cópia local sem qualquer versão, irá mostrar as diferenças face ao repositório.

Exemplo 4.2. Imprime as diferenças face ao repositório, isto é cópias locais

kdesvn exec diff o-meu-ficheiro.c


Exemplo 4.3. imprime as diferenças entre versões

kdesvn exec diff -r 21:20 o-meu-ficheiro.c


Ao determinar as diferenças entre dois itens, poderá indicar as versões dos itens ao URL dos mesmos, isto é:

http://servidor/local/item?rev=HEAD

Exemplo 4.4. Diferenças entre duas versões marcadas

kdesvn exec diff http://www.alwins-world.de/repos/kdesvn/tags/rel_0_6_2 http://www.alwins-world.de/repos/kdesvn/tags/rel_0_6_3