Re: Confusing language in man page

On 7/14/07, Satyam Sharma [off-list ref] wrote:

Hi,

[ I'm using Fedora's latest package. ]

I should probably clarify:

$ git --version
git version 1.5.0.6

Perhaps man pages / functionality have been updated significantly
since that, so let me know if that's the case.

From git-checkout(1) and git-branch(1):

-l     Create the new branch's ref log. This activates recording of
all changes to made the
       branch ref, enabling use of date

I'd be glad if someone could explain that a bit more verbosely
in the man page
(or just here in a reply), or at least make that grammatically
correct/readable :-)

Ok, another confusion I hit (as I learn more about git) tonight:

* What exactly is the use of git-diff's "-p" option?

$ git diff

and

$ git diff -p

produce the same output / do the same thing -- the man page mentions
"Generate patch (see section on generating patches)" but I couldn't find
said section (is that referring to some other man page?)

* On my system, doing:

$ git diff

with no outstanding changes in my current working tree produces some
bogus newlines, throwing the prompt to the bottom of the xterm window.
This sounds like weird / undesirable behaviour and I have a feeling must
already be fixed in latest git (?)

Thanks,
Satyam