Svenska ▾ Topics ▾ Latest version ▾ git-show last updated in 2.53.0

NAMN

git-show - Visa olika typer av objekt

SYNOPSIS

git show [<flaggor>] <objekt>…​

BESKRIVNING

Visar ett eller flera objekt (blobbar, träd, taggar och incheckningar).

För incheckningar visas loggmeddelandet och den textuella differensen. Den presenterar också sammanslagings-incheckningen i ett speciellt format som produceras av git diff-tree --cc.

För taggar, visar den taggmeddelandet och de refererade objekten.

För träd, visar den namnen (motsvarande git ls-tree med --name-only).

För vanliga blobbar, visar den det vanliga innehållet.

Vissa alternativ som kommandot git log förstår kan användas för att styra hur ändringarna som incheckning introducerar visas.

Den här manualsidan beskriver endast de mest använda alternativen.

ALTERNATIV

<objekt>…​

Namnen på objekt som ska visas (standardinställningen är HEAD). För en mer komplett lista över hur objektnamn stavas, se avsnittet "SPECIFICERING AV REVISIONER" i gitrevisions[7].

--pretty[=<format>]
--format=<format>

Skriv ut innehållet i inchecknings-loggarna i ett givet format med en pretty-print, där <format> kan vara ett av följande: oneline, short, medium, full, fuller, reference, email, raw, format:<string> och tformat:<string>. När <format> inte är något av ovanstående, och innehåller %<placeholder>, fungerar det som om --pretty=tformat:<format> vore angivet.

Se avsnittet "VACKERT FORMAT" för ytterligare information om varje format. När =<format>-delen utelämnas används medium som standard.

Note
 Du kan ange standardformatet för pretty i förvars-konfigurationen (se git-config[1]).
--abbrev-commit

Istället för att visa det fullständiga 40-byte hexadecimala inchecknings-objektnamnet, visa ett prefix som namnger objektet unikt. Alternativet --abbrev=<n> (som också modifierar diff-utdata, om det visas) kan användas för att ange prefixets minsta längd.

Detta borde göra --pretty=oneline mycket mer läsbar för personer som använder terminaler med 80 kolumner.

--no-abbrev-commit

Visa det fullständiga 40-byte hexadecimala inchecknings-objektnamnet. Detta negerar --abbrev-commit, antingen explicit eller underförstått av andra alternativ som --oneline. Det åsidosätter också variabeln log.abbrevCommit.

--oneline

Detta är en förkortning för --pretty=oneline --abbrev-commit som används tillsammans.

--encoding=<kodning>

Incheckning-objekt registrerar teckenkodningen som används för loggmeddelandet i deras kodningshuvud; det här alternativet kan användas för att ange att kommandot ska koda om inchecknings-loggmeddelandet i den kodning som användaren föredrar. För icke-rörmokeri-kommandon är standardvärdet UTF-8. Observera att om ett objekt påstår sig vara kodat i X och vi matar ut i X, kommer vi att mata ut objektet ordagrant; det betyder att ogiltiga sekvenser i den ursprungliga commiten kan kopieras till utdata. På samma sätt, om iconv(3) misslyckas med att konvertera incheckningen, kommer vi att mata ut det ursprungliga objektet ordagrant i tysthet.

--expand-tabs=<n>
--expand-tabs
--no-expand-tabs

Utför en tabbexpandering (ersätt varje tabb med tillräckligt med mellanslag för att fylla till nästa visningskolumn som är en multipel av <n>) i loggmeddelandet innan det visas i utdata. --expand-tabs är en förkortning för --expand-tabs=8, och --no-expand-tabs är en förkortning för --expand-tabs=0, vilket inaktiverar tabbexpandering.

Som standard expanderas flikarna i snygga format som indenterar loggmeddelandet med 4 mellanslag (dvs. medium, som är standard, full och fuller).

--notes[=<ref>]

Visa anteckningarna (se git-notes[1]) som kommenterar incheckningen när inchecknings-loggmeddelandet visas. Detta är standardinställningen för kommandona git log, git show och git whatchanged när det inte finns något --pretty, --format eller --oneline-alternativ angivet på kommandoraden.

Som standard, är de anteckningar som visas från anteckningsreferenserna som listas i variablerna core.notesRef och notes.displayRef (eller motsvarande miljööverskridanden). Se git-config[1] för mer information.

Med ett valfritt argument <ref>, använd ref för att hitta de anteckningar som ska visas. Ref kan ange hela referensnamnet när det börjar med refs/notes/; när det börjar med notes/, prefixeras refs/ och annars refs/notes/ för att bilda referensens fullständiga namn.

Flera --notes-alternativ kan kombineras för att styra vilka anteckningar som visas. Exempel: "--notes=foo" visar endast anteckningar från refs/notes/foo; "--notes=foo --notes" visar både anteckningar från "refs/notes/foo" och från standardanteckningsreferenserna.

--no-notes

