From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp12.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 wASsDMXAd2KoiwAAbAwnHQ (envelope-from ) for ; Sun, 08 May 2022 15:08:21 +0200 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp12.migadu.com with LMTPS id UBC7DMXAd2JjfwEAauVa8A (envelope-from ) for ; Sun, 08 May 2022 15:08:21 +0200 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 C98EFB57D for ; Sun, 8 May 2022 15:08:20 +0200 (CEST) Received: from localhost ([::1]:40382 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1nnge3-0001E5-VQ for larch@yhetil.org; Sun, 08 May 2022 09:08:20 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:52654) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nngdc-0001CQ-TI for emacs-orgmode@gnu.org; Sun, 08 May 2022 09:07:52 -0400 Received: from mail-pl1-x630.google.com ([2607:f8b0:4864:20::630]:44637) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1nngdb-0007xz-Ex for emacs-orgmode@gnu.org; Sun, 08 May 2022 09:07:52 -0400 Received: by mail-pl1-x630.google.com with SMTP id q4so8682395plr.11 for ; Sun, 08 May 2022 06:07:50 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=from:to:cc:subject:in-reply-to:references:date:message-id :mime-version; bh=g5BxZpJTwhjjK0JiToOqsw54tC3L7resGK0Rr2r3Mmw=; b=kv6BSf4z238pKC91hxAZGGi2G9G+xrlGuCZypQsGwELf/eeEWguKvd6vZBmYeaSL+8 6b0xAoLOUqF7zrGyynptp/CVSKSaPyrvmEcPG6uvxRJAbyqaaT1fFOamTxHYq6YyG0Gd Lnz4ycGOedn0J8vcNGjA6aWLmTZewnvuVX0RFrlJQd/ow33C2ZwY8XrKkZrkmNDAV/Q8 mVKNAAMlbcXT8DLU4N5tQUj9wIyc9+gLDgOvSjBUXIGSLM9rAeS0J9ArSBLa8hkrC1W2 ubLZv63kVO+vWtWobVS4QtCu2t4jjS2070YE4xkk0xJ/HnwI87wTPQXA0S2CCLnVb8ID 9q7g== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:to:cc:subject:in-reply-to:references:date :message-id:mime-version; bh=g5BxZpJTwhjjK0JiToOqsw54tC3L7resGK0Rr2r3Mmw=; b=NhIf33TPTpyZjlpSTMXRnxWRqp0YMezXAsjNS1qxTQjcucWzMUqWGGt0A81+F5cyW7 Nvug5/GYBsFvKNCVrXIW0tnwBejNdSsnTbvJQ5cz5tmC7aCZgybXOzcdA4lmlU6PRuxY HjuJhjnGDgIIc6GOJD4eUUm2DQEicWGp+EhypUZGMUet1Btg3XmjLy/AqgHEL0uUyMlv XKkokNHX16nnx5d39SXCk9gHu4mP7N2mMFERw+x0WdjdRES04PBMyoPVEOTIsO7jwf+o eco8+qrSGrOrHNZXvUm9bKu4m5ibXmhT6Ln3xTTxx3ZQ52Do6Jdib/rtOTjVaHGqjWia 4pfw== X-Gm-Message-State: AOAM531x68gEpicum9kIDtrw7H3p887NBZTmeNy3QJuvOw3MLZhJ/Eft BKljF+OIyq6BtmKdmsaXAIc= X-Google-Smtp-Source: ABdhPJwlhE4+j6G5Lio6zR21Pv1Hq2E8WaWMCbwOOjxDVL9D5JyDqwKl19pThQpzZjjlsnTzAsY1RA== X-Received: by 2002:a17:90b:1b44:b0:1dc:315f:4510 with SMTP id nv4-20020a17090b1b4400b001dc315f4510mr21755555pjb.28.1652015269527; Sun, 08 May 2022 06:07:49 -0700 (PDT) Received: from localhost ([66.154.104.4]) by smtp.gmail.com with ESMTPSA id w14-20020a170902e88e00b0015e8d4eb1easm5163214plg.52.2022.05.08.06.07.48 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 08 May 2022 06:07:49 -0700 (PDT) From: Ihor Radchenko To: Phil Hudson Cc: emacs orgmode-mailinglist Subject: Re: org-agenda-filter-by-tag doco In-Reply-To: References: Date: Sun, 08 May 2022 21:08:32 +0800 Message-ID: <87k0awqii7.fsf@localhost> MIME-Version: 1.0 Content-Type: text/plain Received-SPF: pass client-ip=2607:f8b0:4864:20::630; envelope-from=yantar92@gmail.com; helo=mail-pl1-x630.google.com X-Spam_score_int: -18 X-Spam_score: -1.9 X-Spam_bar: - X-Spam_report: (-1.9 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_ENVFROM_END_DIGIT=0.25, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham 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 X-Migadu-To: larch@yhetil.org X-Migadu-Country: US ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1652015300; 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:in-reply-to:in-reply-to: references:references:list-id:list-help:list-unsubscribe: list-subscribe:list-post:dkim-signature; bh=g5BxZpJTwhjjK0JiToOqsw54tC3L7resGK0Rr2r3Mmw=; b=LX7QT8OLDhxX16/CBtZXgun5gBZgED8ge92NBBEmTZ1fJf/OkjIWE9OWbGUJHMT2MOcvbE BlJeFJlt8MMbYHQkZGJd5Ads/fBj88eBqFZsPEn2X7Ksix9tqhwrLKpXf9QHA4CxfkRVGS 1A5AphNRw92wyATtDwwKHrGsoXCiU387WfgR0MrKHTVR0XjIM+vAbkxYQqkxApgXBy9Cq2 QcTWjGVSjBVlJ+6ZpdF1+2zUWErN+LEu2RC4/Vxe39Q8o7G1C1oD6MeDxRweIRMBjbReiC 3T/cmV/eIE24smw/d4xKi0T9R+vyZs4HJdqKQcYKYogo7aMI5XUTMPZqf84E8A== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1652015300; a=rsa-sha256; cv=none; b=Ayih5OAzOQZ9qoJOteti9z2ZA+8oomFI13C3pCSYrk/RtBcTLzKYJJebGcZmHGVFWlMTjA +mRD7SIUvRhR+3KL7uq5EAZE35PkrCDlC17icAiDvem6NZ98Jf+tgizZQVCgGMB19nDLHK QywYoivn+udn0GIng2MlENt/vBvXnA2+0Pk/r8ZfhzS2a2mhd09YbJTszjIx/l/ukAFeUx HQNu+OAKjiiOw4VQATSXh/En0BLweI4LL9cYBt+8kVoU6Lt5PbPcrHEDn6nsPV63pFz3qI 1tX8GnPbqgvWUwgRmyCTLhAdXcDQPQ9/6n9W9BmmbVmDmEEpj4kB1/5o/qNfeg== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20210112 header.b=kv6BSf4z; dmarc=pass (policy=none) header.from=gmail.com; spf=pass (aspmx1.migadu.com: domain of "emacs-orgmode-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="emacs-orgmode-bounces+larch=yhetil.org@gnu.org" X-Migadu-Spam-Score: -3.51 Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20210112 header.b=kv6BSf4z; dmarc=pass (policy=none) header.from=gmail.com; spf=pass (aspmx1.migadu.com: domain of "emacs-orgmode-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="emacs-orgmode-bounces+larch=yhetil.org@gnu.org" X-Migadu-Queue-Id: C98EFB57D X-Spam-Score: -3.51 X-Migadu-Scanner: scn1.migadu.com X-TUID: UHmN+gmWa8YK Phil Hudson writes: > 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 do not think that it is a good idea. There is not much point explaining basic Emacs concepts discussed in Emacs/Elisp manual in every docstring of functions making use of universal arguments. Note that C-u gets automatically highlighted when you view the function docstring. Clicking on it brings you to the docstring for universal argument, which, in turn, also contains a link to the manual page. I think it is good enough. Best, Ihor