On 08/09/2015 04:31 PM, Gordon Pettey wrote: > On Sun, Aug 9, 2015 at 7:06 AM, Anthony G. Basile <bluen...@gentoo.org > <mailto:bluen...@gentoo.org>> wrote: > > > Particularly, we should prepend "CATEGORY/PN: " to the first line so > we can easily search git log for what happened to a package. > > > Good format to help reading unfiltered logs, but invalid reasoning. 'git > log portage/cat/pn' or 'git log portage/cat-old/pn-old > portage/cat-moved/pn-moved' gets every commit affecting files in said > package's directory. > >
"git log some-dir" is directory-based, while the commit message is based on what the commit primarily affected. In addition, you don't really want to guess what "PN: foo" means, because of name ambiguity (we have a lot of those in the tree). Anyway, this is already decided. If you want to improve the wording/reasoning in the wiki, go ahead: https://wiki.gentoo.org/wiki/Gentoo_git_workflow#commit_message_format