From mboxrd@z Thu Jan 1 00:00:00 1970 From: Petr Baudis Subject: Re: [FAQ?] Rationale for git's way to manage the index Date: Wed, 9 May 2007 19:26:22 +0200 Message-ID: <20070509172622.GA4489@pasky.or.cz> References: <46a038f90705072016x17bd60c3ic779459438ffc19@mail.gmail.com> <20070509134151.GT4489@pasky.or.cz> <56b7f5510705090933t261e414es9e3cc63b28b60546@mail.gmail.com> <20070509171845.GC23778@fieldses.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Cc: Dana How , Linus Torvalds , Martin Langhoff , git@vger.kernel.org, Junio C Hamano To: "J. Bruce Fields" X-From: git-owner@vger.kernel.org Wed May 09 19:26:32 2007 Return-path: Envelope-to: gcvg-git@gmane.org Received: from vger.kernel.org ([209.132.176.167]) by lo.gmane.org with esmtp (Exim 4.50) id 1Hlpvs-00080C-4h for gcvg-git@gmane.org; Wed, 09 May 2007 19:26:32 +0200 Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1756734AbXEIR0Z (ORCPT ); Wed, 9 May 2007 13:26:25 -0400 Received: (majordomo@vger.kernel.org) by vger.kernel.org id S1756652AbXEIR0Z (ORCPT ); Wed, 9 May 2007 13:26:25 -0400 Received: from w241.dkm.cz ([62.24.88.241]:51579 "EHLO machine.or.cz" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1755930AbXEIR0Y (ORCPT ); Wed, 9 May 2007 13:26:24 -0400 Received: (qmail 8381 invoked by uid 2001); 9 May 2007 19:26:22 +0200 Content-Disposition: inline In-Reply-To: <20070509171845.GC23778@fieldses.org> X-message-flag: Outlook : A program to spread viri, but it can do mail too. User-Agent: Mutt/1.5.13 (2006-08-11) Sender: git-owner@vger.kernel.org Precedence: bulk X-Mailing-List: git@vger.kernel.org Archived-At: On Wed, May 09, 2007 at 07:18:45PM CEST, J. Bruce Fields wrote: > On Wed, May 09, 2007 at 09:33:40AM -0700, Dana How wrote: > > Geez, this is similar [in nature, not scale] to what I've been doing. > > After reading about people "right-clicking on hunks in git-gui", > > I was convinced I needed to force myself to do more manipulations > > inside git itself. Hmm... > > > > Maybe, in addition to [or in] the User Manual, git should have some > > workflow examples, which have been cribbed from various emails > > on this list? > > That's something several people have asked for, and I think it's a great > idea--I just haven't personally had much time to get to it. But I'd > happily take even very rough patches and help get them into shape. > > The way I'd thought of doing it was having an "examples" section at the > end of each chapter, with subsections for each individual example; see > the one at the end of the "exploring git history" chapter: > > http://www.kernel.org/pub/software/scm/git/docs/user-manual.html#history-examples > > They shouldn't use the material introduced in the associated chapter, > but it's also OK to introduce new commands (with references to the man > pages) when their use in the example is pretty self-explanatory. (In > fact, this is a great way to introduce more commands and options--git > has so many that it would be tedious to try to be comprehensive, but > they'd fit well in examples.) > > The patch-editing stuff discussed above might fit best at the end of > "rewriting history and maintaining patch series". There is some workflow-related discussion accumulated over years in Documentation/howto/, some of them also already suffering quite of a bitrot. :-( -- Petr "Pasky" Baudis Stuff: http://pasky.or.cz/ Ever try. Ever fail. No matter. // Try again. Fail again. Fail better. -- Samuel Beckett