¿Cómo leer el resultado de git diff?

Echemos un vistazo a un ejemplo de diferenciación avanzada del historial de git (en la confirmación 1088261f en el repositorio git.git ):

diff --git a/builtin-http-fetch.c b/http-fetch.c
similarity index 95%
rename from builtin-http-fetch.c
rename to http-fetch.c
index f3e63d7..e8f44ba 100644
--- a/builtin-http-fetch.c
+++ b/http-fetch.c
@@ -1,8 +1,9 @@
 #include "cache.h"
 #include "walker.h"
 
-int cmd_http_fetch(int argc, const char **argv, const char *prefix)
+int main(int argc, const char **argv)
 {
+       const char *prefix;
        struct walker *walker;
        int commits_on_stdin = 0;
        int commits;
@@ -18,6 +19,8 @@ int cmd_http_fetch(int argc, const char **argv, const char *prefix)
        int get_verbosely = 0;
        int get_recover = 0;
 
+       prefix = setup_git_directory();
+
        git_config(git_default_config, NULL);
 
        while (arg < argc && argv[arg][0] == '-') {

Analicemos este parche línea por línea.

• la primera linea

  diferencia --git a/builtin-http-fetch.cb/http-fetch.c

  es un encabezado "git diff" en el formulario diff --git a/file1 b/file2. Los nombres de archivo a/y b/son los mismos a menos que se trate de cambiar el nombre/copiar (como en nuestro caso). Esto --gitquiere decir que diff está en el formato diff "git".

• A continuación se encuentran una o más líneas de encabezado extendidas. Los primeros tres

  índice de similitud 95%
  cambiar el nombre desde incorporado-http-fetch.c
  cambiar el nombre a http-fetch.c

  díganos que se cambió el nombre del archivo de builtin-http-fetch.ca http-fetch.cy que esos dos archivos son 95% idénticos (que se usó para detectar este cambio de nombre).
  
  La última línea en el encabezado de diferencia extendida, que es

  índice f3e63d7..e8f44ba 100644

  cuéntenos sobre el modo del archivo dado ( 100644significa que es un archivo normal y no, por ejemplo, un enlace simbólico, y que no tiene un bit de permiso ejecutable), y sobre el hash abreviado de la preimagen (la versión del archivo antes del cambio dado) y la postimagen (la versión del archivo después del cambio). Esta línea se utiliza para git am --3wayintentar realizar una combinación de tres vías si el parche no se puede aplicar por sí solo.
  
  

• El siguiente es el encabezado de diferenciación unificado de dos líneas.

  --- a/integrado-http-fetch.c
  +++b/http-fetch.c

  En comparación con diff -Uel resultado, no tiene desde el tiempo de modificación del archivo ni hasta el tiempo de modificación del archivo después de los nombres de los archivos de origen (preimagen) y destino (postimagen). Si se creó el archivo, la fuente es /dev/null; Si se eliminó el archivo, el destino es /dev/null.
  Si establece diff.mnemonicPrefixla variable de configuración en verdadero, en lugar de los prefijos a/y b/en este encabezado de dos líneas, puede tener en su lugar c/, y como prefijos, respectivamente i/, con lo que compara; ver git-config(1)w/o/

• Luego vienen uno o más grupos de diferencias; cada trozo muestra un área donde los archivos difieren. Los trozos de formato unificado comienzan con una línea como

  @@ -1,8 +1,9 @@

  o

  @@ -18,6 +19,8 @@ int cmd_http_fetch(int argc, const char **argv, ...

  Está en el formato @@ from-file-range to-file-range @@ [header]. El rango desde el archivo tiene el formato -<start line>,<number of lines>y el rango hasta el archivo tiene el formato +<start line>,<number of lines>. Tanto la línea de inicio como el número de líneas se refieren a la posición y la longitud del fragmento en la preimagen y la postimagen, respectivamente. Si no se muestra el número de líneas, significa que es 1.

El encabezado opcional muestra la función C donde ocurre cada cambio, si es un archivo C (como -pla opción en GNU diff), o el equivalente, si corresponde, para otros tipos de archivos.

• Luego viene la descripción de dónde difieren los archivos. Las líneas comunes a ambos archivos comienzan con un carácter de espacio. Las líneas que realmente difieren entre los dos archivos tienen uno de los siguientes caracteres indicadores en la columna de impresión de la izquierda:

• '+': aquí se agregó una línea al primer archivo.

• '-' -- Aquí se eliminó una línea del primer archivo.

Entonces, por ejemplo, el primer fragmento

     #include "cache.h"
     #include "walker.h"
     
    -int cmd_http_fetch(int argc, const char **argv, const char *prefix)
    +int main(int argc, const char **argv)
     {
    +       const char *prefix;
            struct walker *walker;
            int commits_on_stdin = 0;
            int commits;

significa que cmd_http_fetchfue reemplazado por mainy esa const char *prefix;línea fue agregada.

En otras palabras, antes del cambio, el fragmento apropiado del archivo 'builtin-http-fetch.c' tenía este aspecto:

    #include "cache.h"
    #include "walker.h"
    
    int cmd_http_fetch(int argc, const char **argv, const char *prefix)
    {
           struct walker *walker;
           int commits_on_stdin = 0;
           int commits;

Después del cambio, este fragmento del archivo ahora 'http-fetch.c' se ve así:

    #include "cache.h"
    #include "walker.h"
     
    int main(int argc, const char **argv)
    {
           const char *prefix;
           struct walker *walker;
           int commits_on_stdin = 0;
           int commits;

• Podría haber

  \ Sin nueva línea al final del archivo

  línea presente (no está en el ejemplo diff).

Como dijo Donal Fellows, es mejor practicar la lectura de diferencias en ejemplos de la vida real, donde sabes lo que has cambiado.

Referencias:

• Página de manual de git-diff(1) , sección "Generación de parches con -p"
• (diff.info) Nodo unificado detallado, "Descripción detallada del formato unificado".

Mar 27 '2010 16:03 Jakub Narębski