Git-show

git-show is een opdrachtregelprogramma dat wordt gebruikt om uitgebreide informatie over Git-objecten te bekijken, zoals blobs, structuren, tags en commits. git-show vertoont specifiek gedrag per objecttype.

De tags geven het tagbericht en andere objecten weer die in de tag zijn opgenomen. Structuren tonen de namen en inhoud van objecten in een structuur. Blobs geven de directe inhoud van de blob weer. Commits tonen een commitlogbericht en een diff-output van de wijzigingen in de commit.

Git-objecten zijn allemaal toegankelijk via referenties. Git-show werkt standaard ten opzichte van de HEAD-referentie. De HEAD-referentie verwijst altijd naar de laatste commit van de huidige branch. Daarom kun je git-show gebruiken om het logbericht en de diff-output van de laatste commit weer te geven.

--oneline
Dit is een sneltoets om de uitgebreide opdracht --pretty=oneline --abbrev-commit te gebruiken

--encoding[=＜encoding＞]
De tekencodering op Git-logberichten is standaard UTF-8. De coderingsoptie kan worden veranderd in een andere output voor tekencodering. Dit is handig als je met Git werkt in een omgeving met een andere tekencodering, zoals een terminal voor een Aziatische taal.

>--expand-tabs=＜n＞
--expand-tabs
--no-expand-tabs
Deze opties vervangen tabtekens door spaties in de output van het logbericht. De waarde n kan worden ingesteld om aan te geven in hoeveel spatietekens de tabs worden omgezet. Zonder een expliciete n-waarde worden tabs omgezet in 8 spaties. --no-expand-tabs is gelijk aan n=0

--notes=＜ref＞
--no-notes
Git heeft een notitiesysteem waarmee willekeurige metagegevens als 'notities' aan objecten kunnen worden gekoppeld. Deze gegevens kunnen verborgen of gefilterd worden als je git-show gebruikt.

--show-signature
Deze optie valideert dat de commit is ondertekend met een gecodeerde handtekening door deze door te geven aan een gpg-subopdracht.

De hierboven besproken optie --pretty accepteert verschillende secundaire opties om de indeling van git-show-output te masseren. Deze secundaire opties worden hieronder vermeld, met een voorbeeldsjabloon.

• oneline
  ＜sha1> ＜title line>

Oneline probeert zoveel mogelijk informatie samen te voegen op één regel.

• short
  commit ＜sha1＞
Author: ＜author＞
＜title line＞

• medium
  commit ＜sha1＞
Author: ＜author＞
Date: ＜author date＞
＜title line＞
＜full commit message＞

• full
  commit ＜sha1＞
Author: ＜author＞
Commit: ＜committer＞
＜title line＞
＜full commit message＞

• fuller
  commit ＜sha1＞
Author: ＜author＞
AuthorDate: ＜author date＞
Commit: ＜committer＞
CommitDate: ＜committer date＞
＜title line＞
＜full commit message＞

• email
  From ＜sha1＞ ＜date＞
From: ＜author＞
Date: ＜author date＞
Subject: [PATCH] ＜title line＞
＜full commit message＞

• raw
  De raw-indeling negeert andere directe opmaakopties die aan git-show zijn doorgegeven en voert de commit precies uit zoals deze is opgeslagen in het object. Raw negeert --abrev en --no-abbrev en toont altijd de bovenliggende commits.

• format:
  Hiermee kan een aangepaste outputindeling worden gespecificeerd. Dit werkt op dezelfde manier als de opdracht printf in de programmeertaal C. De optie --pretty=format vereist een secundaire waarde van een sjabloontekenreeks. De sjabloon heeft toegang tot placeholder-variabelen die worden gevuld met gegevens uit het commit-object. Deze placeholders worden hieronder vermeld:
  
  • %H: commit-hash
  • %h: afgekorte commit-hash
  • %T: structuur-hash
  • %t: afgekorte structuur-hash
  • %P: bovenliggende hashes
  • %p: afgekorte bovenliggende hashes
  • %an: auteursnaam
  • %aN: auteursnaam
  • %ae: e-mailadres van auteur
  • %aE: e-mailadres van auteur
  • %ad: auteursdatum (notatie volgens de optie --date=)
  • %aD: auteursdatum, RFC2822-stijl
  • %ar: auteursdatum, relatief
  • %at: auteursdatum, UNIX-tijdstempel
  • %ai: auteursdatum, ISO 8601-indeling
  • %cn: naam van committer
  • %cN: naam van committer
  • %ce: e-mailadres van committer
  • %cE: e-mailadres van committer
  • %cd: datum van committer
  • %cD: datum van committer, RFC2822-stijl
  • %cr: datum van committer, relatief
  • %ct: datum van committer, UNIX-tijdstempel
  • %ci: datum van committer, ISO 8601-indeling
  • %d: referentienamen, zoals de optie --decorate van git-log(1)
  • %e: codering
  • %s: onderwerp
  • %f: opgeschoonde onderwerpregel, geschikt voor een bestandsnaam
  • %b: hoofdtekst
  • %N: commit-notities
  • %gD: reflog-selector, bijv. refs/stash@{1}
  • %gd: ingekorte reflog selector, bijv. stash@{1}
  • %gs: reflog-onderwerp
  • %Cred: verander kleur in rood
  • %Cgreen: verander kleur in groen
  • %Cblue: verander kleur in blauw
  • %Creset: reset kleur
  • %C(...): kleurspecificatie, zoals beschreven in de configuratieoptie color.branch.*
  • %m: links, rechts of grensteken
  • %n: nieuwe regel
  • %%: a onbewerkt %
  • %x00: print a byte uit een hexadecimale code
  • %w([[,[,]]]): verander de regelterugloop, zoals de optie -w van git-shortlog

Hier worden alle bestanden vermeld die zijn verwerkt tijdens een commit.

Dit toont een specifieke versie van een bestand. Vervang de REVISON door een Git sha.

Dit toont de v2.0.0-tag en ook een commit op 6ef002d74cbbc099e1063728cab14ef1fc49c783

Dit levert als output alle commits op in het bereik van commit A tot commit D.

git-show is een zeer veelzijdige opdracht voor het onderzoeken van objecten in een Git-repo. De opdracht kan worden gebruikt om specifieke bestanden te targeten in specifieke revisies. Als je een commit-bereik onderzoekt met git-show, worden alle individuele commits in het bereik weergegeven. git-show kan een handige tool zijn om patch-notities aan te maken en wijzigingen bij te houden in een repository.