¿Cuáles son las diferencias entre el doble punto "..." y el triple punto "..." en los rangos de confirmación de Git diff?

¿Cuáles son las diferencias entre los siguientes comandos ?:

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

El manual de diferencias habla de ello:

Comparar ramas

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

1. Cambios entre los consejos del tema y las ramas maestras.
2. Lo mismo que arriba.
3. Cambios que ocurrieron en la rama maestra desde que se inició la rama del tema.

Pero no está totalmente claro para mí.

Como ya había creado estas imágenes, pensé que valdría la pena usarlas en otra respuesta, aunque la descripción de la diferencia entre ..(punto-punto) y ...(punto-punto-punto) es esencialmente la misma que en la respuesta de manojlds .

El comando git difftípicamente¹ solo muestra la diferencia entre los estados del árbol entre exactamente dos puntos en el gráfico de confirmación. Las anotaciones ..y ...en git difftienen los siguientes significados:

En otras palabras, git diff foo..bares exactamente lo mismo que git diff foo bar; ambos le mostrarán la diferencia entre las puntas de las dos ramas fooy bar. Por otro lado, git diff foo...barle mostrará la diferencia entre la "base de fusión" de las dos ramas y la punta de bar. La "base de fusión" suele ser la última confirmación en común entre esas dos ramas, por lo que este comando le mostrará los cambios que barha introducido su trabajo , mientras ignora todo lo que se ha hecho mientras footanto.

Eso es todo lo que necesita saber sobre las anotaciones ..y . Sin embargo......git diff

... una fuente común de confusión aquí es eso ..y ...significa cosas sutilmente diferentes cuando se usa en un comando como el git logque espera un conjunto de confirmaciones como uno o más argumentos. (Todos estos comandos terminan usando git rev-listpara analizar una lista de confirmaciones de sus argumentos).

El significado de ..y ...para git logse puede mostrar gráficamente de la siguiente manera:

Entonces, git rev-list foo..barte muestra todo en la rama barque no está también en la rama foo. Por otro lado, git rev-list foo...barmuestra todos los commits que están en uno foo o bar , pero no en ambos . El tercer diagrama solo muestra que si enumera las dos ramas, obtiene las confirmaciones que están en una o en ambas.

Bueno, creo que todo es un poco confuso, de todos modos, y creo que los diagramas de gráficos de confirmación ayudan :)

¹ Solo digo "típicamente" ya que al resolver conflictos de fusión, por ejemplo, git diffle mostrará una fusión de tres vías.

Mi versión consolidada de .. vs ... con diff vs log

git diff foo master Diferencia entre los compromisos superiores (cabeza) de foo y master.

git diff foo..master Otra forma de hacer lo mismo.

git diff foo...masterDifiere del ancestro común ( git merge-base foo master) de foo y master a tip of master. En otras palabras, muestra solo los cambios que la rama maestra ha introducido desde su ancestro común con foo.

Este ejemplo de GitHub explica cuándo usar los dos:

Por ejemplo, si crea una rama 'dev' y agrega una función a un archivo, luego regrese a su rama 'maestra' y elimine una línea del archivo README, y luego ejecute algo como esto:

$ git diff master dev

Le indicará que se agregó una función desde el primer archivo y se agregó una línea al archivo README. ¿Por qué? Porque en la rama, el archivo README todavía tiene la línea original, pero en 'maestro' la ha eliminado, por lo que comparar directamente las instantáneas parece que 'dev' la agregó.

Lo que realmente quiere comparar es qué 'dev' ha cambiado desde que sus ramas divergieron. Para hacer eso, Git tiene una pequeña taquigrafía:

$ git diff master...dev

git diff foo master

mostrará las diferencias entre el tema y la rama maestra en ese momento

git diff foo..master

esto también mostrará las diferencias entre el tema y la rama maestra en ese momento

git diff foo...master

Esto mostrará todas las diferencias entre cuándo se hizo el tema desde la rama y después

así que los primeros 2 comandos son los mismos y el último solo muestra una vista más amplia en el historial de diferencias

La imagen superior es equivalente al árbol gráfico inferior.

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

Una imagen vale más que mil palabras, la diferencia entre .. ... ^se muestra a continuación.

$ git log master..test
# output C0 C1

$ git log ^master test
# output C0 C1

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