From: Bo Yang Date: Sun, 11 Apr 2010 02:23:25 GMT Subject: Re: [PATCH 1/2 v2] Add a basic idea section for git-blame. Message-ID: In-Reply-To: <7veiinw0bw.fsf@alter.siamese.dyndns.org> Hi Junio, On Sun, Apr 11, 2010 at 3:53 AM, Junio C Hamano wrote: > It doesn't really matter to them _why_ only B is blamed to the parent in > "A B" -> "B A" movement without -M (and your "BASIC IDEA" section is too > sketchy for readers to guess why, even if they wanted to learn the > implementation detail, which they typically don't). > > Things like: > >    - they can use -M to annotate across block-of-lines swappage within a file; >    - use of -M adds cost --- it spends extra cycles; >    - similarly -C annotates across block-of-lines swappage between files; >    - use -f -C adds larger cost; ... > > are the only important things they want to know about, no? I think all the four things above are mentioned in [PATCH 2/2 v2] message, it contains who should the command pass blame to and the order of the algorithm used. Would you please take a look at that patch? And the BASIC IDEA section just want to make a basic description about how blame works briefly. If you thought that it is non-use for end-users, how about just discard it and make a more technical one at technical/git-blame.txt ? Thanks! Regards! Bo