On Wed, 25 Nov 2009 19:02:19 +0100, Jed Brown <jed@59A2.org> wrote:
> This currently means the same thing as --format=headers-only, but this
> name gives more freedom to change --format=headers-only without breaking
> existing versions of git.

While it may make sense in the future to put something git-specific
here, I'd rather wait on creating the additional option until we
actually have something.

Otherwise, our documentation is more complicated, and callers will feel
the need to call the longer option "just in case", and all for possibly
no reason at all.

-Carl