2011-08-19 15 views
8

Duplicar posibles:
Branch descriptions in git¿Es posible agregar una etiqueta descriptiva a una rama de Git?

¿Hay alguna forma de añadir una descripción a una rama Git? Me gustaría mantener los nombres de mi rama bastante cortos, pero a veces sería útil enumerarlos con alguna breve descripción adjunta.

+0

Buena pregunta - que sería bueno para poder para hacer esto para las etiquetas también. –

+0

@Paul R: es posible para las etiquetas, simplemente use git tag -m "mensaje" – dunni

Respuesta

2

Usted puede hacer esto con git notes:

git notes add your_branch -m "BRANCH_DESCRIPTION: A descriptive name for this branch" 

continuación, puede leer de nuevo usando este comando:

git notes show your_branch 

Puede almacenar sus notas como un archivo y utilizar en su lugar, el cambio de la opción -m para la opción -f y, por supuesto, pasar un nombre de archivo en lugar de una cadena.

git notes add your_branch -f mynotes.txt 
+0

Gracias, eso lo alivia un poco. Aún así sería bueno poder enumerar todas las ramas con las notas al lado de ellas. – JoGr

+3

Creo que esto es un error, las notas de Git solo se pueden agregar a los objetos, por lo que esto es en realidad agregar la nota a la confirmación que estaba en la punta de 'your_branch' cuando se ejecutó el comando, en lugar de la rama. Una vez que haya agregado más commits a 'your_branch', las notas' git show your_branch' ya no funcionarán. Creo que una mejor solución es [la respuesta más votado en la pregunta a la que Luwe se vinculó] (http://stackoverflow.com/q/2108405/223092). –

+0

Sí, de hecho. No funciona del modo que quería cuando sigo mi flujo de trabajo normal. Veré la pregunta vinculada ... – JoGr

1

El lugar para añadir su rama descripciones & nombre debe aparecer con las notas merge commit. Esto se debe a que las ramas deben ser de corta vida, y no se puede garantizar que su (s) punta (s) de rama duren para siempre.

El tiempo que realmente los necesita (nombres de ramas descriptivos) es cuando tiene que revisar un historial anterior que se haya fundido en él y después de que se haya eliminado ese extremo, etc. Y necesita más pistas sobre cómo de qué se trató todo (también debería haber escrito mejores mensajes de confirmación ;-)

Por lo tanto, la combinación de fusión enumeraría los nombres/detalles de ramas de las ramas padre (especialmente No2, No3, .., ya que el nombre 1 ya sea 'maestro' o se mostrará en una combinación posterior).

Recuerde, el nombre y la descripción de la sucursal es una conveniencia, no una necesidad. Estoy seguro de que hay mensajes de Linus T a tal efecto (por lo general con algún énfasis ;-)

ya recibe algo de ayuda sobre los nombres de las sucursales .. how-to-avoid-merge-branch-name-of-branch-in-commit-messages

Cuestiones relacionadas