Adicione o repositório informado como um submódulo no caminho especificado ao conjunto de alterações para ser feito o commit ao lado do projeto atual: o projeto atual é chamado de "superproject".

Exiba a condição geral dos submódulos. Irá exibir o SHA-1 do commit registrado atualmente para cada submódulo, junto com o caminho do submódulo e a saída do comando git description para o SHA-1. Cada SHA-1 provavelmente será prefixado com - caso o submódulo não seja inicializado,+ caso o commit verificado do submódulo atual não coincida com o SHA-1 encontrado no índice do repositório que contenha o U caso o submódulo tenha conflitos de mesclagem.

Inicialize os submódulos registrados no índice (que foram adicionados e onde os commits foram feitos em outros lugares) configurando o submodule.$name.url no .git/config. Ele usa a mesma configuração do .gitmodules como um modelo. Caso a URL seja relativa, será resolvido utilizando ramo remoto predefinido. Caso não nenhum ramo remoto seja predefinido, o repositório atual será reconhecido como sendo a upstream.

Cancele o registro dos submódulos informado, ou seja, remova toda a seção submodule.$name do .git/config junto com a sua árvore de trabalho. Outras futuras chamadas para o comando git submodule update, git submodule foreach e git submodule sync irão ignorar todos os submódulos não registrados até que sejam inicializados novamente, então utilize este comando caso não queira mais fazer uma verificação do submódulo na sua árvore de trabalho local.

Define o submódulo como predefinido nos ramos monitorados remotamente. A opção --branch permite que o nome do ramo remoto seja definido. A opção --default remove a chave da configuração submodule.<nome>.branch, que faz com que a predefinição do ramo monitorado seja o HEAD remoto.

Define a URL do submódulo informado para <newurl> . Em seguida, sincronize automaticamente a nova configuração da URL remota do submódulo.

Exiba o resumo do commit entre o commit informado (a predefinição retorna para HEAD) e a árvore de trabalho/índice. Para um submódulo em questão, são exibidas uma série de commit do submódulo entre o commit do super projeto e o índice ou a árvore de trabalho (alternada por --cached). Caso a opção --files seja utilizada, exiba a série dos commits no submódulo entre o índice do super projeto e a árvore de trabalho do submódulo (esta opção não permite a utilização da opção --cached ou para informar um commit de forma explícita).

Avalia um comando arbitrário do shell em cada sub-módulo averiguado. O comando tem acesso às variáveis $name, $sm_path, $displaypath, $sha1 e $toplevel: $name é o nome da seção do submódulo relevante no .gitmodules, $sm_path é o caminho do submódulo conforme foi diretamente registrado no superprojeto, $displaypath contém o caminho relativo do diretório de trabalho atual para o diretório raiz dos sub-módulos, $sha1 é o commit conforme registrado diretamente no superprojeto e $toplevel é o caminho absoluto e direto para o nível mais alto do superprojeto. Observe que para evitar conflitos com $ PATH no Windows, a variável $path agora é um sinônimo obsoleto da variável $sm_path. Todos os submódulos definidos no superprojeto, mas sem averiguação, são ignorados por este comando. A menos que seja utilizado a opção --quiet, o foreach imprime o nome de cada submódulo antes de avaliar o comando. Caso a opção --recursive seja utilizada, os submódulos serão percorridos de forma recursiva (ou seja, o comando shell informado também será avaliado nos submódulos aninhados). Um retorno do comando diferente de zero em qualquer submódulo, faz com que o processamento seja finalizado. Isso pode ser alterado adicionando || : até o final do comando.

git submodule foreach 'echo $sm_path `git rev-parse HEAD`'

Sincroniza a configuração da URL remota dos submódulos com o valor definido em .gitmodules. Afetará apenas os submódulos que já possuem uma entrada da URL no .git/config (é o caso quando eles são inicializados ou foram adicionados recentemente). É útil quando as URLs do submódulo mudam a upstream e você precisa atualizar os seus repositórios locais de acordo.

Caso um diretório git de um submódulo estiver dentro dele, mova o diretório git do submódulo para o caminho $GIT_DIR/modules do superprojeto, conecte o diretório git, o seu diretório de trabalho, definindo core.worktree e adicionando um Arquivo .git apontando para o diretório git incorporado no diretório git dos superprojetos.

Exiba apenas as mensagens de erro.

Esta opção só é válida para os comandos add e update. É predefinido que a condição geral do progresso seja relatada no fluxo de erros quando estiver conectado em um terminal, a menos que -q seja utilizado. Esta opção impõem a condição geral do progresso, mesmo que o fluxo de erro predefinido não seja direcionado para um terminal.

Esta opção só é válida para o comando deinit. Cancele o registro de todos os submódulos na árvore de trabalho.

O ramo do repositório para ser adicionado como um submódulo. O nome do ramo é registrado como submodule.<nome>.branch no .gitmodules para update --remote. Um valor especial de . é utilizado para indicar que o nome do ramo no submódulo deve ser o mesmo nome como o da ramificação atual, no repositório atual. Caso a opção não seja utilizada, a predefinição retorna para o HEAD remoto.