Visa inte anteckningar. Detta upphäver ovanstående alternativ --notes, genom att återställa listan över anteckningsreferenser från vilka anteckningar visas. Alternativ analyseras i den ordning som anges på kommandoraden, så t.ex. "--notes --notes=foo --no-notes --notes=bar" kommer bara att visa anteckningar från refs/notes/bar.

--show-notes-by-default

Visa standardanteckningarna om inte alternativ för att visa specifika anteckningar anges.

--show-notes[=<ref>]
--standard-notes
--no-standard-notes

Dessa alternativ är föråldrade. Använd alternativen --notes/--no-notes ovan istället.

--show-signature

Kontrollera giltigheten hos ett signerat inchecknings-objekt genom att skicka signaturen till gpg --verify och visa utdata.

Warning

Missing sv/pretty-formats.adoc

See original version for this content.

DIFF-FORMATERING

Alternativen nedan kan användas för att ändra hur git show genererar diff-utdata.

-p
-u
--patch

Generate patch (see Generera patchtext med -p).

-s
--no-patch

Undertryck all utdata från diff-maskineriet. Användbart för kommandon som git show som visar patchen som standard för att undertrycka deras utdata, eller för att avbryta effekten av alternativ som --patch, --stat tidigare på kommandoraden i ett alias.

-m

Visa differenser för sammanslagings-incheckningar i standardformatet. Detta liknar --diff-merges=on, förutom att -m inte kommer att producera någon utdata om inte -p också anges.

-c

Producera kombinerad diff-utdata för sammanslagings-incheckningar. Genväg för --diff-merges=combined -p.

--cc

Producera tät kombinerad diff-utdata för sammanslagnings-incheckningar. Genväg för --diff-merges=dense-combined -p.

--dd

Skapa diff med avseende på första föräldern för både sammanslå- och reguljära incheckningar. Genväg för --diff-merges=first-parent -p.

--remerge-diff

Produce remerge-diff output for merge commits. Shortcut for --diff-merges=remerge -p.

--no-diff-merges

Synonym för --diff-merges=off.

--diff-merges=<format>

Ange diff-formatet som ska användas för sammanslagnings-incheckningar. Standardinställningen är `dense-combined` om inte --first-parent används, i vilket fall first-parent är standardinställningen.

Följande format stöds:

off
none

Inaktivera utdata för diffs för sammanslagnings-incheckningar. Användbart för att åsidosätta implicita värden.

on
m

Gör diff-utdata för sammanslagnings-incheckningar så att de visas i standardformatet. Standardformatet kan ändras med hjälp av konfigurationsvariabeln log.diffMerges, vars standardvärde är separate.

first-parent
1

Visa fullständig skillnad med avseende på första föräldern. Detta är samma format som --patch producerar för icke-sammanslagna incheckningar.

separate

Visa fullständig differens med avseende på varje förälder. Separat loggpost och differens genereras för varje förälder.

combined
c

Visa skillnader från varje förälder till sammanslagningsresultatet samtidigt istället för att visa parvisa skillnader mellan en förälder och resultatet en i taget. Dessutom listas endast filer som har ändrats från alla föräldrar.

dense-combined
cc

Komprimera ytterligare utdata som produceras av --diff-merges=combined genom att utelämna ointressanta stycken vars innehåll i föräldrarna bara har två varianter och sammanslagningsresultatet väljer en av dem utan modifiering.

remerge
r

Återsammanfoga två-föräldra sammanslagnings-incheckningar för att skapa ett temporärt trädobjekt – potentiellt innehållande filer med konfliktmarkörer och liknande. En skillnad visas sedan mellan det temporära trädet och den faktiska sammanslagnings-incheckningen.

Utdata som genereras när detta alternativ används kan komma att ändras, och detsamma gäller dess interaktion med andra alternativ (såvida det inte uttryckligen dokumenterats).

--combined-all-paths

Gör att kombinerade diffs (används försammanslagnings-incheckningar) listar namnet på filen från alla föräldrar. Det har således bara effekt när --diff-merges=[dense-]combined används, och är sannolikt bara användbart om filnamnsändringar upptäcks (dvs. när antingen namnbyte eller kopieringsdetektering har begärts).

-U<n>
--unified=<n>

Generera skillnader med <n> kontextrader istället för de vanliga tre. implicerar --patch.

--output=<fil>

Utdata till en specifik fil istället för stdout.

--output-indicator-new=<tecken>
--output-indicator-old=<tecken>
--output-indicator-context=<tecken>

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

--raw

För varje incheckning, visa en sammanfattning av ändringarna med hjälp av raw diff -formatet. Se avsnittet "RÅTTUTGÅNGSFORMAT" i git-diff[1]. Detta skiljer sig från att visa själva loggen i råformat, vilket du kan uppnå med --format=raw.

--patch-with-raw

Synonym till -p --raw.

-t

Visa trädobjekten i diff-utdata.

--indent-heuristic

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

--no-indent-heuristic

Inaktivera indenteringsheuristiken.

--minimal

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

--patience

Generera en diff med algoritmen "patience diff".

--histogram

Generera en diff med algoritmen "histogram diff".

--anchored=<text>

