Re: [PATCH] notes: mention --notes in more places

2012-10-18 Thread Michael J Gruber
Jeff King venit, vidit, dixit 17.10.2012 21:05: > On Wed, Oct 17, 2012 at 07:30:56AM -0600, Eric Blake wrote: > >>> We've talked about it several times, but it's never happened (probably >>> because most people don't actually use notes). >> >> And people (like me) don't use notes because they aren

Re: [PATCH] notes: mention --notes in more places

2012-10-17 Thread Junio C Hamano
Jeff King writes: > On Wed, Oct 17, 2012 at 07:30:56AM -0600, Eric Blake wrote: > >> > We've talked about it several times, but it's never happened (probably >> > because most people don't actually use notes). >> >> And people (like me) don't use notes because they aren't documented. >> Catch-22

Re: [PATCH] notes: mention --notes in more places

2012-10-17 Thread Jeff King
On Wed, Oct 17, 2012 at 07:30:56AM -0600, Eric Blake wrote: > > We've talked about it several times, but it's never happened (probably > > because most people don't actually use notes). > > And people (like me) don't use notes because they aren't documented. > Catch-22, so we have to start somewh

Re: [PATCH] notes: mention --notes in more places

2012-10-17 Thread Eric Blake
On 10/16/2012 11:51 PM, Jeff King wrote: > It may also make sense to show notes differently when outputting the > "email" format as format-patch does. E.g., using a triple-dash would > keep them separate from the commit message when using "git am". Like: > > your commit message > > Signed-off

Re: [PATCH] notes: mention --notes in more places

2012-10-16 Thread Junio C Hamano
Jeff King wrote: >It may also make sense to show notes differently when outputting the >"email" format as format-patch does. E.g., using a triple-dash would >keep them separate from the commit message when using "git am". Like: > > your commit message > > Signed-off-by: You > --- > your notes

Re: [PATCH] notes: mention --notes in more places

2012-10-16 Thread Jeff King
On Tue, Oct 16, 2012 at 09:19:35PM -0600, Eric Blake wrote: > Every so often, I search 'git send-email --help' to remember some > option I've used in the past, only to discover that the option is > documented instead in 'git format-patch --help'. Worse, even that > command didn't document the opt

Re: [PATCH] notes: mention --notes in more places

2012-10-16 Thread Junio C Hamano
Eric Blake writes: > * git-notes.txt: Mention that --notes option exists in many > commands to override defaults. > * git-format-patch.txt: Include pretty-options, for things like > --notes. > * git-send-email.txt: Mention that revision lists forwarded to > format-patch can also include options.

[PATCH] notes: mention --notes in more places

2012-10-16 Thread Eric Blake
Every so often, I search 'git send-email --help' to remember some option I've used in the past, only to discover that the option is documented instead in 'git format-patch --help'. Worse, even that command didn't document the option I was looking for today, which was how to include 'git notes' in