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't

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

2012-10-17 Thread Junio C Hamano
Jeff King p...@peff.net 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

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-by: You

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 somewhere.

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

2012-10-17 Thread Junio C Hamano
Jeff King p...@peff.net 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.

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

2012-10-16 Thread Junio C Hamano
Eric Blake ebl...@redhat.com 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

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 option