From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp2.migadu.com ([2001:41d0:403:4876::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms13.migadu.com with LMTPS id QB11MuNhn2blXQAAe85BDQ:P1 (envelope-from ) for ; Tue, 23 Jul 2024 07:55:16 +0000 Received: from aspmx1.migadu.com ([2001:41d0:403:4876::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp2.migadu.com with LMTPS id QB11MuNhn2blXQAAe85BDQ (envelope-from ) for ; Tue, 23 Jul 2024 09:55:15 +0200 X-Envelope-To: larch@yhetil.org Authentication-Results: aspmx1.migadu.com; dkim=none; 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=none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1721721315; 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; bh=mm8Xnxl1KrexNXKFByr0P5hLTmk+EGLoReTCzobV/uE=; b=ECCu8Gq+gM+M4GVL37IdSixdK7mCrgl3AQolkhe6EeWJpPAldfA0XgUZBD+2/uhGOjjzcv L3Vl+r992N6kEWhoNmsARt7mPL694iIOA4sPuD4+eo0MgsaecvwPmWWzj8uzbHh1b8YQrW 3EaLt717K5W5z6gmKolv12Jnnm/r2SHfn6v2VqxBea03ldvncgH65kgEsgUfQRalL9Vjja QwSySH7G96UG8Txz1fnMWFZxVwDSBq6HkW3u6sbil09PRtzpucH9ZKdcf49JullVFwAOeq BIgj5oXovKEvqU0AXJ6PXaCnLPhu5Pzob9LywNUI5lqx/5RsZq86DDEMkZBUDg== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=none; 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=none ARC-Seal: i=1; s=key1; d=yhetil.org; t=1721721315; a=rsa-sha256; cv=none; b=JVo70m4szDXYYENfhBaBFCrQBh7Cv6pcyX5J+2BGKpqA9Qet1IxtBebYwjLan8o6zzmsn/ fNSZNVn6Tx+LA2G12NwAed1WyblWlNnKe6pNuGDMU0MC5e7sEg4uSC27QT4sZ/Z3vZcPBI 47yZ9iifPybw+2vv0YmyvSWNzCrDI+vy0dTaMfWB+VYL4iHQCwVE6aeVmewQOLX5zk26aq CUMonF+p0ibtT6OxNws00bWPLyi548dIoLjN1h93sTTcEHj1MFK4reVF4gV3hqlPfb1eO6 j3Wu7pgzbA0WsdVFEkuAqVpe/7hKH1FCPyc4y2i55Mmaq1+JFHfarSB5kSGU/A== 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 55E387D4BF for ; Tue, 23 Jul 2024 09:55:15 +0200 (CEST) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1sWALj-0006AW-HL; Tue, 23 Jul 2024 03:54:19 -0400 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 1sWALg-00063a-Lc for emacs-orgmode@gnu.org; Tue, 23 Jul 2024 03:54:16 -0400 Received: from k-7.ch ([185.31.100.96]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1sWALe-0002ie-Gn for emacs-orgmode@gnu.org; Tue, 23 Jul 2024 03:54:15 -0400 Received: from van (_gateway [192.168.1.1]) (Authenticated sender: seb) by k-7.ch (Postfix) with ESMTPSA id 32403E810D; Tue, 23 Jul 2024 09:54:11 +0200 (CEST) From: =?utf-8?Q?S=C3=A9bastien_Gendre?= To: Ihor Radchenko Cc: =?utf-8?Q?Andr=C3=A1s?= Simonyi , emacs-orgmode@gnu.org Subject: Re: org-cite-insert function docstring and documentation don't tell how to validate In-Reply-To: <87ed7kshmw.fsf@localhost> (Ihor Radchenko's message of "Tue, 23 Jul 2024 07:16:07 +0000") References: <87le1vrr09.fsf@k-7.ch> <877cdcsqlm.fsf@k-7.ch> <87ed7kshmw.fsf@localhost> User-Agent: mu4e 1.12.1; emacs 29.4 Date: Tue, 23 Jul 2024 09:54:10 +0200 Message-ID: <87jzhctufx.fsf@k-7.ch> MIME-Version: 1.0 Content-Type: multipart/signed; boundary="=-=-="; micalg=pgp-sha256; protocol="application/pgp-signature" Received-SPF: pass client-ip=185.31.100.96; envelope-from=seb@k-7.ch; helo=k-7.ch 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, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 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-bounces+larch=yhetil.org@gnu.org X-Migadu-Country: US X-Migadu-Flow: FLOW_IN X-Spam-Score: -8.51 X-Migadu-Queue-Id: 55E387D4BF X-Migadu-Scanner: mx10.migadu.com X-Migadu-Spam-Score: -8.51 X-TUID: C99FvAd5P2Km --=-=-= Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable What does "empty input exists" mean=C2=A0? Ihor Radchenko writes: > S=C3=A9bastien Gendre writes: > >> I have found that on Vanilla Emacs, it's "C-j". >> >> And with Vertico, it's "Alt-Enter". >> >> I=C2=A0wonder if we need to document it. In the docstring of >> "org-cite-insert" and in the documentation. Of course, not mentioning >> every possible shortcut. But at least telling how the command >> "org-cite-insert" behave. And the general idea of how user can stop the >> reference selection. > > The minibuffer prompt in `org-cite-insert' says: "empty input exits" > IMHO, it is more than enough. In fact, better than shelving it deep into > the manual/docstring. --=-=-= Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQI/BAEBCAApFiEEaA9vw9ypVj1kP0tAtYb3x3I54p4FAmafYaILHHNlYkBrLTcu Y2gACgkQtYb3x3I54p6uHw/+JDXx8VeQZJluV5tSMt2LIN2CosTJ/8PRAEeSlJik 6S6BkjSQM4EofIQ6gp9wzB2PiT1/MXTb48TNEbvkk/q8qzoZlDdoC/FvZ15cf16Z +LEGdn8egJ9lNnj9u/MgVEfOC2D4sk2LQG8GYwZPFOMXpdD3HZi3A4/36uxsaToS GsIZn1lUQ1r3kVfptdGe00VAX5M2j18QkQbQj46KSglW5OTvct9pljoyTw++bCD/ UDryLFIuHQNk9fcvoFDuUJgfWKUOtokYJaJX/XKaAGQdbN4/iyFXYzJ1VD7ySDcJ meME60LwhTST+QSl3Ksac0G8i6mFasEtq+MXbfuyDVwG27cUeU3vIj5L7450aqT3 Vjb55buxbBvvBv1GqjqPIAEO+8XQGtJzhqG0qiwGw675usw8QfPAcelrW6upyMfA XB1fTx5bDQu5ZP9GooLJAvo1VCJooLSR5etVqFy62d16D0k4oOAru4VW1AlioYbz dfzhoZCj9cNtNnz999XYgSe25BQEYb5et8AQsVXaLxWtbU9jfC33qq9gq7m1iDHM 0bp7aIJQRi0gbw70tSLX3Rme/fk9Jf+4A6Zr5sqsc/3eoWOJkVgXKwxsr4mjLEgV el5Xx+U/k8hPUpCYlXXop8MDJLH0fWlueA1p5Sfzjai43waizsoOsIdo/c0mDhbF 43w= =vHnF -----END PGP SIGNATURE----- --=-=-=--