From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp2.migadu.com ([2001:41d0:403:58f0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms13.migadu.com with LMTPS id qOLhCwyYXWfmqgAAe85BDQ:P1 (envelope-from ) for ; Sat, 14 Dec 2024 14:37:00 +0000 Received: from aspmx1.migadu.com ([2001:41d0:403:58f0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp2.migadu.com with LMTPS id qOLhCwyYXWfmqgAAe85BDQ (envelope-from ) for ; Sat, 14 Dec 2024 15:37:00 +0100 X-Envelope-To: larch@yhetil.org Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20230601 header.b=VM+98OLO; 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"; dmarc=pass (policy=none) header.from=gmail.com ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1734187020; 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=5aydO/BfzZKfhz+x5+Wkd94SQU9sIG1qAMXRx1bO8hw=; b=G3lVO0YDcsY5w/eku8gqEASYRSOtb6SPdq72cllsGJL+FMTTd81EHuC1n8y+fvu9KqwNbw Pa41ltNhIZxtFJo+7aa5f0A8CofvvD1u/lky1OgRwqmprJBlKR2gSaZUfsPEiUgUU8bOoC DERBlPyRq9G7B5wD0ZiPa+11pKwu9K/2PjjjChwFYEWnZFJDpw62BiLitQ4qPBFCNYXykE NLwFHtbHlIlvUcy6fTYI5+mGYiOMRcmJBlFv4ow2U+pA/B5RJ5pW7KIAIIK8I9plnGlJ4r hG8tggV6TduhkiEisuUQ6A1nGRfGP5e2hZWsh7EARk4Aul5ghLExbK/GvcXcGA== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1734187020; a=rsa-sha256; cv=none; b=XenfukkoN3xCv9gIBI2MFdNSgw2ij03NVw+YM1gWjtphqEsEQMrl7vvd2B9ur6ROPrn8BN O0jMhdp8zO7AYeGfSbb3N/u5XbRNQ0N0+rxkZa6L5ljRqvlR703fcoccxex27U+1FeeC9s 2ku4mTfhsywlsK3b91crzG52QYrUTqz8LsxnBGQOxpkmoxnkCtoU2M7B1YrCsahlmbzOxJ D/KaTH5LiVJKZ+T3NYijzZcO4D9fR/IyWwyAPD3bt8N0BDqP2s4C7O4+pjAxhWY7RTIpW6 rpUc18d1xxSKFhEB+gERyA3p21qlgXw2Zje8EDeGEuwCsSuPqqQKBMsclP+ffA== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20230601 header.b=VM+98OLO; 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"; dmarc=pass (policy=none) header.from=gmail.com 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 1957A43C01 for ; Sat, 14 Dec 2024 15:37:00 +0100 (CET) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1tMTFX-0004sX-Ja; Sat, 14 Dec 2024 09:36:07 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1tMTAX-0003lN-Kn; Sat, 14 Dec 2024 09:30:57 -0500 Received: from mail-qv1-xf43.google.com ([2607:f8b0:4864:20::f43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1tMTAS-0007VV-FR; Sat, 14 Dec 2024 09:30:57 -0500 Received: by mail-qv1-xf43.google.com with SMTP id 6a1803df08f44-6dae1690c3cso21740286d6.2; Sat, 14 Dec 2024 06:30:51 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1734186651; x=1734791451; darn=gnu.org; h=mime-version:user-agent:message-id:date:references:in-reply-to :subject:cc:to:from:from:to:cc:subject:date:message-id:reply-to; bh=5aydO/BfzZKfhz+x5+Wkd94SQU9sIG1qAMXRx1bO8hw=; b=VM+98OLOlGZ7JIC7fS4NVd9bl351orw66goVhUnYaqykxc1Zzi63jf6o217I0rdrqx 6qCb4ey+EJs0sltzniBKHpKJpR00E6xqXHuFCSitEzwPFlhXoiOmQmkGWpRVeB2iwXsJ cpg5q6VQGm4dto3YpaFXWIgptGWm9Z1RWEQixQyNP0hEvH0oxPBaRJtS0MUsN1yjh1xV Dork0CTMj8jKZjFP7We9bUl9EAAHrdismY/l1qqchcaqv2oCMcaG2JORB4mh9c0A3FvS k6PeTOy2DSriJAwiLyilFM0+eHSb183Qv4x/X87Ndyg5dVK9j8ZbqkVlEwTv4dctuyBw ntbA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1734186651; x=1734791451; h=mime-version:user-agent:message-id:date:references:in-reply-to :subject:cc:to:from:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=5aydO/BfzZKfhz+x5+Wkd94SQU9sIG1qAMXRx1bO8hw=; b=ozyqCXRgWuGzBRnsaZgzXduPA+bNtA8jY4mWTUGBKNXz7/+ACD3bjZBtzUTvWK8IT/ nXaiNiYGoFXvMhx/kC79VfSALiA5REK9w0/GjUV+9YScWV+Xvzvr9v/479yGhookvMXR 7rHHEOz4VucM/VvOSTh2FAaNQPscDg8Rb0H4GlzQPEYecWV/J+PCBAi6/G3/uBMbiuph W10RSEinCYebOYzjF/xeakFMLccmKb3sefq/7MwE33JcuV+qHS/fi5MG515G7eHAWtgA ah+mRxfMbeeQ8J6KbaJiKdJ5wU5/bVHht5edqxDJ5PfZ8qBsI7wYmS47450YAqsJdn+N utuQ== X-Forwarded-Encrypted: i=1; AJvYcCV7mTZIcal5f41UtIDKkan0+BIf2VcEf2rIfCuknuL9BV7tM7i68pB5ztC+9eIMbQQUqEPTB+UN2v6LVQ==@gnu.org, AJvYcCVbPXZHJf5aOOYi5JU8PK8mL/qc2FqCOqFEqdXZg329E7IY4tOrjFmAQljcpujIabP0Zl4Kwpp2ySvCXwwOFg==@gnu.org X-Gm-Message-State: AOJu0YyTf9BAQPvrHcLUUmS9dO6+lrZnDay+eUVs70MAOADhKnuewhk9 nHr9/oNMTvYTRVOkn3hJ+iDSzKkPwpeqo79rYCuc2CyjoyhxqVj/ X-Gm-Gg: ASbGncs+U+v7eXAhYp9GQGAdj69j+zh7iQqe0bj79vttnoJK98+DLvdHVe2jVFfMjb8 tIbUaANpRP1DwhqGcWzCYnl5ui+cf0mg38EUB+yhHR98MbbwK/hLcqKc/lVBcTduKR52T3SmvUb iyNmhx+yJzBZX/itRNJv4grj0OEcECgscu+ciNvUHT5CodCmkkSSvQuLgVzjAJFv+LrbBQwev/n es5MECFh+dNJXPoS08+/O6ZTbohFveCuyj/ait8LITAFukVxh5F X-Google-Smtp-Source: AGHT+IFQA8fREG6SEfK6pfHHeM3jUko7CWc5WewahZNMAh7adOHCzvEcxLfVR2yW1dVrA+CEkw+CLw== X-Received: by 2002:ad4:4eea:0:b0:6d4:25c4:e77d with SMTP id 6a1803df08f44-6dc8cad5c5fmr102218166d6.34.1734186650978; Sat, 14 Dec 2024 06:30:50 -0800 (PST) Received: from gnus ([70.26.179.129]) by smtp.gmail.com with ESMTPSA id 6a1803df08f44-6dccd3630a9sm8020436d6.90.2024.12.14.06.30.50 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 14 Dec 2024 06:30:50 -0800 (PST) From: Suhail Singh To: Ihor Radchenko Cc: Suhail Singh , =?utf-8?Q?Tor-bj=C3=B6rn?= Claesson , emacs-devel@gnu.org, emacs-orgmode@gnu.org, Philip Kaludercic , Omar =?utf-8?Q?Antol=C3=ADn?= Camarena , Jonas Bernoulli , Juri Linkov , karthikchikmagalur@gmail.com, Visuwesh , charles.choi@yummymelon.com, Justin Burkett Subject: Re: [RFC] The best way to choose an "action" at point: context-menu-mode, transient, which-key or embark? In-Reply-To: <87bjxefuu8.fsf@localhost> (Ihor Radchenko's message of "Sat, 14 Dec 2024 09:59:59 +0000") References: <8734m28l9a.fsf@gmail.com> <87y120daue.fsf@localhost> <874j4m9ep6.fsf@gmail.com> <87h68gfqj1.fsf@localhost> <87pln3f3cc.fsf@localhost> <87jzd9ojj0.fsf@localhost> <87cyj0ajm9.fsf@gmail.com> <87zfm4s50x.fsf@localhost> <87wmh8s358.fsf@localhost> <87y11nwp9z.fsf@gmail.com> <87v7wd9a2h.fsf@localhost> <878qt7fbki.fsf@gmail.com> <87o71jwdxz.fsf@localhost> <87wmg6edr0.fsf@gmail.com> <87msgzh1dh.fsf@localhost> <8734irb383.fsf@gmail.com> <87bjxefuu8.fsf@localhost> Date: Sat, 14 Dec 2024 09:30:39 -0500 Message-ID: <87r06al4kw.fsf@gmail.com> User-Agent: Gnus/5.13 (Gnus v5.13) MIME-Version: 1.0 Content-Type: text/plain Received-SPF: pass client-ip=2607:f8b0:4864:20::f43; envelope-from=suhailsingh247@gmail.com; helo=mail-qv1-xf43.google.com X-Spam_score_int: -17 X-Spam_score: -1.8 X-Spam_bar: - X-Spam_report: (-1.8 / 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 autolearn=ham autolearn_force=no X-Spam_action: no action X-Mailman-Approved-At: Sat, 14 Dec 2024 09:36:04 -0500 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-bounces+larch=yhetil.org@gnu.org X-Migadu-Flow: FLOW_IN X-Migadu-Country: US X-Migadu-Spam-Score: -8.41 X-Spam-Score: -8.41 X-Migadu-Queue-Id: 1957A43C01 X-Migadu-Scanner: mx11.migadu.com X-TUID: JM21wcEuhTaw Ihor Radchenko writes: >> Hopefully, the description of each action will be a first-class member >> of the "List of possible actions". Or is the intent that the >> description be taken from the form representing an action (e.g. a defun, >> a lambda etc). > > Using a docstring sounds like a good idea. But it is a bit early to > decide these details. I'd like to discuss the more general design first. I agree that it may be premature to think about implementation details of how docstrings are stored etc. However, I would like to ensure that any discussion of the design of ways-to-choose-an-action-at-point include self-documentation and self-discovery in the desiderata. Perhaps this goes without saying, in which case please ignore this message. However, it's too important to be left to chance. -- Suhail