Generera vanliga patchar utan diffstat.

Generate diffs with <n> lines of context. The number of context lines defaults to diff.context or 3 if the configuration variable is unset. (-U without <n> is silently accepted as a synonym for -p due to a historical accident).

Skriv utdata till en specifik fil i stället för stdout.

Ange tecknet som används för att indikera nya, gamla eller kontextuella rader i den genererade patchen. Normalt är de +, - respektive ' '.

Aktivera heuristiken som flyttar olika styckesgränser för att göra patchar lättare att läsa. Detta är standardinställningen.

Inaktivera indenteringsheuristiken.

Lägg extra tid på att se till att minsta möjliga skillnad produceras.

Generera en diff med algoritmen "patience diff".

Generera en diff med algoritmen "histogram diff".

Generera en diff med algoritmen "anchored diff".

Välj en diff-algoritm. Varianterna är följande:

Generera en diffstat. Som standard används så mycket utrymme som behövs för filnamnsdelen och resten för grafdelen. Maximal bredd är som standard terminalbredd, eller 80 kolumner om den inte är ansluten till en terminal, och kan åsidosättas av <bredd>. Bredden på filnamnsdelen kan begränsas genom att ge en annan bredd <namnbredd> efter ett kommatecken eller genom att ställa in diff.statNameWidth=<namnbredd>. Bredden på grafdelen kan begränsas genom att använda --stat-graph-width=<grafbredd> eller genom att ställa in diff.statGraphWidth=<grafbredd>. Att använda --stat eller --stat-graph-width påverkar alla kommandon som genererar en statistisk graf, medan att ställa in diff.statNameWidth eller diff.statGraphWidth inte påverkar git format-patch. Genom att ange en tredje parameter <count> kan du begränsa utdata till de första <count> raderna, följt av ... om det finns fler.

Skriv ut en komprimerad sammanfattning av utökad huvud-information, såsom skapande eller borttagning av filer ("ny" eller "borta", valfritt +l om det är en symbolisk länk) och lägesändringar (+x eller -x för att lägga till respektive ta bort en körbar bit) i diffstat. Informationen placeras mellan filnamnsdelen och grafdelen. Innebär --stat.

Liknar --stat, men visar antalet tillagda och borttagna rader i decimalnotation och sökväg utan förkortning, för att göra det mer maskinvänligt. För binära filer matas två - ut i stället för 0 0.

Skriv endast ut den sista raden i formatet --stat som innehåller det totala antalet ändrade filer, samt antalet tillagda och borttagna rader.

Visar fördelningen av den relativa mängden ändringar för varje underkatalog. Beteendet för --dirstat kan anpassas genom att skicka en kommaseparerad lista med parametrar. Standardvärdena styrs av konfigurationsvariabeln diff.dirstat (se git-config[1]). Följande parametrar är tillgängliga:

Synonym för --dirstat=cumulative.

Synonym för --dirstat=files,<param>,....

Skriv ut en komprimerad sammanfattning av utökad huvud-information, såsom skapanden, namnbyten och läges-ändringar.

Stäng av namnbytesdetektering, även när konfigurationsfilen anger standardinställningen för det.

Huruvida tomma blobbar ska användas som namnbyteskälla.

I stället för de första tecknen, visa de fullständiga namnen på blob-objekten före och efter avbildningen på "index"-raden när du genererar utdata för patch-format.

Förutom --full-index, mata ut en binär diff som kan tillämpas med git-apply.

I stället för att visa det fullständiga 40-byte hexadecimala objektnamnet i utdata i diff-raw-format och diff-tree-rubrikrader, visa det kortaste prefixet som är minst <n> hexdigits långt och som unikt refererar till objektet. I diff-patch-utdataformat har --full-index högre prioritet, d.v.s. om --full-index anges kommer fullständiga blobnamn att visas oavsett --abbrev. Antal siffror som inte är standard kan anges med --abbrev=<n>.