Generera en diff med algoritmen "anchored diff".

Det här alternativet kan anges mer än en gång.

Om en rad finns i både käll- och destinationsraden, bara finns en gång och börjar med <text>, försöker den här algoritmen förhindra att den visas som en borttagning eller tillägg i utdata. Den använder algoritmen "patience diff" internt.

--diff-algorithm=(patience|minimal|histogram|myers)

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

default
myers

Den grundläggande giriga diff-algoritmen. För närvarande är detta standard.

minimal

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

patience

Använd algoritmen "patience diff" när du genererar patchar.

histogram

Denna algoritm utökar tålamodsalgoritmen till att "stödja vanliga element med låg förekomst".

Om du till exempel, konfigurerade variabeln diff.algorithm till ett värde som inte är standard och vill använda standardvärdet, måste du använda alternativet --diff-algorithm=default.

--stat[=<bredd>[,<namn-bredd>[,<antal>]]

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.

Dessa parametrar kan också ställas in individuellt med --stat-width=<bredd>, --stat-name-width=<namn-bredd> och --stat-count=<antal>.

--compact-summary

Skriv ut en komprimerad sammanfattning av utökad headerinformation, 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.

--numstat

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 istället för att säga 0 0.

--shortstat

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

-X [<param>,...]
--dirstat[=<param>,...]

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:

changes

Beräkna dirstat-talen genom att räkna raderna som har tagits bort från källan eller lagts till i destinationen. Detta ignorerar mängden rena kodförflyttningar inom en fil. Med andra ord räknas inte omarrangemang av rader i en fil lika mycket som andra ändringar. Detta är standardbeteendet när ingen parameter anges.

lines

Beräkna dirstat-talen genom att göra den vanliga radbaserade diff-analysen och summera antalet borttagna/tillagda rader. (För binära filer, räkna istället 64-byte-block, eftersom binära filer inte har något naturligt koncept för rader). Detta är ett dyrare --dirstat-beteende än changes-beteendet, men det räknar omordnade rader i en fil lika mycket som andra ändringar. Den resulterande utdata överensstämmer med vad du får från de andra --*stat-alternativen.

files

Beräkna dirstat-talen genom att räkna antalet ändrade filer. Varje ändrad fil räknas lika i dirstat-analysen. Detta är det beräkningsmässigt billigaste beteendet för --dirstat, eftersom det inte behöver titta på filinnehållet alls.

cumulative

Count changes in a child directory for the parent directory as well. Note that when using cumulative, the sum of the percentages reported may exceed 100%. The default (non-cumulative) behavior can be specified with the noncumulative parameter.

<gränsvärde>

En heltalsparameter anger en gränsvärde i procent (3 % som standard). Kataloger som bidrar med mindre än denna procentandel av ändringarna visas inte i utdata.

Exempel: Följande räknar ändrade filer, ignorerar kataloger med mindre än 10 % av den totala mängden ändrade filer och ackumulerar antal underkataloger i överordnade kataloger: --dirstat=files,10,cumulative.

--cumulative

Synonym för --dirstat=cumulative.

--dirstat-by-file[=<param>,...]

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

--summary

Output a condensed summary of extended header information such as creations, renames and mode changes.

--patch-with-stat

Synonym till -p --stat.

-z

Separera incheckningar med NUL istället för newlines.

Also, when --raw or --numstat has been given, do not munge pathnames and use NULs as output field terminators.

Utan detta alternativ, citeras sökvägar med "ovanliga" tecken enligt beskrivningen för konfigurationsvariabeln core.quotePath (se git-config[1]).

--name-only

Visa endast namnet på varje ändrad fil i trädet efter avbildningen. Filnamnen är ofta kodade i UTF-8. För mer information, se diskussionen om kodning på manualsidan för git-log[1].

--name-status

Visa endast namn och status för varje ändrad fil. Se beskrivningen av alternativet --diff-filter för information om vad statusbokstäverna betyder. Precis som --name-only är filnamnen ofta kodade i UTF-8.

--submodule[=<format>]

Ange hur skillnader i undermoduler visas. När --submodule=short anges används formatet short. Detta format visar bara namnen på incheckningar i början och slutet av intervallet. När --submodule eller --submodule=log anges används formatet log. Detta format listar incheckningar i intervallet, precis som git-submodule[1] summary gör. När --submodule=diff anges används formatet diff. Detta format visar en inline-diff av ändringarna i undermodulinnehållet mellan inchecknings-intervallet. Standardinställningen är diff.submodule eller formatet short om konfigurationsalternativet inte är inställt.

--color[=<när>]

Visa färglagd skillnad. --color (dvs. utan =<när>) är samma sak som --color=always. <när> kan vara en av always, aldrig eller auto.

--no-color

Stäng av färgad diff. Det är samma sak som --color=never.

--color-moved[=<läge>]

Flyttade kodrader färgas annorlunda. Standardvärdet för <läge> är no om alternativet inte anges och zebra om alternativet utan läge anges. Läget måste vara ett av:

no

Flyttade linjer markeras inte.

default

Är en synonym för "zebra". Detta kan komma att ändras till ett mer förnuftigt läge i framtiden.

plain

Alla rader som läggs till på en plats och togs bort på en annan plats kommer att färgas med color.diff.newMoved. På liknande sätt kommer color.diff.oldMoved att användas för borttagna rader som läggs till någon annanstans i diff-filen. Det här läget plockar upp alla flyttade rader, men det är inte särskilt användbart i en granskning för att avgöra om ett kodblock flyttades utan permutation.

blocks

Block med flyttad text på minst 20 alfanumeriska tecken upptäcks snabbt. De upptäckta blocken målas med antingen färgen color.diff.(old|new)Moved. Intilliggande block kan inte skiljas åt.

zebra

Block med flyttad text detekteras som i blocks-läge. Blocken målas med antingen färgen color.diff.(old|new)Moved eller color.diff.(old|new)MovedAlternative. Växlingen mellan de två färgerna indikerar att ett nytt block har detekterats.

dimmed-zebra

Liknar zebra, men ytterligare nedtoning av ointressanta delar av flyttad kod utförs. Gränslinjerna för två intilliggande block anses intressanta, resten är ointressant. dimmed_zebra är en föråldrad synonym.

--no-color-moved

Stäng av rörelsedetektering. Detta kan användas för att åsidosätta konfigurationsinställningar. Det är samma sak som --color-moved=no.

--color-moved-ws=<läge>,...

Detta konfigurerar hur blanksteg ignoreras när rörelsedetektering utförs för --color-moved. Dessa lägen kan anges som en kommaseparerad lista:

no

Ignorera inte blanksteg när du utför rörelsedetektering.

ignore-space-at-eol

Ignorera ändringar i blanktecken vid radslut.

ignore-space-change

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

ignore-all-space

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.

allow-indentation-change

Ignorera först eventuella blanksteg i flyttdetekteringen, gruppera sedan de flyttade kodblocken endast i ett block om ändringen i blanksteg är densamma per rad. Detta är inkompatibelt med de andra lägena.

--no-color-moved-ws

Ignorera inte blanksteg när du utför rörelsedetektering. Detta kan användas för att åsidosätta konfigurationsinställningar. Det är samma sak som --color-moved-ws=no.

--word-diff[=<läge>]

Som standard avgränsas ord med blanksteg; se --word-diff-regex nedan. <läge> har som standard plain och måste vara en av:

color

Markera ändrade ord med endast färger. Innebär --color.

plain

Visar ord som [-borttagen-] och {tillagd}. Gör inga försök att ta escape avgränsare om de förekommer i indata, så utdata kan vara tvetydig.

porcelain

Använd ett speciellt radbaserat format avsett för skriptanvändning. Tillagda/borttagna/oändrade körningar skrivs ut i det vanliga enhetliga diff-formatet, med början med ett +/-/` -tecknet i början av raden och sträcker sig till slutet av raden. Nya rader i inmatningen representeras av en tilde `~ på en egen rad.

none

Inaktivera orddiff igen.

Observera att trots namnet på det första läget, används färg för att markera de ändrade delarna i alla lägen om det är aktiverat.

--word-diff-regex=<regex>

Använd <regex> för att avgöra vad ett ord är, istället för att betrakta sträckor av icke-blanksteg som ett ord. Innebär även --word-diff om det inte redan var aktiverat.

Varje icke-överlappande matchning av <regex> betraktas som ett ord. Allt mellan dessa matchningar betraktas som blanktecken och ignoreras(!) i syfte att hitta skillnader. Du kanske vill lägga till |[^[:space:]] i ditt reguljära uttryck för att se till att det matchar alla tecken som inte är blanktecken. En matchning som innehåller en nyrad avkortas tyst(!) vid nyradslinjen.

Till exempel kommer --word-diff-regex=. att behandla varje tecken som ett ord och, på motsvarande sätt, visa skillnader tecken för tecken.

Regex-funktionen kan också ställas in via en diff-drivrutin eller ett konfigurationsalternativ, se gitattributes[5] eller git-config[1]. Om du anger den explicit åsidosätts alla diff-drivrutiner eller konfigurationsinställningar. Diff-drivrutiner åsidosätter konfigurationsinställningar.

--color-words[=<regex>]

Motsvarande --word-diff=color plus (om ett regex angavs) --word-diff-regex=<regex>.

--no-renames

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

--rename-empty
--no-rename-empty

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

--check

Varna om ändringar introducerar konfliktmarkörer eller blankteckenfel. Vad som anses vara blankteckenfel styrs av konfigurationen av core.whitespace. Som standard betraktas efterföljande blanktecken (inklusive rader som enbart består av blanktecken) och ett mellanslagstecken som omedelbart följs av ett tabbtecken inuti radens första indrag som blankteckenfel. Avslutas med status som inte är noll om problem upptäcks. Inte kompatibel med --exit-code.

--ws-error-highlight=<slag>

Markera blankteckenfel i raderna context, old eller new i diff-filen. Flera värden separeras med kommatecken, none återställer tidigare värden, default återställer listan till new och all är en förkortning för old,new,context. När detta alternativ inte anges och konfigurationsvariabeln diff.wsErrorHighlight inte är angiven, markeras endast blankteckenfel i raderna new. Blankteckenfelen är färgade med color.diff.whitespace.

--full-index

Istä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.

--binary

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

--abbrev[=<n>]

Istä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>.

-B[<n>][/<m>]
--break-rewrites[=[<n>][/<m>]]

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

Det påverkar hur en förändring som innebär en total omskrivning av en fil, inte som en serie borttagningar och infogningar blandade med ett fåtal rader som råkar matcha textuellt som kontexten, utan som en enda borttagning av allt gammalt följt av en enda infogning av allt nytt, och siffran <m> styr denna aspekt av -B-alternativet (standard är 60%). -B/70% anger att mindre än 30% av originalet ska finnas kvar i resultatet för att Git ska betrakta det som en total omskrivning (dvs. annars kommer den resulterande patchen att vara en serie borttagningar och infogningar blandade med kontextrader).

När den används med -M betraktas även en helt omskriven fil som källa till ett namnbyte (vanligtvis betraktar -M bara en fil som försvunnit som källa till ett namnbyte), och siffran <n> styr denna aspekt av alternativet -B (standard är 50%). -B20% anger att en ändring med tillägg och borttagning jämfört med 20% eller mer av filens storlek är berättigad att plockas upp som en möjlig källa till ett namnbyte till en annan fil.

-M[<n>]
--find-renames[=<n>]

Om du genererar diffs, upptäck och rapportera namnbyten för varje . incheckning För att följa filer över namnbyten medan du går igenom historiken, se --follow. 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 %.

-C[<n>]
--find-copies[=<n>]

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>.

--find-copies-harder

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.

-D
--irreversible-delete

Utelämna preimage för borttagningar, d.v.s. skriv bara ut rubriken 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.

När det används tillsammans med -B, utelämna även förbilden i borttagningsdelen av ett borttagnings-/skaparpar.

-l<num>

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 reservdel 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.

--diff-filter=[(A|C|D|M|R|T|U|X|B)...[*]]

Markera endast filer som är Tillagda (A), Kopierade (C), Borttagna (D), Modifierade (M), Omdöpta (R), har sin typ (dvs. vanlig fil, symlänk, undermodul, …​) ändrad (T), är Osammanslagna (U), är Okända (X) eller har fått sin parning Bruten (B). Vilken kombination som helst av filtertecknen (inklusive inga) kan användas. När * (Allt-eller-inget) läggs till i kombinationen markeras alla sökvägar om det finns någon fil som matchar andra kriterier i jämförelsen; om det inte finns någon fil som matchar andra kriterier markeras ingenting.

Also, these upper-case letters can be downcased to exclude. E.g. --diff-filter=ad excludes added and deleted paths.

Observera att inte alla diffs kan innehålla alla typer. Till exempel kan kopierade och omdöpta poster inte visas om detektering för dessa typer är inaktiverat.

-S<sträng>

Leta efter skillnader som ändrar antalet förekomster av den angivna <sträng> (dvs. tillägg/borttagning) i en fil. Avsedd för skriptutvecklarens bruk.

Det är användbart när du letar efter ett exakt kodblock (som en struktur) och vill veta blockets historia sedan det först kom till: använd funktionen iterativt för att mata in det intressanta blocket i föravbildningen tillbaka till -S och fortsätt tills du får den allra första versionen av blocket.

Binära filer genomsöks också.

-G<regex>

Leta efter skillnader vars patchtext innehåller tillagda/borttagna rader som matchar <regex>.

För att illustrera skillnaden mellan -S<regex> --pickaxe-regex och -G<regex>, betrakta en incheckning med följande diff i samma fil:

+    return frotz(nitfol, two->ptr, 1, 0);
...
-    hit = frotz(nitfol, mf2.ptr, 1, 0);

Medan git log -G"frotz\(nitfol" visar denna incheckning, gör git log -S"frotz\(nitfol" --pickaxe-regex inte det (eftersom antalet förekomster av den strängen inte ändrades).

Om inte --text anges kommer patchar av binära filer utan ett textconv-filter att ignoreras.

Se posten pickaxe i gitdiffcore[7] för mer information.

--find-object=<objekt-id>

Leta efter skillnader som ändrar antalet förekomster av det angivna objektet. I likhet med -S är det bara argumentet som skiljer sig genom att det inte söker efter en specifik sträng utan efter ett specifikt objekt-id.

Objektet kan vara en blob eller en undermodul-incheckning. Det innebär att -t-alternativet i git-log också kan hitta träd.

--pickaxe-all

När -S eller -G hittar en ändring, visa alla ändringar i den ändringsmängden, inte bara de filer som innehåller ändringen i <sträng>.

--pickaxe-regex

Behandla <sträng> som ges till -S som ett utökat POSIX-reguljärt uttryck som matchar.

-O<ordingsfil>

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.

Utmatningsordningen bestäms av ordningen på glob-mönstren i <ordingsfil>. Alla filer med sökvägar som matchar det första mönstret matas ut först, alla filer med sökvägar som matchar det andra mönstret (men inte det första) matas ut härnäst, och så vidare. Alla filer med sökvägar som inte matchar något mönster matas ut sist, som om det fanns ett implicit match-all-mönster i slutet av filen. Om flera sökvägar har samma rangordning (de matchar samma mönster men inga tidigare mönster), är deras utmatningsordning i förhållande till varandra den normala ordningen.

<ordingsfil> tolkas enligt följande:

  • Tomma rader ignoreras, så de kan användas som avgränsare för läsbarhet.

  • Rader som börjar med en hash ("#") ignoreras, så de kan användas för kommentarer. Lägg till ett bakåtsnedstreck ("\") i början av mönstret om det börjar med en hash.

  • Varje annan rad innehåller ett enda mönster.

Mönster har samma syntax och semantik som mönster som används för fnmatch(3) utan FNM_PATHNAME-flaggan, förutom att ett sökvägsnamn också matchar ett mönster om borttagning av ett antal av de slutliga sökvägsnamnskomponenterna matchar mönstret. Till exempel matchar mönstret "foo*bar" "fooasdfbar" och "foo/bar/baz/asdf" men inte "foobarx".

--skip-to=<fil>
--rotate-to=<fil>

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

-R

Växla två indata; det vill säga visa skillnader mellan index eller fil på disk och trädinnehåll.

--relative[=<sökväg>]
--no-relative

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.

-a
--text

Hantera alla filer som text.

--ignore-cr-at-eol

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

--ignore-space-at-eol

Ignorera ändringar i blanktecken vid radslut.

-b
--ignore-space-change

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

-w
--ignore-all-space

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.

--ignore-blank-lines

Ignorera ändringar i rader som är helt blanka.

-I<regex>
--ignore-matching-lines=<regex>

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

--inter-hunk-context=<nummer>

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.

-W
--function-context

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

--ext-diff

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.

--no-ext-diff

Tillåt inte externa diff-drivrutiner.

--textconv
--no-textconv

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.

--ignore-submodules[=(none|untracked|dirty|all)]

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.

--src-prefix=<prefix>

Visa givet käll_<prefix>_ istället för ”a/”.

--dst-prefix=<prefix>

Visa den angivna mål <prefix> istället för "b/".

--no-prefix

Visa inte käll- eller målprefix.

--default-prefix

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]).

