From mboxrd@z Thu Jan 1 00:00:00 1970 From: Linus Torvalds Subject: Re: [kernel.org users] [RFD] On deprecating "git-foo" for builtins Date: Tue, 26 Aug 2008 12:04:51 -0700 (PDT) Message-ID: References: <7vprnzt7d5.fsf@gitster.siamese.dyndns.org> <1219664940.9583.42.camel@pmac.infradead.org> <7vy72kek6y.fsf@gitster.siamese.dyndns.org> <20080826145719.GB5046@coredump.intra.peff.net> <1219764860.4471.13.camel@gaara.bos.redhat.com> <1219766398.7107.87.camel@pmac.infradead.org> <20080826180926.GA25711@isilmar.linta.de> <20080826185548.GA7559@hera.kernel.org> Mime-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Cc: Dominik Brodowski , =?ISO-8859-15?Q?Kristian_H=F8gsberg?= , Johannes Schindelin , users@kernel.org, Jeff King , Junio C Hamano , David Woodhouse , git@vger.kernel.org To: Al Viro X-From: git-owner@vger.kernel.org Tue Aug 26 21:08:44 2008 Return-path: Envelope-to: gcvg-git-2@gmane.org Received: from vger.kernel.org ([209.132.176.167]) by lo.gmane.org with esmtp (Exim 4.50) id 1KY3t7-000453-S5 for gcvg-git-2@gmane.org; Tue, 26 Aug 2008 21:07:34 +0200 Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1758663AbYHZTF7 (ORCPT ); Tue, 26 Aug 2008 15:05:59 -0400 Received: (majordomo@vger.kernel.org) by vger.kernel.org id S1759348AbYHZTF7 (ORCPT ); Tue, 26 Aug 2008 15:05:59 -0400 Received: from smtp1.linux-foundation.org ([140.211.169.13]:58880 "EHLO smtp1.linux-foundation.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1758445AbYHZTF6 (ORCPT ); Tue, 26 Aug 2008 15:05:58 -0400 Received: from imap1.linux-foundation.org (imap1.linux-foundation.org [140.211.169.55]) by smtp1.linux-foundation.org (8.14.2/8.13.5/Debian-3ubuntu1.1) with ESMTP id m7QJ4qSR001205 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Tue, 26 Aug 2008 12:04:53 -0700 Received: from localhost (localhost [127.0.0.1]) by imap1.linux-foundation.org (8.13.5.20060308/8.13.5/Debian-3ubuntu1.1) with ESMTP id m7QJ4pY2022402; Tue, 26 Aug 2008 12:04:51 -0700 In-Reply-To: <20080826185548.GA7559@hera.kernel.org> User-Agent: Alpine 1.10 (LFD 962 2008-03-14) X-Spam-Status: No, hits=-3.928 required=5 tests=AWL,BAYES_00,OSDL_HEADER_SUBJECT_BRACKETED X-Spam-Checker-Version: SpamAssassin 3.2.4-osdl_revision__1.47__ X-MIMEDefang-Filter: lf$Revision: 1.188 $ X-Scanned-By: MIMEDefang 2.63 on 140.211.169.13 Sender: git-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: git@vger.kernel.org Archived-At: On Tue, 26 Aug 2008, Al Viro wrote: > > Well, to be fair, "man git-add for git add is rather unconventional" is > a valid point... On the other hand: - "man" simply cannot currently handle "man git add", even though there's been some noise to teach it. - you can use "git help add" instead, since git itself does understand this. It will just go "man git-add" for you, so that your fingers don't have to type that dash ;) > FWIW, personally I couldn't care less as long as manpages *are* there and > we do not end up with something like "oh, just use info / html / some other > weird crap; manpages are not suitable(tm), dontcha know" I don't think _that_ is going to happen. You're not the only one who wants man-pages. Linus