{"thread":{"id":"25011","subject":"Should git-citool be in mainporcelain in command-list?","startedAt":"2010-09-06T21:27:13Z","lastAt":"2010-09-06T22:31:20Z","messageCount":6,"participants":["Ævar Arnfjörð Bjarmason","Jonathan Nieder"],"isPatch":false,"patchVersion":null,"patchTotal":null},"messages":[{"id":"150137","messageId":"AANLkTi=Hn_GG1y3gkVxgnsKyVD+VutG5SU5HhmhRfktH@mail.gmail.com","threadId":"25011","inReplyTo":null,"subject":"Should git-citool be in mainporcelain in command-list?","fromName":"Ævar Arnfjörð Bjarmason","fromEmail":"avarab@gmail.com","sentAt":"2010-09-06T21:27:13Z","receivedAt":"2010-09-06T21:27:13Z","isPatch":false,"sender":{"key":"avarab@gmail.com","avatar":"https://avatars.githubusercontent.com/u/45301?v=4"},"body":"Maybe there should be an aliases category:\n\n    $ grep -e git-gui -e citool command-list.txt\n    git-citool                              mainporcelain\n    git-gui                                 mainporcelain\n\nA very minor nit, just something I ran into while gettext-izing and\nwondered \"what's that\".\n\nBut I'm probably the only one that's used command-list.txt for\nanything non-Make related in a while :)\n"},{"id":"150139","messageId":"20100906213937.GF26371@burratino","threadId":"25011","inReplyTo":"AANLkTi=Hn_GG1y3gkVxgnsKyVD+VutG5SU5HhmhRfktH@mail.gmail.com","subject":"Re: Should git-citool be in mainporcelain in command-list?","fromName":"Jonathan Nieder","fromEmail":"jrnieder@gmail.com","sentAt":"2010-09-06T21:39:37Z","receivedAt":"2010-09-06T21:39:37Z","isPatch":false,"sender":{"key":"jrnieder@gmail.com","avatar":"https://avatars.githubusercontent.com/u/281595?v=4"},"body":"Ævar Arnfjörð Bjarmason wrote:\n\n> Maybe there should be an aliases category:\n> \n>     $ grep -e git-gui -e citool command-list.txt\n>     git-citool                              mainporcelain\n>     git-gui                                 mainporcelain\n> \n> A very minor nit, just something I ran into while gettext-izing and\n> wondered \"what's that\".\n> \n> But I'm probably the only one that's used command-list.txt for\n> anything non-Make related in a while :)\n\nIts main purpose is to populate the command list in git.1:\n\n   Main porcelain commands\n[...]\n\tgit-citool(1)\n\t   Graphical alternative to git-commit.\n[...]\n\tgit-gui(1)\n\t   A portable graphical interface to Git.\n\nWhat do you think this should say?  (Honest question --- I\nhaven't thought hard about it.)\n"},{"id":"150141","messageId":"AANLkTimRoAgAtrkpyd08mVG93prQ40B1y=ReLRdNfbWt@mail.gmail.com","threadId":"25011","inReplyTo":"20100906213937.GF26371@burratino","subject":"Re: Should git-citool be in mainporcelain in command-list?","fromName":"Ævar Arnfjörð Bjarmason","fromEmail":"avarab@gmail.com","sentAt":"2010-09-06T22:00:19Z","receivedAt":"2010-09-06T22:00:19Z","isPatch":false,"sender":{"key":"avarab@gmail.com","avatar":"https://avatars.githubusercontent.com/u/45301?v=4"},"body":"On Mon, Sep 6, 2010 at 21:39, Jonathan Nieder <jrnieder@gmail.com> wrote:\n> Ævar Arnfjörð Bjarmason wrote:\n>\n>> Maybe there should be an aliases category:\n>>\n>>     $ grep -e git-gui -e citool command-list.txt\n>>     git-citool                              mainporcelain\n>>     git-gui                                 mainporcelain\n>>\n>> A very minor nit, just something I ran into while gettext-izing and\n>> wondered \"what's that\".\n>>\n>> But I'm probably the only one that's used command-list.txt for\n>> anything non-Make related in a while :)\n>\n> Its main purpose is to populate the command list in git.1:\n>\n>   Main porcelain commands\n> [...]\n>        git-citool(1)\n>           Graphical alternative to git-commit.\n> [...]\n>        git-gui(1)\n>           A portable graphical interface to Git.\n>\n> What do you think this should say?  (Honest question --- I\n> haven't thought hard about it.)\n\nI haven't either, and I don't use git-gui or the git citool alias. I\ndidn't even know about it until yesterday.\n\nThe entries in git(1) don't indicate that citool is a convenience\nalias for git-gui:\n\n       git-gui(1)\n           A portable graphical interface to Git.\n\n       git-citool(1)\n           Graphical alternative to git-commit.\n\nMaybe it shouldn't be listed there at all to avoid confusion, or maybe\nit should be in an aliases category to clearly indicate its function\nas a convenience alias in the manpage.\n"},{"id":"150143","messageId":"20100906220757.GH26371@burratino","threadId":"25011","inReplyTo":"AANLkTimRoAgAtrkpyd08mVG93prQ40B1y=ReLRdNfbWt@mail.gmail.com","subject":"Re: Should git-citool be in mainporcelain in command-list?","fromName":"Jonathan Nieder","fromEmail":"jrnieder@gmail.com","sentAt":"2010-09-06T22:07:57Z","receivedAt":"2010-09-06T22:07:57Z","isPatch":false,"sender":{"key":"jrnieder@gmail.com","avatar":"https://avatars.githubusercontent.com/u/281595?v=4"},"body":"Ævar Arnfjörð Bjarmason wrote:\n\n> The entries in git(1) don't indicate that citool is a convenience\n> alias for git-gui:\n\nThat's because it isn't, no?\n\nSYNOPSIS\n       git citool\n\nDESCRIPTION\n       A Tcl/Tk based graphical interface to review modified\n       files, stage them into the index, enter a commit message\n       and record the new commit onto the current branch. This\n       interface is an alternative to the less interactive git\n       commit program.\n\n       git citool is actually a standard alias for git gui\n       citool. See git-gui(1) for more details.\n"},{"id":"150144","messageId":"AANLkTiknz1vmXj+jOHudyW1QQkZhy+EgMG7_56_50GT6@mail.gmail.com","threadId":"25011","inReplyTo":"20100906220757.GH26371@burratino","subject":"Re: Should git-citool be in mainporcelain in command-list?","fromName":"Ævar Arnfjörð Bjarmason","fromEmail":"avarab@gmail.com","sentAt":"2010-09-06T22:17:05Z","receivedAt":"2010-09-06T22:17:05Z","isPatch":false,"sender":{"key":"avarab@gmail.com","avatar":"https://avatars.githubusercontent.com/u/45301?v=4"},"body":"On Mon, Sep 6, 2010 at 22:07, Jonathan Nieder <jrnieder@gmail.com> wrote:\n> Ævar Arnfjörð Bjarmason wrote:\n>\n>> The entries in git(1) don't indicate that citool is a convenience\n>> alias for git-gui:\n>\n> That's because it isn't, no?\n\nI mean \"convenience\" interchangeably with \"standard\" as this paragraph\nuses it:\n\n>       git citool is actually a standard alias for git gui\n>       citool. See git-gui(1) for more details.\n\nI.e. `git gui citool` and `git citool` launch the same thing, the\nlatter is just a shorter way to do it.\n"},{"id":"150147","messageId":"20100906223120.GI26371@burratino","threadId":"25011","inReplyTo":"AANLkTiknz1vmXj+jOHudyW1QQkZhy+EgMG7_56_50GT6@mail.gmail.com","subject":"Re: Should git-citool be in mainporcelain in command-list?","fromName":"Jonathan Nieder","fromEmail":"jrnieder@gmail.com","sentAt":"2010-09-06T22:31:20Z","receivedAt":"2010-09-06T22:31:20Z","isPatch":false,"sender":{"key":"jrnieder@gmail.com","avatar":"https://avatars.githubusercontent.com/u/281595?v=4"},"body":"Ævar Arnfjörð Bjarmason wrote:\n> On Mon, Sep 6, 2010 at 22:07, Jonathan Nieder <jrnieder@gmail.com> wrote:\n\n>>       git citool is actually a standard alias for git gui\n>>       citool. See git-gui(1) for more details.\n>\n> I.e. `git gui citool` and `git citool` launch the same thing, the\n> latter is just a shorter way to do it.\n\nAll I meant is that it is not an alias for \"git gui\" but for\n\"git gui citool\".  I can imagine a person reading git(1) and\nlearning about the ability to say\n\n\tgit citool\n\nthough I guess by the same token a person might wonder why\nthe list does not include similar\n\n\tgit blametool\n\nand\n\n\tgit browsertool\n\ncommands.  Anyway, I have nothing against a separate \"aliases\" category.\nSorry for the noise.\n"}]}