--line-prefix=<prefix>

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

--ita-invisible-in-index

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.

--max-depth=<djup>

För varje sökvägsspecifikation 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ägsspecifikationen. Givet ett träd som innehåller foo/bar/baz visar följande lista de träffar som genereras av varje uppsättning alternativ:

  • --max-depth=0 -- foo: foo

  • --max-depth=1 -- foo: foo/bar

  • --max-depth=1 -- foo/bar: foo/bar/baz

  • --max-depth=1 -- foo foo/bar: foo/bar/baz

  • --max-depth=2 -- foo: foo/bar/baz

Om ingen sökvägsspec anges mäts djupet som om alla poster på toppnivå vore specificerade. Observera att detta skiljer sig från att mäta från roten, eftersom --max-depth=0 fortfarande skulle returnera foo. Detta låter dig fortfarande begränsa djupet samtidigt som du frågar efter en delmängd av posterna på toppnivå.

Observera att det här alternativet endast stöds för skillnader mellan trädobjekt, inte mot indexet eller arbetskatalog.

För en mer detaljerad förklaring av dessa vanliga alternativ, se även gitdiffcore[7].

Generera patchtext med -p

Att köra git-diff[1], git-log[1], git-show[1], git-diff-index[1], git-diff-tree[1] eller git-diff-files[1] med alternativet -p producerar patchtext. Du kan anpassa skapandet av patchtext via miljövariablerna GIT_EXTERNAL_DIFF och GIT_DIFF_OPTS (se git[1]), och attributet diff (se gitattributes[5]).

