Re: docs and completion and dashless commands

From: Junio C Hamano <gitster@pobox.com>
Date: Aug 22, 2008, 21:34 UTC
Message-ID: <7vr68g7n02.fsf@gitster.siamese.dyndns.org>
In-Reply-To: <alpine.LNX.0.999999.0808221550100.11892@mojave>

dherring@ll.mit.edu writes:

Show 5 quoted lines

> First off, I'm not too keen on these dashless commands.
> - We now have `man git-X` but can't run `git-X`
> - A separate completion script must be installed for bash
> - Lose completion for all other shells
> - History expansion is complicated (e.g. `!git-push` vs `!git push`)

Please stop and leave the dead horse lie in piece. You are more than a year too late.

> Anyway, could someone modify INSTALL to mention
> contrib/completion/git-completion.bash and putting `git --exec-path`
> in PATH for other shells?

And please nobody waste time on the latter. "git-foo" form for builtins will be removed from the filesystem eventually and at that point:

	#!/bin/sh

	PATH=$(git --exec-path):$PATH
        .. do its thing ..
        git-commit -a -m 'funny wrapper created commit'

will _stop_ working. If somebody is starting a new script there is no point using the form only to later update to the dashless form.

> These docs might also instruct users to call
> git-config and set their global username and email.

Please read the first few paragraphs of gittutorial(7).