Dela upp fullständiga omskrivningsändringar i par av radera och skapa. Detta tjänar två syften:

detektera namnändringar Om <n> anges, är det ett tröskelvärde för likhetsindexet (dvs. mängden tillägg/borttagningar jämfört med filens storlek). Till exempel betyder -M90% att Git ska betrakta ett borttagnings-/tilläggspar som ett namnbyte om mer än 90 % av filen inte har ändrats. Utan ett %-tecken ska talet läsas som ett bråktral, med ett decimaltecken före. Dvs. -M5 blir 0,5 och är således detsamma som -M50%. På liknande sätt är -M05 detsamma som -M5%. För att begränsa detekteringen till exakta namnbyten, använd -M100%. Standardlikhetsindexet är 50 %.

Identifiera kopior såväl som byt namn. Se även --find-copies-harder. Om <n> anges har det samma betydelse som för -M<n>.

Av prestandaskäl hittar -C-alternativet som standard bara kopior om originalfilen för kopian ändrades i samma ändringsuppsättning. Denna flagga gör att kommandot inspekterar omodifierade filer som kandidater för kopians källa. Detta är en mycket dyr operation för stora projekt, så använd den med försiktighet. Att ge mer än ett -C-alternativ har samma effekt.

Utelämna preimage för borttagningar, d.v.s. skriv bara ut huvudet men inte skillnaden mellan preimage och /dev/null. Den resulterande patchen är inte avsedd att tillämpas med patch eller git apply; detta är enbart för personer som bara vill koncentrera sig på att granska texten efter ändringen. Dessutom saknar utdata uppenbarligen tillräckligt med information för att tillämpa en sådan patch i omvänd ordning, även manuellt, därav namnet på alternativet.

Alternativen -M och -C involverar några preliminära steg som kan upptäcka delmängder av namnbyten/kopior billigt, följt av en uttömmande del som jämför alla återstående oparade destinationer med alla relevanta källor. (För namnbyten är endast återstående oparade källor relevanta; för kopior är alla originalkällor relevanta.) För N källor och destinationer är denna uttömmande kontroll O(N^2). Detta alternativ förhindrar att den uttömmande delen av namnbytes-/kopieringsdetektering körs om antalet inblandade käll-/destinationsfiler överstiger det angivna antalet. Standardvärdet är diff.renameLimit. Observera att värdet 0 behandlas som obegränsat.

Styr ordningen i vilka filer visas i utdata. Detta åsidosätter konfigurationsvariabeln diff.orderFile (se git-config[1]). För att avbryta diff.orderFile, använd -O/dev/null.

Släng filerna före den namngivna <fil> från utdata (d.v.s. hoppa till), eller flytta dem till slutet av utdata (d.v.s. rotera till). Dessa alternativ uppfanns främst för användning av git difftool-kommandot, och kanske inte är särskilt användbara annars.

När den körs från en underkatalog till projektet kan den få instruktioner att exkludera ändringar utanför katalogen och visa sökvägar relativa till den med detta alternativ. När du inte befinner dig i en underkatalog (t.ex. i ett bart arkiv) kan du namnge vilken underkatalog som utdata ska vara relativ till genom att ange <sökväg> som argument. --no-relative kan användas för att ångra både konfigurationsalternativet diff.relative och föregående --relative.

Hantera alla filer som text.

Ignorera vagnretur i slutet av raden vid en jämförelse.

Ignorera ändringar i blanktecken vid radslut.

Ignorera ändringar i mängden blanktecken. Detta ignorerar blanktecken i radslutet och betraktar alla andra sekvenser av ett eller flera mellanslagstecken som likvärdiga.

Ignorera blanktecken när du jämför rader. Detta ignorerar skillnader även om en rad har blanktecken medan den andra raden inte har något.

Ignorera ändringar i rader som är helt blanka.

Ignorera ändringar vars alla rader matchar <regex>. Det här alternativet kan anges mer än en gång.

