[PATCH v2 try2 00/14] Officially start moving to the term 'staging area'

2014-04-25 Thread Felipe Contreras
tl;dr: everyone except Junio C Hamano and Drew Northup agrees; we should move away from the name the index. 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

Re: [PATCH v2 try2 00/14] Officially start moving to the term 'staging area'

2014-04-25 Thread Hilco Wijbenga
On 25 April 2014 11:12, Felipe Contreras felipe.contre...@gmail.com 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. The term 'staging

Re: [PATCH v2 00/14] Officially start moving to the term 'staging area'

2013-10-24 Thread Andreas Krey
On Thu, 24 Oct 2013 02:57:15 +, Karsten Blees wrote: ... The latter. I don't know about 'broader', but I'll try to summarize _my_ world view: (1) Audience matters For actual users, we need an accurate model that supports a variety of use cases without falling apart. IMO, a working

Re: [PATCH v2 00/14] Officially start moving to the term 'staging area'

2013-10-24 Thread Felipe Contreras
Karsten Blees wrote: (2) Index An index, as in a library, maps almost perfectly to what the git index is _and_ what we do with it. Not really. An index in the context of a library, and in any other context, is a tool that indicates where something is, in order to find it quickly. That is

Re: [PATCH v2 00/14] Officially start moving to the term 'staging area'

2013-10-23 Thread Karsten Blees
Am 19.10.2013 16:08, schrieb Philip Oakley: From: Karsten Blees karsten.bl...@gmail.com Am 15.10.2013 00:29, schrieb Felipe Contreras: tl;dr: everyone except Junio C Hamano and Drew Northup agrees; we should move away from the name the index. It has been discussed many times in the past

Re: [PATCH v2 00/14] Officially start moving to the term 'staging area'

2013-10-19 Thread Philip Oakley
From: Karsten Blees karsten.bl...@gmail.com Am 15.10.2013 00:29, schrieb Felipe Contreras: tl;dr: everyone except Junio C Hamano and Drew Northup agrees; we should move away from the name the index. It has been discussed many times in the past that 'index' is not an appropriate description for

Re: [PATCH v2 00/14] Officially start moving to the term 'staging area'

2013-10-18 Thread Matthieu Moy
I'm lacking time to read and answer in detail, sorry. Junio C Hamano gits...@pobox.com writes: It must be done is different from any change is good, as long as it introduces more instances of word 'stage'. I agree. Something must be done, at least to remove the cache Vs index confusion. I'm

Re: [PATCH v2 00/14] Officially start moving to the term 'staging area'

2013-10-18 Thread John Szakmeister
On Fri, Oct 18, 2013 at 5:46 AM, Matthieu Moy matthieu@grenoble-inp.fr wrote: I'm lacking time to read and answer in detail, sorry. Junio C Hamano gits...@pobox.com writes: It must be done is different from any change is good, as long as it introduces more instances of word 'stage'. I

Re: [PATCH v2 00/14] Officially start moving to the term 'staging area'

2013-10-18 Thread Felipe Contreras
On Fri, Oct 18, 2013 at 4:46 AM, Matthieu Moy matthieu@grenoble-inp.fr wrote: I'm lacking time to read and answer in detail, sorry. Junio C Hamano gits...@pobox.com writes: It must be done is different from any change is good, as long as it introduces more instances of word 'stage'. I

Re: [PATCH v2 00/14] Officially start moving to the term 'staging area'

2013-10-18 Thread Max Horn
On 17.10.2013, at 21:50, Junio C Hamano gits...@pobox.com wrote: Felipe Contreras felipe.contre...@gmail.com writes: [...] However, since you asked, I would share a couple of comments regarding the index, cache and staging area. (1) Staging area. The phrase staging area is not an

Re: [PATCH v2 00/14] Officially start moving to the term 'staging area'

2013-10-18 Thread Karsten Blees
Am 15.10.2013 00:29, schrieb Felipe Contreras: tl;dr: everyone except Junio C Hamano and Drew Northup agrees; we should move away from the name the index. 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,