Det som -p-alternativet producerar skiljer sig något från det traditionella diff-formatet:

  1. Det föregås av en "git diff"-rubrik som ser ut så här:

    diff --git a/fil1 b/fil2

    Filnamnen a/ och b/ är desamma om det inte rör sig om att byta namn/kopiera. Speciellt, även vid skapande eller borttagning, används /dev/null inte istället för filnamnen a/ eller b/.

    När ett namnbyte/kopiering är inblandat visar fil1 och fil2 namnet på källfilen för namnbytet/kopieringen respektive namnet på filen som namnbytet/kopieringen producerar.

  2. It is followed by one or more extended header lines:

    old mode <sökväg>
new mode <behörigheter>
deleted file mode <behörigheter>
new file mode <läge>
copy from <sökväg>
copy to <sökväg>
rename from <sökväg>
rename to <sökväg>
similarity index <nummer>
dissimilarity index <nummer>
index <hash>..<hash> <behörigheter>

    Fil-rättigheter <behörigheter> skrivs ut som 6-siffriga oktala tal inklusive filtyp och filbehörighetsbitar.

    Sökvägar i utökade rubriker inkluderar inte prefixen a/ och b/.

    Likhetsindexet är andelen oförändrade rader och olikhetsindexet är andelen ändrade rader. Det är ett avrundat heltal följt av ett procenttecken. Likhetsindexvärdet 100 % är således reserverat för två lika filer, medan 100 % olikhet innebär att ingen rad från den gamla filen kom med i den nya.

    Indexraden innehåller namnen på blob-objekten före och efter ändringen. <behörigheter> inkluderas om fil-rättigheterna inte ändras; annars anger separata rader det gamla och det nya läget.

  3. Sökvägar med "ovanliga" tecken anges i citat enligt beskrivningen för konfigurationsvariabeln core.quotePath (se git-config[1]).

  4. Alla fil1-filer i utdata refererar till filer före incheckning, och alla fil2-filer refererar till filer efter incheckning. Det är felaktigt att tillämpa varje ändring på varje fil sekventiellt. Till exempel kommer den här patchen att byta a och b:

    diff --git a/a b/b