Visar sammanhanget mellan olika stycken, upp till det angivna <antal> rader, och sammanfogar därmed stycken som ligger nära varandra. Standardvärdet är diff.interHunkContext eller 0 om konfigurationsalternativet inte är inställt.

Visa hela funktionen som kontextrader för varje ändring. Funktionsnamnen bestäms på samma sätt som git diff räknar ut patch-hunk-huvuden (se "Definiera en anpassad styckes-huvud" i gitattributes[5]).

Tillåt att en extern diff-hjälp körs. Om du ställer in en extern diff-drivrutin med gitattributes[5], måste du använda den här alternativet med git-log[1] och vänner.

Tillåt inte externa diff-drivrutiner.

Tillåt (eller förbjud) att externa textkonverteringsfilter körs vid jämförelse av binära filer. Se gitattributes[5] för mer information. Eftersom textconv-filter vanligtvis är en envägskonvertering är den resulterande diff-funktionen lämplig för mänsklig konsumtion, men kan inte tillämpas. Av denna anledning är textconv-filter som standard endast aktiverade för git-diff[1] och git-log[1], men inte för git-format-patch[1] eller diff rörmokeri-kommandon.

Ignorera ändringar i undermoduler i diff-genereringen. all är standardinställningen. Om none används betraktas undermodulen som modifierad när den antingen innehåller ospårade eller modifierade filer, eller om dess HEAD skiljer sig från incheckningen som registrerats i superprojektet, och kan användas för att åsidosätta alla inställningar i ignore-alternativet i git-config[1] eller gitmodules[5]. När untracked används anses undermoduler inte vara smutsiga när de bara innehåller ospårat innehåll (men de skannas fortfarande efter modifierat innehåll). Om dirty används ignoreras alla ändringar i arbetsträdet för undermoduler, endast ändringar i de incheckningar som lagras i superprojektet visas (detta var beteendet fram till 1.7.0). Om all används döljs alla ändringar i undermoduler.

Visa det angivna käll_<prefix>_ i stället för "a/".

Visa det angivna mål_<prefix>_ i stället för "b/".

Visa inte käll- eller målprefix.

Använd standard käll- och destinationsprefixen ("a/" och "b/"). Detta åsidosätter konfigurationsvariabler som diff.noprefix, diff.srcPrefix, diff.dstPrefix och diff.mnemonicPrefix (se git-config[1]).

Lägg till ett ytterligare <prefix> före varje utdatarad.

Som standard visas poster som läggs till av git add -N som en befintlig tom fil i git diff och en ny fil i git diff --cached. Det här alternativet gör att posten visas som en ny fil i git diff och obefintlig i git diff --cached. Det här alternativet kan ångras med --ita-visible-in-index. Båda alternativen är experimentella och kan komma att tas bort i framtiden.

För varje sökvägsmönster som anges på kommandoraden, gå ner högst <djup>-nivåer i kataloger. Värdet -1 betyder ingen gräns. Kan inte kombineras med jokertecken i sökvägsmönster. Givet ett träd som innehåller foo/bar/baz visar följande lista de träffar som genereras av varje uppsättning alternativ:

Förbered patchar från de senaste <n> incheckningarna.

Använd <kat> för att lagra de resulterande filerna, i stället för den aktuella arbetskatalogen.

Namnge utdata i formatet [PATCH n/m], även med en enda patch.

Namnge utdata i formatet [PATCH].

Börja numrera patcherna vid <n> i stället för 1.

Utdatafilernas namn blir en enkel nummersekvens utan den normala första raden från incheckningsmeddelandet.

Ta inte bort/lägg inte till [PATCH] i första raden av incheckningsloggmeddelandet.

Lägg till en Signed-off-by-slutrad till incheckningsmeddelandet, med din egen incheckare-identitet. Se signoff-alternativet i git-commit[1] för mer information.

Skriv ut alla incheckningar till standardutdata i mbox-format, i stället för att skapa en fil för varje enskild incheckning.

