Re: [PATCH] docs/git-mailinfo: Mention the manual separator (---)
- From
W. Trevor King <wking@tremily.us>
- Date
- Sep 30, 2014, 21:48 UTC
- Message-ID
- <20140930214846.GK3770@odin.tremily.us>
- In-Reply-To
- <xmqqiok4rew5.fsf@gitster.dls.corp.google.com>
On Tue, Sep 30, 2014 at 02:12:58PM -0700, Junio C Hamano wrote:
> If we are extending the documentation on "---", …
Ah, I see that the --- are actually mentioned already in the DISCUSSION section of git-am(1) since 2499857b (git-am documentation: describe what is taken from where, 2007-03-24). I expected the docs to be either in git-mailinfo(1) (since the code added by f0658cf2 (restrict the patch filtering, 2007-03-12) is in mailinfo) or to match a grep for '---'. Maybe we should drop this patch in favor of notes in git-mailinfo(1) and git-format-patch(1) pointing folks at the DISCUSSION section in git-am(1) and a more easily grepable “three dashes ('---')" in gi-am(1)?
Cheers, Trevor
-- This email may be signed or encrypted with GnuPG (http://www.gnupg.org). For more information, see http://en.wikipedia.org/wiki/Pretty_Good_Privacy