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: git blame [was: git and bzr] Date: Thu, 30 Nov 2006 11:55:34 -0800 Message-ID: <87d574u2tl.wl%cworth@cworth.org> References: <45357CC3.4040507@utoronto.ca> <20061021130111.GL75501@over-yonder.net> <453F2FF8.2080903@op5.se> <200610251146.06116.jnareb@gmail.com> <87slhcz8zh.wl%cworth@cworth.org> <7vu01ro20b.fsf@assigned-by-dhcp.cox.net> <20061026101038.GA13310@coredump.intra.peff.net> <877iyne4dm.fsf@alplog.fr> <456B7C6A.80104@webdrake.net> <456CEF31.8080600@webdrake.net> <456D7A76.3080605@webdrake.net> <456F21D6.1060200@webdrake.net> Mime-Version: 1.0 (generated by SEMI 1.14.6 - "Maruoka") Content-Type: multipart/signed; boundary="pgp-sign-Multipart_Thu_Nov_30_11:55:29_2006-1"; micalg=pgp-sha1; protocol="application/pgp-signature" Content-Transfer-Encoding: 7bit NNTP-Posting-Date: Thu, 30 Nov 2006 19:56:59 +0000 (UTC) Cc: Joseph Wakeling , git@vger.kernel.org Return-path: Envelope-to: gcvg-git@gmane.org In-Reply-To: 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 1Gps1M-0003Gk-N5 for gcvg-git@gmane.org; Thu, 30 Nov 2006 20:56:37 +0100 Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1031257AbWK3T43 (ORCPT ); Thu, 30 Nov 2006 14:56:29 -0500 Received: (majordomo@vger.kernel.org) by vger.kernel.org id S1031269AbWK3T43 (ORCPT ); Thu, 30 Nov 2006 14:56:29 -0500 Received: from mx1.redhat.com ([66.187.233.31]:34489 "EHLO mx1.redhat.com") by vger.kernel.org with ESMTP id S1031257AbWK3T41 (ORCPT ); Thu, 30 Nov 2006 14:56:27 -0500 Received: from int-mx1.corp.redhat.com (int-mx1.corp.redhat.com [172.16.52.254]) by mx1.redhat.com (8.12.11.20060308/8.12.11) with ESMTP id kAUJuElp010874; Thu, 30 Nov 2006 14:56:14 -0500 Received: from mail.boston.redhat.com (mail.boston.redhat.com [172.16.76.12]) by int-mx1.corp.redhat.com (8.13.1/8.13.1) with ESMTP id kAUJuEZl005715; Thu, 30 Nov 2006 14:56:14 -0500 Received: from raht.cworth.org (sebastian-int.corp.redhat.com [172.16.52.221]) by mail.boston.redhat.com (8.12.11.20060308/8.12.11) with ESMTP id kAUJuCfi024985; Thu, 30 Nov 2006 14:56:13 -0500 To: Linus Torvalds Sender: git-owner@vger.kernel.org --pgp-sign-Multipart_Thu_Nov_30_11:55:29_2006-1 Content-Type: text/plain; charset=US-ASCII On Thu, 30 Nov 2006 10:44:48 -0800 (PST), Linus Torvalds wrote: > > But that only exists for a couple of man-pages, and mostly for the simple > ones at that. And a lot of the real examples would need "real data" to > work on, so it can't easily be done as a trivial example in a man-page, it > really needs a tutorial to "build up" to the situation where you can then > explain with an example what to do. Here's a crazy idea. How about a "git tutorial" builtin or "git example" or something that would create a repository into some useful state for demonstrating something. I know that I'm regularly putting stuff into emails like: mkdir gittest cd gittest git init-db echo hello > hello git add hello git commit -m "add hello" git checkout -b other echo other > other git add other git commit -m "add other" git checkout master # OK, that was just setup, here's what I want to demonstrate git pull . other ... So maybe if there was a command to setup a standard example repository, ("git boilerplate", "git sandbox", "git playground" ?), then the documentation could use that to have full-fledged examples without having to duplicate similar setup each time. And then there could be a way for this command to also spit out the commands it is using to reach some state so it could even serve as a sort of self-documenting tutorial of some sort. Anyone interested in exploring something like that? -Carl --pgp-sign-Multipart_Thu_Nov_30_11:55:29_2006-1 Content-Type: application/pgp-signature Content-Transfer-Encoding: 7bit -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.5 (GNU/Linux) iD8DBQBFbzc26JDdNq8qSWgRAloeAKCA3l/zIBA522p83Q7bN+eujYDNeACgk5ye TEdvCb4Ijql8E9MpyHTB8XI= =78Ke -----END PGP SIGNATURE-----