Arqueología del software: annotate

De Wiki de EGC
Revisión del 21:50 5 nov 2014 de Pneira (discusión | contribuciones)
(dif) ← Revisión anterior | Revisión actual (dif) | Revisión siguiente → (dif)
Saltar a: navegación, buscar

git te permite anotar la líneas de código de un fichero con la información de los cambios aplicados mediante:

% git annotate fichero

Esto muestra una salida del tipo:

03fc405d        (     Profe     2014-10-29 16:52:32 +0100       1)def holamundo():
801efff4        (     Profe     2014-10-29 17:06:37 +0100       2)      """Función adios mundo"""
40aa61e2        (     profe     2014-11-05 20:33:50 +0100       3)      print "hola mundo."
03fc405d        (     Profe     2014-10-29 16:52:32 +0100       4)
03fc405d        (     Profe     2014-10-29 16:52:32 +0100       5)def adiosmundo():
801efff4        (     Profe     2014-10-29 17:06:37 +0100       6)      """Función hola mundo"""
40aa61e2        (     profe     2014-11-05 20:33:50 +0100       7)      print "adios mundo."
03fc405d        (     Profe     2014-10-29 16:52:32 +0100       8)
03fc405d        (     Profe     2014-10-29 16:52:32 +0100       9)
03fc405d        (     Profe     2014-10-29 16:52:32 +0100       10)holamundo()
03fc405d        (     Profe     2014-10-29 16:52:32 +0100       11)adiosmundo()
  • En la primera columna indica el ID que identifica de manera única el cambio.
  • En la segunda indica el autor del cambio, seguido de la fecha en la tercera.
  • La última columna ofrece las líneas del fichero enumeradas.

Es frecuente que, pasados meses o años, uno no recuerde la razón por la que una línea esta ahí. En ese caso, git annotate te permite averiguar cuál fue el último cambio que sucedió en dicha línea. Si el título y la descripción del cambio están bien redactados y ofrecen información de calidad, muy probablemente responderá a tu pregunta mediante:

% git show COMMIT-ID