From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from localhost (localhost [127.0.0.1]) by olra.theworths.org (Postfix) with ESMTP id D6F89431FB6 for ; Wed, 22 Feb 2012 12:07:09 -0800 (PST) X-Virus-Scanned: Debian amavisd-new at olra.theworths.org X-Spam-Flag: NO X-Spam-Score: -0.7 X-Spam-Level: X-Spam-Status: No, score=-0.7 tagged_above=-999 required=5 tests=[RCVD_IN_DNSWL_LOW=-0.7] autolearn=disabled Received: from olra.theworths.org ([127.0.0.1]) by localhost (olra.theworths.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id s3JGH7IVU1+S for ; Wed, 22 Feb 2012 12:07:09 -0800 (PST) Received: from mail-wi0-f181.google.com (mail-wi0-f181.google.com [209.85.212.181]) (using TLSv1 with cipher RC4-SHA (128/128 bits)) (No client certificate requested) by olra.theworths.org (Postfix) with ESMTPS id 0C1E4431FAE for ; Wed, 22 Feb 2012 12:07:08 -0800 (PST) Received: by wibhi8 with SMTP id hi8so326552wib.26 for ; Wed, 22 Feb 2012 12:07:07 -0800 (PST) Received-SPF: pass (google.com: domain of pieter@praet.org designates 10.216.139.165 as permitted sender) client-ip=10.216.139.165; Authentication-Results: mr.google.com; spf=pass (google.com: domain of pieter@praet.org designates 10.216.139.165 as permitted sender) smtp.mail=pieter@praet.org Received: from mr.google.com ([10.216.139.165]) by 10.216.139.165 with SMTP id c37mr9806786wej.53.1329941227883 (num_hops = 1); Wed, 22 Feb 2012 12:07:07 -0800 (PST) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=gamma; h=from:to:cc:subject:in-reply-to:references:user-agent:date :message-id:mime-version:content-type:x-gm-message-state; bh=J5ZZeFJ4B+N099wFVS/7oPmt4svyJOR/5vpsRXWWnik=; b=tAzE0U10tCULcTNZoutSHuTZbVm7sYV3dLdmb3BU2FvkV1+31gYlYztb3A0afDDUDU Q5+Jm38z6NjAs/VaFaPsfuJbyrwYu1HMjwmmFA87gtkweNw83LkisviwxIIgrhZO5fsg hJIWBB/5o6ht2M4D5b5LabzSi0dInu438mmLY= Received: by 10.216.139.165 with SMTP id c37mr8115486wej.53.1329941227736; Wed, 22 Feb 2012 12:07:07 -0800 (PST) Received: from localhost ([109.131.181.26]) by mx.google.com with ESMTPS id bg3sm4057599wib.10.2012.02.22.12.07.06 (version=TLSv1/SSLv3 cipher=OTHER); Wed, 22 Feb 2012 12:07:07 -0800 (PST) From: Pieter Praet To: Michal Sojka , Mark Walters , Jani Nikula Subject: Re: [PATCH] emacs: Mention race condition safety in user visible documentation In-Reply-To: <87linwsg2r.fsf@steelpick.2x.cz> References: <1329605059-15358-1-git-send-email-sojkam1@fel.cvut.cz> <87y5rzmg5v.fsf@steelpick.2x.cz> <87vcn0tw1f.fsf@qmul.ac.uk> <87linwsg2r.fsf@steelpick.2x.cz> User-Agent: Notmuch/0.11.1+210~g6afc43e (http://notmuchmail.org) Emacs/23.3.1 (x86_64-unknown-linux-gnu) Date: Wed, 22 Feb 2012 21:04:50 +0100 Message-ID: <8762ey8wil.fsf@praet.org> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Gm-Message-State: ALoCoQl+4cCjDowH803R8gDRUM0/F2ZuN9nZ+bszPcg9ctBFkzWfdY+Lmpak89D9J8ktZi5FRA5t Cc: notmuch@notmuchmail.org X-BeenThere: notmuch@notmuchmail.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: "Use and development of the notmuch mail system." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 22 Feb 2012 20:07:10 -0000 On Tue, 21 Feb 2012 10:15:08 +0100, Michal Sojka wrote: > [...] > OK, at least one supporter here :) The updated patch follows: > > -- >8 -- > Subject: [PATCH] emacs: Clarify description of thread manipulating functions > > It is not clear whether the term "thread" refers to the thread in the > database or to the thread currently shown in a buffer. Those two > meanings may refer to different sets of messages, e.g. when a new email > is added to the database while the buffer shows the state before the new > email arrived. > > This patch replaces the term thread with the term current buffer, which > is hopefully less ambiguous. > --- +1 Also, the inverse is true for the comment about `notmuch-search-tag-all' in `notmuch-search-mode's docstring. Patch follows. Peace -- Pieter