git-rev-list - Online in de cloud

PROGRAMMA:

NAAM

git-rev-list - Geeft commit-objecten weer in omgekeerde chronologische volgorde

KORTE INHOUD

git rev-lijst [ --max-aantal= ]
[ --overslaan= ]
[ --max-leeftijd= ]
[ --min-leeftijd= ]
[ --schaars ]
[ --samenvoegt ]
[ --geen-samenvoegingen ]
[ --min-ouders= ]
[ --geen-min-ouders ]
[ --max-ouders= ]
[ --geen-max-ouders ]
[ --eerste ouder ]
[ --verwijder-leeg ]
[ --volledige geschiedenis ]
[ --niet ]
[ --alle ]
[ --takken[= ] ]
[ --tags[= ] ]
[ --afstandsbedieningen[= ] ]
[ --glob= ]
[ --negeren-ontbreekt ]
[ --stdin ]
[ --rustig ]
[ --topo-volgorde ]
[ --ouders ]
[ --tijdstempel ]
[ --links rechts ]
[ --alleen links ]
[ --alleen rechts ]
[ --kersenmerk ]
[ --kersenpluk ]
[ --codering= ]
[ --(auteur|committer|grep)= ]
[ --regexp-negeer-case | -i ]
[ --extended-regexp | -E]
[ --vaste tekenreeksen | -F ]
[ --datum= ]
[ [ --objecten | --objecten-rand | --objecten-rand-agressief ]
[ --uitgepakt ] ]
[ --mooi | --kop ]
[ --doorsnijden ]
[ --doorsnijd-vars ]
[ --doorsnijd alles ]
[ --samenvoegen ]
[ --achteruit ]
[ --walk-reflogs ]
[ --niet-lopen ] [ --do-lopen ]
[ --graaf ]
[ --gebruik-bitmap-index ]
... [ -- ...]

PRODUCTBESCHRIJVING

Maak een lijst van commits die bereikbaar zijn door de bovenliggende links van de gegeven commit(s) te volgen,
maar sluit commits uit die bereikbaar zijn van degene(n) gegeven met a ^ voor hen.
De uitvoer wordt standaard in omgekeerde chronologische volgorde weergegeven.

Je kunt dit zien als een vaste operatie. Commits die op de opdrachtregel worden gegeven, vormen een set van
commits die bereikbaar zijn vanaf een van deze, en vervolgens commits die bereikbaar zijn vanaf een van de
die meegegeven zijn ^ vooraan worden van die set afgetrokken. De overige commits zijn wat
komt naar voren in de uitvoer van het commando. Er kunnen diverse andere opties en padparameters worden gebruikt
om het resultaat nog verder te beperken.

Dus het volgende commando:

$ git rev-lijst foo bar ^baz

betekent "een lijst maken van alle commits die bereikbaar zijn foo or bars, maar niet van baz".

Een bijzondere vermelding".." kan worden gebruikt als afkorting voor "^' '
". Een van de volgende termen kan bijvoorbeeld door elkaar worden gebruikt:

$ git rev-lijst oorsprong..HEAD
$ git rev-lijst HEAD ^origin

Een andere speciale vermelding is "..." wat handig is voor samenvoegingen. De
De resulterende set commits is het symmetrische verschil tussen de twee operanden. De
de volgende twee opdrachten zijn gelijkwaardig:

$ git rev-list AB --niet $(git merge-base --all AB)
$ git rev-lijst A...B

rev-lijst is een zeer essentieel Git-commando, omdat het de mogelijkheid biedt om
doorkruis de vooroudersgrafieken van commits. Om deze reden heeft het veel verschillende opties
maakt het mogelijk om gebruikt te worden door commando's die zo verschillend zijn als git halveren en git herpakken.

OPTIES

Plegen Het beperken van
Naast het specificeren van een reeks commits die moeten worden vermeld met behulp van de speciale notaties
uitgelegd in de beschrijving, kunnen aanvullende commit-beperkingen worden toegepast.

Het gebruik van meer opties beperkt over het algemeen de uitvoer verder (bijvoorbeeld --sinds= grenzen aan
pleegt nieuwer dan , en gebruik het met --grep= verdere grenzen aan verplichtingen
wiens logbericht een regel bevat die overeenkomt ), tenzij anders vermeld.

Houd er rekening mee dat deze worden toegepast voordat de bestel- en opmaakopties voor commits worden toegepast, zoals
--achteruit.

- , -N , --max-aantal=
Beperk het aantal commits dat moet worden uitgevoerd.

--overslaan=
overslaan aantal commit voordat de commit-uitvoer wordt weergegeven.

--sinds= , --na=
Toon commits die recenter zijn dan een specifieke datum.

--tot= , --voor=
Toon commits ouder dan een specifieke datum.

--max-leeftijd= , --min-leeftijd=
Beperk de uitvoer van commits tot een opgegeven tijdsbereik.

--auteur= , --committer=
Beperk de uitvoer van commits tot degenen met auteur/committer headerregels die overeenkomen met de
opgegeven patroon (reguliere expressie). Met meer dan één --author= , verplicht
waarvan de auteur overeenkomt met een van de gegeven patronen, wordt gekozen (op dezelfde manier voor meerdere
--committor= ).

--grep-reflog=
Beperk de uitvoer van commits tot degenen met reflog-items die overeenkomen met het opgegeven patroon
(reguliere expressie). Met meer dan één --grep-reflog, commit waarvan het reflog-bericht
overeenkomt met een van de gegeven patronen. Het is een fout om deze optie te gebruiken, tenzij
--walk-reflogs is in gebruik.

--grep=
Beperk de uitvoer van commits tot degenen met een logbericht dat overeenkomt met het opgegeven patroon
(reguliere expressie). Met meer dan één --grep= , commit wiens boodschap
overeenkomt met een van de gegeven patronen wordt gekozen (maar zie --all-match).

--alles-match
Beperk de uitvoer van commits tot degenen die overeenkomen met alle gegeven --grep, in plaats van degenen die dat doen
overeenkomen met minstens één.

--omkeren-grep
Beperk de uitvoer van commits tot degenen met een logbericht die niet overeenkomen met het patroon
gespecificeerd met --grep= .

