From: "Ævar Arnfjörð Bjarmason" <email@example.com> To: Felipe Contreras <firstname.lastname@example.org> Cc: "Junio C Hamano" <email@example.com>, "Elijah Newren" <firstname.lastname@example.org>, "Gábor Farkas" <email@example.com>, "Git Mailing List" <firstname.lastname@example.org> Subject: Re: git switch/restore, still experimental? Date: Mon, 10 May 2021 12:58:16 +0200 [thread overview] Message-ID: <email@example.com> (raw) In-Reply-To: <firstname.lastname@example.org> On Thu, May 06 2021, Felipe Contreras wrote: > Ævar Arnfjörð Bjarmason wrote: >> On Thu, May 06 2021, Felipe Contreras wrote: First of all, I think we're in rather violent agreement about the real matter at hand here, and are at best talking about the design of the keychain for the bikeshed... >> > If you use natural language: >> > >> > 1. Git, switch to a new branch >> > >> > 2. Git, switch, create, branch >> > >> > One of these simply flows, the other is complete gibberish. I think >> > anyone familiar with English can identify which is which. >> >> Well, there's "Git, create a new branch and switch to it" > > Which command is that? > > git create branch --checkout? > > I'm following the order of the words from left to right. I'm just pointing out that git in general and certainly not the *nix tradition it follows tries to make commands readable in anything like English sentence order. If you attempt to read "log", "status", "rebase" etc. commands like that you'll at best end up sounding somewhat like Yoda. >> Also, there's the verb "make" in common use in git's command set >> e.g. git-mktag, git-mktree, as well as mkdir(1), mkfifo(1) etc. > > Sure, although I wouldn't consider them main commands. I for one never > use them. > >> In any case, unless we're talking about rewamping git's entire command >> set (e.g. having a git-newtree or whatever) I'd like to think that it's >> more productive to focus on making the commands/switches we have >> internally consistent when possible, which is what I'm advocating in the >> E-Mail that started this sub-thread. > > But we are talking about a new command, it is precisely at this point we > need to think about what could have been if mistakes of the past had not > happened. > > We should not repeat past mistakes without a very good reason. > > I don't think we should seek consistency for consistency's sake. Sure, > consistency is good, but it's only one of many considerations. > > In this case however we have a rare occasion in which both consistency and > natural language meet, we should not squander it. > > In fact, to be even more consistent we could add a -n option to git > branch, which would be reduntant but more explicit, like --list. Indeed, I agree with all of that. I.e. we should move to "switch" to "-n" instead of "-c" etc., and add a "-n" to "branch" for consistency. After all that's my upthread proposal... I just don't think it's worth trying to make the argv readable as a sentence, even if we had no backwards compatibility to worry about.
next prev parent reply other threads:[~2021-05-10 11:51 UTC|newest] Thread overview: 25+ messages / expand[flat|nested] mbox.gz Atom feed top 2021-05-04 10:32 Gábor Farkas 2021-05-04 19:54 ` Felipe Contreras 2021-05-05 3:46 ` Elijah Newren 2021-05-05 4:01 ` Eric Sunshine 2021-05-05 11:09 ` Ævar Arnfjörð Bjarmason 2021-05-05 17:46 ` Felipe Contreras 2021-05-05 19:26 ` Sergey Organov 2021-05-05 19:48 ` Sergey Organov 2021-05-06 1:39 ` Junio C Hamano 2021-05-06 15:19 ` Sergey Organov 2021-05-06 10:05 ` Ævar Arnfjörð Bjarmason 2021-05-06 14:29 ` Sergey Organov 2021-05-06 2:16 ` Junio C Hamano 2021-05-06 10:02 ` Ævar Arnfjörð Bjarmason 2021-05-10 11:04 ` Ævar Arnfjörð Bjarmason 2021-05-10 18:27 ` Junio C Hamano 2021-05-06 11:00 ` Felipe Contreras 2021-05-06 15:26 ` Ævar Arnfjörð Bjarmason 2021-05-06 21:55 ` Felipe Contreras 2021-05-10 10:58 ` Ævar Arnfjörð Bjarmason [this message] 2021-05-11 7:15 ` Felipe Contreras 2021-05-05 14:18 ` Johannes Schindelin 2021-05-05 14:26 ` Randall S. Becker 2021-05-06 1:15 ` Junio C Hamano 2021-05-05 17:52 ` Felipe Contreras
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 List information: http://vger.kernel.org/majordomo-info.html * Reply using the --to, --cc, and --in-reply-to switches of git-send-email(1): git send-email \ --email@example.com \ --firstname.lastname@example.org \ --email@example.com \ --firstname.lastname@example.org \ --email@example.com \ --firstname.lastname@example.org \ --email@example.com \ --subject='Re: git switch/restore, still experimental?' \ /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
Code repositories for project(s) associated with this inbox: https://80x24.org/mirrors/git.git This is a public inbox, see mirroring instructions for how to clone and mirror all data and code used for this inbox; as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).