From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp2.migadu.com ([2001:41d0:303:e16b::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms1.migadu.com with LMTPS id IEDYDfC5VGYYZAAAe85BDQ:P1 (envelope-from ) for ; Mon, 27 May 2024 18:50:56 +0200 Received: from aspmx1.migadu.com ([2001:41d0:303:e16b::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp2.migadu.com with LMTPS id IEDYDfC5VGYYZAAAe85BDQ (envelope-from ) for ; Mon, 27 May 2024 18:50:56 +0200 X-Envelope-To: larch@yhetil.org Authentication-Results: aspmx1.migadu.com; dkim=fail ("body hash did not verify") header.d=iki.fi header.s=lahtoruutu header.b=Ngox694G; spf=pass (aspmx1.migadu.com: domain of notmuch-bounces@notmuchmail.org designates 2a01:4f9:c011:7a79::1 as permitted sender) smtp.mailfrom=notmuch-bounces@notmuchmail.org; dmarc=none; arc=reject ("signature check failed: fail, {[1] = sig:iki.fi:reject}") ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1716828656; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: in-reply-to:in-reply-to:references:references:list-id:list-help: list-owner:list-unsubscribe:list-subscribe:list-post:dkim-signature; bh=CnR5C+D9pZz4bJhMoUvpj+sdnGlKc5W52QqYIh1HCmc=; b=mNuJ84eJMAfz6UZACcAVwFVxolYn+l2BiatuGGdscFV8lief4/HP5t2MWtf0KmW2x8bZvL ULxXygkt8jqoPExaz2enpnkw2cxoYRnqa53mfGT6Yw2e187CFfcIAUDYPPQYHDPmEsbbFW eopiy5EPP0ak7M942C2DbTXpz/0oHtmFR7DHyP8F/i9r3eeiWOd8qvRrjMIaXNGq3w2hQ5 D7lS4tCGLq2jNTLqAHEHiplKgHopD4nBLTmOsfpbaxJwq2nUej1ASG2850efpJtjbq74cK hr4SWT5PjdEKX8mK0kfR6uBUEDR6XgaAPuKWOSs6kBauKyqmcvR73mAZcFG5tA== ARC-Authentication-Results: i=2; aspmx1.migadu.com; dkim=fail ("body hash did not verify") header.d=iki.fi header.s=lahtoruutu header.b=Ngox694G; spf=pass (aspmx1.migadu.com: domain of notmuch-bounces@notmuchmail.org designates 2a01:4f9:c011:7a79::1 as permitted sender) smtp.mailfrom=notmuch-bounces@notmuchmail.org; dmarc=none; arc=reject ("signature check failed: fail, {[1] = sig:iki.fi:reject}") ARC-Seal: i=2; s=key1; d=yhetil.org; t=1716828656; a=rsa-sha256; cv=fail; b=gQZxkulJ23z9eT6CJR5W7A9Jg/YOXmlkrbvuFyLguubykTieFtXGv8+i8HNwBakUy3C+vo JrS7/5GIwCOUAPyVj7JHJh89F/Gh05oboc4LQmOYqghk6OVysYVdWVucDpc6J9GtbNct1X R6GYf5+wHyol9+PQQbJZRhjuBtWRTojB06QE0W3cwbWiBO1CknDRe4ws8GzUg1M0rDsPsb Pf5TN7rRKYogmXXU5QtgIB4Z0jAQ8vaJ2OTkmURhG/6dorqolvPdnl5+V9e8ObmC2XecyP c9ZD2uNjzsi6/EO9a5AzqtR82BcTSDRGK2MzJEmk8600naw/chTkL09dkLHB3Q== Received: from mail.notmuchmail.org (yantan.tethera.net [IPv6:2a01:4f9:c011:7a79::1]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id BA1CA3A691 for ; Mon, 27 May 2024 18:50:55 +0200 (CEST) Received: from yantan.tethera.net (localhost [127.0.0.1]) by mail.notmuchmail.org (Postfix) with ESMTP id 6525E5E522; Mon, 27 May 2024 16:50:47 +0000 (UTC) Received: from lahtoruutu.iki.fi (lahtoruutu.iki.fi [185.185.170.37]) by mail.notmuchmail.org (Postfix) with ESMTPS id 4279B5E50F for ; Mon, 27 May 2024 16:50:46 +0000 (UTC) Received: from mithlond (mobile-access-6df007-238.dhcp.inet.fi [109.240.7.238]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange ECDHE (prime256v1) server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) (Authenticated sender: tlikonen) by lahtoruutu.iki.fi (Postfix) with ESMTPSA id 4Vp1qS6jgbz49Pym; Mon, 27 May 2024 19:50:44 +0300 (EEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=iki.fi; s=lahtoruutu; t=1716828645; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: in-reply-to:in-reply-to:references:references; bh=ytCCVw9is0zoFSwR0G3PdhweP/EMtCotU3Zr0LoxW7U=; b=Ngox694GeLsttjR4EY6HPKHPFu044njMnE+IMYxXNN5cgUwsjeWQz4U8YJkeoJtxesIFIQ wcuGNplIqwLj5DyvSzwp/Lfc8HK+jvACa5GYZYRjkVsUKxDFlf5hnhNvV7BqkJDr0CAbu5 4PYb/t3d55pDD6ufdYJ3aN/KPq7GMDmg9RthavVLM7t0bENrYucPcV2tjXq618dJEd0OPp WQmsPwf3SD2G9avonLimZisQLgtruEiFSfbS870Qqvi96nXI/cMzhY9kMfYED0A1uAN73M OtsFFrq4WulgHgO1ZLDm4pU2ZtKthrQ2hb3LG+l6QXdFlwUsf7zPTUkPPS68iQ== ARC-Seal: i=1; s=lahtoruutu; d=iki.fi; t=1716828645; a=rsa-sha256; cv=none; b=DNyLbY0mXiGkgdxmSAbM4HiQ/noqOuUpjx0oV7cpFE9poLjdpljW7VYooaVgzQp3jxznN6 UlFjHXtFJVy6nmwX5uZwsYditFFElA8W66sG8armJ6D4hF3k0AnL0JEXg5FKRX8d3Kd5wv HhNFZukaiGQQjK79wxSNh+0IySPCTeSDTxknFZNjMX6T42dSvcwxtuYAk/tDd9jhDEV3N0 9/qVCBE1hI/+bWPv+Qu/j9hSyMsuchhxIbyRBD0UGQwoDzQGIgA1mR9zWWfTa4f64LtFIw 2+r8uBTozoXifWsg7O50fgPIX1aCQ/8aE21it0DFqc5uI7PkxPyL+DFdgZ104A== ARC-Authentication-Results: i=1; ORIGINATING; auth=pass smtp.auth=tlikonen smtp.mailfrom=tlikonen@iki.fi ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=iki.fi; s=lahtoruutu; t=1716828645; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: in-reply-to:in-reply-to:references:references; bh=ytCCVw9is0zoFSwR0G3PdhweP/EMtCotU3Zr0LoxW7U=; b=TJuwqTaWEvh2Jg1srWGSm1/Vu3fJb6GqpnZukGM/Hi4UbtbFGN5jOxc6zFEvSFXBnsxyyK Q6iJEl7R695fbzd1Vvgb2p8+iG6KCE+ZrQ6V7XhPLE7T/Pr0LepW+KbxuUnAiKjuPzMt0N C/KgyKUfEEN8WvXixp4yKE5q8vZmgORXift1Uox03gfJfhHkzHNsPXt7TIa0mVxcrU3Cc2 21kEGJikbcaz0m0Ck0wgv696oxSN451fNy/GPdzUXRjQdQLXBRQCkBjOv7kYxsdwYgED3o n8MmD0hlbjWzlBA3NDkt5kHqZYYe2x/f2VpkJbHNahofL92/3ByjfF8pkK/l+Q== From: Teemu Likonen To: Daniel Kahn Gillmor , Michael J Gruber , David Bremner Subject: Re: Meaning of offset in notmuch search --output=files --offset= In-Reply-To: <875xuzs8w2.fsf@fifthhorseman.net> References: <87ed9wz6im.fsf@iki.fi> <87v8328j47.fsf@iki.fi> <87a5ke1a0t.fsf@tethera.net> <878qzxj99h.fsf@iki.fi> <875xuzs8w2.fsf@fifthhorseman.net> User-Agent: Notmuch/0.38.3 (https://notmuchmail.org) Emacs/29.3.50 (x86_64-pc-linux-gnu) Date: Mon, 27 May 2024 19:50:36 +0300 Message-ID: <87a5kbi4gz.fsf@iki.fi> MIME-Version: 1.0 Message-ID-Hash: AYW5K62FWMIYZIPVDICMHZSMK5DNCWYA X-Message-ID-Hash: AYW5K62FWMIYZIPVDICMHZSMK5DNCWYA X-MailFrom: tlikonen@iki.fi 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; digests; suspicious-header CC: notmuch@notmuchmail.org X-Mailman-Version: 3.3.3 Precedence: list List-Id: "Use and development of the notmuch mail system." List-Help: List-Owner: List-Post: List-Subscribe: List-Unsubscribe: Content-Type: multipart/mixed; boundary="===============7191168047063787684==" X-Migadu-Flow: FLOW_IN X-Migadu-Country: DE X-Migadu-Spam-Score: 0.65 X-Spam-Score: 0.65 X-Migadu-Queue-Id: BA1CA3A691 X-Migadu-Scanner: mx13.migadu.com X-TUID: CNsaNE0DMCfQ --===============7191168047063787684== Content-Type: multipart/signed; boundary="=-=-="; micalg=pgp-sha256; protocol="application/pgp-signature" --=-=-= Content-Type: text/plain Content-Transfer-Encoding: quoted-printable * 2024-05-27 09:05:01-0400, Daniel Kahn Gillmor wrote: > I don't see much difference between any of these versions, Then it needs more work still. We want to make it clear for everybody, don't we? Let's go back to my original confusion. Currently it reads: --offset=3D[-]N Skip displaying the first N results. With the leading '-', start at the Nth result from the end. What "results"? The search match or the output? Two interpretations: 1. "Notmuch search" results an internal message list. "--offset=3DN" will skip N messages in the internal message list and then starts printing the rest of the messages in the "--output" format. [This is what Notmuch really does.] 2. "Notmuch search" results an internal message list and it starts printing them in "--output" format. It will use "--offset=3DN" to skip N output items, regardless of what they are: summary, threads, messages, files, tags. [This is the wrong interpretation.] So, how do we improve the notmuch-search manual so that everybody understands "--offset=3DN" correctly? =2D-=20 /// Teemu Likonen - .-.. https://www.iki.fi/tlikonen/ // OpenPGP: 6965F03973F0D4CA22B9410F0F2CAE0E07608462 --=-=-= Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iIYEARYIAC4WIQQL23klfGMkeOvdGCt57xklfWtWWwUCZlS53RAcdGxpa29uZW5A aWtpLmZpAAoJEHnvGSV9a1ZbmcUBANhcaqWoIyxaUkghfCEbBVOGDlSzJCw2d97F RZVAz1B9AQCje84EYxPtiiRKzoYzrdtfXbxVodBvtkCMCNgtFIZ/CQ== =6qIn -----END PGP SIGNATURE----- --=-=-=-- --===============7191168047063787684== Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Content-Disposition: inline --===============7191168047063787684==--