Setup and Config
Getting and Creating Projects
Basic Snapshotting
Branching and Merging
Sharing and Updating Projects
Inspection and Comparison
Patching
Debugging
External Systems
Server Admin
- 2.43.1 → 2.46.1 no changes
- 2.43.0 11/20/23
- 2.10.5 → 2.42.3 no changes
- 2.9.5 07/30/17
- 2.1.4 → 2.8.6 no changes
- 2.0.5 12/17/14
DESCRIÇÃO
Esse não é um comando que o usuário final gostaria de executar. Nunca. Esta documentação destina-se às pessoas que estão estudando os scripts do Porcelain-ish e/ou que estão escrevendo novos scripts.
O scriptlet git sh-setup foi projetado para ser originado (usando .
) através dos outros scripts shell para configurar algumas variáveis apontando para os diretórios normais do Git e algumas funções auxiliares do shell.
Antes de fazer o "sourcing", o seu script deve configurar algumas variáveis; USAGE
(e LONG_USAGE
, se houver) é usado para definir a mensagem fornecida pela função shell usage()
. SUBDIRECTORY_OK
pode ser definido se o script puder ser executado num subdiretório da árvore de trabalho (alguns comandos não o fazem).
O scriptlet define o GIT_DIR
e as variáveis shell GIT_OBJECT_DIRECTORY
, porém não as exporta no ambiente.
FUNÇÕES
- die
encerra após emitir a mensagem de erro informada no fluxo de erros predefinido.
- usage
encerre com a mensagem do consumo.
- set_reflog_action
Define o ambiente
GIT_REFLOG_ACTION
como uma determinada cadeia de caracteres (normalmente o nome do programa), a menos que já esteja definido. Sempre que o script que atualiza refs executa um comandogit
, uma entrada no reflog é criada usando o valor dessa string para deixar o registro de qual comando atualizou a ref.- git_editor
executa um editor selecionado pelo usuário (GIT_EDITOR, core.editor, VISUAL ou EDITOR) em um determinado arquivo, mas com erro caso nenhum editor seja definido e o terminal for burro.
- is_bare_repository
gera
true
oufalse
no fluxo da saída padrão para indicar caso o repositório seja um repositório simples (ou seja, sem uma associação a qualquer árvore de trabalho).- cd_to_toplevel
executa o chdir no nível mais alto da árvore de trabalho.
- require_work_tree
verifica se o diretório atual está dentro da árvore de trabalho do repositório, ou de outra forma, encerre.
- require_work_tree_exists
verifica se a árvore de trabalho associada ao repositório existe e, caso contrário, encerra. Geralmente é feito antes de invocar
cd_to_toplevel
, o que é impossível de ser feito se não houver uma árvore de trabalho.- require_clean_work_tree <ação> [<dica>]
verifica se a árvore de trabalho e o índice associados ao repositório não têm alterações não confirmadas nos arquivos rastreados. Caso contrário, ele emite uma mensagem de erro no formato
Cannot <ação>: <motivo>. <dica>
, e encerra. Exemplo:require_clean_work_tree rebase "Faça o commit ou armazene-os."
- get_author_ident_from_commit
gera o código para uso com o eval para definir as variáveis
GIT_AUTHOR_NAME
,GIT_AUTHOR_EMAIL
eGIT_AUTHOR_DATE
para um determinado commit.- create_virtual_base
modifica o primeiro arquivo para que apenas as linhas em comum com o segundo arquivo permaneçam. Caso haja um material comum insuficiente, o primeiro arquivo será deixado vazio. O resultado é adequado como uma entrada da base virtual para mesclagem de três vias.
GIT
Parte do conjunto git[1]