From mboxrd@z Thu Jan 1 00:00:00 1970 From: Jeff King Subject: Re: [PATCH 1/8] Documentation/notes: document format of notes trees Date: Sun, 9 May 2010 02:52:20 -0400 Message-ID: <20100509065220.GA23717@sigill.intra.peff.net> References: <20100509031357.GA7926@progeny.tock> <20100509031935.GA7958@progeny.tock> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: QUOTED-PRINTABLE Cc: git@vger.kernel.org, Johan Herland , Thomas Rast To: Jonathan Nieder X-From: git-owner@vger.kernel.org Sun May 09 08:52:32 2010 connect(): No such file or directory Return-path: Envelope-to: gcvg-git-2@lo.gmane.org Received: from vger.kernel.org ([209.132.180.67]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1OB0NJ-000083-A2 for gcvg-git-2@lo.gmane.org; Sun, 09 May 2010 08:52:29 +0200 Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751255Ab0EIGwX convert rfc822-to-quoted-printable (ORCPT ); Sun, 9 May 2010 02:52:23 -0400 Received: from peff.net ([208.65.91.99]:60669 "EHLO peff.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1750971Ab0EIGwX (ORCPT ); Sun, 9 May 2010 02:52:23 -0400 Received: (qmail 17208 invoked by uid 107); 9 May 2010 06:52:37 -0000 Received: from sigill.intra.peff.net (HELO sigill.intra.peff.net) (10.0.0.7) (smtp-auth username relayok, mechanism cram-md5) by peff.net (qpsmtpd/0.40) with ESMTPA; Sun, 09 May 2010 02:52:37 -0400 Received: by sigill.intra.peff.net (sSMTP sendmail emulation); Sun, 09 May 2010 02:52:20 -0400 Content-Disposition: inline In-Reply-To: <20100509031935.GA7958@progeny.tock> Sender: git-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: git@vger.kernel.org Archived-At: On Sat, May 08, 2010 at 10:19:35PM -0500, Jonathan Nieder wrote: > How well does =E2=80=98git notes=E2=80=99 handle notes trees without = a commit > currently? I remembered some rumor about a commitless mode in which > the only history is the reflog, but I am not sure how much of that is > implemented yet and I did not check. >=20 > If it was only groundless rumor (read: I made it up), then the last > paragraph of the discussion should be removed. My original textconv caching implementation used commitless notes. The new version uses commits, but keeps the history truncated. As far as I know, you can manipulate the latter with git-notes, but I haven't tried much (adding a new note should make a history graph with length 2, whic= h will then get re-truncated the next time we add something to the cache automatically). But certainly "list", "show", and "prune" should work, which are the ones I would expect to be useful for such a cache. > +It is also permitted for a notes ref to point directly to a tree > +object, in which case the history of the notes can be read with > +`git log -p -g `. You would also use this to see the history of cache notes. They have commits, but the only ancestry is in the reflog. So perhaps: Some notes refs may be "history-less", either because they point directly to a tree instead of a commit, or because their commits are truncated (the notes generated by textconv caching are an example of the latter). To see the local history of these refs, view the reflog with `git log -g `. -Peff