-i, --regexp-negeer-case
Overeenkomen met de beperkende patronen voor reguliere expressies, ongeacht de hoofdletter.

--basic-regexp
Beschouw de beperkende patronen als reguliere reguliere expressies; dit is de standaardinstelling.

-E, --extended-regexp
Beschouw de beperkende patronen als uitgebreide reguliere expressies in plaats van de
standaard reguliere reguliere expressies.

-F, --vaste snaren
Beschouw de beperkende patronen als vaste tekenreeksen (interpreteer het patroon niet als een
reguliere expressie).

--perl-regexp
Beschouw de beperkende patronen als Perl-compatibele reguliere expressies. Vereist
libpcre waarin het moet worden gecompileerd.

--verwijderen-leeg
Stop wanneer een bepaald pad uit de boom verdwijnt.

--samenvoegingen
Druk alleen merge commits af. Dit is precies hetzelfde als --min-parents=2.

--geen samenvoegingen
Print geen commits met meer dan één ouder. Dit is precies hetzelfde als
--max-ouders=1.

--min-ouders= , --max-ouders= , --geen-min-ouders, --geen-max-ouders
Toon alleen commits die minstens (of maximaal) zoveel ouder-commits hebben. In
bijzonder, --max-parents=1 is hetzelfde als --no-merges, --min-parents=2 is hetzelfde als
--samenvoegt. --max-parents=0 geeft alle root commits en --min-parents=3 alle octopussen
fuseert.

--no-min-parents en --no-max-parents stellen deze limieten opnieuw in (naar geen limiet).
Equivalente vormen zijn --min-parents=0 (elke commit heeft 0 of meer ouders) en
--max-parents=-1 (negatieve getallen geven geen bovengrens aan).

--eerste ouder
Volg alleen de eerste ouder-commit als je een merge-commit ziet. Deze optie kan een
beter overzicht bij het bekijken van de evolutie van een bepaalde onderwerptak, omdat
samenvoegingen in een onderwerpvertakking hebben de neiging alleen te gaan over het aanpassen aan upstream-updates
van tijd tot tijd, en met deze optie kunt u de individuele binnengebrachte commits negeren
aan jullie geschiedenis door zo’n samenvoeging. Kan niet worden gecombineerd met --bisect.

--niet
Keert de betekenis van de om ^ voorvoegsel (of het ontbreken daarvan) voor alle volgende revisies
specificeerders, tot de volgende --niet.

--alle
Doe alsof alle refs in refs/ op de opdrachtregel staan ​​vermeld als .