Esta opção só é válida para os comandos add, deinit e update. Ao executar add, permita adicionar um caminho ignorado do submódulo. Ao executar o deinit, as árvores de trabalho do submódulo serão removidos mesmo que contenham alterações locais. Ao executar update (efetiva apenas com o procedimento de averiguação), descarte as alterações locais nos submódulos durante a alternância para um commit diferente; sempre execute uma operação de averiguação no submódulo, mesmo que o commit listado no índice do repositório coincida com o commit averiguado no submódulo.

Esta opção só é válida para os comandos status e summary. Esses comandos normalmente utilizam o commit encontrado no submódulo HEAD, porém o commit armazenado no índice que é utilizado em seu lugar.

Esta opção só é válida para o comando summary. Quando esta opção é utilizada o comando compara o commit no índice em conjunto com o que está no submódulo HEAD.

Esta opção só é válida para o comando summary. Limite o tamanho do resumo (quantidade de commits exibidos no total). O número 0 desativa o resumo; um número negativo significa ilimitado (já predefinido). Este limite se aplica apenas aos submódulos modificados. O tamanho é sempre limitado a 1 para os submódulos adicionado/excluído/tipo alterado.

Esta opção só é válida para o comando update. Em vez de utilizar o SHA-1 registrado no superprojeto para atualizar o submódulo, utilize a condição geral do submódulo do ramo monitorado remotamente. O ramo remoto utilizado é o ramo (branch.<nome>.remote) predefinido para origin. O ramo remoto costumava retornar para o HEAD remoto, porém o nome do ramo pode ser substituído ao definir a opção submodule.<nome>.branch ou entre .gitmodules ou .git/config (onde .git/config tem prioridade).

Esta opção só é válida para o comando update. Não capture os novos objetos do site remoto.

Esta opção só é válida para o comando update. Faça a averiguação do commit registrado no superprojeto em um HEAD desanexado no submódulo. Este é o comportamento predefinido, a utilização principal desta opção é substituir o submodule.$name.update quando definido como um valor diferente do checkout. Caso a chave do submodule.$name.update não esteja nem explicitamente configurada ou definida com checkout (para averiguação), então esta opção se torna implícita.

Esta opção só é válida para o comando update. Mescle o commit registrado no superprojeto do ramo atual do submódulo. Caso esta opção seja utilizada, o HEAD do submódulo não será desconectado. Caso uma mesclagem falhe e interrompa este processo, será necessário resolver os conflitos resultantes no submódulo com as ferramentas habituais da resolução de conflitos. Caso a chave submodule.$name.update esteja configurada para mesclar, então esta opção se torna implícita.

Esta opção só é válida para o comando update. Reorganize a fundação do ramo atual no commit registrado no superprojeto. Caso esta opção seja utilizada, o HEAD do submódulo não será desconectado. Caso uma mesclagem falhe e interrompa este processo, será necessário resolver os conflitos resultantes com git-rebase[1]. Caso a chave submodule.$name.update esteja definida como rebase, então esta opção se torna implícita.

Esta opção só é válida para o comando update. Inicialize todos os submódulos para os quais o comando "git submodule init" não foi chamado até o momento antes da atualização.

Esta opção só é válida para o comando add. Define o nome do submódulo para a carreira de caracteres informada em vez de padronizar o seu caminho. O nome deve ser válido como um nome de diretório e não pode terminar com um /.

Esta opção só é válida para os comandos add e update. Às vezes estes comandos precisam clonar um repositório remoto. Neste caso, esta opção será passada ao comando git-clone[1].

Esta opção só é válida para os comandos add e update. Às vezes estes comandos precisam clonar um repositório remoto. Neste caso, esta opção será passada ao comando git-clone[1].

Esta opção só é válida para os comandos foreach, update, status e sync. Transponha os submódulos recursivamente. A operação é executada não apenas nos submódulos do repositório atual, mas também em qualquer outro submódulo aninhado dentro desses submódulos (e assim por diante).

Esta opção é válida para os comandos add e update. Crie uma clonagem superficial com um histórico truncado para uma quantidade determinada de revisões. Consulte git-clone[1]

Esta opção só é válida para o comando update. O clone inicial de um submódulo por predefinição, utilizará o submodule.<nome>.shallow recomendado conforme é fornecido pelo arquivo .gitmodules. Para ignorar as sugestões, utilize --no-recommend-shallow.

Esta opção só é válida para o comando update. Clone novos submódulos em paralelo com a mesmo quantidade de trabalhos. A predefinição retorna para a configuração existente em submodule.fetchJobs.

Esta opção só é válida para o comando update. Clone apenas uma ramificação durante a atualização: HEAD ou uma definida pela opção --branch.

Caminhos para o submódulo(s). Quando for utilizado, restringe o comando a operar apenas nos submódulos encontrados nos caminhos informados. (É obrigatório a utilização desta opção com o add).