Re: [PATCH v2 00/14] Officially start moving to the term 'staging area'

2013-10-18 Thread Felipe Contreras
Karsten Blees wrote: Am 15.10.2013 00:29, schrieb Felipe Contreras: tl;dr: everyone except Junio C Hamano and Drew Northup agrees; we should move away from the name the index. It has been discussed many times in the past that 'index' is not an appropriate description for what the

Re: [PATCH v2 00/14] Officially start moving to the term 'staging area'

2013-10-17 Thread Junio C Hamano
Felipe Contreras felipe.contre...@gmail.com writes: Junio, can you make an exception and reply to this thread? The change to move away from the term the index has been suggested many times since many years ago, it is an extremely important change to users, and all the Git developers agree it

Re: [PATCH v2 00/14] Officially start moving to the term 'staging area'

2013-10-17 Thread Felipe Contreras
Junio C Hamano wrote: Felipe Contreras felipe.contre...@gmail.com writes: Junio, can you make an exception and reply to this thread? The change to move away from the term the index has been suggested many times since many years ago, it is an extremely important change to users, and all

[PATCH v2 00/14] Officially start moving to the term 'staging area'

2013-10-14 Thread Felipe Contreras
tl;dr: everyone except Junio C Hamano and Drew Northup agrees; we should move away from the name the index. 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

Re: [PATCH v2 00/14] Officially start moving to the term 'staging area'

2013-10-14 Thread Felipe Contreras
On Mon, Oct 14, 2013 at 5:29 PM, Felipe Contreras felipe.contre...@gmail.com wrote: tl;dr: everyone except Junio C Hamano and Drew Northup agrees; we should move away from the name the index. Junio, can you make an exception and reply to this thread? The change to move away from the term the

[PATCH try2 00/14] Officially start moving to the term 'staging area'

2013-10-12 Thread Felipe Contreras
tl;dr: everyone except Junio C Hamano and Drew Northup agrees; we should move away from the name the index. 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

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

2013-09-08 Thread Philip Oakley
From: Felipe Contreras felipe.contre...@gmail.com 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.

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 philipoak...@iee.org wrote: From: Felipe Contreras felipe.contre...@gmail.com 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

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 piotr.krukowie...@gmail.com 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

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 n1xim.em...@gmail.com wrote: On Wed, Sep 4, 2013 at 3:13 AM, Piotr Krukowiecki piotr.krukowie...@gmail.com wrote: Just wanted to point to a Dr. Dobb's article from Monday:

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 n1xim.em...@gmail.com wrote: On Fri, Aug 30, 2013 at 1:16 AM, Piotr Krukowiecki piotr.krukowie...@gmail.com wrote: Drew Northup n1xim.em...@gmail.com napisał: I agree with Junio. This effort is better spent making the documentation clearer and more

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 n1xim.em...@gmail.com wrote: On Thu, Aug 29, 2013 at 6:10 PM, Felipe Contreras felipe.contre...@gmail.com wrote: On Thu, Aug 29, 2013 at 4:55 PM, Drew Northup n1xim.em...@gmail.com wrote: On Thu, Aug 29, 2013 at 2:37 PM, Junio C Hamano

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 swanson...@gmail.com wrote: On Thu, Aug 29, 2013 at 11:01 AM, Felipe Contreras felipe.contre...@gmail.com 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

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

2013-09-06 Thread Hilco Wijbenga
On 6 September 2013 08:45, Ping Yin pkufra...@gmail.com wrote: On Wed, Sep 4, 2013 at 2:08 PM, William Swanson swanson...@gmail.com wrote: On Thu, Aug 29, 2013 at 11:01 AM, Felipe Contreras felipe.contre...@gmail.com wrote: It has been discussed many times in the past that 'index' is not an

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

