From: Johannes Sixt <j.sixt@viscovery.net>
Date: Thu, 27 Sep 2007 06:22:27 GMT
Subject: Re: grafts not appearing in manual pages
Message-ID: <46FB4C23.8010400@viscovery.net>
In-Reply-To: <20070926210102.GF26099@fieldses.org>

J. Bruce Fields schrieb:
> On Wed, Sep 26, 2007 at 10:24:41PM +0200, Mike Hommey wrote:
>> Hi,
>>
>> The only occurrence of grafts in the manual pages is in the
>> git-filter-branch one. I somehow feel this is wrong not to see it
>> described more "formally" in the manual pages.
>>
>> I wouldn't mind writing a small something, except I have no idea what
>> would be the most appropriate place to talk about it... Does anyone have
>> such an idea ?
> 
> It could go in Documentation/user-manual.txt, but I don't know where.

IMHO grafts should not be made known to a wide audience until send-pack, 
pack-objects, and prune are fixed so that you cannot corrupt your repository 
when there are grafts.

See http://thread.gmane.org/gmane.comp.version-control.git/37744
in particular http://article.gmane.org/gmane.comp.version-control.git/37866
on a sketch how to fix the issues.

-- Hannes