--takken[= ]
Doe alsof alle refs in refs/heads op de opdrachtregel staan ​​als .
If is gegeven, beperk dan de vertakkingen tot degenen die overeenkomen met de gegeven shell-glob. Indien patroon
mist ?, *of [, /* aan het einde wordt geïmpliceerd.

--tags[= ]
Doe alsof alle refs in refs/tags op de opdrachtregel staan ​​als . Indien
is gegeven, beperk tags dan tot degenen die overeenkomen met een gegeven shell-glob. Als patroon ontbreekt ?,
*of [, /* aan het einde wordt geïmpliceerd.

--afstandsbedieningen[= ]
Doe alsof alle refs in refs/remotes op de opdrachtregel staan ​​als .
If is gegeven, beperk dan de takken voor het volgen op afstand tot takken die overeenkomen met de gegeven shell
klodder. Als patroon ontbreekt ?, *of [, /* aan het einde wordt geïmpliceerd.

--glob=
Doe alsof alle scheidsrechters overeenkomen met Shell Glob staan ​​vermeld op de
opdrachtregel als ​ Leidend scheidsrechters/, wordt automatisch voorafgegaan als dit ontbreekt. Als
patroon ontbreekt ?, *of [, /* aan het einde wordt geïmpliceerd.

--uitsluiten=
Neem geen overeenkomende referenties op dat de volgende --all, --takken, --tags,
--remotes, of --glob zou anders overwegen. Herhalingen van deze optie stapelen zich op
uitsluitingspatronen tot aan de volgende --all, --branches, --tags, --remotes, of --glob
optie (andere opties of argumenten verwijderen geaccumuleerde patronen niet).

De gegeven patronen mogen niet beginnen met refs/heads, refs/tags of refs/remotes wanneer
toegepast op respectievelijk --branches, --tags of --remotes, en ze moeten beginnen met
refs/ wanneer toegepast op --glob of --all. Indien een achterstand /* bedoeld is, moet het gegeven worden
uitdrukkelijk.

--herladen
Doe alsof alle objecten die door reflogs worden genoemd op de opdrachtregel staan ​​als
.

--negeren-ontbrekend
Als u een ongeldige objectnaam in de invoer ziet, doe dan alsof de slechte invoer dat niet is
gegeven.

--standaard
Naast de vermeld op de opdrachtregel, lees ze dan uit de standaard
invoer. Als een -- scheidingsteken wordt gezien, stop dan met het lezen van commits en begin met het lezen van paden naar
beperk het resultaat.

--stil
Druk niets af in standaarduitvoer. Dit formulier is in de eerste plaats bedoeld om de
beller om de uitgangsstatus te testen om te zien of een reeks objecten volledig is verbonden (of
niet). Het is sneller dan het omleiden van stdout naar /dev/null, omdat de uitvoer dat niet hoeft te doen
geformatteerd zijn.

--kersenmerk
Zoals --cherry-pick (zie hieronder), maar markeer gelijkwaardige commits met = in plaats van weg te laten
hen, en ongelijke met +.

--kersenpluk
Laat elke commit weg die dezelfde verandering introduceert als een andere commit aan de “andere kant”
wanneer de set commits beperkt is met symmetrische verschillen.

Als je bijvoorbeeld twee vestigingen hebt, A en B, is dit een gebruikelijke manier om alle commits op te sommen
slechts één kant ervan is met --left-right (zie het voorbeeld hieronder in de beschrijving
van de optie --links-rechts). Het toont echter de commits die zijn uitgekozen
uit de andere tak (bijvoorbeeld: "3e op b" kan uit tak A worden geplukt).
Met deze optie worden zulke paren commits uitgesloten van de uitvoer.

--alleen links, --alleen rechts
Lijst maakt alleen commits aan de betreffende kant van een symmetrisch bereik, dat wil zeggen alleen degene die dat doen
zou worden gemarkeerd < resp. > door --links-rechts.

--cherry-pick --right-only A...B laat bijvoorbeeld de commits van B weg die in zijn
A of zijn patch-equivalent aan een commit in A. Met andere woorden, dit vermeldt de + commits
van git cherry A B. Preciezer gezegd: --cherry-pick --right-only --no-merges geeft de
exacte lijst.

--kers
Een synoniem voor --right-only --cherry-mark --no-merges; handig om de uitvoer te beperken
de commits aan onze kant en markeer degene die zijn toegepast op de andere kant van a
gevorkte geschiedenis met git log --cherry upstream...mybranch, vergelijkbaar met git cherry
stroomopwaarts mijn tak.

-g, --walk-reflogs
In plaats van de commit-voorouderketen te doorlopen, kun je de reflog-items van de meest recente doorlopen
één tot oudere. Wanneer deze optie wordt gebruikt, kunt u geen commits opgeven die u wilt uitsluiten
(dat is, ^ plegen, commit1..commit2 en vastleggen1...vastleggen2 notaties kunnen niet worden gebruikt).

Met een ander formaat --pretty dan oneline (om voor de hand liggende redenen), veroorzaakt dit de uitvoer
om twee extra regels informatie uit de reflog te halen. Standaard, commit@{N-de}
In de uitvoer wordt notatie gebruikt. Wanneer de startcommit is opgegeven als commit@{nu},
uitgang ook gebruikt commit@{tijdstempel} notatie in plaats daarvan. Onder --pretty=oneline wordt de
commit-bericht wordt voorafgegaan door deze informatie op dezelfde regel. Deze optie kan dat niet
worden gecombineerd met --reverse. Zie ook git-reflog(1).

--samenvoegen
Na een mislukte samenvoeging worden referenties weergegeven die betrekking hebben op bestanden die een conflict hebben en niet bestaan
alle hoofden om samen te voegen.

--grens
Uitvoer uitgesloten grenscommits. Grenscommits worden voorafgegaan door -.

--gebruik-bitmap-index
Probeer de doorloop te versnellen met behulp van de pack-bitmapindex (indien beschikbaar). Opmerking
dat bij het doorkruisen van --objecten, bomen en blobs niet geassocieerd zullen zijn
pad afgedrukt.

Geschiedenis vereenvoudiging
Soms ben je alleen geïnteresseerd in delen van de geschiedenis, bijvoorbeeld de commits
een bepaald wijzigen . Maar er zijn twee delen van Geschiedenis vereenvoudiging, een deel
is het selecteren van de commits en de andere is hoe je het moet doen, aangezien er verschillende strategieën voor zijn
vereenvoudig de geschiedenis.

Met de volgende opties selecteert u de commits die moeten worden weergegeven:


Verplicht het wijzigen van het gegeven zijn geselecteerd.

--vereenvoudigen door decoratie
Commits waarnaar wordt verwezen door een bepaalde branch of tag worden geselecteerd.

Merk op dat extra commits kunnen worden getoond om een ​​betekenisvolle geschiedenis te geven.

De volgende opties zijn van invloed op de manier waarop de vereenvoudiging wordt uitgevoerd:

Standaard modus
Vereenvoudigt de geschiedenis tot de eenvoudigste geschiedenis die de uiteindelijke staat van de boom verklaart.
Het eenvoudigst omdat het enkele zijtakken snoeit als het eindresultaat hetzelfde is (bijv
takken met dezelfde inhoud samenvoegen)

--volledige geschiedenis
Hetzelfde als de standaardmodus, maar er wordt geen geschiedenis verwijderd.

--gespannen
Alleen de geselecteerde commits worden getoond, plus enkele met een betekenisvolle geschiedenis.

--schaars
Alle commits in de vereenvoudigde geschiedenis worden getoond.

--simplify-samenvoegingen
Extra optie voor --full-history om enkele onnodige samenvoegingen uit het resultaat te verwijderen
geschiedenis, aangezien er geen geselecteerde commits zijn die bijdragen aan deze fusie.

--voorouderspad
Wanneer er een reeks commits wordt gegeven om weer te geven (bijv commit1..commit2 or commit2 ^vastleggen1),
geef alleen commits weer die direct bestaan ​​in de vooroudersketen tussen de commit1 en
commit2, dwz commits die beide afstammelingen zijn van commit1, en voorouders van commit2.

Een meer gedetailleerde uitleg volgt.

Stel dat u foo hebt opgegeven als . We zullen commits aanroepen die foo wijzigen! TREESAME,
en de rest BOOM. (In een diff gefilterd op foo zien ze er verschillend en gelijk uit,
respectievelijk.)

In het volgende zullen we altijd naar dezelfde voorbeeldgeschiedenis verwijzen om de situatie te illustreren
verschillen tussen vereenvoudigingsinstellingen. We gaan ervan uit dat u op een bestand filtert
foo in deze commit-grafiek:

.-A---M---N---O---P---Q
/ / / / / /
IBCDEY
\ / / / / /
`-------------' X

De horizontale geschiedenislijn A---Q wordt beschouwd als de eerste ouder van elke samenvoeging. De
verplichtingen zijn:

· I is de initiële commit, waarin foo bestaat met de inhoud “asdf”, en een bestand quux
bestaat met de inhoud “quux”. Initiële commits worden vergeleken met een lege boom, dus I
!BOOM.

· In A bevat foo alleen maar “foo”.

· B bevat dezelfde verandering als A. De samenvoeging van M is triviaal en daarom voor iedereen TREESAME
ouders.

· C verandert foo niet, maar de samenvoeging N verandert het in “foobar”, dus het is niet TREESAME
aan welke ouder dan ook.

· D stelt foo in op “baz”. De samenvoeging O combineert de snaren van N en D tot “foobarbaz”;
dat wil zeggen, het is voor geen enkele ouder TREESAME.

· E verandert quux in “xyzzy”, en de samenvoeging P combineert de snaren tot “quux xyzzy”. P is
TREESAME voor O, maar niet voor E.

· X is een onafhankelijke root-commit die een nieuwe bestandskant heeft toegevoegd, en Y heeft deze gewijzigd. Y is
TREESAME met X. Door de samenvoeging van Q is er zijde toegevoegd aan P, en Q is TREESAME aan P, maar niet aan Y.

rev-list loopt achteruit door de geschiedenis, inclusief of exclusief commits op basis van of
Er wordt gebruik gemaakt van --volledige geschiedenis en/of ouderherschrijving (via --parents of --children). De
volgende instellingen zijn beschikbaar.

Standaard modus
Commits worden opgenomen als ze voor geen enkele ouder TREESAME zijn (hoewel dit wel mogelijk is).
gewijzigd, zie --sparse hieronder). Als de commit een merge was, en het was TREESAME to one
ouder, volg alleen die ouder. (Zelfs als er meerdere TREESAME-ouders zijn, volg dan
slechts één van hen.) Volg anders alle ouders.

Dit resulteert in:

.-A---N---O
///
ID KAART

Merk op hoe de regel om alleen de TREESAME-ouder te volgen, als die beschikbaar is, B verwijderde
geheel buiten beschouwing gelaten. C werd overwogen via N, maar is TREESAME. Root-commits
worden vergeleken met een lege boom, dus ik is !BOMEN.

Ouder/kind-relaties zijn alleen zichtbaar met --parents, maar dat heeft geen invloed op de
commits geselecteerd in de standaardmodus, dus we hebben de bovenliggende lijnen getoond.

--volledige geschiedenis zonder herschrijven door ouders
Deze modus verschilt op één punt van de standaard: volg altijd alle ouders van een samenvoeging,
ook al is het voor een van hen BOOM. Zelfs als er meer dan één kant van de fusie is
commits die zijn opgenomen, betekent dit niet dat de samenvoeging zelf is! In de
wij krijgen bijvoorbeeld

IABNDOPQ

M werd uitgesloten omdat het voor beide ouders TREESAME is. E, C en B kregen allemaal vier wijd,
maar alleen B was !TREESAME, dus de anderen verschijnen niet.

Merk op dat het zonder ouderherschrijving niet echt mogelijk is om over de
ouder/kind-relaties tussen de commits, dus we laten zien dat ze niet verbonden zijn.

--volledige geschiedenis met herschrijving van de ouders
Gewone commits worden alleen opgenomen als ze !TREESAME zijn (hoewel dit kan worden gewijzigd,
zie --sparse hieronder).

Samenvoegingen zijn altijd inbegrepen. Hun ouderlijst is echter herschreven: langs elkaar
ouder, verwijder commits die zelf niet zijn opgenomen. Dit resulteert in

.-A---M---N---O---P---Q
/ / / / /
IB / D /
\ / / / /
`-------------'

Vergelijk met --volledige geschiedenis zonder hierboven te herschrijven. Merk op dat E is weggesnoeid omdat
het is TREESAME, maar de ouderlijst van P is herschreven om E's ouder I te bevatten
hetzelfde gebeurde voor C en N, en X, Y en Q.

Naast de bovenstaande instellingen kun je wijzigen of TREESAME de opname beïnvloedt:

--gespannen
Toezeggingen die worden gedaan, worden opgenomen als deze voor geen enkele ouder TREESAME zijn.

--schaars
Alle commits die gelopen worden, zijn inbegrepen.

Merk op dat dit zonder --full-history het samenvoegen nog steeds vereenvoudigt: als een van de ouders
is TREESAME, we volgen alleen die ene, dus de andere kanten van de samenvoeging zijn dat nooit
liep.

--simplify-samenvoegingen
Bouw eerst een geschiedenisgrafiek op dezelfde manier als --volledige geschiedenis met herschrijven van de ouders
doet (zie hierboven).

Vereenvoudig vervolgens elke commit C tot zijn vervangende C' in de uiteindelijke geschiedenis volgens
de volgende regels:

· Stel C' in op C.

· Vervang elke ouder P van C' door zijn vereenvoudiging P'. Laat vallen tijdens het proces
ouders die voorouders zijn van andere ouders of die root zijn waar TREESAME zich aan verbindt
een lege stamboom en verwijder duplicaten, maar zorg ervoor dat u nooit alle ouders laat vallen
wij zijn TREESAME.

· Als C' na dit bovenliggende herschrijven een root- of merge-commit is (heeft nul of >1
ouders), een grenscommit, of !TREESAME, blijft het. Anders wordt het vervangen
met zijn enige ouder.

Het effect hiervan wordt het best aangetoond door middel van een vergelijking met --volledige geschiedenis met ouder
herschrijven. Het voorbeeld verandert in:

.-BEN GEEN
///
IBD
\ / /
`---------'

Let op de belangrijkste verschillen in N, P en Q over de volledige geschiedenis:

· De ouderlijst van N had ik verwijderd, omdat deze een voorouder is van de andere ouder M.
Toch bleef N bestaan ​​omdat het !TREESAME is.

· De ouderlijst van P had ik op dezelfde manier verwijderd. P werd vervolgens volledig verwijderd, omdat
het had één ouder en is TREESAME.

· De bovenliggende lijst van Q had Y vereenvoudigd tot X. X werd vervolgens verwijderd, omdat het a was
BOOM wortel. Q werd vervolgens volledig verwijderd, omdat het één ouder had en dat ook is
BOOM.

Ten slotte is er een vijfde vereenvoudigingsmodus beschikbaar:

--voorouderspad
Beperk de getoonde commits tot degenen die direct in de vooroudersketen zitten tussen de “van”
en “to” commits in het gegeven commit bereik. Dat wil zeggen dat alleen commits worden weergegeven die dat wel zijn
voorouder van de “naar” commit en afstammelingen van de “van” commit.

Als voorbeeld van een gebruiksscenario kunnen we de volgende commitgeschiedenis beschouwen:

D---E-------F
/ \ \
B---C---G---H---I---J
​
A-------K---------------L--M

Een vaste klant DM berekent de set commits die voorouders zijn van M, maar sluit de
degenen die voorouders zijn van D. Dit is handig om te zien wat er met de geschiedenis is gebeurd
leidend tot M sinds D, in de zin van “wat heeft M dat niet bestond in D”.
Het resultaat in dit voorbeeld zou alle commits zijn, behalve A en B (en D zelf, van
Cursus).

Als we willen weten welke commits in M ​​besmet zijn met de bug die is geïntroduceerd door
D en moeten worden gerepareerd, maar misschien willen we alleen de subset ervan bekijken DM Dat
eigenlijk afstammelingen van D, dat wil zeggen exclusief C en K. Dit is precies wat de
--ancestry-path optie wel. Toegepast op de DM bereik resulteert dit in:

E-------F
​
G---H---I---J
\
LM

Met de optie --simplify-by-decoration kunt u alleen het grote geheel van de afbeelding bekijken
topologie van de geschiedenis, door commits weg te laten waarnaar niet wordt verwezen door tags. Toezeggingen zijn
gemarkeerd als !TREESAME (met andere woorden, bewaard nadat de geschiedenisvereenvoudigingsregels zijn beschreven
hierboven) als (1) er naar wordt verwezen door tags, of (2) ze de inhoud van de paden wijzigen
gegeven op de opdrachtregel. Alle andere commits worden gemarkeerd als TREESAME (onder voorbehoud van
weg vereenvoudigd).

tweedeling helpers
--doorsnijden
Beperk de uitvoer tot het ene commit-object dat ongeveer halverwege tussen include en
uitgesloten commits. Merk op dat de slechte bisectie ref refs/bisect/bad is toegevoegd aan de
opgenomen commits (als deze bestaat) en de goede bisectie refs refs/bisect/good-* zijn
toegevoegd aan de uitgesloten commits (als ze bestaan). Stel dat er dus geen refs zijn
refs/doorsnijden/, als

$ git rev-list --splits foo ^bar ^baz

uitgangen middelpunt, de uitvoer van de twee opdrachten

$ git rev-list foo ^midpoint
$ git rev-lijst middelpunt ^bar ^baz

zou ongeveer even lang zijn. Het vinden van de verandering die een regressie introduceert
wordt dus gereduceerd tot een binaire zoekopdracht: herhaaldelijk nieuwe 'middenpunten' genereren en testen tot
de commit-keten heeft lengte één. Kan niet worden gecombineerd met --first-parent.

--doorsnijd-vars
Dit berekent hetzelfde als --bisect, behalve dat refs in refs/bisect/ niet worden gebruikt,
en behalve dat dit tekst uitvoert die klaar is om door de shell te worden geëvalueerd. Deze lijnen zullen dat wel doen
wijs de naam van de middelpuntrevisie toe aan de variabele bisect_rev, en de verwachte
aantal commits dat moet worden getest nadat bisect_rev is getest tot bisect_nr, het verwachte
aantal commits dat moet worden getest als bisect_rev goed blijkt te zijn voor bisect_good, de
verwacht aantal commits dat moet worden getest als bisect_rev slecht blijkt te zijn
bisect_bad, en het aantal commits dat we nu in tweeën splitsen om bisect_all te maken.

--doorsnijd alles
Hiermee worden alle commit-objecten tussen de opgenomen en uitgesloten commits in volgorde uitgevoerd
door hun afstand tot de opgenomen en uitgesloten commits. Refs in refs/bisect/ zijn dat niet
gebruikt. Degene die het verst verwijderd is, wordt eerst weergegeven. (Dit is de enige die wordt weergegeven door
--doorsnijden.)

Dit is handig omdat je hierdoor gemakkelijk een goede commit kunt kiezen om te testen wanneer je maar wilt
om te voorkomen dat sommige ervan om de een of andere reden worden getest (ze kunnen bijvoorbeeld niet worden gecompileerd).

Deze optie kan samen met --bisect-vars worden gebruikt, in dit geval nadat alles is gesorteerd
commit-objecten, zal er dezelfde tekst zijn alsof --bisect-vars alleen zou zijn gebruikt.

Plegen Bestellen
Standaard worden de commits in omgekeerde chronologische volgorde weergegeven.

--datumvolgorde
Laat geen ouders zien voordat alle kinderen zijn getoond, maar laat anders wel commits zien
de volgorde van de commit-tijdstempel.

--auteur-datum-volgorde
Laat geen ouders zien voordat alle kinderen zijn getoond, maar laat anders wel commits zien
de volgorde van de tijdstempel van de auteur.

--topo-orde
Laat geen ouders zien voordat alle kinderen zijn getoond, en vermijd het tonen van commitments
meerdere geschiedenislijnen vermengd.

In een commitgeschiedenis als deze:

---1----2----4----7
​

3----5----6----8---
waarbij de cijfers de volgorde van commit-tijdstempels, git rev-list en vrienden met aangeven
--date-order toont de commits in de tijdstempelvolgorde: 8 7 6 5 4 3 2 1.

Met --topo-volgorde zouden ze 8 6 5 3 7 4 2 1 weergeven (of 8 7 4 2 6 5 3 1); wat ouder
commits worden vóór nieuwere getoond om te voorkomen dat de commits van twee worden getoond
parallelle ontwikkelingstraject met elkaar vermengd.

--omgekeerde
Voer de commits in omgekeerde volgorde uit. Kan niet worden gecombineerd met --walk-reflogs.

Object traversal
Deze opties zijn vooral bedoeld voor het inpakken van Git-repository's.

--voorwerpen
Druk de object-ID's af van elk object waarnaar wordt verwezen door de vermelde commits. --objecten foo
^bar betekent dus “stuur mij alle object-ID’s die ik moet downloaden als ik de commit heb
object bars maar niet foo'.

--objecten-rand
Vergelijkbaar met --objects, maar druk ook de ID's van uitgesloten commits af, voorafgegaan door een “-”
karakter. Deze wordt gebruikt door git-pack-objecten(1) om een ​​“dun” pakket te bouwen, dat registreert
objecten in gedeltificeerde vorm op basis van objecten in deze uitgesloten commits
netwerkverkeer verminderen.

--objecten-rand-agressief
Vergelijkbaar met --objects-edge, maar het probeert moeilijker uitgesloten commits te vinden ten koste van
verhoogde tijd. Dit wordt gebruikt in plaats van --objects-edge om “dunne” pakketten voor te bouwen
ondiepe opslagplaatsen.

--geïndexeerde objecten
Doe alsof alle bomen en blobs die door de index worden gebruikt, op de opdrachtregel worden vermeld.
Merk op dat u waarschijnlijk ook --objects wilt gebruiken.

--uitgepakt
Alleen nuttig met --objects; druk de object-ID's af die niet in pakketten zitten.

--no-walk[=(gesorteerd|ongesorteerd)]
Toon alleen de gegeven commits, maar doorloop hun voorouders niet. Dit heeft geen effect
als er een bereik is opgegeven. Als het argument ongesorteerd wordt opgegeven, worden de commits getoond
de volgorde die ze op de opdrachtregel kregen. Anders (indien gesorteerd of geen argument was
gegeven), worden de commits weergegeven in omgekeerde chronologische volgorde op committijd. Kan niet zijn
gecombineerd met --graph.

--doe-loop
Heft een eerdere --no-walk op.

Plegen opmaak
Met behulp van deze opties git-rev-lijst(1) zal zich op dezelfde manier gedragen als de meer gespecialiseerde familie van
commit log tools: git-log(1) git-show(1), en git-wat-veranderd(1)

--mooi[= ], --format=
Druk de inhoud van de commit-logboeken mooi af in een bepaald formaat, waar kan zijn
een van een lijn, kort, Medium, vol, voller, email, rauw, formaat: en
tformaat:. Wanneer is geen van de bovenstaande, en heeft % tijdelijke aanduiding daarin, het
doet alsof --pretty=tformat: werden gegeven.

Zie de sectie "MOOIE FORMATS" voor aanvullende details voor elk formaat. Wanneer
= Als een deel wordt weggelaten, is dit standaard ingesteld Medium.

Opmerking: u kunt het standaard Pretty-formaat opgeven in de repositoryconfiguratie (zie
git-config(1)).

--afkorting-commit
In plaats van de volledige hexadecimale commit-objectnaam van 40 bytes weer te geven, toont u alleen a
gedeeltelijk voorvoegsel. Een niet-standaard aantal cijfers kan worden opgegeven met "--abbrev= "
(wat ook de diff-uitvoer wijzigt, als deze wordt weergegeven).

Dit zou "--pretty=oneline" een stuk leesbaarder moeten maken voor mensen die het gebruiken
Terminals met 80 kolommen.

--geen-afkorting-commit
Toon de volledige hexadecimale commit-objectnaam van 40 bytes. Dit ontkent --abbrev-commit en
de opties die dit impliceren, zoals "--oneline". Het overschrijft ook de
log.abbrevCommit variabel.

--een lijn
Dit is een afkorting voor "--pretty=oneline --abbrev-commit" samen gebruikt.

--codering=
De commit-objecten leggen de voor het logbericht gebruikte codering vast in hun codering
koptekst; deze optie kan worden gebruikt om de opdracht te vertellen het commit-logboekbericht opnieuw te coderen
in de door de gebruiker gewenste codering. Voor niet-loodgietersopdrachten is dit standaard de waarde
UTF-8. Merk op dat als een object beweert te zijn gecodeerd in X en we uitvoeren in X, we
zal het object woordelijk weergeven; dit betekent dat ongeldige reeksen in het origineel voorkomen
commit kan naar de uitvoer worden gekopieerd.

--show-handtekening
Controleer de geldigheid van een ondertekend commit-object door de handtekening door te geven aan gpg --verify
en laat de uitvoer zien.

--relatieve-datum
Synoniem voor --date=relatief.

--datum=
Is alleen van kracht voor datums die worden weergegeven in een voor mensen leesbaar formaat, zoals bij gebruik
--zeer. log.date configuratievariabele stelt een standaardwaarde in voor de --date van de logopdracht
keuze. Standaard worden datums weergegeven in de oorspronkelijke tijdzone (committer's of
van de auteur). Als -local aan het formaat wordt toegevoegd (bijvoorbeeld iso-local), is dit het lokale formaat van de gebruiker
In plaats daarvan wordt de tijdzone gebruikt.

--date=relative toont datums relatief ten opzichte van de huidige tijd, bijvoorbeeld “2 uur geleden”. De
-local optie kan niet worden gebruikt met --raw of --relative.

--date=local is een alias voor --date=default-local.

--date=iso (of --date=iso8601) toont tijdstempels in een ISO 8601-achtig formaat. De
verschillen met het strikte ISO 8601-formaat zijn:

· een spatie in plaats van het datum-/tijdscheidingsteken T

· een ruimte tussen tijd en tijdzone

· geen dubbele punt tussen uren en minuten van de tijdzone

--date=iso-strict (of --date=iso8601-strict) toont tijdstempels in strikte ISO 8601
formaat.

--date=rfc (of --date=rfc2822) toont tijdstempels in RFC 2822-formaat, vaak te vinden in
e-mailberichten.

--date=short toont alleen de datum, maar niet de tijd, in het formaat JJJJ-MM-DD.

--date=raw toont de datum in het interne onbewerkte Git-formaat %s %z formaat.

--date=format:... voert het formaat ... naar uw systeem strftime. Gebruik --date=format:%c
om de datum weer te geven in het voorkeursformaat van uw systeemlandinstelling. Zie de strftime-handleiding voor
een volledige lijst met tijdelijke aanduidingen voor formaten. Wanneer u -local gebruikt, is de juiste syntaxis
--date=formaat-lokaal:....

--date=default is het standaardformaat en is vergelijkbaar met --date=rfc2822, met enkele
uitzonderingen:

· er staat geen komma na de dag van de week

· de tijdzone wordt weggelaten als de lokale tijdzone wordt gebruikt

--koptekst
Druk de inhoud van de commit af in raw-formaat; elk record wordt gescheiden door een NUL
karakter.

--ouders
Print ook de ouders van de commit (in de vorm "commit parent..."). Maakt ook mogelijk
herschrijven van ouders, zie Geschiedenis vereenvoudiging hieronder.

--kinderen
Print ook de kinderen van de commit (in de vorm "commit child..."). Maakt ook mogelijk
herschrijven van ouders, zie Geschiedenis vereenvoudiging hieronder.

--tijdstempel
Druk de onbewerkte commit-tijdstempel af.

--links rechts
Markeer vanaf welke kant van een symmetrische diff een commit bereikbaar is. Commiteert van links
zijde worden voorafgegaan door < en die aan de rechterkant met >. Indien gecombineerd met --boundary,
deze commits worden voorafgegaan door -.

Als u bijvoorbeeld deze topologie heeft:

y---b---b tak B
/ \ /
/.
/ / \
o---x---a---een tak A

je zou een uitvoer als deze krijgen:

$ git rev-list --links-rechts --grens --pretty=oneline A...B

>bbbbbbb... 3e op b
>bbbbbbb... 2e op b
<aaaaaa... 3e op a
<aaaaaa... 2e op a
-jjjjjjj... 1e op b
-xx... 1e op a

--grafiek
Teken aan de linkerkant een op tekst gebaseerde grafische weergave van de commitgeschiedenis
van de uitvoer. Dit kan ervoor zorgen dat er extra regels tussen de commits worden afgedrukt, in de juiste volgorde
zodat de grafiekgeschiedenis correct wordt getekend. Niet combineerbaar met --no-walk.

Dit maakt herschrijven door ouders mogelijk, zie Geschiedenis vereenvoudiging hieronder.

Dit impliceert standaard de --topo-order optie, maar de --date-order optie kan ook zijn
wees duidelijk.

--show-lineaire-break[= ]
Wanneer --graph niet wordt gebruikt, worden alle geschiedenistakken afgevlakt, wat het moeilijk kan maken
zie dat de twee opeenvolgende commits niet tot een lineaire tak behoren. Deze optie
plaatst in dat geval een barrière tussen hen in. Als is gespecificeerd, het is de
tekenreeks die wordt weergegeven in plaats van de standaardtekenreeks.

--Graaf
Druk een getal af dat aangeeft hoeveel commits er in de lijst zouden zijn opgenomen, en onderdruk alle andere
uitgang. Wanneer u het samen met --left-right gebruikt, drukt u in plaats daarvan de tellingen voor left en af
juiste commits, gescheiden door een tab. Bij gebruik samen met --cherry-mark, laat het patchje weg
equivalente commits uit deze tellingen en druk de telling voor equivalente commits af
gescheiden door een tabblad.

MOOI FORMATS

Als de commit een merge is, en als het Pretty-formaat dat niet is een lijn, email or rauween
Er wordt een extra regel ingevoegd vóór de Auteur: lijn. Deze regel begint met "Merge: " en
de sha1s van voorouderlijke commits worden afgedrukt, gescheiden door spaties. Houd er rekening mee dat de vermelde
commits hoeft niet noodzakelijkerwijs de lijst te zijn van de directe ouder verplicht zich als je beperkt bent
uw kijk op de geschiedenis: als u bijvoorbeeld alleen geïnteresseerd bent in veranderingen die verband houden met a
bepaalde map of bestand.

Er zijn verschillende ingebouwde formaten, en u kunt extra formaten definiëren door a in te stellen
zeer. config-optie naar een andere formaatnaam, of a formaat: touwtje, als
hieronder beschreven (zie git-config(1)). Hier zijn de details van de ingebouwde formaten:

· een lijn



Deze is zo compact mogelijk ontworpen.

· kort

verbinden
Auteur:



· Medium

verbinden
Auteur:
Datum:





· vol

verbinden
Auteur:
Verbinden:





· voller

verbinden
Auteur:
AuteurDatum:
Verbinden:
Datum vastlegging:





· email

Van
Van:
Datum:
Onderwerp: [PATCH]



· rauw

De rauw format toont de gehele commit precies zoals opgeslagen in het commit-object.
Opvallend is dat de SHA-1's volledig worden weergegeven, ongeacht of --abbrev of
--geen afkorting wordt gebruikt, en ouders informatie laat zien dat de echte ouder zich engageert, zonder
rekening houdend met transplantaten of geschiedenisvereenvoudiging. Houd er rekening mee dat dit formaat van invloed is
de manier waarop commits worden weergegeven, maar niet de manier waarop de diff wordt weergegeven, bijvoorbeeld met git log
--rauw. Gebruik --no-abbrev om volledige objectnamen in een onbewerkt diff-formaat te krijgen.

· formaat:

De formaat: Met het format kunt u opgeven welke informatie u wilt weergeven.
Het werkt een beetje zoals het printf-formaat, met de opmerkelijke uitzondering dat je een
nieuwe lijn met %n in plaats van \n.

bijv., formaat: "De auteur of %h was %een, %ar%nDe titel was >>%s<<%n" zou laten zien
iets zoals dit:

De auteur van fe6e0ee was Junio ​​C Hamano, 23 uur geleden
De titel was >>t4119: test autocomputing -p voor traditionele diff-invoer.<

De tijdelijke aanduidingen zijn:

· %H: hash plegen

· %h: afgekorte commit-hash

· %T: boomhash

· %t: afgekort boomhash

· %P: ouder-hashes

· %p: afgekorte ouder-hashes

· %een: auteur naam

· %een: auteursnaam (met respect voor .mailmap, zie git-shortlog(1) of git-schuld(1))

· %een: e-mail van de auteur

· %aE: e-mail van de auteur (met respect voor .mailmap, zie git-shortlog(1) of git-schuld(1))

· %advertentie: auteursdatum (formaat respecteert --date= optie)

· %advertentie: auteursdatum, RFC2822-stijl

· %ar: auteursdatum, relatief

· %bij: auteursdatum, UNIX-tijdstempel

· %ai: auteursdatum, ISO 8601-achtig formaat

· %aI: auteursdatum, strikt ISO 8601-formaat

· %cn: committernaam

· %cN: committernaam (met respect voor .mailmap, zie git-shortlog(1) of git-schuld(1))

· %ce: committer-e-mailadres

· %ce: committer e-mail (met respect voor .mailmap, zie git-shortlog(1) of git-schuld(1))

· %CD: committer datum (formaat respecteert --date= optie)

· %CD: committerdatum, RFC2822-stijl

· %cr: committerdatum, relatief

· %ct: committerdatum, UNIX-tijdstempel

· % ci: committerdatum, ISO 8601-achtig formaat

· %cl: committerdatum, strikt ISO 8601-formaat

· %d: ref-namen, zoals de optie --decorate van git-log(1)

· %D: referentienamen zonder de omloop "(", ")".

· %e: codering

· %s: onderwerp

· %f: opgeschoonde onderwerpregel, geschikt voor een bestandsnaam

· %b: lichaam

· %B: rauw lichaam (onverpakt onderwerp en lichaam)

· %GG: onbewerkt verificatiebericht van GPG voor een ondertekende commit

· %G?: toon "G" voor een goede handtekening, "B" voor een slechte handtekening, "U" voor een goede,
niet-vertrouwde handtekening en "N" voor geen handtekening

· %GS: toon de naam van de ondertekenaar voor een ondertekende commit

· %GK: toon de sleutel die wordt gebruikt om een ​​ondertekende commit te ondertekenen

· %gD: reflog-selector, bijvoorbeeld refs/stash@{1}

· %gd: verkorte reflog-selector, bijvoorbeeld stash@{1}

· %gn: reflog identiteitsnaam

· %gN: reflog identiteitsnaam (met respect voor .mailmap, zie git-shortlog(1) of git-
schuld(1))

· %ge: herlog identiteits-e-mailadres

· %gE: reflog identiteits-e-mail (met respect voor .mailmap, zie git-shortlog(1) of git-
schuld(1))

· %g: reflog-onderwerp

· % Krediet: verander de kleur naar rood

· %Cgroen: verander de kleur naar groen

· %Cblauw: verander de kleur naar blauw

· %Creset: kleur opnieuw instellen

· %C(...): kleurspecificatie, zoals beschreven in color.branch.* configuratieoptie; toevoegen
auto, zal in het begin alleen kleur uitzenden als kleuren zijn ingeschakeld voor loguitvoer
(door color.diff, color.ui of --color, en met respect voor de automatische instellingen van de
eerstgenoemde als we naar een terminal gaan). alleen auto (dwz %C(auto)) wordt ingeschakeld
automatische kleuring op de volgende tijdelijke aanduidingen totdat de kleur opnieuw wordt gewijzigd.

· %m: links, rechts of grensmarkering

· %n: nieuwe lijn

· %%: een rauwe %

· %x00: druk een byte af van een hexadecimale code

· %w([ [, [, ]]]): regelomloop wijzigen, zoals de optie -w van git-
tekort(1).

· %<( [,trunc|ltrunc|mtrunc]): zorg ervoor dat de volgende tijdelijke aanduiding minimaal N kolommen bevat,
indien nodig opvullingsruimten aan de rechterkant. Eventueel afkappen aan het begin
(ltrunc), het midden (mtrunc) of het einde (trunc) als de uitvoer langer is dan N
kolommen. Merk op dat afkappen alleen correct werkt met N >= 2.

· %<|( ): zorg ervoor dat de volgende tijdelijke aanduiding minimaal tot N-de kolommen duurt, opvulling
indien nodig ruimten aan de rechterkant

· %>( ), %>|( ): gelijkwaardig aan %<( ), %<|( ) respectievelijk, maar opvulruimten
aan de linkerzijde

· %>>( ), %>>|( ): gelijkwaardig aan %>( ), %>|( ) respectievelijk, behalve dat als de
de volgende tijdelijke aanduiding neemt meer spaties in beslag dan opgegeven en er zijn spaties aan de linkerkant,
gebruik die ruimtes

· %><( ), %><|( ): gelijkwaardig aan % <( ), %<|( ) respectievelijk, maar beide opvullen
zijkanten (dwz de tekst is gecentreerd)

Note
Sommige tijdelijke aanduidingen kunnen afhankelijk zijn van andere opties die aan de revisie-traversal-engine worden gegeven.
De %g* reflog-opties zullen bijvoorbeeld een lege string invoegen, tenzij dit het geval is
het doorlopen van reflog-items (bijvoorbeeld door git log -g). De tijdelijke aanduidingen %d en %D zullen worden gebruikt
het "korte" decoratieformaat als --decorate nog niet bij de opdracht was opgegeven
lijn.

Als u erna een + (plusteken) toevoegt % van een tijdelijke aanduiding wordt er onmiddellijk een regelinvoer ingevoegd
vóór de uitbreiding als en slechts als de tijdelijke aanduiding uitbreidt naar een niet-lege tekenreeks.

Als u erna een - (minteken) toevoegt % van een tijdelijke aanduiding, regelfeeds die er onmiddellijk aan voorafgaan
de uitbreiding wordt verwijderd als en alleen als de tijdelijke aanduiding uitbreidt naar een lege tekenreeks.

Als u een ` ` (spatie) erna toevoegt % van een tijdelijke aanduiding wordt er vlak voor een spatie ingevoegd
de uitbreiding als en slechts als de tijdelijke aanduiding uitbreidt naar een niet-lege tekenreeks.

· tformaat:

De tformaat: formaat werkt precies zo formaat:, behalve dat het "terminator" biedt
semantiek in plaats van "separator"-semantiek. Met andere woorden, elke commit heeft de
berichtbeëindigingsteken (meestal een nieuwe regel) toegevoegd, in plaats van een scheidingsteken
tussen de vermeldingen geplaatst. Dit betekent dat de uiteindelijke invoer een enkelregelig formaat zal hebben
correct worden afgesloten met een nieuwe regel, net zoals het "oneline"-formaat dat doet. Voor
voorbeeld:

$ git log -2 --pretty=format:%h 4da45bef \
| perl -pe '$_ .= " -- GEEN NEWLINE\n" tenzij /\n/'
4da45be
7134973 -- GEEN NEWLINE

$ git log -2 --pretty=tformat:%h 4da45bef \
| perl -pe '$_ .= " -- GEEN NEWLINE\n" tenzij /\n/'
4da45be
7134973

Bovendien wordt elke niet-herkende tekenreeks waarin een % voorkomt, geïnterpreteerd alsof dit wel het geval is
tformat: ervoor. Deze twee zijn bijvoorbeeld gelijkwaardig:

$ git log -2 --pretty=tformat:%h 4da45bef
$ git log -2 --pretty=%h 4da45bef

GIT

Een deel van de git(1) Suite

Gebruik git-rev-list online met behulp van onworks.net-services