vcsh - Online na nuvem

PROGRAMA:

NOME

vcsh - Sistema de controle de versão para $ HOME - vários repositórios Git em $ HOME

SINOPSE

vcsh [opções] comando

vcsh clonar [-b ramo] url [repo]

vcsh delete repo

vcsh entrar repo

vcsh foreach [-g] git comando

vcsh ajudar

vcsh o init repo

vcsh Lista

vcsh rastreado por lista [repo]

vcsh lista não rastreada [-a] [-r] [repo]

vcsh puxar

vcsh empurrar

vcsh rebatizar repo novo nome

vcsh corrida repo concha comando

vcsh status [repo]

vcsh atualização repo

vcsh versão

vcsh qual substring

vcsh escreva-gitignore repo

vcsh repo git comando

vcsh repo

DESCRIÇÃO

vcsh permite que você tenha vários git(1) repositórios, todos mantendo suas árvores de trabalho
em $ HOME sem derrotar um ao outro. Isso, por sua vez, significa que você pode ter um repositório
por conjunto de configuração (zsh, vim, ssh, etc), escolhendo e escolhendo quais configurações você deseja usar em
qual máquina.

vcsh está usando uma técnica chamada repositórios Git nus falsos, mantendo $ GIT_DIR em uma
diretório diferente de $ GIT_WORK_TREE que é apontado para $ HOME.

O uso de links simbólicos não é necessário nesta configuração, tornando a configuração mais limpa.

vcsh foi projetado com mr(1) em mente, então você pode querer instalá-lo junto com o vcsh. Este
sendo dito, você pode facilmente usar vcsh sem mr se você preferir.

Um exemplo de configuração para vcsh e mr pode ser encontrada em
https://github.com/RichiH/vcsh_mr_template e usado com vcsh clonar
https://github.com/RichiH/vcsh_mr_template mr.

Observe que você sempre pode usar um caminho em vez de um nome para repo. Isso é necessário para
suporte mr e outros scripts de forma adequada e sem preocupação para um usuário interativo.

OPÇÕES

Fonte -c lima antes de outros arquivos de configuração

-d Habilita o modo de depuração

-v Ativar modo detalhado

COMANDOS

clone Clone um repositório existente.

Se você precisar clonar um pacote de repositórios, consulte o apos-clone-aposentado
gancho.

Você também pode usar um único repositório git com vários ramos. Use o -b opção
para especificar um branch no momento da clonagem, o padrão é dominar.

commit Commit em todos os repositórios

delete Exclua um repositório existente.

digite Enter repository; gerar novos $ SHELL.

foreach
Execute o comando git para cada repositório vcsh.

-g: Execute em contexto geral.

ajuda Mostra a ajuda.

init Inicializa um repositório vazio.

list Lista todos os repositórios vcsh locais.

rastreado por lista
Liste todos os arquivos rastreados por vcsh.

Se você quiser listar os arquivos rastreados por um repositório específico, basta anexar o
sobrenome do repositório.

listar rastreado por
Liste os arquivos rastreados por um repositório.

Este é um comando legado; você deveria usar rastreado por lista ao invés.

lista não rastreada
Liste todos os arquivos NÃO rastreados por vcsh.

-a: Mostra todos os arquivos. Por padrão, o git ls-arquivos --excluir-padrão é chamado.

-r: Modo recursivo. Por padrão, a lista de arquivos é superficial e pára no diretório
níveis sempre que possível.

$ repo: Lista os arquivos não rastreados por este repositório específico.

puxar Puxe de todos os controles remotos vcsh.

empurre Push para todos os controles remotos vcsh.

renomear Renomear um repositório.

execute o comando Executar com $ GIT_DIR e $ GIT_WORK_TREE definir. Permite que você execute todo e qualquer
comandos sem quaisquer restrições. Use com cuidado.

Observe que existe um recurso um tanto mágico para execução. Ao invés de repo it
aceita caminho, também. Qualquer coisa que tenha uma barra será considerada uma
caminho. vcsh corrida irá então operar neste diretório em vez do normalmente
gerado a partir do nome do repositório. Isso é necessário para apoiar o sr e outros
scripts corretamente e sem preocupação para um usuário interativo.

status Mostra o status de todos / um repositório vcsh.

atualização
Atualize o repositório para as configurações recomendadas atualmente.

versão
Imprima informações sobre a versão.

qual substring
Encontre substring no nome de qualquer arquivo rastreado.

escreva-gitignore
Escreva .gitignore.d /repo via git ls-arquivos.

repo comando git
Atalho para correr vcsh em um repo. Vai preceder git para comando.

repo Atalho para correr vcsh entrar .

MEIO AMBIENTE

Como observado anteriormente, vcsh estabelecerá $ GIT_DIR e $ GIT_WORK_TREE para os valores apropriados para
repositórios Git falsos.

CONFIG

Existem várias maneiras de ligar os vários botões vcsh. Em ordem ascendente
precedência, eles são:

· VARIABLE = foo vcsh

·

· <$ XDG_CONFIG_HOME / vcsh / config>

· vcsh -c

Observe que esses arquivos são originários. Todo e qualquer comando será executado no
contexto do seu shell.

