From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on dcvr.yhbt.net X-Spam-Level: X-Spam-ASN: AS11403 66.111.4.0/24 X-Spam-Status: No, score=-4.0 required=3.0 tests=AWL,BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_LOW,SPF_HELO_PASS, SPF_PASS shortcircuit=no autolearn=ham autolearn_force=no version=3.4.2 Received: from out3-smtp.messagingengine.com (out3-smtp.messagingengine.com [66.111.4.27]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by dcvr.yhbt.net (Postfix) with ESMTPS id 86AA71F4BD for ; Wed, 9 Oct 2019 13:22:11 +0000 (UTC) Received: from compute7.internal (compute7.nyi.internal [10.202.2.47]) by mailout.nyi.internal (Postfix) with ESMTP id C315B2016D; Wed, 9 Oct 2019 09:22:10 -0400 (EDT) Received: from mailfrontend1 ([10.202.2.162]) by compute7.internal (MEProxy); Wed, 09 Oct 2019 09:22:10 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=alyssa.is; h= from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; s=fm1; bh=QwjiD9R8V0pFP7mGoYtjHvTHHE pn95PtNiyf/KqgRBU=; b=MO04i29APT/gFgj0hwBkIjfJlY8ev2SLbIxD+ecukJ Rc78BjsZbol3yjZ9c4CIvPe0VPZTwGJFAFMSC6HsCdLughkRX5UnZpv/OAIpMZan JfxXjL4j/v4TxGFjBrtM7REpb+x6up4lUMSoHTD11PHexfjlSDqZlriBpaQorcT1 FcQlLwGxTEeVps49j2O0Dz8TX9k/fckjQ5+sBh5gQbbzj9z8ch7A2oryI5GDPrSk SvuaNPA12n6yYIaA6aVsFOoYEe8ngwTviLkX9Y/y3aOAi8tzPP2NUOV3xdy0HWQe x8HQahFM/PmJjLI6MuIsqu9M7M72SPsJhcktianFQpkA== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:content-transfer-encoding:date:from :message-id:mime-version:subject:to:x-me-proxy:x-me-proxy :x-me-sender:x-me-sender:x-sasl-enc; s=fm1; bh=QwjiD9R8V0pFP7mGo YtjHvTHHEpn95PtNiyf/KqgRBU=; b=HHR4o6PpXtaOqT2dqIdoa12XpxtGMKQQO Upe9Aht5wDl3bcXwCq5nzeozWMuVgTQ3sB/pEI23QsMPZKT2XBndK4kv+YTuDkMb hv3rn2sTonEoEPlJS4rqqD79xrmaBjW77CtmgrifX6bbt5srEuFn/zAEGWxoUfmS eXLUeVXgthPg1UuvCKV4LiRY4wo2N7sPr4tueWUsOuFQN0cx+8zIDxqbUCQvItvJ bYZ5r8ty0QBYsp2tRISLXu51pZ09kJeP2vXilpb2sphjiiTllZ8jdb+VWN3fhE4c Y+0U72gjthpNdcLo8YCKhDFJd2HC5Jnzm+4xk96vG71qG8nqff1Iw== X-ME-Sender: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedufedriedugdeflecutefuodetggdotefrodftvf curfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfghnecu uegrihhlohhuthemuceftddtnecunecujfgurhephffvufffkffoggfgsedtkeertdertd dtnecuhfhrohhmpeetlhihshhsrgcutfhoshhsuceohhhisegrlhihshhsrgdrihhsqeen ucffohhmrghinhepvgigrghmphhlvgdrtghomhenucfkphepkedurddukeejrddvvdegrd dufedtnecurfgrrhgrmhepmhgrihhlfhhrohhmpehhihesrghlhihsshgrrdhishenucev lhhushhtvghrufhiiigvpedt X-ME-Proxy: Received: from localhost (130.224.187.81.in-addr.arpa [81.187.224.130]) by mail.messagingengine.com (Postfix) with ESMTPA id E29788005C; Wed, 9 Oct 2019 09:22:09 -0400 (EDT) From: Alyssa Ross To: meta@public-inbox.org Cc: Alyssa Ross Subject: [PATCH] doc: explain publicinbox..watchheader Date: Wed, 9 Oct 2019 13:21:14 +0000 Message-Id: <20191009132113.29255-1-hi@alyssa.is> X-Mailer: git-send-email 2.23.0 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit List-Id: It wasn't clear to me exactly what this does -- in particular, what happens if it isn't specified? Does it support multiple values? A very brief explanation can answer both of these questions without making somebody look at the code. --- The part about it not supporting multiple values is my best guess based on a quick glance at the code -- I may well have missed something. Documentation/public-inbox-config.pod | 3 +++ Documentation/public-inbox-watch.pod | 4 ++++ 2 files changed, 7 insertions(+) diff --git a/Documentation/public-inbox-config.pod b/Documentation/public-inbox-config.pod index 4e8ba4d..8d545f7 100644 --- a/Documentation/public-inbox-config.pod +++ b/Documentation/public-inbox-config.pod @@ -80,6 +80,9 @@ Default: none; only for L users [publicinbox "test"] watchheader = List-Id: +If specified, L will only process mail matching +the given header. Multiple values are not currently supported. + Default: none; only for L users =item publicinbox..nntpmirror diff --git a/Documentation/public-inbox-watch.pod b/Documentation/public-inbox-watch.pod index 3f282f0..198c170 100644 --- a/Documentation/public-inbox-watch.pod +++ b/Documentation/public-inbox-watch.pod @@ -15,7 +15,11 @@ In ~/.public-inbox/config: mainrepo = /path/to/test.example.com.git ; config keys specific to public-inbox-watch: + watch = maildir:/path/to/maildirs/.INBOX.test/ + + ; optional, emails that don't have a header matching + ; value will be skipped watchheader = List-Id: [publicinboxwatch] -- 2.23.0