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 confirmados em outro lugar) definindo submodule.$name.url em .git/config, usando a mesma configuração de .gitmodules como modelo. Se o URL for relativo, ele será resolvido usando o ramo remoto padrão. Se não houver um ramo remoto padrão, o repositório atual será considerado 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 de shell arbitrário em cada submódulo verificado. O comando tem acesso às variáveis $name, $sm_path, $displaypath, $sha1 e $toplevel: O $name é o nome da seção relevante do submódulo em .gitmodules, $sm_path é o caminho do submódulo conforme registrado no superprojeto imediato, $displaypath contém o caminho relativo do diretório de trabalho atual para o diretório raiz do submódulo, $sha1 é o commit conforme registrado no superprojeto imediato e $toplevel é o caminho absoluto para o topo imediato 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 que não tenham sido verificados, são ignorados por esse comando. A menos que seja informado a opção --quiet, o foreach imprime o nome de cada submódulo antes de avaliar o comando. Se a opção --recursive for usada, os submódulos serão percorridos recursivamente (ou seja, o comando do shell fornecido também será avaliado nos submódulos aninhados). Um retorno diferente de zero do comando em qualquer submódulo faz com que o processamento seja encerrado. Isso pode ser substituído pela adição de || : ao 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.

Essa opção só é válida para o comando add e update. A condição geral do progresso é relatada no fluxo de erro padrão por padrão quando ele é anexado a um terminal, a menos que a opção -q seja especificada. Esta opção impõem a condição geral de progresso, ainda que o fluxo de erro predefinido não seja direcionado a 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 que será adicionado como um submódulo. O nome do ramo é gravado como submodule.<nome>.branch em .gitmodules para update --remote. Um valor especial . é usado para indicar que o nome do ramo no submódulo deve ser o mesmo nome do ramo atual no repositório atual. Se a opção não for especificada, a predefinição é o HEAD remoto.

Esta opção só é válida para os comandos add, deinit e update. Ao executar add, permite adicionar um caminho de submódulo que de outra forma seria ignorado. Ao executar o deinit, as árvores de trabalho do submódulo serão removidas mesmo que contenham alterações locais. Ao executar o update (apenas eficaz com o procedimento de checkout), descarte as alterações locais nos submódulos ao mudar para um commit diferente; e execute sempre uma operação de checkout no submódulo, mesmo que o commit listado no índice do repositório que o contém corresponda ao commit verificado no submódulo.

Esta opção só é válida para os comandos statuse summary. Esses comandos normalmente usam o commit encontrado no submódulo HEAD, mas com essa opção, o commit armazenado no índice é usado.

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. Limitar o tamanho do resumo summary (quantidade de commits mostrados no total). Usar 0 desativará o resumo summary; um número negativo significa ilimitado (o padrão). Este limite só se aplica aos submódulos alterados. O tamanho é sempre limitado a 1 para submódulos adicionados/excluídos/alterados por tipo.

Esta opção só é válida para o comando update. Em vez de usar o SHA-1 registrado do superprojeto para atualizar o submódulo, use a condição do submódulo da ramificação rastreada remotamente. O "remoto" usado é o ramo da ramificação remota (branch.<nome>.remote), cujo padrão é origin. A ramificação remota usada tem como padrão o HEAD remoto, mas o nome da ramificação pode ser substituído pela configuração da opção submodule.<nome>.branch em .gitmodules ou .git/config (tendo precedência o .git/config).

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

Esta opção só é válida para o comando update. Faça o checkout do commit registrado no superprojeto num HEAD desanexado no submódulo. Esse é o comportamento predefinido; o principal uso dessa opção é substituir submodule.$name.update quando definido com um valor diferente do checkout. Se a chave submodule.$name.update não estiver explicitamente definida ou estiver definida como checkout, essa opção será implícita.

Esta opção só é válida para o comando update. Mesclar o commit registrado no superprojeto na ramificação atual do submódulo. Se essa opção for fornecida, o HEAD do submódulo não será desanexado. Se uma falha de mesclagem impedir este processo, você terá que resolver os conflitos resultantes dentro do submódulo com as ferramentas usuais de resolução de conflitos. Se a chave submodule.$name.update estiver definida como merge, esta opção estará implícita.

Esta opção só é válida para o comando update. Faça o rebase do ramo atual para o commit registrado no superprojeto. Se essa opção for fornecida, o HEAD do submódulo não será desanexado. Se uma falha de mesclagem impedir este processo, você terá que resolver estas falhas com o comando git-rebase[1]. Se a chave submodule.$name.update estiver definida como rebase, esta opção estará implícita.

Esta opção só é válida para o comando update. Inicialize todos os submódulos para onde o 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 /.

Essa opção só é válida para o comando add e update. Esses comandos às vezes precisam clonar um repositório remoto. Nesse caso, essa opção será encaminhada para o comando git-clone[1].

Essa opção só é válida para o comando add e update. Esses comandos às vezes precisam clonar um repositório remoto. Nesse caso, essa opção será encaminhada para o comando git-clone[1].

Essa opção só é válida para os comandos foreach, update, status e sync. Percorrer os submódulos recursivamente. A operação é realizada não apenas nos submódulos do repositório atual, mas também em quaisquer submódulos aninhados dentro desses submódulos (e assim por diante).

Esta opção é válida para os comandos add e update. Cria um clone superficial (shallow) com um histórico truncado para o número especificado de revisões. Consulte git-clone[1]

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

Esta opção só é válida para o comando update. Clonar os novos submódulos em paralelo com a mesma quantidade de trabalhos. A predefinição é o que estiver em submodule.fetchJobs.

Esta opção só é válida para o comando update. Clone apejas um ramo durante a atualização: HEAD ou um ramo especificado pela opção --branch.

Os caminhos para os submódulos. Quando especificada, esta opção restringirá o comando a operar apenas nos submódulos encontrados nos caminhos especificados. (Esta é uma exigência do argumento add).