From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <dkg@fifthhorseman.net>
Received: from localhost (localhost [127.0.0.1])
 by arlo.cworth.org (Postfix) with ESMTP id 1A8FA6DE0B3E
 for <notmuch@notmuchmail.org>; Thu, 19 Oct 2017 22:30:06 -0700 (PDT)
X-Virus-Scanned: Debian amavisd-new at cworth.org
X-Spam-Flag: NO
X-Spam-Score: -0.023
X-Spam-Level: 
X-Spam-Status: No, score=-0.023 tagged_above=-999 required=5
 tests=[AWL=-0.023] autolearn=disabled
Received: from arlo.cworth.org ([127.0.0.1])
 by localhost (arlo.cworth.org [127.0.0.1]) (amavisd-new, port 10024)
 with ESMTP id SHBL5boU0Nfv for <notmuch@notmuchmail.org>;
 Thu, 19 Oct 2017 22:30:04 -0700 (PDT)
Received: from che.mayfirst.org (che.mayfirst.org [162.247.75.118])
 by arlo.cworth.org (Postfix) with ESMTP id 37F3C6DE0A89
 for <notmuch@notmuchmail.org>; Thu, 19 Oct 2017 22:30:04 -0700 (PDT)
Received: from fifthhorseman.net (ool-6c3a0662.static.optonline.net
 [108.58.6.98])
 by che.mayfirst.org (Postfix) with ESMTPSA id 8CE87F99B;
 Fri, 20 Oct 2017 01:30:02 -0400 (EDT)
Received: by fifthhorseman.net (Postfix, from userid 1000)
 id E740920748; Fri, 20 Oct 2017 01:17:23 -0400 (EDT)
From: Daniel Kahn Gillmor <dkg@fifthhorseman.net>
To: David Bremner <david@tethera.net>, Notmuch Mail <notmuch@notmuchmail.org>
Subject: Re: [PATCH v6 06/14] reindex: drop all properties named with prefix
 "index."
In-Reply-To: <878tg7ic9a.fsf@tethera.net>
References: <20171017191008.8742-1-dkg@fifthhorseman.net>
 <20171017191008.8742-7-dkg@fifthhorseman.net> <878tg7ic9a.fsf@tethera.net>
Date: Fri, 20 Oct 2017 01:17:23 -0400
Message-ID: <87r2tyxusc.fsf@fifthhorseman.net>
MIME-Version: 1.0
Content-Type: text/plain
X-BeenThere: notmuch@notmuchmail.org
X-Mailman-Version: 2.1.23
Precedence: list
List-Id: "Use and development of the notmuch mail system."
 <notmuch.notmuchmail.org>
List-Unsubscribe: <https://notmuchmail.org/mailman/options/notmuch>,
 <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>
List-Archive: <http://notmuchmail.org/pipermail/notmuch/>
List-Post: <mailto:notmuch@notmuchmail.org>
List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>
List-Subscribe: <https://notmuchmail.org/mailman/listinfo/notmuch>,
 <mailto:notmuch-request@notmuchmail.org?subject=subscribe>
X-List-Received-Date: Fri, 20 Oct 2017 05:30:06 -0000

On Thu 2017-10-19 08:54:25 -0300, David Bremner wrote:
> Daniel Kahn Gillmor <dkg@fifthhorseman.net> writes:
>
>>   *
>> + * Notmuch has some conventions about how certain properties are
>> + * treated.  Those conventions include:
>> + *
>> + * - properties whose name begins with "index." are cleared (and
>> + *   possibly re-set) upon reindexing.
>> + *
>>   */
>
> I wonder if this duplication of documentation is a good idea. I agree
> it's conceptually part of the API, but I worry that the two copies will
> drift apart. One option would be to have notmuch.h comment point to the
> man page.

Good catch.  I've updated this in my series on gitlab.

     --dkg