# Should git-citool be in mainporcelain in command-list? 6 messages from 2010-09-06 to 2010-09-06. Participants: Ævar Arnfjörð Bjarmason, Jonathan Nieder. Thread: https://gitlist.dev/t/25011 ## Ævar Arnfjörð Bjarmason, 2010-09-06 21:27 Subject: Should git-citool be in mainporcelain in command-list? Message-ID: URL: https://gitlist.dev/e/AANLkTi%3DHn_GG1y3gkVxgnsKyVD%2BVutG5SU5HhmhRfktH%40mail.gmail.com ``` Maybe there should be an aliases category: $ grep -e git-gui -e citool command-list.txt git-citool mainporcelain git-gui mainporcelain A very minor nit, just something I ran into while gettext-izing and wondered "what's that". But I'm probably the only one that's used command-list.txt for anything non-Make related in a while :) ``` ## Jonathan Nieder, 2010-09-06 21:39 Subject: Re: Should git-citool be in mainporcelain in command-list? Message-ID: <20100906213937.GF26371@burratino> URL: https://gitlist.dev/e/20100906213937.GF26371%40burratino In-Reply-To: ``` Ævar Arnfjörð Bjarmason wrote: > Maybe there should be an aliases category: > > $ grep -e git-gui -e citool command-list.txt > git-citool mainporcelain > git-gui mainporcelain > > A very minor nit, just something I ran into while gettext-izing and > wondered "what's that". > > But I'm probably the only one that's used command-list.txt for > anything non-Make related in a while :) Its main purpose is to populate the command list in git.1: Main porcelain commands [...] git-citool(1) Graphical alternative to git-commit. [...] git-gui(1) A portable graphical interface to Git. What do you think this should say? (Honest question --- I haven't thought hard about it.) ``` ## Ævar Arnfjörð Bjarmason, 2010-09-06 22:00 Subject: Re: Should git-citool be in mainporcelain in command-list? Message-ID: URL: https://gitlist.dev/e/AANLkTimRoAgAtrkpyd08mVG93prQ40B1y%3DReLRdNfbWt%40mail.gmail.com In-Reply-To: <20100906213937.GF26371@burratino> ``` On Mon, Sep 6, 2010 at 21:39, Jonathan Nieder wrote: > Ævar Arnfjörð Bjarmason wrote: > >> Maybe there should be an aliases category: >> >>     $ grep -e git-gui -e citool command-list.txt >>     git-citool                              mainporcelain >>     git-gui                                 mainporcelain >> >> A very minor nit, just something I ran into while gettext-izing and >> wondered "what's that". >> >> But I'm probably the only one that's used command-list.txt for >> anything non-Make related in a while :) > > Its main purpose is to populate the command list in git.1: > >   Main porcelain commands > [...] >        git-citool(1) >           Graphical alternative to git-commit. > [...] >        git-gui(1) >           A portable graphical interface to Git. > > What do you think this should say?  (Honest question --- I > haven't thought hard about it.) I haven't either, and I don't use git-gui or the git citool alias. I didn't even know about it until yesterday. The entries in git(1) don't indicate that citool is a convenience alias for git-gui: git-gui(1) A portable graphical interface to Git. git-citool(1) Graphical alternative to git-commit. Maybe it shouldn't be listed there at all to avoid confusion, or maybe it should be in an aliases category to clearly indicate its function as a convenience alias in the manpage. ``` ## Jonathan Nieder, 2010-09-06 22:07 Subject: Re: Should git-citool be in mainporcelain in command-list? Message-ID: <20100906220757.GH26371@burratino> URL: https://gitlist.dev/e/20100906220757.GH26371%40burratino In-Reply-To: ``` Ævar Arnfjörð Bjarmason wrote: > The entries in git(1) don't indicate that citool is a convenience > alias for git-gui: That's because it isn't, no? SYNOPSIS git citool DESCRIPTION A Tcl/Tk based graphical interface to review modified files, stage them into the index, enter a commit message and record the new commit onto the current branch. This interface is an alternative to the less interactive git commit program. git citool is actually a standard alias for git gui citool. See git-gui(1) for more details. ``` ## Ævar Arnfjörð Bjarmason, 2010-09-06 22:17 Subject: Re: Should git-citool be in mainporcelain in command-list? Message-ID: URL: https://gitlist.dev/e/AANLkTiknz1vmXj%2BjOHudyW1QQkZhy%2BEgMG7_56_50GT6%40mail.gmail.com In-Reply-To: <20100906220757.GH26371@burratino> ``` On Mon, Sep 6, 2010 at 22:07, Jonathan Nieder wrote: > Ævar Arnfjörð Bjarmason wrote: > >> The entries in git(1) don't indicate that citool is a convenience >> alias for git-gui: > > That's because it isn't, no? I mean "convenience" interchangeably with "standard" as this paragraph uses it: >       git citool is actually a standard alias for git gui >       citool. See git-gui(1) for more details. I.e. `git gui citool` and `git citool` launch the same thing, the latter is just a shorter way to do it. ``` ## Jonathan Nieder, 2010-09-06 22:31 Subject: Re: Should git-citool be in mainporcelain in command-list? Message-ID: <20100906223120.GI26371@burratino> URL: https://gitlist.dev/e/20100906223120.GI26371%40burratino In-Reply-To: ``` Ævar Arnfjörð Bjarmason wrote: > On Mon, Sep 6, 2010 at 22:07, Jonathan Nieder wrote: >>       git citool is actually a standard alias for git gui >>       citool. See git-gui(1) for more details. > > I.e. `git gui citool` and `git citool` launch the same thing, the > latter is just a shorter way to do it. All I meant is that it is not an alias for "git gui" but for "git gui citool". I can imagine a person reading git(1) and learning about the ability to say git citool though I guess by the same token a person might wonder why the list does not include similar git blametool and git browsertool commands. Anyway, I have nothing against a separate "aliases" category. Sorry for the noise. ```