[oe] OEDEM 2010: [RFC] useful commit message
k.kooi at student.utwente.nl
Sun Oct 31 11:20:36 CET 2010
-----BEGIN PGP SIGNED MESSAGE-----
On 29-10-10 11:02, Paul Menzel wrote:
> Dear OE folks,
> could you please discuss the following proposal.
> I would very much like more elaborate commit messages. This is in my
> opinion already demanded by the commit policy , but often patch
> submitters, especially those not sending changes to review to the list,
> since they have direct access to the repository, fail to adhere to the
> The reason is, quite often I do not understand why a change was
> necessary. It would very much help me, if at least the error message was
> pasted to be able to compare with one’s own error messages and what
> distribution and machine was used to test the recipe.
We discussed this at OEDEM and AIUI the TSC will make a recommendation
about it later, but in the meantime you can expand existing commit
messages with git notes:
git-notes - Add/inspect commit notes
git notes (edit [-F <file> | -m <msg>] | show) [commit]
This command allows you to add notes to commit messages, without
changing the commit. To discern these notes from the message stored in
the commit object, the notes
are indented like the message, after an unindented line saying
To disable commit notes, you have to set the config variable
core.notesRef to the empty string. Alternatively, you can set it to a
different ref, something like
"refs/notes/bugzilla". This setting can be overridden by the
environment variable "GIT_NOTES_REF".
Edit the notes for a given commit (defaults to HEAD).
Show the notes for a given commit (defaults to HEAD).
Use the given note message (instead of prompting). If
multiple -m (or -F) options are given, their values are concatenated as
Take the note message from the given file. Use - to read the
note message from the standard input. If multiple -F (or -m) options are
given, their values are
concatenated as separate paragraphs.
It would of course be better to get it right the first time :)
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.5 (Darwin)
-----END PGP SIGNATURE-----
More information about the Openembedded-devel