Informação para os programadores sobre o KIO::ksvnNota
Poderá ignorar isto se não estiver interessado na programação com o KIO.
O KIO::ksvn::special conhece as seguintes operações; estas são feitas de forma quase igual à existente actualmente no KIO do 'kdesdk-kioslaves' por isso, por exemplo, o KDevelop podê-lo-á usar se o 'kdesdk-kioslaves' não estiver instalado, mas usa o kdesvn::KIO::svn.
Tabela 3.1. Visão geral dos comandos do KIO::ksvn::special
| Nome do comando | ID numérico | Lista de parâmetros | Implementado na versão actual? |
|---|---|---|---|
| Checkout | 1 |
KURL repositorio, KURL destino, int numVersao, QString tipoVersao O destino não será modificado isto é, mas o conteúdo será extraído sem criar uma sub-pasta! Por exemplo, a origem poderá estar em | Sim |
| Update | 2 | KURL url, int numVersao, QString textoVersao Se o numVersao < 0, é processado o 'textoVersao'. O formato do 'textoVersao' está descrito no Apêndice. | Sim |
| Commit | 3 | KURL::List urls O parâmetro 'urls' é uma lista com os URL's locais a enviar. Irá pedir a mensagem de registo. | Sim |
| Log | 4 |
int numVersaoInicial, QString textoVersaoInicial, int numVersaoFinal, QString textoVersaoFinal, KURL::List Use isto com cuidado - poderá produzir uma grande quantidade de dados. | Sim |
| Import | 5 | KURL repositorioDestino, KURL localOrigem | Sim |
| Add | 6 | KURL | Sim |
| Del | 7 | KURL::List | Sim |
| Reverter | 8 | KURL::List A reversão no KIO é sempre não-recursiva e sem quaisquer confirmações (a invocação da aplicação deverá fazê-lo por si) | Sim |
| Status | 9 | KURL item, bool verificarRepo, bool recursivo item - o item para o qual obter as informações, verificarRepo - verifica se existem versões mais recentes no repositório, recursivo - a verificação é recursiva ou não. | Sim |
| Mkdir | 10 | KURL::List | Sim |
| Resolve | 11 | KURL, bool recursivo | Sim |
| Switch | 12 | KURL pasta_copia_local, KURL url_novo_repositorio, bool recursivo, int numeroVersao, QString tipoVersao | Sim |
| Diff | 13 |
URL uri1, KURL uri2, int r1, QString rtexto1, int r2, QString rtexto2, bool recursivo Para as diferenças entre repositórios locais, use o protocolo 'file:///'. Para as diferenças entre cópias locais, defina os URL's sem protocolo! | Sim |
Os valores devolvidos podem ser obtidos por meta-dados, veja a documentação da API para mais detalhes.
Tabela 3.2. Conteúdo dos meta-dados
| Tecla | Valor possível |
|---|---|
| path | A localização do item sobre o qual foi feita a acção, isto é o URL indicado |
| action | O tipo de acção numérico |
| kind | O tipo de item (se é uma pasta ou um ficheiro) |
| mime_t | O tipo MIME do item no Subversion |
| content | O estado do conteúdo (valor do Subversion) |
| prop | O estado das propriedades (valor do Subversion) |
| rev | A versão resultante ou a versão manipulada |
| string | Uma mensagem interna e legível. |
| loggedaction | O texto da acção definida pelo Subversion sobre o item (A, M, D) |
| loggedcopyfrompath | Foi copiado a partir de que local? (pode ser vazio) |
| loggedcopyfromrevision | Foi copiado a partir de que versão? (poderá ser < 0) |
| loggedpath | Em que local individual a acção registada foi definida (a localização está definida com o URL de invocação) |
| diffresult | uma linha de resultado das diferenças |