Skapa en multipart/mixed-bilaga där första delen är incheckningsmeddelandet och patchen själv ligger i andra delen, med Content-Disposition: attachment.

Inaktivera skapandet av en bilaga, vilket åsidosätter konfigurationsinställningen.

Skapa en multipart/mixed-bilaga där första delen är incheckningsmeddelandet och patchen själv ligger i andra delen, med Content-Disposition: inline.

Styr tillägg av rubrikerna In-Reply-To och References för att få det andra och efterföljande e-postmeddelandena att visas som svar på det första. Styr också genereringen av rubriken Message-ID att referera till.

Få det första mejlet (eller alla mejl med --no-thread) att visas som ett svar på det angivna <meddelande-id>, vilket undviker att trådar bryts för att tillhandahålla en ny patchserie.

Inkludera inte en patch som matchar en incheckning i <tills>..<sedan>. Detta kommer att undersöka alla patchar som är åtkomliga från <sedan> men inte från <tills> och jämföra dem med de patchar som genereras, och alla patchar som matchar ignoreras.

Inkludera patchar för incheckningar som inte introducerar några ändringar, vilka utelämnas som standard.

Styr vilka delar av följebrevet som fylls i automatiskt med hjälp av grenens beskrivning.

Använd innehållet i <fil> i stället för grenens beskrivning för att generera följebrevet.

I stället för standardprefixet [PATCH] i ämnesraden, använd i stället [<ämnesprefix>]. Detta kan användas för att namnge en patchserie och kan kombineras med alternativet --numbered.

I stället för standardvärdet 64 byte kapas de genererade utdatafilnamnen till ungefär <n> byte (ett för kort värde höjs tyst till en rimlig längd). Standardvärdet är värdet i konfigurationsvariabeln format.filenameMaxLength, eller 64 om den inte är satt.

Lägger till strängen <rfc> (standardinställningen är "RFC") framför ämnesprefixet. Eftersom ämnesprefixet är standardinställt på "PATCH" får du "RFC PATCH" som standard.

