From mboxrd@z Thu Jan 1 00:00:00 1970 X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on dcvr.yhbt.net X-Spam-Level: X-Spam-ASN: AS31976 209.132.176.0/21 X-Spam-Status: No, score=-3.5 required=3.0 tests=BAYES_00, HEADER_FROM_DIFFERENT_DOMAINS,MSGID_FROM_MTA_HEADER,RP_MATCHES_RCVD shortcircuit=no autolearn=ham autolearn_force=no version=3.4.0 From: Carl Worth Subject: Re: Cleaning up git user-interface warts Date: Tue, 14 Nov 2006 11:59:46 -0800 Message-ID: <87ejs5u7d9.wl%cworth@cworth.org> References: <87k61yt1x2.wl%cworth@cworth.org> <455A1137.8030301@shadowen.org> <87hcx1u934.wl%cworth@cworth.org> <20061114192914.GD4299@spearce.org> Mime-Version: 1.0 (generated by SEMI 1.14.6 - "Maruoka") Content-Type: multipart/signed; boundary="pgp-sign-Multipart_Tue_Nov_14_11:59:46_2006-1"; micalg=pgp-sha1; protocol="application/pgp-signature" Content-Transfer-Encoding: 7bit NNTP-Posting-Date: Tue, 14 Nov 2006 20:00:38 +0000 (UTC) Cc: Andy Whitcroft , Junio C Hamano , git@vger.kernel.org Return-path: Envelope-to: gcvg-git@gmane.org In-Reply-To: <20061114192914.GD4299@spearce.org> User-Agent: Wanderlust/2.14.0 (Africa) Emacs/21.4 Mule/5.0 (SAKAKI) Precedence: bulk X-Mailing-List: git@vger.kernel.org Archived-At: Received: from vger.kernel.org ([209.132.176.167]) by ciao.gmane.org with esmtp (Exim 4.43) id 1Gk4SD-0000ky-NZ for gcvg-git@gmane.org; Tue, 14 Nov 2006 21:00:23 +0100 Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1755467AbWKNUAJ (ORCPT ); Tue, 14 Nov 2006 15:00:09 -0500 Received: (majordomo@vger.kernel.org) by vger.kernel.org id S1755468AbWKNUAI (ORCPT ); Tue, 14 Nov 2006 15:00:08 -0500 Received: from theworths.org ([217.160.253.102]:6885 "EHLO theworths.org") by vger.kernel.org with ESMTP id S1755467AbWKNUAF (ORCPT ); Tue, 14 Nov 2006 15:00:05 -0500 Received: (qmail 31996 invoked from network); 14 Nov 2006 15:00:03 -0500 Received: from localhost (HELO raht.cworth.org) (127.0.0.1) by localhost with SMTP; 14 Nov 2006 15:00:03 -0500 To: Shawn Pearce Sender: git-owner@vger.kernel.org --pgp-sign-Multipart_Tue_Nov_14_11:59:46_2006-1 Content-Type: text/plain; charset=US-ASCII On Tue, 14 Nov 2006 14:29:14 -0500, Shawn Pearce wrote: > Uh, see contrib/completion/git-completion.bash. Oops. I had seen this and thought I had installed it properly a while ago, (copied it to /etc/bash_completion.d/git), but I hadn't realized it wasn't active in the shell I used to test while composing that email. > "git " completes commands. It offers too many completions > for your taste it sounds like, as it also offers plumbing... but > that's fixable. :-) Yes, I think we'd all be better off if we could designate some subset of the current git commands as not being intended for users to type on the command line and pulled them out of the completion scripts. It is tough though. Looking through what's available in the short list from "git --help" I notice that update-index isn't there, and that's currently still required, (as we've been discussing here). But even things as "core plumbing" as git rev-list I find extremely useful on the command like with simple pipelines. On the other hand, there are definitely some commands I've never typed, and are not intended to be typed by the user. Here are a few I see as fairly obvious just from skimming the list: merge-* http-* ssh-* upload-* mktag mktree check-ref-format ... There are a bunch of others as well. Maybe it would be easier to start with the list in git --help and see what should be added to that. The documentation for some of the above commands have phrases such as "Invoked by " and "usually not invoked by the end user" which does make the distinction quite clear. So it would be nice if git could keep these away from the user more. -Carl --pgp-sign-Multipart_Tue_Nov_14_11:59:46_2006-1 Content-Type: application/pgp-signature Content-Transfer-Encoding: 7bit -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.5 (GNU/Linux) iD8DBQBFWiAy6JDdNq8qSWgRAjbPAKCHGQCVh9f1C/0Tv1psKmt1kJWBCgCfXFO9 cFxdrWkjSaPraUReDlzpPxc= =4gtB -----END PGP SIGNATURE-----