Lägg till det givna kodförrådet som en undermodul vid den givna sökvägen till ändringsmängden som ska checkas-in bredvid det aktuella projektet: det aktuella projektet kallas "superprojektet".

Visar statusen för undermodulerna. Detta skriv ut SHA-1 för den för närvarande utcheckade incheckning för varje undermodul, tillsammans med sökvägen till undermodulen och utdata från git describe för SHA-1. Varje SHA-1 kommer eventuellt att ha prefixet - om undermodulen inte är initierad, + om den för närvarande utcheckade undermoduls-incheckning inte matchar SHA-1 som finns i indexet för det innehållande kodförråd och U om undermodulen har sammanslagningskonflikter.

Initiera de undermoduler som är registrerade i indexet (som lades till och checkas-in någon annanstans) genom att sätta submodule.$name.url i .git/config, med samma inställning från .gitmodules som mall. Om URL:en är relativ kommer den att lösas med hjälp av standardfjärren. Om det inte finns någon standardfjärr antas det aktuella arkivet vara uppströms.

Avregistrera de givna undermodulerna, d.v.s. ta bort hela submodule.$name-sektionen från .git/config tillsammans med deras arbetsträd. Ytterligare anrop till git submodule update, git submodule foreach och git submodule sync kommer att hoppa över alla oregistrerade undermoduler tills de initialiseras igen, så använd det här kommandot om du inte längre vill ha en lokal utcheckning av undermodulen i ditt arbetsträd.

Ställer in standardgrenen för fjärrspårning för undermodulen. Alternativet --branch gör att fjärrgrenen kan specificeras. Alternativet --default tar bort konfigurationsnyckeln submodule.<namn>.branch, vilket gör att spårningsgrenen som standard anges till fjärrgrenen HEAD.

Ställer in URL:en för den angivna undermodulen till <nyurl>. Sedan synkroniseras undermodulens nya fjärr-URL-konfiguration automatiskt.

Visa inchecknings-sammanfattning mellan den givna incheckningen (standard är HEAD) och arbetsträd/index. För en aktuell undermodul visas en serie incheckningar i undermodulen mellan den givna superprojekt-incheckningen och indexet eller arbetskatalog (växlat med --cached). Om alternativet --files anges, visas serien av incheckningar i undermodulen mellan superprojektets index och undermodulens arbetskatalog (det här alternativet tillåter inte användning av alternativet --cached eller att tillhandahålla en explicit incheckning).

Utvärderar ett godtyckligt skalkommando i varje utcheckad undermodul. Kommandot har åtkomst till variablerna $name, $sm_path, $displaypath, $sha1 och $toplevel: $name är namnet på den relevanta undermodulsektionen i .gitmodules, $sm_path är sökvägen till undermodulen som registrerats i det omedelbara superprojektet, $displaypath innehåller den relativa sökvägen från den aktuella arbetskatalogen till undermodulernas rotkatalog, $sha1 är incheckning som registrerats i det omedelbara superprojektet, och $toplevel är den absoluta sökvägen till den översta nivån av det omedelbara superprojektet. Observera att för att undvika konflikter med $PATH i Windows är variabeln $path nu en föråldrad synonym till variabeln $sm_path. Alla undermoduler som definierats i superprojektet men inte utcheckats ignoreras av detta kommando. Om inte --quiet är angivet, skriver foreach ut namnet på varje undermodul innan kommandot utvärderas. Om --recursive anges, passeras undermoduler rekursivt (dvs. det givna shellkommandot utvärderas även i kapslade undermoduler). En retur som inte är noll från kommandot i någon undermodul gör att bearbetningen avslutas. Detta kan åsidosättas genom att lägga till || : i slutet av kommandot.

git-submodul för varje 'echo $sm_path `git rev-parse HEAD`'

Synkroniserar undermodulers konfigurationsinställning för fjärr-URL till värdet som anges i .gitmodules. Det påverkar endast de undermoduler som redan har en URL-post i .git/config (det är fallet när de initieras eller nyligen läggs till). Detta är användbart när undermodulers URL:er ändras uppströms och du behöver uppdatera dina lokala arkiv i enlighet därmed.

Om en git-katalog för en undermodul finns inuti undermodulen, flytta git-katalogen för undermodulen till dess superprojekts sökväg $GIT_DIR/modules och anslut sedan git-katalogen och dess arbetskatalog genom att ställa in core.worktree och lägga till en .git-fil som pekar på git-katalogen inbäddad i superprojects git-katalog.

Skriv bara ut felmeddelanden.

Det här alternativet är endast giltigt för kommandona "add" och "update". Förloppsstatus rapporteras som standard i standardfelströmmen när den är kopplad till en terminal, såvida inte -q anges. Denna flagga tvingar fram förloppsstatus även om standardfelströmmen inte dirigeras till en terminal.

Det här alternativet är endast giltigt för deinit-kommandot. Avregistrera alla undermoduler i arbetskatalog.

Gren till kodförrådet som ska läggas till som undermodul. Namnet på grenen registreras som submodule.<namn>.branch i .gitmodules för update --remote. Ett specialvärde på . används för att indikera att namnet på grenen i undermodulen ska vara samma namn som den aktuella grenen i det aktuella kodförrådet. Om alternativet inte anges används standardvärdet HEAD som fjärrnamn.

