From: Michael J Gruber <git@drmicha.warpmail.net>
To: Erick Mattos <erick.mattos@gmail.com>
Cc: Junio C Hamano <gitster@pobox.com>,
Peter Baumann <waste.manager@gmx.de>,
git@vger.kernel.org
Subject: Re: [PATCH v3] git checkout: create unparented branch by --orphan
Date: Mon, 22 Mar 2010 09:54:47 +0100 [thread overview]
Message-ID: <4BA73057.1020602@drmicha.warpmail.net> (raw)
In-Reply-To: <55bacdd31003211415k79b7a039n3f19eb95eefcad43@mail.gmail.com>
Erick Mattos venit, vidit, dixit 21.03.2010 22:15:
> Hi,
>
> 2010/3/21 Junio C Hamano <gitster@pobox.com>:
>> I'm not native either, and "orphan" sounded strange in that we've never
>> used that word in any of our use case or workflow description in our
>> documents.
>
> I didn't know. I thought you were American.
>
>> The main point of the feature is not the emptyness of the resulting tree
>> (it is merely one possible outcome), but is the lack of parents in the
>> resulting commit. So I would recommend against --empty. --root might be
>> a good synonym, though, and we _do_ already use that word for that purpose
>> in some commands (e.g. "log --root").
>
> --root could be a synonym but the reason I haven't chosen it was the
> fact that it could mislead people to think the functionality will do
> something with/based on the first commit of the actual branch,
> subjectively thinking "THE ROOT".
>
> IMHO --orphan (no parents) is more obvious.
>
> We should argue one of our native English speaker amidst this
> developer community to be sure.
[Disclosure: non-native speaker but having lived with natives ;)]
I'd favour "root" for several reasons:
- "root" is the correct technical term in graph theory
- "root" is used the same way in other (Git) places
- "orphan" is someone who used to have parents, so with "orphan" I would
rather associate the process of removing parents from the picture
(removing parentship information from an existing commit)
Just my two Euro-cents :)
Michael
next prev parent reply other threads:[~2010-03-22 8:57 UTC|newest]
Thread overview: 13+ messages / expand[flat|nested] mbox.gz Atom feed top
2010-03-21 15:34 [PATCH v3] git checkout: create unparented branch by --orphan Erick Mattos
2010-03-21 17:14 ` Peter Baumann
2010-03-21 17:55 ` Erick Mattos
2010-03-21 19:37 ` Junio C Hamano
2010-03-21 21:15 ` Erick Mattos
2010-03-22 8:54 ` Michael J Gruber [this message]
2010-03-22 12:46 ` Chris Johnsen
2010-03-22 14:36 ` Erick Mattos
2010-03-21 21:38 ` Junio C Hamano
2010-03-22 12:43 ` Chris Johnsen
2010-03-22 14:14 ` Erick Mattos
2010-03-22 16:06 ` Translating error messages in Git (was: Re: [PATCH v3] git checkout: create unparented branch by --orphan) Jakub Narebski
2010-03-22 20:19 ` [PATCH v3] git checkout: create unparented branch by --orphan Junio C Hamano
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=4BA73057.1020602@drmicha.warpmail.net \
--to=git@drmicha.warpmail.net \
--cc=erick.mattos@gmail.com \
--cc=git@vger.kernel.org \
--cc=gitster@pobox.com \
--cc=waste.manager@gmx.de \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.