threads / discuss / 43538

Re: Documentation/git-commit.txt

Subject: Re: Documentation/git-commit.txt

## tl;dr

3 messages between Dec 10, 2006 and Dec 11, 2006.

replies: 2people: 3as markdown or json

Horst H. von Brand· Dec 10, 2006, 00:11 UTC · lore

Alan Chandler <alan@chandlerfamily.org.uk> wrote:

[...]

Show 6 quoted lines

> How about the following wording here
> 
> Instead of staging the content of each file immediately after changing 
> it, you can wait until you have completed all the changes you want to 
> make and then use the `-a` option to tell `git commit` to look for all 
> changes to the content it is tracking and commit it automatically. That

                 ^^^^^^^
                 files
                 (or "files whose contents")

> is, this example ...

[Yes, git tracks the contents of files, but it also has a list of files
 whose contents it is tracking]

-- 
Dr. Horst H. von Brand                   User #22616 counter.li.org
Departamento de Informatica                    Fono: +56 32 2654431
Universidad Tecnica Federico Santa Maria             +56 32 2654239

Alan Chandler· Dec 10, 2006, 09:23 UTC · re: Horst H. von Brand · lore

On Sunday 10 December 2006 00:11, Horst H. von Brand wrote:

Show 20 quoted lines

> Alan Chandler <alan@chandlerfamily.org.uk> wrote:
>
> [...]
>
> > How about the following wording here
> >
> > Instead of staging the content of each file immediately after
> > changing it, you can wait until you have completed all the changes
> > you want to make and then use the `-a` option to tell `git commit`
> > to look for all changes to the content it is tracking and commit it
> > automatically. That
>
>                  ^^^^^^^
>                  files
>                  (or "files whose contents")
>
> > is, this example ...
>
> [Yes, git tracks the contents of files, but it also has a list of
> files whose contents it is tracking]

regardless, I think "it" should become "them"

... it is tracking and commit them automatically.

-- 
Alan Chandler

Andreas Ericsson· Dec 11, 2006, 14:58 UTC · re: Alan Chandler · lore

Alan Chandler wrote:

Show 24 quoted lines

> On Sunday 10 December 2006 00:11, Horst H. von Brand wrote:
>> Alan Chandler <alan@chandlerfamily.org.uk> wrote:
>>
>> [...]
>>
>>> How about the following wording here
>>>
>>> Instead of staging the content of each file immediately after
>>> changing it, you can wait until you have completed all the changes
>>> you want to make and then use the `-a` option to tell `git commit`
>>> to look for all changes to the content it is tracking and commit it
>>> automatically. That
>>                  ^^^^^^^
>>                  files
>>                  (or "files whose contents")
>>
>>> is, this example ...
>> [Yes, git tracks the contents of files, but it also has a list of
>> files whose contents it is tracking]
> 
> regardless, I think "it" should become "them"
> 
> ... it is tracking and commit them automatically. 
>

Works wonderfully, as the syntactically anal will notice that "them" refers to "the changes" while newbies glossing over the docs will think of "them" as "the files" (which is technically incorrect but amounts to the same thing from that same newbies perspective).

-- 
Andreas Ericsson                   andreas.ericsson@op5.se
OP5 AB                             www.op5.se