From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp0 ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id UFBQI6pZo2HBFQEAgWs5BA (envelope-from ) for ; Sun, 28 Nov 2021 11:27:54 +0100 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp0 with LMTPS id aNr9HqpZo2GCBAAA1q6Kng (envelope-from ) for ; Sun, 28 Nov 2021 10:27:54 +0000 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id F1BCF7AAD for ; Sun, 28 Nov 2021 11:27:53 +0100 (CET) Received: from localhost ([::1]:49552 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mrHPV-0004rb-6X for larch@yhetil.org; Sun, 28 Nov 2021 05:27:53 -0500 Received: from eggs.gnu.org ([209.51.188.92]:34854) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mrHOw-0004oR-Gm for emacs-orgmode@gnu.org; Sun, 28 Nov 2021 05:27:18 -0500 Received: from mail-ua1-f48.google.com ([209.85.222.48]:42911) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1mrHOu-0000lX-98 for emacs-orgmode@gnu.org; Sun, 28 Nov 2021 05:27:18 -0500 Received: by mail-ua1-f48.google.com with SMTP id t13so27808369uad.9 for ; Sun, 28 Nov 2021 02:27:14 -0800 (PST) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:mime-version:from:date:message-id:subject:to; bh=HXMP3Wsn2tyS55zrCEnQo+s8i8lP23qIhNJD9nrQegU=; b=ePIcrGeOBB11oEpuhTaV1FVP1ipj49sL3FIIfU8B4enL3fN+w9kb68O8gxOvIHoTuv Td1acXX2pA4TOvTW30q+A3PBhPScAYCZdrC+817TzbQuJV2mpeIKSbGMi2u4xstMsmcY Y5eYeH1R4fkXjg6ODrBGXjTFDBGfi3A+G0DpJsYtPY1lJKAbq0o4oUto3EoZK5qriJ5Y 2GDuZOOI+bhBGGeFmA77mODVciVMjZY5UkgNgcHsgsQAhSEeWXzTDsbyyFNiFSkWBkA7 M4IN8YTAkEv9dsuk/wcu7+a/X+eYGenRp8LWHx8/KVdX1167iqXw24hSgk65n1n3k6M+ GykA== X-Gm-Message-State: AOAM530WEdznyu20N5inlz8v+JZf9QO5md/zB6Uyc+WxlVf64algX7eQ TEULl67kH3sdbOWwkUD/ny77dEu1QDvd8rP8xmHwtI616NgZuw== X-Google-Smtp-Source: ABdhPJwKoZgmGyuUse0rTXJy1T4OMhAOiMmz9/9gw7XsEuxtJEQ+7pm/mKVXuxhHjxR3pKkUeQ1IhsajVL9ZSc2t4os= X-Received: by 2002:ab0:2a10:: with SMTP id o16mr43633861uar.36.1638095233580; Sun, 28 Nov 2021 02:27:13 -0800 (PST) MIME-Version: 1.0 From: Phil Hudson Date: Sun, 28 Nov 2021 10:27:02 +0000 Message-ID: Subject: org-agenda-filter-by-tag doco To: emacs orgmode-mailinglist Content-Type: text/plain; charset="UTF-8" Received-SPF: pass client-ip=209.85.222.48; envelope-from=philhudsonster@gmail.com; helo=mail-ua1-f48.google.com X-Spam_score_int: -13 X-Spam_score: -1.4 X-Spam_bar: - X-Spam_report: (-1.4 / 5.0 requ) BAYES_00=-1.9, FREEMAIL_FORGED_FROMDOMAIN=0.249, FREEMAIL_FROM=0.001, HEADER_FROM_DIFFERENT_DOMAINS=0.249, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=no autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-orgmode@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+larch=yhetil.org@gnu.org Sender: "Emacs-orgmode" X-Migadu-Flow: FLOW_IN ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1638095274; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:mime-version:mime-version: content-type:content-type:list-id:list-help:list-unsubscribe: list-subscribe:list-post; bh=HXMP3Wsn2tyS55zrCEnQo+s8i8lP23qIhNJD9nrQegU=; b=sXxWcLUzbVwlYlzqqbEriw7PZcrNOH3pXF9bGXEb9sMsUwN0Glt0vJJw8TWniPDnKrPgqH SEPzZ4H7odde2Mr5ymDtmu9+A1zxgTfR3bh8a5yMrvFyV4nvHXyod1TzIkEIwLr4daaSdo YQrufOEVOdbWcra8SjEH5VRDe2glg2CGnGL/O9M26e/ZPZZDf5c/usPT/IBsWeYuQFfJyG Bjp2WCiU/OgfSIsbrnUEgXatCD2yTF2ncX3Hrholc/8AnmEst6UT4uYh+U2Z/l0/VeNOZr pb4h3As6tNyFMGPJMBTVjZYGKyM9fFbtN0w0Mgr2Hc6p/IgQNhCkz85UVCWudA== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1638095274; a=rsa-sha256; cv=none; b=QxHWcm2j5ialtszXuGVbvMeNjjw1dkQARysu3xrjpxomfEhlPOSD0vKHaupU8doRFXHwxh zwir7z7ZHgwmPNtfWf0eUYFb2L4KFTiUBgr2Uuetsy1Nfndx4miyv+TTFMe58pj1OsFYKH KhhGvZHqqwaa4EAsO6fYXVj+O8p0Zw3zUwrsoM3UXQHNnU+VlWBj8OQfdl+uRNlhUEPumd OL3u3nWV7wa113RMSwRObeqznttCc/T7o1NM82kZypmKXS4FXGZ5SOIyYUb3rSL0A/zXp9 QZcgOP8t3HUFZ4W6aDeC27i3fRHb1aYptIe6/1hWJOa3HTKu3zKFPmMBsPLc6w== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=none; spf=pass (aspmx1.migadu.com: domain of emacs-orgmode-bounces@gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=emacs-orgmode-bounces@gnu.org X-Migadu-Spam-Score: -2.91 Authentication-Results: aspmx1.migadu.com; dkim=none; dmarc=none; spf=pass (aspmx1.migadu.com: domain of emacs-orgmode-bounces@gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=emacs-orgmode-bounces@gnu.org X-Migadu-Queue-Id: F1BCF7AAD X-Spam-Score: -2.91 X-Migadu-Scanner: scn1.migadu.com X-TUID: wyX8F6fspXbH I'd like to expand the docstring of command `org-agenda-filter-by-tag` to document the Elisp equivalent of interactive prefix arguments. By trial and error and guesswork I determined that I could emulate `C-u C-u` by passing `'(16)` as the second argument (`strip-or-accumulate`). I'd like to add text explaining this, generalized to all prefix combinations. I just thought I'd mention it on the list first, to get any thoughts and advice that might be useful. For instance, currently there is a paragraph for each prefix combination (`C-u`, `C-u C-u` and `C-u C-u C-u`). Should I add Elisp calling doco to each, or should I expand the subsequent paragraph that deals specifically with Elisp calling? I tend to favor the latter as least confusing, but that might be a matter of convention or opinion that others are better qualified to comment on. A further point: I already knew from prolonged usage that `C-u` combinations evaluate numerically as powers of 4, but a newbie might not. Should we explain this? I don't think it would be appropriate, but again I'm open to advice. If not, should we at least link to the explanation in the Elisp manual? I know we don't usually bother, but since outcomes differ substantively in this case, maybe we should here.