aboutsummaryrefslogtreecommitdiffstats

Mainline and stable with git notes

This repository is a mirror of mainline + stable with a twist: git notes!

git notes are small bits of extra information that can be added to a git commit after-the-fact; they are not actually part of the commit itself.

The notes in this particular repository contain cross-referencing information such as:

  • Fixed-by: (for commits which are later referenced as Fixed:)
  • Fixed-by-stable: (for which commits which have fixes that were backported to stable)
  • Stable: (for commits which are backported to stable)
  • Lore: (references to threads matching the patch subject)
  • Fixes: CVE-… (for commits which have CVEs assigned)
  • Introduces: CVE-… (for commits which are identified as introducing a security issue)

Using git notes locally

If you want to display notes locally (i.e. in git log and git show), you can do this:

git remote add notes git://git.kernel.org/pub/scm/linux/kernel/git/vegard/linux.git
git config remote.notes.fetch +refs/notes/commits:refs/notes/commits

You’ll need to sync regularly to get the most recent updates, which can be done with either git fetch notes or git remote update.

If you don’t want to use notes anymore, delete them from your repository with:

git remote rm notes
git update-ref -d refs/notes/commits

Using git notes on git.kernel.org

If you wish to have note show up in your own repository on git.kernel.org, the only way to do this currently is to push the refs/notes/commits ref to your own repository (assuming you already have the notes in your local repository):

git push origin +refs/notes/commits

The gitolite track feature currently does not really work for notes, since it only tracks branches and tags (refs/notes/heads/* and refs/notes/tags/*).

I’ve submitted git patches to allow external repositories to be used as a source of notes, but these were rejected by the maintainer. I may try to pick this up again at some point in the future if there is interest or demand for it.