From: Junio C Hamano <junkio@cox.net>
Date: Mon, 16 Apr 2007 07:48:30 GMT
Subject: Re: [PATCH] Update git-am documentation
Message-ID: <7vy7ksvjxt.fsf@assigned-by-dhcp.cox.net>
In-Reply-To: <20070416072131.GA20722@localdomain>

Andrew Ruder <andy@aeruder.net> writes:

> Documentation/git-am.txt missing several short versions
> of options.  Added documentation for --resolvemsg=<msg>
> command-line option.
>
> Signed-off-by: Andrew Ruder <andy@aeruder.net>
> ---
>  Sometimes it is a bit difficult to gauge intention by reading the code.
>  :)  My initial thought was that it was just to aid in scripting git-am
>  and left it at that.  But I'd still much rather have all command-line
>  options in the man pages even if they are primarily for internal use as
>  sometimes they still will find themself useful in atypical situations.

It is _solely_ (not "primarily") for git-rebase and not even for
"scripting around".  In other words, it is an implementation
detail of git-rebase and I would rather reserve the right to
update that implementation detail by not setting that in stone
for users to abuse.