Markera serien som den <n>:te iterationen av ämnet. Utdatafilnamnen får prefixet v<n>, och ämnesprefixet ("PATCH" som standard, men konfigurerbart med alternativet --subject-prefix) får tillägget ` v<n>. Till exempel kan --reroll-count=4 skapa filen v4-0001-add-makefile.patch, som innehåller "Subject: [PATCH v4 1/20] Add makefile". <n> behöver inte vara ett heltal (till exempel tillåts "--reroll-count=4.4" eller "--reroll-count=4rev2"), men nackdelen med ett sådant värde är att range-diff/interdiff mot föregående version inte exakt anger vilken version den nya iterationen jämförs med.

Lägg till en To:-huvudrad i e-posthuvudena. Detta läggs ovanpå eventuella konfigurerade huvudrader och kan användas flera gånger. Den negerade formen --no-to kastar bort alla To:-huvudrader som lagts till hittills (från konfiguration eller kommandorad).

Lägg till en Cc:-huvudrad i e-posthuvudena. Detta läggs ovanpå eventuella konfigurerade huvudrader och kan användas flera gånger. Den negerade formen --no-cc kastar bort alla Cc:-huvudrader som lagts till hittills (från konfiguration eller kommandorad).

Använd ident i From:-huvudraden i varje incheckningsmejl. Om författaridentiteten för incheckningen inte textuellt matchar angiven ident, lägg en From:-huvudrad i meddelandets brödtext med den ursprungliga författaren. Om ingen ident anges används incheckarens identitet.

När e-postavsändaren anges via alternativet --from läggs som standard en in-body-From: högst upp i incheckningsloggmeddelandet för att identifiera den verkliga författaren, om avsändaren skiljer sig från författaren. Med det här alternativet läggs in-body-From: till även när avsändaren och författaren har samma namn och adress, vilket kan hjälpa om e-postlistans programvara förvanskar avsändaridentiteten. Standardvärdet hämtas från konfigurationsvariabeln format.forceInBodyFrom.

Lägg till en godtycklig huvudrad i e-posthuvudena. Detta läggs ovanpå eventuella konfigurerade huvudrader och kan användas flera gånger. Till exempel --add-header="Organization: git-foo". Den negerade formen --no-add-header kastar bort alla (To:, Cc: och anpassade) huvudrader som hittills lagts till från konfiguration eller kommandorad.

Generera, utöver patcharna, en följebrevsfil som innehåller grenbeskrivningen, shortlog och den övergripande diffstat. Du kan fylla i en beskrivning i filen innan du skickar den.

Koda e-posthuvuden som innehåller icke-ASCII-tecken med "Q-encoding" (beskrivet i RFC 2047), i stället för att skriva ut huvudraderna ordagrant. Standardvärdet hämtas från konfigurationsvariabeln format.encodeEmailHeaders.

Som hjälp för granskare kan du infoga en interdiff i följebrevet, eller som kommentar till den enda patchen i en 1-patchserie, som visar skillnaderna mellan den tidigare versionen av patchserien och serien som formateras nu. föregående är en enskild revision som anger toppen för den föregående serien, vilken delar en gemensam bas med serien som formateras (till exempel git format-patch --cover-letter --interdiff=feature/v1 -3 feature/v2).

Som hjälp för granskare kan du infoga en range-diff (se git-range-diff[1]) i följebrevet, eller som kommentar till den enda patchen i en 1-patchserie, som visar skillnaderna mellan den tidigare versionen av patchserien och serien som formateras nu. föregående kan vara en enskild revision som anger toppen för den tidigare serien om den delar en gemensam bas med serien som formateras (till exempel git format-patch --cover-letter --range-diff=feature/v1 -3 feature/v2), eller ett revisionsintervall om de två versionerna av serien är åtskilda (till exempel git format-patch --cover-letter --range-diff=feature/v1~3..feature/v1 -3 feature/v2).

Använd tillsammans med --range-diff för att justera heuristiken som matchar incheckningar mellan den föregående och den aktuella patchserien genom att ändra justeringsfaktorn för kostnad vid skapande/borttagning. Se git-range-diff[1] för detaljer.

Lägg till anteckningarna (se git-notes[1]) för incheckningen efter raden med tre bindestreck.

Lägg till en signatur i varje meddelande som skapas. Enligt RFC 3676 separeras signaturen från brödtexten med en rad som innehåller '-- '. Om signaturalternativet utelämnas används Git-versionsnumret som standardsignatur.

Fungerar precis som --signature, förutom att signaturen läses från en fil.

I stället för att använda .patch som suffix för genererade filnamn, använd det angivna suffixet. Ett vanligt alternativ är --suffix=.txt. Om du lämnar detta tomt tas suffixet .patch bort.

Skriv inte ut namnen på de genererade filerna till standardutdata.

Visa inte innehållet i ändringarna i binära filer, utan visa i stället ett meddelande om att filerna har ändrats. Patchar som genereras med det här alternativet kan inte tillämpas korrekt, men de är fortfarande användbara för kodgranskning.

Skriv ut en hash med enbart nollor i varje patchs From:-huvud i stället för incheckningens hash.

Registrera basträdinformationen för att identifiera det tillstånd som patchserien gäller för. Se avsnittet BASTRÄDINFORMATION nedan för mer information. Om <incheckning> är "auto" väljs en basincheckning automatiskt. Alternativet --no-base åsidosätter en format.useAutoBase-konfiguration.

Behandla revisionsargumentet som ett <revisionsintervall>, även om det bara är en enda incheckning (som normalt skulle behandlas som en <sedan>). Observera att rotincheckningar som ingår i det angivna intervallet alltid formateras som skapandepatchar, oberoende av denna flagga.

Visa förloppsrapporter på stderr när patchar genereras.