2013-09-04 Thread William Swanson
On Thu, Aug 29, 2013 at 11:01 AM, Felipe Contreras felipe.contre...@gmail.com 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

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-04 Thread Drew Northup
On Wed, Sep 4, 2013 at 3:13 AM, Piotr Krukowiecki piotr.krukowie...@gmail.com 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

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 piotr.krukowie...@gmail.com wrote: Drew Northup n1xim.em...@gmail.com 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

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 felipe.contre...@gmail.com wrote: On Thu, Aug 29, 2013 at 4:55 PM, Drew Northup n1xim.em...@gmail.com wrote: On Thu, Aug 29, 2013 at 2:37 PM, Junio C Hamano gits...@pobox.com wrote: Felipe Contreras felipe.contre...@gmail.com writes: It has

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 l@web.de 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

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 l@web.de wrote: Am 29.08.2013 22:36, schrieb Felipe Contreras: On Thu, Aug 29, 2013 at 3:03 PM, René Scharfe l@web.de wrote: If you have a --work-tree option then parseopt accepts --work as well, unless it's ambiguous, i.e. another option

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 l@web.de wrote: Am 29.08.2013 22:36, schrieb Felipe Contreras: On Thu, Aug 29, 2013 at 3:03 PM, René Scharfe l@web.de wrote: If you have a --work-tree option then parseopt accepts --work as well, unless it's ambiguous, i.e. another

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 felipe.contre...@gmail.com 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,

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 felipe.contre...@gmail.com wrote: On Thu, Aug 29, 2013 at 1:37 PM, Junio C Hamano gits...@pobox.com 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.

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 felipe.contre...@gmail.com wrote: On Thu, Aug 29, 2013 at 2:57 PM, Felipe Contreras felipe.contre...@gmail.com wrote: Here are the threads once again: http://thread.gmane.org/gmane.comp.version-control.git/197111

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 felipe.contre...@gmail.com wrote: On Fri, Aug 30, 2013 at 2:11 PM, Felipe Contreras felipe.contre...@gmail.com wrote: On Thu, Aug 29, 2013 at 2:57 PM, Felipe Contreras felipe.contre...@gmail.com wrote: Here are the threads once again:

Officially start moving to the term 'staging area'

2013-08-29 Thread Felipe Contreras
Hi, 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. The term 'staging area' is more intuitive for newcomers which are more familiar with English

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

2013-08-29 Thread Junio C Hamano
Felipe Contreras felipe.contre...@gmail.com 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

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

2013-08-29 Thread Matthieu Moy
Felipe Contreras felipe.contre...@gmail.com 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

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

2013-08-29 Thread Felipe Contreras
Matthieu Moy wrote: Felipe Contreras felipe.contre...@gmail.com 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

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

2013-08-29 Thread Matthieu Moy
Felipe Contreras felipe.contre...@gmail.com 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

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

2013-08-29 Thread Matthieu Moy
Felipe Contreras felipe.contre...@gmail.com 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/ --

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 gits...@pobox.com wrote: Felipe Contreras felipe.contre...@gmail.com 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

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 felipe.contre...@gmail.com 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

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 l@web.de wrote: Am 29.08.2013 20:57, schrieb Felipe Contreras: Matthieu Moy wrote: Felipe Contreras felipe.contre...@gmail.com writes: Moreover, the --stage and --work --work alone sounds weird. At least to me, it does not immediately

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

2013-08-29 Thread Matthieu Moy
Felipe Contreras felipe.contre...@gmail.com 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,

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 gits...@pobox.com wrote: Felipe Contreras felipe.contre...@gmail.com 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

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 n1xim.em...@gmail.com wrote: On Thu, Aug 29, 2013 at 2:37 PM, Junio C Hamano gits...@pobox.com wrote: Felipe Contreras felipe.contre...@gmail.com writes: It has been discussed many times in the past that 'index' is not an appropriate description

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

2013-08-29 Thread Piotr Krukowiecki
Drew Northup n1xim.em...@gmail.com 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