Botões interessantes que você pode girar:

$ VCSH_GITATTRIBUTES
Pode ser Nenhum, ou qualquer outro valor.

Nenhum não manterá atributos Git em um local especial.

Se definido com qualquer outro valor, os arquivos gitattributes específicos do repo serão mantidos.

O padrão é Nenhum.

$ VCSH_GITIGNORE
Pode ser exato, Nenhum, ou recursiva.

exato irá semear o arquivo ignorar específico do repo com todos os nomes de arquivos e diretórios
qual git ls-arquivos retorna.

Nenhum não gravará nenhum arquivo para ignorar.

recursiva descerá por meio de todos os diretórios recursivamente, além do
acima.

O padrão é exato.

$ VCSH_VCSH_WORKTREE
Pode ser absoluto, ou relativo.

absoluto irá definir um caminho absoluto; padronizando para $ HOME.

relativo irá definir um caminho relativo a $ GIT_DIR.

O padrão é absoluto.

Botões menos interessantes que você pode girar:

$ VCSH_DEBUG
Entre no modo de depuração.

$ XDG_CONFIG_HOME
Conforme especificado na ´Especificação do Diretório Base XDG´, consulte
http://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html

O padrão é <$ HOME / .config>.

$ VCSH_REPO_D
O diretório onde os repositórios são lidos e armazenados.

O padrão é <$ XDG_CONFIG_HOME / vcsh / repo.d>.

$ VCSH_HOOK_D
O diretório de onde os ganchos são lidos.

O padrão é <$ XDG_CONFIG_HOME / vcsh / hooks-enabled>.

$ VCSH_BASE
O diretório onde os repositórios são retirados.

O padrão é $ HOME.

GANCHO SISTEMA

vcsh fornece um sistema de gancho. Os scripts de gancho devem ser executáveis ​​e devem ser colocados em
<$ XDG_CONFIG_HOME / vcsh / hooks-available>. A partir daí, eles podem ser vinculados a
<$ XDG_CONFIG_HOME / vcsh / hooks-enabled>; vcsh só executará ganchos que estão neste
diretório.

Os ganchos seguem um formato simples. pré-corrida será executado antes que qualquer coisa seja executada. Se você quiser
tem mais de um script para um certo gancho, basta acrescentar qualquer tipo de string para ordenar
eles. Um sistema de pré-corrida, , etc é sugerido; outras opções
seria pré-corrida-10 ou . Um ponto após o nome do gancho é opcional.

Se você deseja criar ganchos para um vcsh repositório, simplesmente acrescente o
nome do repositório, seguido de um ponto, ou seja . Caso contrário, as mesmas regras que
acima se aplicam. No entanto, o ponto entre o nome do repositório e o gancho é obrigatório.

Ganchos disponíveis são pré-clonar, pós-clonagem, apos-clone-aposentado, pré-comando, pós-comando,
pré-entrar, pós-entrada, pré-inicialização, pós-inicialização, pré-tração, pós-tração, pré-push, pós-push,
pré-corrida, pós-corrida, pré-atualização e pós-atualização. Se você precisar de mais, vcsh é trivial para
patch, mas por favor, avise o upstream para que possamos enviá-los por padrão.

OVERLAY SISTEMA

vcsh também fornece um sistema de sobreposição. Semelhante aos ganchos, os locais recomendados são
<$ XDG_CONFIG_HOME / vcsh / overlays-available> e <$ XDG_CONFIG_HOME / vcsh / overlays-enabled>.

As sobreposições seguem as mesmas regras que os ganchos e você é livre para sobrescrever todo e qualquer
funções. Da mesma forma que os ganchos, você pode usar sobreposições globais ou específicas do repositório usando
seja <$ VCSH_OVERLAY_D / $ VCSH_COMMAND> ou <$ VCSH_OVERLAY_D / $ VCSH_REPO_NAME. $ VCSH_COMMAND>.

Observe que nada o impede de, por exemplo, sobrescrever status() in
<$ VCSH_OVERLAY_D / commit>. Como as sobreposições serão obtidas e você está substituindo arbitrariamente
funções, todo e qualquer recurso pode parar de funcionar ou você pode até perder dados.

Você foi avisado.

DETALHADO HOWTO E MAIS LONGE READING

As páginas de manual geralmente são curtas e, às vezes, inúteis para obter as melhores práticas. Enquanto o
autor tentou evitar isso neste caso, as páginas de manual não podem cobrir howtos detalhados.

Este software também vem com um arquivo chamado . Ele contém várias abordagens para
configurar e usar o vcsh. Você pode ver o arquivo como texto simples ou renderizá-lo em
vários outros formatos via Markdown.

Em sistemas baseados em Debian, este arquivo pode ser encontrado em .

SEGURANÇA CONSIDERAÇÕES

vcsh permite que você execute comandos arbitrários via vcsh corrida. Por exemplo, adicionar um sudo(8).
regra para vcsh seria muito estúpido.

Além disso, o vcsh irá fornecer, ou seja, executar, todos os arquivos listados em CONFIG. Você pode colocar qualquer
e todos os comandos nesses arquivos de configuração e eles serão executados.

Use vcsh online usando serviços onworks.net