Det här alternativet är endast giltigt för kommandona add, deinit och update. När du kör add, tillåts tillägg av en annars ignorerad sökväg för en undermodul. Det här alternativet används också för att kringgå en kontroll av att undermodulens namn inte redan används. Som standard kommer git submodule add att misslyckas om det föreslagna namnet (som härleds från sökvägen) redan är registrerat för en annan undermodul i kodförrådet. Genom att använda --force kan kommandot fortsätta genom att automatiskt generera ett unikt namn genom att lägga till ett nummer till det motstridiga namnet (t.ex. om en undermodul med namnet child finns, kommer den att försöka child1, och så vidare). När du kör deinit kommer undermodulens arbetskatalog att tas bort även om de innehåller lokala ändringar. När du kör update (endast effektivt med utcheckningsproceduren), kasta bort lokala ändringar i undermoduler när du byter till en annan incheckning; och kör alltid en utcheckningsoperation i undermodulen, även om commiten som listas i indexet för det innehållande arkivet matchar den incheckning som checkats ut i undermodulen.

Det här alternativet gäller endast för status- och sammanfattnings-kommandon. Dessa kommandon använder vanligtvis incheckning som finns i undermodulen HEAD, men med det här alternativet, används istället incheckning som lagras i indexet.

Det här alternativet är endast giltigt för kommandot summary. Kommandot jämför incheckningen i indexet med den i undermodulen HEAD när det här alternativet används.

Det här alternativet gäller endast för kommandot summary. Begränsa storleken på sammanfattningen (antalet incheckninger som visas totalt). Om du anger 0 inaktiveras sammanfattningen; ett negativt tal betyder obegränsat (standard). Denna gräns gäller endast modifierade undermoduler. Storleken är alltid begränsad till 1 för tillagda/borttagna/typändrade undermoduler.

Det här alternativet är endast giltigt för kommandot update. Istället för att använda superprojektets registrerade SHA-1 för att uppdatera undermodulen, använd statusen för undermodulens fjärrspårningsgren. Fjärrgrenen som används är grenens fjärr (branch.<namn>.remote), med standardinställningen origin. Fjärrgrenen som används har som standard fjärren HEAD, men grennamnet kan åsidosättas genom att ställa in alternativet submodule.<namn>.branch i antingen .gitmodules eller .git/config (med .git/config prioriterat).

Det här alternativet är endast giltigt för kommandot update. Hämta inte nya objekt från fjärrplatsen.

Det här alternativet är endast giltigt för kommandot update. Checka ut incheckningen som registrerats i superprojektet på en frånkopplat HEAD i submodulen. Detta är standardbeteendet, det huvudsakliga syftet med det här alternativet är att åsidosätta submodule.$name.update när det är satt till ett annat värde än checkout. Om nyckeln submodule.$name.update antingen inte är explicit angiven eller är satt till checkout, är det här alternativet implicit.

Det här alternativet är endast giltigt för kommandot update. Sammanfoga incheckningen som registrerats in i superprojektet till den aktuella grenen av undermodulen. Om det här alternativet anges kommer undermodulens HEAD inte att kopplas från. Om ett sammanslagningsfel förhindrar denna process måste du lösa de resulterande konflikterna inom undermodulen med vanliga konfliktlösningsverktyg. Om nyckeln submodule.$name.update är satt till merge är det här alternativet implicit.

Det här alternativet är endast giltigt för kommandot update. Ombasera den aktuella grenen till incheckningen som registrerats i superprojektet. Om det här alternativet anges kommer undermodulens HEAD inte att bli frånkopplat. Om ett merge-fel förhindrar denna process måste du lösa dessa fel med git-rebase[1]. Om nyckeln submodule.$name.update är satt till rebase är det här alternativet implicit.

Det här alternativet är endast giltigt för kommandot update. Initiera alla undermoduler för vilka "git submodule init" inte har anropats hittills innan uppdatering.

Det här alternativet är endast giltigt för kommandot add. Det ställer in undermodulens namn till den angivna strängen istället för att som standard använda dess sökväg. Namnet måste vara giltigt som katalognamn och får inte sluta med ett /.

Det här alternativet är endast giltigt för kommandona add och update. Dessa kommandon behöver ibland klona ett fjärrkodförråd I det här fallet, skickas det här alternativet till kommandot git-clone[1].

Det här alternativet är endast giltigt för kommandona add och update. Dessa kommandon behöver ibland klona ett fjärrkodförråd I det här fallet, skickas det här alternativet till kommandot git-clone[1].

Det här alternativet är endast giltigt för kommandona foreach, update, status och sync. Gå igenom undermoduler rekursivt. Operationen utförs inte bara i undermodulerna i det aktuella repot, utan även i alla kapslade undermoduler inuti dessa undermoduler (och så vidare).

Det här alternativet är giltigt för kommandona add och update. Skapa en ytlig klon med en historik avkortad till det angivna antalet revisioner. Se git-clone[1]

Det här alternativet är endast giltigt för kommandot update. Den initiala klonen av en undermodul kommer att använda den rekommenderade submodule.<namn>.shallow som tillhandahålls av .gitmodules-filen som standard. För att ignorera förslagen, använd --no-recommend-shallow.

Det här alternativet är endast giltigt för kommandot update. Klona nya undermoduler parallellt med lika många jobb. Standardinställningen är submodule.fetchJobs.

Det här alternativet är endast giltigt för kommandot update. Klona endast en gren under uppdatering: HEAD eller en som anges av --branch.

Sökvägar till undermodul(er). När detta anges begränsas kommandot till att endast fungera på de undermoduler som finns vid de angivna sökvägarna. (Detta argument krävs med add).