From: Jonathan Nieder <jrnieder@gmail.com>
Date: Mon, 22 Sep 2014 22:34:49 GMT
Subject: Re: [PATCH v5 09/35] lockfile.c: document the various states of lock_file objects
Message-ID: <20140922223449.GH1175@google.com>
In-Reply-To: <54203E4D.7030800@alum.mit.edu>

Michael Haggerty wrote:

> I agree with your point about overlap. I will split the documentation
> into two parts with less redundancy:
>
> * Documentation/technical/api-lockfile.txt: How to use the API.
>
> * lockfile.{c,h}: Internal implementation details.
>
> I think the implementation details would get lost among the thousand
> things in cache.h. So instead, I will add a commit on top of the patch
> series that splits out a lockfile.h header file (which I think is a good
> idea anyway), and moves the internal documentation there. Sound good?

Yep, a separate lockfile.h header file sounds sensible to me.

Thanks,
Jonathan