Re: Officially start moving to the term 'staging area'

2013-09-08 Thread Felipe Contreras
On Sun, Sep 8, 2013 at 2:49 AM, Philip Oakley wrote: > From: "Felipe Contreras" > Sent: Sunday, September 08, 2013 2:33 AM > [snip...] > >> The snapshot concept is totally orthogonal from the staging area >> concept. Git works in snapshots, which are frozen images of how the >> content tree was a

Re: Officially start moving to the term 'staging area'

2013-09-08 Thread Philip Oakley
From: "Felipe Contreras" Sent: Sunday, September 08, 2013 2:33 AM [snip...] The snapshot concept is totally orthogonal from the staging area concept. Git works in snapshots, which are frozen images of how the content tree was at a certain point in time; IOW; a commit. (I feel that) In most peo

Re: Officially start moving to the term 'staging area'

2013-09-07 Thread Felipe Contreras
On Tue, Sep 3, 2013 at 11:45 PM, Drew Northup wrote: > On Thu, Aug 29, 2013 at 6:10 PM, Felipe Contreras > wrote: >> On Thu, Aug 29, 2013 at 4:55 PM, Drew Northup wrote: >>> On Thu, Aug 29, 2013 at 2:37 PM, Junio C Hamano wrote: Felipe Contreras writes: > It has been discussed ma

Re: Officially start moving to the term 'staging area'

2013-09-07 Thread Felipe Contreras
On Tue, Sep 3, 2013 at 11:23 PM, Drew Northup wrote: > On Fri, Aug 30, 2013 at 1:16 AM, Piotr Krukowiecki > wrote: >> Drew Northup napisał: >>>I agree with Junio. This effort is better spent making the >>>documentation clearer and more succinct. The reality is that a user >>>needs to build a mod

Re: Officially start moving to the term 'staging area'

2013-09-07 Thread Felipe Contreras
On Wed, Sep 4, 2013 at 8:36 AM, Drew Northup wrote: > On Wed, Sep 4, 2013 at 3:13 AM, Piotr Krukowiecki > wrote: >> Just wanted to point to a Dr. Dobb's article from Monday: >> http://www.drdobbs.com/tools/getting-started-with-git-the-fundamental/240160261?pgno=2 >> >> The author does not use the

Re: Officially start moving to the term 'staging area'

2013-09-07 Thread Felipe Contreras
On Wed, Sep 4, 2013 at 2:13 AM, Piotr Krukowiecki wrote: > Just wanted to point to a Dr. Dobb's article from Monday: > http://www.drdobbs.com/tools/getting-started-with-git-the-fundamental/240160261?pgno=2 > > The author does not use the use the word "index" at all. Instead he > writes in followin

Re: Officially start moving to the term 'staging area'

2013-09-06 Thread Hilco Wijbenga
On 6 September 2013 08:45, Ping Yin wrote: > On Wed, Sep 4, 2013 at 2:08 PM, William Swanson wrote: >> On Thu, Aug 29, 2013 at 11:01 AM, Felipe Contreras >> wrote: >>> It has been discussed many times in the past that 'index' is not an >>> appropriate description for what the high-level user doe

Re: Officially start moving to the term 'staging area'

2013-09-06 Thread Ping Yin
On Wed, Sep 4, 2013 at 2:08 PM, William Swanson wrote: > On Thu, Aug 29, 2013 at 11:01 AM, Felipe Contreras > wrote: >> It has been discussed many times in the past that 'index' is not an >> appropriate description for what the high-level user does with it, and >> it has been agreed that 'staging

Re: Officially start moving to the term 'staging area'

2013-09-04 Thread Drew Northup
On Wed, Sep 4, 2013 at 3:13 AM, Piotr Krukowiecki wrote: > Just wanted to point to a Dr. Dobb's article from Monday: > http://www.drdobbs.com/tools/getting-started-with-git-the-fundamental/240160261?pgno=2 > > The author does not use the use the word "index" at all. Instead he > writes in followin

Re: Officially start moving to the term 'staging area'

2013-09-04 Thread Piotr Krukowiecki
Just wanted to point to a Dr. Dobb's article from Monday: http://www.drdobbs.com/tools/getting-started-with-git-the-fundamental/240160261?pgno=2 The author does not use the use the word "index" at all. Instead he writes in following way: ---

Re: Officially start moving to the term 'staging area'