rename from a
rename to b
diff --git a/b b/a
rename from b
rename to a

  5. Hunk-rubriker nämner namnet på den funktion som hunken gäller för. Se "Definiera en anpassad hunk-rubrik" i gitattributes[5] för detaljer om hur man anpassar detta till specifika språk.

Kombinerat diff-format

Alla diff-genererande kommandon kan använda -c eller --cc alternativet för att skapa en kombinerad diff när en merge visas. Detta är standardformatet när merges visas med git-diff[1] eller git-show[1]. Observera också att du kan ge lämplig --diff-merges alternativ till vilket som helst av dessa kommandon för att tvinga generering av diffs i ett specifikt format.

Ett "kombinerat diff"-format ser ut så här:

diff --combined describe.c
index fabadb8,cc95eb0..4866510
--- a/describe.c
+++ b/describe.c
@@@ -98,20 -98,12 +98,20 @@@
	return (a_date > b_date) ? -1 : (a_date == b_date) ? 0 : 1;
  }

- static void describe(char *arg)
 -static void describe(struct commit *cmit, int last_one)
++static void describe(char *arg, int last_one)
  {
 +	unsigned char sha1[20];
 +	struct commit *cmit;
	struct commit_list *list;
	static int initialized = 0;
	struct commit_name *n;

 +	if (get_sha1(arg, sha1) < 0)
 +		usage(describe_usage);
 +	cmit = lookup_commit_reference(sha1);
 +	if (!cmit)
 +		usage(describe_usage);
 +
	if (!initialized) {
		initialized = 1;
		for_each_ref(get_name);

  1. Den föregås av en "git diff"-rubrik, som ser ut så här (när alternativet -c används):

    diff --combined fil

    eller så här (när --cc-alternativet används):

    diff --cc fil

  2. Den följs av en eller flera utökade rubrikrader (detta exempel visar en sammanslagning med två föräldrar):

    index <hash>,<hash>..<hash>
mode <behörighter>,<behörighter>..<behörighter>
new file mode <behörighter>
deleted file mode <behörighter>,<behörighter>

    Raden mode <behörighter>,<behörighter>..<behörighter> visas bara om minst en av <behörighter> skiljer sig från resten. Utökade rubriker med information om detekterad innehållsförflyttning (namnbyten och kopieringsdetektering) är utformade för att fungera med diff-värdet för två <trädlikt> och används inte av kombinerat diff-format.

  3. Den följs av en tvåradig från-fil/till-fil-rubrik:

    --- a/fil
+++ b/fil

    I likhet med den tvåradiga rubriken för det traditionella unified diff-formatet används /dev/null för att signalera skapade eller raderade filer.

    Om alternativet --combined-all-paths däremot anges, får du istället för en tvåradig från-fil/till-fil-rubrik en N+1-radig from-file/to-file-rubrik, där N är antalet föräldrar i sammanslagings-incheckning:

    --- a/fil
--- a/fil
--- a/fil
+++ b/fil

    Detta utökade format kan vara användbart om namnbytes- eller kopieringsdetektering är aktivt, så att du kan se filens ursprungliga namn i olika överordnade filer.

  4. Chunk-headerformatet är modifierat för att förhindra att folk av misstag matar in det i patch -p1. Kombinerat diff-format skapades för granskning av sammanslagings inchecknings-ändringar och var inte avsett att tillämpas. Ändringen liknar ändringen i den utökade index-headern:

    @@@ <från-fil-omfång> <från-fil-omfång> <till-fil-omfånge> @@@

    Det finns (antal föräldrar + 1) @-tecken i chunk-rubriken för kombinerat diff-format.

Till skillnad från det traditionella "unified" diff-formatet, som visar två filer A och B med en enda kolumn som har prefixet - (minus — visas i A men tas bort i B), + (plus — saknas i A men läggs till i B) eller " " (mellanslag — oförändrat), jämför detta format två eller flera filer fil1, fil2,…​ med en fil X, och visar hur X skiljer sig från var och en av filN. En kolumn för var och en av filN läggs till på utdataraden för att ange hur X:s rad skiljer sig från den.

Ett --tecknet i kolumn N betyder att raden visas i fileN men inte i resultatet. Ett +-tecknet i kolumn N betyder att raden visas i resultatet, och fileN har inte den raden (med andra ord, raden lades till, ur den överordnade filens synvinkel).

I exemplet ovan ändrades funktionssignaturen från båda filerna (därav två borttagningar av - från både fil1 och fil2, plus ++ för att betyda att en rad som lades till inte visas i vare sig fil1 eller fil2). Dessutom är åtta andra rader desamma från fil1 men visas inte i fil2 (därav prefixet +).

När det visas med git diff-tree -c jämför den föräldrarna till en sammanslagnings-incheckning med sammanslagnings-resultatet (dvs. file1..fileN är föräldrarna). När det visas med git diff-files -c jämför den de två olösta sammanslagnings-föräldrarna med den fungerande arbetskatalog filen (dvs. file1 är steg 2, även kallad "vår version", file2 är steg 3, även kallad "deras version").

EXEMPEL

git show v1.0.0

Visar taggen v1.0.0, tillsammans med objektet som taggen pekar på.

git show v1.0.0^{tree}

Visar trädet som pekas på av taggen v1.0.0.

git show -s --format=%s v1.0.0^{commit}

Visar ämnet för den incheckning som pekas på av taggen v1.0.0.

git show next~10:Documentation/README

Visar innehållet i filen Dokumentation/README som det var aktuellt vid den tionde sista incheckningen av grenen next.

git show master:Makefile master:t/Makefile

Sammanfogar innehållet i nämnda Makefiles i huvudet på grenen master.

DISKUSSION

Git är till viss del teckenkodningsagnostisk.

  • Innehållet i blob-objekten är otolkade sekvenser av byte. Det finns ingen kodningsöversättning på kärnnivå.

  • Sökvägsnamn är kodade i UTF-8-normaliseringsform C. Detta gäller trädobjekt, indexfilen, referensnamn, såväl som sökvägsnamn i kommandoradsargument, miljövariabler och konfigurationsfiler (.git/config (se git-config[1]), gitignore[5], gitattributes[5] och gitmodules[5]).

    Observera att Git på kärnnivå behandlar sökvägsnamn helt enkelt som sekvenser av icke-NUL-byte, det finns inga konverteringar av sökvägskodning (förutom på Mac och Windows). Därför fungerar användning av sökvägsnamn som inte är ASCII-namn oftast även på plattformar och filsystem som använder äldre utökade ASCII-kodningar. Förvar som skapas på sådana system kommer dock inte att fungera korrekt på UTF-8-baserade system (t.ex. Linux, Mac, Windows) och vice versa. Dessutom antar många Git-baserade verktyg helt enkelt att sökvägsnamn är UTF-8 och kommer inte att kunna visa andra kodningar korrekt.

  • Meddelanden i commitloggar kodas vanligtvis i UTF-8, men andra utökade ASCII-kodningar stöds också. Detta inkluderar ISO-8859-x, CP125x och många andra, men inte UTF-16/32, EBCDIC och CJK multibyte-kodningar (GBK, Shift-JIS, Big5, EUC-x, CP9xx etc.).

Även om vi uppmuntrar att incheckning-loggmeddelandena kodas i UTF-8, är både kärnan och Git Porcelain utformade för att inte tvinga fram UTF-8 på projekt. Om alla deltagare i ett visst projekt tycker att det är bekvämare att använda äldre kodningar, förbjuder inte Git det. Det finns dock några saker att tänka på.

  1. git commit och git commit-tree utfärdar en varning om incheckning-loggmeddelandet som ges till det inte ser ut som en giltig UTF-8-sträng, såvida du inte uttryckligen anger att ditt projekt använder en äldre kodning. Sättet att säga detta är att ha i18n.commitEncoding i .git/config-filen, så här:

    [i18n]
	commitEncoding = ISO-8859-1

    Inchecknings-objekt som skapats med ovanstående inställning registrerar värdet för i18n.commitEncoding i sin encoding-header. Detta är för att hjälpa andra som tittar på dem senare. Avsaknaden av denna header innebär att inchecknings-loggmeddelandet är kodat i UTF-8.

  2. git log, git show, git blame och vänner tittar på encoding-headern för ett inchecknings-objekt och försöker koda om loggmeddelandet till UTF-8 om inget annat anges. Du kan ange önskad utdatakodning med i18n.logOutputEncoding i .git/config-filen, så här:

    [i18n]
	logOutputEncoding = ISO-8859-1

    Om du inte har den här konfigurationsvariabeln, används värdet för i18n.commitEncoding istället.

Observera att vi medvetet valde att inte koda om incheckning-loggmeddelandet när en incheckning görs för att tvinga fram UTF-8 på inchecknings-objektnivå, eftersom omkodning till UTF-8 inte nödvändigtvis är en reversibel operation.

GIT

En del av git[1]-sviten