Re: Should git-citool be in mainporcelain in command-list?

On Mon, Sep 6, 2010 at 21:39, Jonathan Nieder [off-list ref] wrote:

Ævar Arnfjörð Bjarmason wrote:

quoted

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.