From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp2 ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms11 with LMTPS id 4JhHDcekL180WAAA0tVLHw (envelope-from ) for ; Sun, 09 Aug 2020 07:24:55 +0000 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp2 with LMTPS id RHMKCcekL1/JEQAAB5/wlQ (envelope-from ) for ; Sun, 09 Aug 2020 07:24:55 +0000 Received: from mail.notmuchmail.org (nmbug.tethera.net [IPv6:2607:5300:201:3100::1657]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) server-signature RSA-PSS (2048 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id 5C7229403C9 for ; Sun, 9 Aug 2020 07:24:54 +0000 (UTC) Received: from [144.217.243.247] (localhost [127.0.0.1]) by mail.notmuchmail.org (Postfix) with ESMTP id 2BEAE29AC1; Sun, 9 Aug 2020 03:24:49 -0400 (EDT) X-Greylist: delayed 302 seconds by postgrey-1.36 at nmbug; Sun, 09 Aug 2020 03:24:46 EDT Received: from mariecurie.labrat.space (mariecurie.labrat.space [116.203.185.229]) by mail.notmuchmail.org (Postfix) with ESMTPS id 7328C2711E for ; Sun, 9 Aug 2020 03:24:46 -0400 (EDT) Received: from labrat.space (adsl-178-38-29-145.adslplus.ch [178.38.29.145]) by mariecurie.labrat.space (Postfix) with ESMTPSA id 6BD60102068B; Sun, 9 Aug 2020 09:19:02 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=labrat.space; s=201904; t=1596957542; bh=UWCSUWYzpUoWpbIrMO88jTItw5ohcXdMlD45NnOq/ps=; h=Date:From:To:Cc:Subject:Message-ID:References:MIME-Version: Content-Type:Content-Disposition:In-Reply-To:From:To:CC:Date: Subject:Content-Type:Content-Disposition:Reply-To:In-Reply-To: MIME-Version:Message-ID:References; b=ASRD2aVwMk80jMcsCjQGZ+YsjBP7unXt3bYyk3N2kabmXww/DW4gZ2KGQMIpA4dcg GKw+6/JjpntzywciA+IbJOn3lz3cdwHgTact4PzNbvboNuzyIOB3tAEseUbs9OL9h1 eM/P3NiHFVCnRxsHmWMNA4J6UCNiXhRDmO8gnRGNdltIp8ro/DLwr+KEqdM2CBI2Sn Azmpitzpm2KFXYY+Nidk78rXLNHjlWiOTm+B8dZGVC9yP7oLXfpXYGy8EJuvg6kSs4 j542zWD2hA8XKiTLjNPlBW915necrW1NbV7G9/VPurUMZVPdQjMTRdb5KcKKnIbOHG b/DBAzQsLFBdg== Date: Sun, 9 Aug 2020 09:19:39 +0200 From: Reto To: David Bremner Subject: Re: [PATCH 02/19] lib: add stub for notmuch_database_open_with_config Message-ID: <20200809071939.gtzqk5hgujzvf7pz@feather.localdomain> Mail-Followup-To: David Bremner , notmuch@notmuchmail.org References: <20200808141653.1124111-1-david@tethera.net> <20200808141653.1124111-3-david@tethera.net> MIME-Version: 1.0 Content-Disposition: inline In-Reply-To: <20200808141653.1124111-3-david@tethera.net> Message-ID-Hash: DXJSMA4JV7DLGGTPZG4DNDNSH4UXHTBE X-Message-ID-Hash: DXJSMA4JV7DLGGTPZG4DNDNSH4UXHTBE X-MailFrom: reto@labrat.space X-Mailman-Rule-Misses: dmarc-mitigation; no-senders; approved; emergency; loop; banned-address; member-moderation; header-match-notmuch.notmuchmail.org-0; nonmember-moderation; administrivia; implicit-dest; max-recipients; max-size; news-moderation; no-subject; suspicious-header CC: notmuch@notmuchmail.org X-Mailman-Version: 3.2.1 Precedence: list List-Id: "Use and development of the notmuch mail system." List-Help: List-Post: List-Subscribe: List-Unsubscribe: Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Scanner: scn0 Authentication-Results: aspmx1.migadu.com; dkim=fail (body hash did not verify) header.d=labrat.space header.s=201904 header.b=ASRD2aVw; dmarc=fail reason="SPF not aligned (strict)" header.from=labrat.space (policy=none); spf=pass (aspmx1.migadu.com: domain of notmuch-bounces@notmuchmail.org designates 2607:5300:201:3100::1657 as permitted sender) smtp.mailfrom=notmuch-bounces@notmuchmail.org X-Spam-Score: 0.13 X-TUID: wKGrMKjCArj3 On Sat, Aug 08, 2020 at 11:16:36AM -0300, David Bremner wrote: > +/* NOTMUCH_DEPRECATED(5, 4) */ > +notmuch_status_t > +notmuch_database_open_verbose (const char *path, > + notmuch_database_mode_t mode, > + notmuch_database_t **database, > + char **error_message); > + > +/** > + * Open an existing notmuch database located at 'database_path', using > + * configuration in 'config_path'. > + * > + * @param[in] database_path > + * @parblock > + * Path to existing database. > + * > + * A notmuch database is a Xapian database containing appropriate > + * metadata. > * > * The database should have been created at some time in the past, > * (not necessarily by this process), by calling > - * notmuch_database_create with 'path'. By default the database should be > - * opened for reading only. In order to write to the database you need to > - * pass the NOTMUCH_DATABASE_MODE_READ_WRITE mode. > + * notmuch_database_create. > + * > + * If 'database_path' is NULL, use the location specified > + * > + * - in the environment variable NOTMUCH_DATABASE, if non-empty > + * > + * - by $XDG_DATA_HOME/notmuch/$PROFILE where XDG_DATA_HOME defaults > + * to "$HOME/.local/share" and PROFILE as as discussed in > + * 'profile' > + * > + * If 'database_path' is non-NULL, but does not appear to be a Xapian > + * database, check for a directory '.notmuch/xapian' below > + * 'database_path' (this is the behavior of > + * notmuch_database_open_verbose pre-0.32). > + * > + * @endparblock > + * @param[in] mode > + * @parblock > + * Mode to open database. Use one of #NOTMUCH_DATABASE_MODE_READ_WRITE > + * or #NOTMUCH_DATABASE_MODE_READ_WRITE I think you want to have NOTMUCH_DATABASE_MODE_READ_ONLY here? Greetings, Reto