Re: Confusing language in man page

["Satyam Sharma" <satyam.sharma@gmail.com>]

On 7/14/07, Satyam Sharma <satyam.sharma@gmail.com> 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