SvnSubversion Command-Line Client svn é o cliente oficial da linha de comando do Subversion. Sua funcionalidade é oferecida através de uma coleção de subcomandos específicos da tarefa, a maioria dos quais aceita uma série de opções para controle fino do comportamento dos programas. Ao usar o programa svn, subcomandos e outros argumentos não-opção devem aparecer em uma ordem especificada na linha de comando. As opções, por outro lado, podem aparecer em qualquer lugar na linha de comando (após o nome do programa, é claro) e, em geral, seu pedido é irrelevante. Por exemplo, todas as seguintes são formas válidas de usar o status svn. E são interpretados exatamente da mesma maneira: as seções a seguir descrevem cada um dos vários subcomandos e opções fornecidos pelo programa de cliente de linha de comando svn, incluindo alguns exemplos de cada subcomando de usos típicos. Svn Opções Enquanto o Subversion tem opções diferentes para seus subcomandos, todas as opções existem em um único recurso de nomes, cada opção é garantida para significar a mesma coisa, independentemente do subcomando com o qual você usa. Por exemplo, --verbose (-v) sempre significa saída detalhada, independentemente do subcomando com o qual você usa. O cliente da linha de comando svn geralmente sai rapidamente com um erro se você passar uma opção que não se aplica ao subcomando especificado. Mas a partir do Subversion 1.5, várias das opções que se aplicam a quase todos os subcomandos foram consideradas aceitáveis por todos os subcomandos, mesmo que não tenham efeito sobre alguns deles. (Esta alteração foi feita principalmente para melhorar a capacidade dos clientes de chamar de scripts de envolvimento personalizados.) Essas opções aparecem agrupadas nas mensagens de uso de clientes de linha de comando como opções globais, como pode ser visto no seguinte bit de saída: os subcomandos svn reconhecem As seguintes opções globais: instrui o Subversion a ler as informações de configuração do diretório especificado em vez da localização padrão (.subversão no diretório inicial dos usuários). Define, durante a duração do comando, o valor de uma opção de configuração de tempo de execução. CONFSPEC é uma string que especifica o espaço de nome da opção de configuração, o nome e o valor que você gostaria de atribuir, formatados como FILE: SECTION: OPTION VALUE. Nesta sintaxe, FILE e SECTION são o arquivo de configuração do tempo de execução (configuração ou servidores) e a seção dele, respectivamente, que contém a opção cujo valor você deseja alterar. A OPÇÃO é, claro, a própria opção, e VALUE o valor (se houver) que deseja atribuir à opção. Por exemplo, para desativar temporariamente o uso do recurso de configuração de propriedade automática, use --config-optionconfig: miscellany: enable-auto-propsno. Você pode usar esta opção várias vezes para alterar vários valores de opções simultaneamente. Evita o armazenamento em cache de informações de autenticação (por exemplo, nome de usuário e senha) nos diretórios de configuração do tempo de execução do Subversion. Desativa todas as solicitações interativas. Alguns exemplos de solicitação interativa incluem solicitações de credenciais de autenticação e decisões de resolução de conflitos. Isso é útil se você estiver executando o Subversion dentro de um script automatizado e é mais apropriado ter o Subversion falhar do que solicitar mais informações. Especifica a senha a ser utilizada ao autenticar contra um servidor Subversion. Se não for fornecido, ou se estiver incorreto, o Subversion solicitará essa informação, conforme necessário. Quando usado com - não interativo. Instrui o Subversion a aceitar certificados de servidor SSL emitidos por autoridades de certificação desconhecidas sem primeiro avisar o usuário. Por motivos de segurança, você deve usar essa opção somente quando a integridade do servidor remoto e o caminho de rede entre ela e seu cliente forem confiáveis. Especifica o nome de usuário a ser usado ao autenticar um servidor Subversion. Se não for fornecido, ou se estiver incorreto, o Subversion solicitará essa informação, conforme necessário. O restante das opções se aplica e é aceito apenas por um subconjunto do subcomando. Eles são os seguintes: Especifica uma ação para a resolução automática de conflitos. Possíveis ações são adiar. base. Cheio de mina. Eles estão cheios. editar. E lançamento. Desativa a verificação executada por padrão pela svn fusionar a partir do Subversion 1.7 que o objetivo de uma operação de mesclagem e todos os seus filhos estão em uma revisão uniforme. Embora a fusão em um alvo de cópia de trabalho de revisão única seja a melhor prática recomendada, esta opção pode ser usada para permitir fusões em cópias de trabalho de revisão mista conforme necessário. Permite a atribuição automática de propriedades (por regras de configuração de tempo de execução), substituindo a diretiva de configuração de tempo de execução de habilitação automática. Execute a operação solicitada usando uma alteração específica. De um modo geral, esta opção é açúcar sintático para - r ARG-1: ARG. Alguns subcomandos permitem uma lista separada por vírgulas de argumentos de número de revisão (por exemplo, - c ARG1, ARG2, ARG3). Alternativamente, você pode fornecer dois argumentos separados por um dash (como em - c ARG1 - ARG2) para identificar o intervalo de revisões entre ARG1 e ARG2. Inclusive. Finalmente, se o argumento de revisão for negado, o intervalo de revisão implícita será revertido: - c -45 é equivalente a - r 45:44. Instrui o Subversion a operar apenas em membros da lista de mudanças chamada ARG. Você pode usar esta opção várias vezes para especificar conjuntos de changelists. Instrui o Subversion a limitar o alcance de uma operação a uma determinada profundidade da árvore. ARG é um dos vazios (apenas o alvo em si), arquivos (o alvo e qualquer arquivo imediato deles), imediatos (o alvo e seus filhos imediatos), ou infinito (o alvo e a totalidade de sua recursão descendente). Permite um modo de saída especial para svn log que inclui um relatório de diferença (a la svn diff) como parte de cada informação de revisão. Especifica um programa externo para usar para mostrar diferenças entre arquivos. Quando o svn diff é invocado sem esta opção, ele usa o mecanismo de diferenciação interna do Subversions, que fornece diffs unificados por padrão. Se você quiser usar um programa de diferenciação externo, use --diff-cmd. Você pode então passar opções para o programa especificado usando a opção --extensions (-x). Especifica um programa externo de diferenciação de 3 vias (usado para mesclar mudanças baseadas em linha em arquivos). Vai através de todos os movimentos de executar um comando, mas não faz nenhuma troca real no disco ou no repositório. Especifica um programa externo para usar para editar uma mensagem de log ou um valor de propriedade. Veja a seção editor-cmd na seção chamada Configuração para formas de especificar um editor padrão. Diz a Subversion que sua mensagem de compromisso é composta usando a codificação de caracteres fornecida. A codificação de caractere padrão é derivada de sua localidade nativa dos sistemas operacionais use esta opção se sua mensagem de confirmação for composta usando qualquer outra codificação. Especifica as personalizações que o Subversion deve fazer ao realizar cálculos de diferença. As extensões válidas incluem: Ignorar alterações na quantidade de espaço em branco. Ignore todo o espaço em branco. Ignore as alterações no estilo EOL (final da linha). Mostrar nomes de função C na saída de dif. Mostre três linhas de contexto de diferença unificada. O valor padrão de ARG é - u. Se você deseja passar vários argumentos, você deve incluir todos eles entre aspas. Observe que quando o Subversion está configurado para invocar um comando diff externo, o valor da opção --extension (-x) não está restrito às opções mencionadas anteriormente, mas pode ser qualquer argumento adicional que o Subversion deve passar para esse comando. Usa o conteúdo do arquivo nomeado para o subcomando especificado. Subcomandos diferentes fazem coisas diferentes com esse conteúdo. Por exemplo, o commit svn usa o conteúdo como uma mensagem de log de confirmação, enquanto o sps de svn o usa como um valor de propriedade. Força um determinado comando ou operação para executar. O Subversion impedirá que você execute algumas operações no uso normal, mas você pode passar desta opção para dizer ao Subversion que eu sei o que estou fazendo, bem como as possíveis repercussões de fazê-lo, então deixe-me em. Esta opção é o equivalente programático de fazer seu próprio trabalho elétrico com o poder se você não sabe o que está fazendo, é provável que você tenha um choque desagradável. Força um parâmetro suspeito passado para a opção --message (-m) ou - file (-F) para ser aceita como válida. Por padrão, o Subversion produzirá um erro se os parâmetros dessas opções parecerem que eles poderiam ser alvos do subcomando. Por exemplo, se você passar um caminho de arquivos versionados para a opção --file (-F), o Subversion assumirá que você cometeu um erro, que o caminho era, em vez disso, o alvo da operação e que você simplesmente não forneceu alguns Otherunversionedfile como a fonte de sua mensagem de log. Para afirmar sua intenção e substituir esses tipos de erros, passe a opção --force-log para subcomandos que aceitam mensagens de log. Permite um modo de saída especial para svn diff projetado para compatibilidade cruzada com o popular sistema de controle de versão distribuído Git. Se usado com um ou mais subcomandos, mostra o texto de ajuda incorporado para cada um. Se usado sozinho, ele exibe o texto geral de ajuda do cliente. Indica ao Subversion que ignore a ascendência ao calcular diferenças (confia apenas no conteúdo do caminho). Também desativa o Fusionamento de rastreamento quando usado com o subcomando Svn Merge. Indica ao Subversion que ignore as definições externas e as cópias de trabalho externas gerenciadas por elas. Desativa a expansão de palavras-chave. Instrui svn patch para ignorar espaços em branco ao tentar identificar o contexto do patch. Imprime saída em um formato adequado para concatenação para saída similar anterior. Instrui o Subversion a usar seu mecanismo de diferenciação incorporado apesar de qualquer mecanismo de diferenciação externo que possa ser especificado para uso na configuração de tempo de execução dos usuários. Indica ao Subversion que não remova os assentos de lista de alterações dos itens de cópia de trabalho depois de confirmar. Mantém a cópia local de um arquivo ou diretório (usado com o comando svn delete). Mostra apenas as primeiras mensagens de registro NUM. Indica que você irá especificar uma mensagem de log ou um comentário de bloqueio na linha de comando, seguindo esta opção. Por exemplo: faz com que a exportação de svn use uma seqüência específica de fim de linha como se fosse a seqüência nativa para a plataforma do cliente. ARG pode ser um dos CR. LF. Ou CRLF. Usa ARG como o alvo mais novo (para uso com svn diff). Desabilita a configuração automática da propriedade, substituindo a diretiva de configuração de tempo de execução de habilitação automática. Impede o Subversion de imprimir diferenças para arquivos excluídos. O comportamento padrão quando você remove um arquivo é para o svn diff para imprimir as mesmas diferenças que você veria se você tivesse mantido o arquivo, mas removido todo o conteúdo. Mostra arquivos na lista de status que normalmente seria omitido, pois eles combinam um padrão na opção de configuração global-ignores ou a propriedade svn: ignore. Consulte a seção chamada Config e a seção chamada Ignorar itens não versionados para obter mais informações. Indica ao Subversion que não desbloqueie arquivos automaticamente. (O comportamento de confirmação padrão é desbloquear todos os arquivos listados como parte do commit). Consulte a seção chamada Bloqueio para obter mais informações. Descontinuada . Pára um subcomando de recursar em subdiretórios. A maioria dos subcomandos recurse por padrão, mas alguns não. Os usuários devem evitar essa opção e usar a opção - depth mais precisa. Para a maioria dos subcomandos, especificar - não-recursivo produz comportamento que é o mesmo que se você especificasse --depthfiles. Mas existem exceções: o status svn não recursivo opera na profundidade imediata, e as formas não recursivas do svn revertem. Svn add. E svn commit operar em uma profundidade vazia. Preste atenção à ancestralidade ao calcular as diferenças. Usa ARG como o alvo antigo (para usar com svn diff). Cria e adiciona subdiretórios parentais inexistentes ou não convertidos para a cópia de trabalho ou repositório como parte de uma operação. Isso é útil para criar automaticamente vários subdiretórios onde nenhum atualmente existe. Se executado em um URL, todos os diretórios serão criados em um único commit. Solicita que o cliente imprima apenas informações essenciais ao executar uma operação. Habilita um modo especial de svn merge em que a operação de mesclagem especificada é gravada nas informações de rastreamento de mesclagem local, mas na verdade não é executada. Faz uma recursão de subcomandos em subdiretórios. (A maioria dos subcomandos recurse por padrão.) Usado com o subcomando svn merge para mesclar todas as URLs de origem são alteradas para a cópia de trabalho. Veja a seção chamada Manter um ramo em sincronização para obter detalhes. Descontinuada. Quando usado com o subcomando svn switch, altera a localização do repositório que a sua cópia de trabalho faz referência. A abordagem preferida do Subversion 1.7, no entanto, é usar o subcomando svn relocate. Veja svn relocate para mais detalhes e um exemplo. Usou com o svn changelist to disassociaterather than associate (que é a operação padrão) o (s) alvo (s) de uma lista de alterações. Causa o patch svn para interpretar as instruções do patch de entrada na reversão de linhas adicionadas como removidas e vice-versa. Especifica uma revisão (ou intervalo de revisões) com a qual operar. Você pode fornecer números de revisão, palavras-chave ou datas (em chaves) como argumentos para a opção de revisão. Se você deseja oferecer uma série de revisões, você pode fornecer duas revisões separadas por dois pontos. Por exemplo: Opera em uma propriedade de revisão em vez de uma propriedade específica de um arquivo ou diretório. Esta opção requer que você também passe uma revisão com a opção --revision (-r). Define a profundidade pegajosa em um diretório em uma cópia de trabalho para uma de excluir. vazio. arquivos. Imediatos. Ou infinito. Para uma cobertura detalhada sobre o que isso significa e sobre como usar essa opção, consulte a seção chamada Diretórios Esparsos. Permite um modo de saída especial para svn diff em que a diferença de conteúdo para um arquivo criado através de uma operação de cópia aparece como seria para um arquivo novo (com cada linha que aparece como uma adição a um arquivo vazio) em vez de um delta contra O arquivo original a partir do qual a cópia foi criada. Usado para fazer o svn mergeinfo exibir certas classes de informações de rastreamento de mesclagem. ARG pode ser mesclado ou elegível. Indicando o desejo de ver revisões já fundidas ou elegíveis para futuras fusões da URL de origem especificada, respectivamente. Faz com que o cliente exiba informações sobre quais arquivos em sua cópia de trabalho estão desatualizados. Isso realmente não atualiza nenhum dos seus arquivos. Apenas mostra quais arquivos serão atualizados se você usar a atualização svn. Causa um subcomando Subversion que atravessa o histórico de um recurso versionado para parar de colher essas informações históricas quando uma cópia é essa, uma localização no histórico onde esse recurso foi copiado de outro local no repositório encontrado. Faz Subversion para usar uma semântica estrita, uma noção que é bastante vaga, a menos que falem sobre subcomandos específicos (ou seja, svn propget). Usado pelo patch svn para ignorar os componentes do caminho NUM líder encontrados nos caminhos especificados no arquivo de entrada do patch. Exibir apenas notificações de resumo de alto nível sobre a operação em vez de sua saída detalhada. Indica ao Subversion que leia caminhos de destino adicionais para a operação de FILENAME. FILENAME deve conter um caminho por linha, com cada caminho que se espera que use a mesma codificação e formatação que faria se você o tivesse especificado diretamente como um argumento na linha de comando. Usa ou exibe informações adicionais do histórico de mesclagem. Solicita que o cliente imprima tanta informação quanto possível ao executar qualquer subcomando. Isso pode resultar na impressão do Subversion em campos adicionais, informações detalhadas sobre todos os arquivos ou informações adicionais sobre suas ações. Imprime as informações da versão do cliente. Esta informação inclui não apenas o número de versão do cliente, mas também uma listagem de todos os módulos de acesso ao repositório que o cliente pode usar para acessar um repositório Subversion. Com --quiet (-q) imprime apenas o número da versão de forma compacta. Usado com a opção --xml para o svn log. Instrui Subversion a recuperar e exibir todas as propriedades de revisão dos padrões usados internamente pelo Subversion, bem como quaisquer partes definidas pelo usuário na saída do log. Usado com a opção --xml para o svn log. Instrui Subversion a omitir todas as propriedades de revisão, incluindo a mensagem de registro padrão, o autor e as datas de revisão da saída do log. Quando usado com qualquer comando que escreve no repositório, define a propriedade de revisão, usando o formato NAMEVALUE, NOME para VALOR. Quando usado com svn log in --xml modo, isso exibe o valor de ARG na saída de log. Imprime saída em formato XML. Descrição Exibe as diferenças entre dois caminhos. Você pode usar o svn diff das seguintes maneiras: use apenas svn diff para exibir modificações locais em uma cópia de trabalho. Exibir as mudanças feitas no TARGET s como são vistas em REV entre duas revisões. TARGET s pode ser todos os caminhos de cópia de trabalho ou todos os URL s. Se TARGET s estiver trabalhando caminhos de cópia, N padrão para BASE e M para a cópia de trabalho se TARGET s são URL s, N deve ser especificado e M padrão para HEAD. A opção - c M é equivalente a - r N: M onde N M-1. Usando - c - M faz o reverso: - r M: N onde N M-1. Mostra as diferenças entre OLD-TGT como foi visto em OLDREV e NEW-TGT como foi visto no NEWREV. PATH s, se dado, são relativos a OLD-TGT e NEW-TGT e restringem a saída às diferenças para esses caminhos. OLD-TGT e NEW-TGT podem estar funcionando caminhos de cópia ou URLREV. NOVO-TGT padrão para OLD-TGT se não especificado. - r N torna OLDREV padrão para N - r N: M faz OLDREV padrão para N e NEWREV padrão para M. Svn diff OLD-URLOLDREV NEW-URLNEWREV é uma abreviatura para svn diff --oldOLD-URLOLDREV --newNEW-URLNEWREV. Svn diff - r N: M URL é uma abreviatura para svn diff - r N: M --OLDURL --newURL. Svn diff - r N: M URL1N URL2M é uma abreviatura para svn diff - r N: M --oldURL1 --newURL2. Se TARGET for um URL, as rotações N e M podem ser administradas através da opção --revision (-r) ou usando a notação conforme descrito anteriormente. Se TARGET for um caminho de cópia de trabalho, o comportamento padrão (quando não é fornecida uma opção --revision (-r)) é exibir as diferenças entre a base e as cópias de trabalho do TARGET. Se uma opção --revision (-r) for especificada neste cenário, porém, significa: O servidor compara TARGETN e TARGETM. O cliente compara TARGETN contra a cópia de trabalho. Se a sintaxe alternativa for usada, o servidor compara URL1 e URL2 nas revisões N e M. respectivamente. Se qualquer N ou M for omitido, um valor de HEAD é assumido. Por padrão, svn diff ignora a ancestralidade dos arquivos e meramente compara o conteúdo dos dois arquivos sendo comparados. Se você usar - notar-ancestralidade. A ancestralidade dos caminhos em questão será levada em consideração ao comparar as revisões (ou seja, se você executar svn diff em dois arquivos com conteúdo idêntico, mas uma ascendência diferente, você verá todo o conteúdo do arquivo como tendo sido removido e adicionado novamente).
No comments:
Post a Comment