Quali sono le differenze tra il punto doppio ".." e il punto triplo "..." negli intervalli di commit diff Git?

Quali sono le differenze tra i seguenti comandi ?:

git diff foo master   # a 
git diff foo..master  # b
git diff foo...master # c

Il manuale diff ne parla:

Confronto di rami

$ git diff topic master    <1>
$ git diff topic..master   <2>
$ git diff topic...master  <3>

1. Cambiamenti tra i suggerimenti dell'argomento e i rami principali.
2. Come sopra.
3. Modifiche apportate al ramo principale da quando il ramo argomento è stato avviato da esso.

ma non è del tutto chiaro per me.

Dato che avevo già creato queste immagini, ho pensato che valesse la pena usarle in un'altra risposta, sebbene la descrizione della differenza tra ..(punto-punto) e ...(punto-punto-punto) sia essenzialmente la stessa della risposta di manojlds .

Il comando in git diffgenere¹ mostra solo la differenza tra gli stati dell'albero tra esattamente due punti nel grafico di commit. Le note ..e ...in git diffhanno i seguenti significati:

In altre parole, git diff foo..barè esattamente lo stesso di git diff foo bar; entrambi ti mostreranno la differenza tra le punte dei due rami fooe bar. D'altra parte, git diff foo...barti mostrerà la differenza tra la "base di unione" dei due rami e la punta di bar. La "base di unione" è in genere l'ultimo commit in comune tra questi due rami, quindi questo comando ti mostrerà i cambiamenti che il tuo lavoro barha introdotto, ignorando tutto ciò che è stato fatto foonel frattempo.

Questo è tutto ciò che devi sapere sul ..e sulle ...annotazioni git diff. Però...

... una fonte comune di confusione qui è quella ..e ...significa cose leggermente diverse quando usate in un comando come quello git logche si aspetta un insieme di commit come uno o più argomenti. (Tutti questi comandi finiscono per utilizzare git rev-listper analizzare un elenco di commit dai loro argomenti.)

Il significato di ..e ...per git logpuò essere mostrato graficamente come di seguito:

Quindi, git rev-list foo..barti mostra tutto sul ramo barche non è anche sul ramo foo. D'altra parte, git rev-list foo...barti mostra tutti i commit che sono in uno foo o bar , ma non in entrambi . Il terzo diagramma mostra solo che se si elencano i due rami, si ottengono i commit che si trovano in uno o entrambi.

Bene, trovo che sia un po 'confuso, comunque, e penso che i diagrammi del grafico di commit aiutino :)

¹ Dico solo "tipicamente" poiché, ad esempio, quando si risolvono i conflitti di unione, git diffviene mostrata un'unione a tre vie.

La mia versione consolidata di .. vs ... con diff vs log

git diff foo master La differenza tra la parte superiore (testa) commette foo e master.

git diff foo..master Un altro modo di fare la stessa cosa.

git diff foo...masterDiff dal comune antenato ( git merge-base foo master) di foo e master a punta di master. In altre parole, mostra solo i cambiamenti che il ramo master ha introdotto dal suo antenato comune con foo.

Questo esempio di GitHub spiega quando usare i due:

Ad esempio, se si crea un ramo "dev" e si aggiunge una funzione a un file, si torna al ramo "principale" e si rimuove una riga da README, quindi si esegue qualcosa del genere:

$ git diff master dev

Ti dirà che una funzione è stata aggiunta dal primo file e una riga è stata aggiunta al file README. Perché? Perché sul ramo, README ha ancora la linea originale, ma su "master" l'hai rimossa, quindi confrontando direttamente le istantanee sembra che "dev" l'abbia aggiunta.

Quello che vuoi davvero confrontare è ciò che 'dev' è cambiato da quando i tuoi rami sono divergenti. Per farlo, Git ha una bella stenografia:

$ git diff master...dev

git diff foo master

mostrerà le differenze tra l'argomento e il ramo principale in quel momento

git diff foo..master

questo mostrerà anche le differenze tra l'argomento e il ramo principale in quel momento

git diff foo...master

questo mostrerà tutte le differenze tra quando l'argomento è stato fatto dal ramo e dopo

quindi i primi 2 comandi sono gli stessi e l'ultimo mostra solo una visione più ampia nella cronologia delle differenze

L'immagine in alto equivale all'albero grafico in basso

A0 <- A1 <- A2 <- A3 (master)
   \
    C0 <- C1 (test)

Un'immagine vale più di mille parole, la differenza tra .. ... ^è mostrata di seguito.

$ git log master..test
# output C0 C1

$ git log ^master test
# output C0 C1

$ git log master…test
# output A1 A2 A3 C0 C1