2013-09-03 Thread William Swanson
On Thu, Aug 29, 2013 at 11:01 AM, Felipe Contreras wrote: > It has been discussed many times in the past that 'index' is not an > appropriate description for what the high-level user does with it, and > it has been agreed that 'staging area' is the best term. I realize Git is not a democracy, but

Re: Officially start moving to the term 'staging area'

2013-09-03 Thread Drew Northup
On Thu, Aug 29, 2013 at 6:10 PM, Felipe Contreras wrote: > On Thu, Aug 29, 2013 at 4:55 PM, Drew Northup wrote: >> On Thu, Aug 29, 2013 at 2:37 PM, Junio C Hamano wrote: >>> Felipe Contreras writes: >>> It has been discussed many times in the past that 'index' is not an appropriate de

Re: Officially start moving to the term 'staging area'

2013-09-03 Thread Drew Northup
On Fri, Aug 30, 2013 at 1:16 AM, Piotr Krukowiecki wrote: > Drew Northup napisał: >>I agree with Junio. This effort is better spent making the >>documentation clearer and more succinct. The reality is that a user >>needs to build a model in their mind of what they are doing which maps >>enough (c

Re: Officially start moving to the term 'staging area'

2013-08-31 Thread David Aguilar
On Sat, Aug 31, 2013 at 12:46 AM, René Scharfe wrote: > Am 29.08.2013 22:36, schrieb Felipe Contreras: >> >> On Thu, Aug 29, 2013 at 3:03 PM, René Scharfe wrote: >>> >>> If you have a --work-tree option then parseopt accepts --work as well, >>> unless it's ambiguous, i.e. another option starts wi

Re: Officially start moving to the term 'staging area'

2013-08-31 Thread Felipe Contreras
On Sat, Aug 31, 2013 at 2:46 AM, René Scharfe wrote: > Am 29.08.2013 22:36, schrieb Felipe Contreras: >> >> On Thu, Aug 29, 2013 at 3:03 PM, René Scharfe wrote: >>> >>> If you have a --work-tree option then parseopt accepts --work as well, >>> unless it's ambiguous, i.e. another option starts wit

Re: Officially start moving to the term 'staging area'

2013-08-31 Thread René Scharfe
Am 29.08.2013 22:36, schrieb Felipe Contreras: On Thu, Aug 29, 2013 at 3:03 PM, René Scharfe wrote: If you have a --work-tree option then parseopt accepts --work as well, unless it's ambiguous, i.e. another option starts with --work, too. So you can have a descriptive, extra-long option and ty

Re: Officially start moving to the term 'staging area'

2013-08-30 Thread Felipe Contreras
On Fri, Aug 30, 2013 at 3:40 PM, Felipe Contreras wrote: > On Fri, Aug 30, 2013 at 2:11 PM, Felipe Contreras > wrote: >> On Thu, Aug 29, 2013 at 2:57 PM, Felipe Contreras >> wrote: > >>> Here are the threads once again: >>> >>> http://thread.gmane.org/gmane.comp.version-control.git/197111 >>> ht

Re: Officially start moving to the term 'staging area'

2013-08-30 Thread Felipe Contreras
On Fri, Aug 30, 2013 at 2:11 PM, Felipe Contreras wrote: > On Thu, Aug 29, 2013 at 2:57 PM, Felipe Contreras > wrote: >> Here are the threads once again: >> >> http://thread.gmane.org/gmane.comp.version-control.git/197111 >> http://thread.gmane.org/gmane.comp.version-control.git/166675 >> http:/

Re: Officially start moving to the term 'staging area'

2013-08-30 Thread Felipe Contreras
On Thu, Aug 29, 2013 at 2:57 PM, Felipe Contreras wrote: > On Thu, Aug 29, 2013 at 1:37 PM, Junio C Hamano wrote: >> IIRC, when this was discussed, many non-native speakers had trouble >> with the verb "to stage", not just from i18n/l10n point of view. > > Well, you recall incorrectly. > > There

Re: Officially start moving to the term 'staging area'

2013-08-30 Thread Felipe Contreras
On Thu, Aug 29, 2013 at 2:57 PM, Felipe Contreras wrote: > Again, *everyone* has agreed that index needs to be renamed, and > "staging area" is the best option. > > Do I really need to go through all the discussions and list each and > every person that participated in them, and show to you how e

Re: Officially start moving to the term 'staging area'

2013-08-29 Thread Piotr Krukowiecki
Drew Northup napisał: >I agree with Junio. This effort is better spent making the >documentation clearer and more succinct. The reality is that a user >needs to build a model in their mind of what they are doing which maps >enough (completely is not required) to what is actually going on to >get w

Re: Officially start moving to the term 'staging area'

2013-08-29 Thread Felipe Contreras
On Thu, Aug 29, 2013 at 4:55 PM, Drew Northup wrote: > On Thu, Aug 29, 2013 at 2:37 PM, Junio C Hamano wrote: >> Felipe Contreras writes: >> >>> It has been discussed many times in the past that 'index' is not an >>> appropriate description for what the high-level user does with it, and >>> it h

Re: Officially start moving to the term 'staging area'

2013-08-29 Thread Drew Northup
On Thu, Aug 29, 2013 at 2:37 PM, Junio C Hamano wrote: > Felipe Contreras writes: > >> It has been discussed many times in the past that 'index' is not an >> appropriate description for what the high-level user does with it, and >> it has been agreed that 'staging area' is the best term. > > "add

Re: Officially start moving to the term 'staging area'

2013-08-29 Thread Matthieu Moy
Felipe Contreras writes: > Matthieu Moy wrote: > >> --work alone sounds weird. At least to me, it does not immediately imply >> "working tree". It is tempting to call the option --work-tree, but git >> already has a global option with that name (git --work-tree=foo bar). > > Yes, --work sounds we

Re: Officially start moving to the term 'staging area'

2013-08-29 Thread Felipe Contreras
On Thu, Aug 29, 2013 at 3:03 PM, René Scharfe wrote: > Am 29.08.2013 20:57, schrieb Felipe Contreras: >> >> Matthieu Moy wrote: >> >>> Felipe Contreras writes: Moreover, the --stage and --work >>> >>> >>> --work alone sounds weird. At least to me, it does not immediately imply >>> "work

Re: Officially start moving to the term 'staging area'

2013-08-29 Thread René Scharfe
Am 29.08.2013 20:57, schrieb Felipe Contreras: Matthieu Moy wrote: Felipe Contreras writes: Moreover, the --stage and --work --work alone sounds weird. At least to me, it does not immediately imply "working tree". It is tempting to call the option --work-tree, but git already has a global op

Re: Officially start moving to the term 'staging area'

2013-08-29 Thread Felipe Contreras
On Thu, Aug 29, 2013 at 1:37 PM, Junio C Hamano wrote: > Felipe Contreras writes: > >> It has been discussed many times in the past that 'index' is not an >> appropriate description for what the high-level user does with it, and >> it has been agreed that 'staging area' is the best term. > > "add

Re: Officially start moving to the term 'staging area'

2013-08-29 Thread Matthieu Moy
Felipe Contreras writes: > add an explanation in Documentation/gitstagingarea.txt > or something. There's Documentation/gitcli.txt, that will need updating anyway (at the bottom, it talks about --cached and --index). -- Matthieu Moy http://www-verimag.imag.fr/~moy/ -- To unsubscribe from this

Re: Officially start moving to the term 'staging area'

2013-08-29 Thread Matthieu Moy
Felipe Contreras writes: > Matthieu Moy wrote: >> These explanations make sense. I think it would be better to put part of >> it in commit messages, so that future contributors can "git blame" the >> doc/implem of these --stage and find them (i.e. avoid the >> misunderstanding that occured with "

Re: Officially start moving to the term 'staging area'

2013-08-29 Thread Felipe Contreras
Matthieu Moy wrote: > Felipe Contreras writes: > > > It has been discussed many times in the past that 'index' is not an > > appropriate description for what the high-level user does with it, and > > it has been agreed that 'staging area' is the best term. > > Thanks for working on this. No time

Re: Officially start moving to the term 'staging area'

2013-08-29 Thread Matthieu Moy
Felipe Contreras writes: > It has been discussed many times in the past that 'index' is not an > appropriate description for what the high-level user does with it, and > it has been agreed that 'staging area' is the best term. Thanks for working on this. No time for a really detailed review, but

Re: Officially start moving to the term 'staging area'

2013-08-29 Thread Junio C Hamano
Felipe Contreras writes: > It has been discussed many times in the past that 'index' is not an > appropriate description for what the high-level user does with it, and > it has been agreed that 'staging area' is the best term. "add" is the verb, not "index" (which is a noun that refers to the th