From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp11.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms5.migadu.com with LMTPS id cBcjD7ljh2PUEQAAbAwnHQ (envelope-from ) for ; Wed, 30 Nov 2022 15:07:53 +0100 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp11.migadu.com with LMTPS id OMcjD7ljh2PHSwAA9RJhRA (envelope-from ) for ; Wed, 30 Nov 2022 15:07:53 +0100 Received: from mail.notmuchmail.org (yantan.tethera.net [135.181.149.255]) (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 E95702B86B for ; Wed, 30 Nov 2022 15:07:52 +0100 (CET) Received: from yantan.tethera.net (localhost [127.0.0.1]) by mail.notmuchmail.org (Postfix) with ESMTP id BB6EE5F959; Wed, 30 Nov 2022 13:58:40 +0000 (UTC) Received: from mail-ed1-x532.google.com (mail-ed1-x532.google.com [IPv6:2a00:1450:4864:20::532]) by mail.notmuchmail.org (Postfix) with ESMTPS id 398445DD92 for ; Wed, 30 Nov 2022 13:58:38 +0000 (UTC) Received: by mail-ed1-x532.google.com with SMTP id x2so24187081edd.2 for ; Wed, 30 Nov 2022 05:58:38 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:sender:from:to:cc:subject:date:message-id:reply-to; bh=nIfr73pI/1ePSed2FrrN1etiPf9LlfkD+SwzLG59PWc=; b=C9a8EkolbQvxnarjE//XgFjEqaBSO5sH1QqRIsU9UmE0GG/b52cECQFUrsaKMghFht 9GpqQGxb7cjiB2mRrL3HKn/7IyGEK7asrQhVFwZkXjybz18T+k+A+7PvaWev8bb2FSfd Ltj66ghNjIzdJcM9eoH64XY3MIIHT+qtoMPnb8kKplMiKo4osWi9g2gLHdXXd84CHVqo RGobbvXvyBUkJ5hVBTYh8UMqwBlz6lPkMs4b76E2GO4YzDCtvnw/1nWtbUi4GU//l6kM gGWeUiv5aEJcS68A/ag+HvxTqSvA/NK9bv11/yfpb9KaVqccHeKV2Wymw8p2d7VoYBp+ Jktw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:sender:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=nIfr73pI/1ePSed2FrrN1etiPf9LlfkD+SwzLG59PWc=; b=zDYETTXqjXB+3xAQGKO4LZWdrGd4FEGjuRJuMybm5aAnliiGdc5piKx9oeQhlkBHuo 2b5ByP1bMkh7ApEcnyAITxsm8HJhlOoMEOxSaFHUPnm5ioNQnwgadjUl7Eh633UPzUhQ qEd/eVIiOve9zSTz3HDybfbTUaN5xGGLuI2oOaBeiQPlLkkWDO57LBPnnH8RNvHrkGfY WgGaWkmiS/Wto05/IJro7pSOnvHFU7DIAYfjuLghHZHuGONthOQTegqIAlj5o7pBOlOg HbwBW+fQUppARJpK3PZ33RORfvIv5lrtdx2rn4hUEXuwaOW0Jb/LpaZW6qnK18xhkDGh aD/g== X-Gm-Message-State: ANoB5pnex3mC8ONLHTPiWb8C4G+l6ID83xvLVW/fkpEfqtqSdqYZWiOb vuUgmdKu7qgb3w/l8zl9QM9PBNTJ2y8= X-Google-Smtp-Source: AA0mqf5Os00nKTBdJZrgqFH+M0uS2rLIVP0iFJimgR8StUq8DEck+YtNINNeExoMFPE32U4WVUY0RQ== X-Received: by 2002:a05:6402:149:b0:458:cc1b:a273 with SMTP id s9-20020a056402014900b00458cc1ba273mr43498488edu.92.1669816716883; Wed, 30 Nov 2022 05:58:36 -0800 (PST) Received: from localhost ([2001:9e8:6a7f:c600:4f70:9e9e:3425:c582]) by smtp.gmail.com with ESMTPSA id m10-20020aa7c48a000000b0045b3853c4b7sm655796edq.51.2022.11.30.05.58.35 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 30 Nov 2022 05:58:36 -0800 (PST) Sender: Michael J Gruber From: michaeljgruber+grubix+git@gmail.com To: notmuch@notmuchmail.org Subject: [PATCH] doc: mark `--output=summary` as default Date: Wed, 30 Nov 2022 14:58:34 +0100 Message-Id: <63b925a0b2f94193dd55bdb11fc87158452169c2.1669816662.git.git@grubix.eu> X-Mailer: git-send-email 2.39.0.rc0.274.g106f0b89d0 MIME-Version: 1.0 Message-ID-Hash: A4RKPXS67HVUIJJJK6EBD33AIDACWAKU X-Message-ID-Hash: A4RKPXS67HVUIJJJK6EBD33AIDACWAKU X-MailFrom: michaeljgruber+grubix+git@gmail.com 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: Michael J Gruber 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: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Migadu-Flow: FLOW_IN X-Migadu-Country: DE ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1669817273; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding:list-id:list-help: list-owner:list-unsubscribe:list-subscribe:list-post:dkim-signature; bh=7/NEyWU6qnfoQrzf/p/K+Ph63NNpPJXdZ060XyfCcHE=; b=Ir8XtHfILW4xlY/MmsN6PsP21yM1V1JiMWth09U9oh7AYDccV7K5SqFmcRKJ+1QjdgIQrF f2E7i9aKAqUpgQrPaU69v2ObTaakdoCDD9IV9i9/59Vg0jsjHrIZ4n/ZuHKIDXZx17cC4l IbSx2G9eUEgOI21ou8FVhfJSPHrIBcWqQi7DDGZJmMr4g/5KAxXPZ2WNCDigCbeXSDCMTU fz2BZ5LoG6d3i5Z6QV8PhgZFIUyH+DG6hPgrhl/lO7W+SzanerME2XaUcYC1d7fBzVDHty SonAtDTGh+a8NEhCM8nlAIzxKcyjxox9j6k91PsTtq82t34IUx7EXNI8KOvKSQ== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1669817273; a=rsa-sha256; cv=none; b=R7Wym43h4lmfRqUYidW/uqVcplzEqwadR5yvbn6HgcgwPEgbSwxY8qaiL0VK3Encdhprjp cFIZiR5DVraN6yyu2AClkz8nKHzMwuDgCVxyY4cM45ud4+oeW/6T4zKU56ZwKn2Z1x9460 B5L7Bhmv0/FVtOlA0Ivv61OBeCuHjizzZ+AQfUf8FXzYPP6NvwOdZ3CBI7ZXV+FGvFNoBN K1QZOmKFXCKcrSj7z9GV62GZJj4JRJgVV5anh62/OtNHR04/EUyybSBbMMKVcUT6DUiOdN Ghkw+2EXpv96yQqU+Gdg4QktllOf1VARn+1q/eONCWYM3u4kzjdEIn7mm44ieA== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=fail ("body hash did not verify") header.d=gmail.com header.s=20210112 header.b=C9a8Ekol; dmarc=fail reason="SPF not aligned (relaxed)" header.from=gmail.com (policy=none); spf=pass (aspmx1.migadu.com: domain of notmuch-bounces@notmuchmail.org designates 135.181.149.255 as permitted sender) smtp.mailfrom=notmuch-bounces@notmuchmail.org X-Migadu-Spam-Score: 7.31 Authentication-Results: aspmx1.migadu.com; dkim=fail ("body hash did not verify") header.d=gmail.com header.s=20210112 header.b=C9a8Ekol; dmarc=fail reason="SPF not aligned (relaxed)" header.from=gmail.com (policy=none); spf=pass (aspmx1.migadu.com: domain of notmuch-bounces@notmuchmail.org designates 135.181.149.255 as permitted sender) smtp.mailfrom=notmuch-bounces@notmuchmail.org X-Migadu-Queue-Id: E95702B86B X-Spam-Score: 7.31 X-Migadu-Scanner: scn1.migadu.com X-TUID: OwwmB9Waf9XF From: Michael J Gruber `notmuch search` behaves differently depending on the output option: It either outputs information pertaining to all threads with matching messages (summary, threads) or to all matching messages (messages, files, tags). The man page refres solely to the former in the main description. Help the user by clearly marking `summary` as the default output option. Signed-off-by: Michael J Gruber --- doc/man1/notmuch-search.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/man1/notmuch-search.rst b/doc/man1/notmuch-search.rst index ad305efd..b87737ea 100644 --- a/doc/man1/notmuch-search.rst +++ b/doc/man1/notmuch-search.rst @@ -43,7 +43,7 @@ Supported options for **search** include .. option:: --output=(summary|threads|messages|files|tags) - summary + summary (default) Output a summary of each thread with any message matching the search terms. The summary includes the thread ID, date, the number of messages in the thread (both the number matched and -- 2.39.0.rc0.274.g106f0b89d0