From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp2.migadu.com ([2001:41d0:303:e224::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms13.migadu.com with LMTPS id iOBXEsCfbWfrpwAAe85BDQ:P1 (envelope-from ) for ; Thu, 26 Dec 2024 18:26:08 +0000 Received: from aspmx1.migadu.com ([2001:41d0:303:e224::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp2.migadu.com with LMTPS id iOBXEsCfbWfrpwAAe85BDQ (envelope-from ) for ; Thu, 26 Dec 2024 19:26:08 +0100 X-Envelope-To: larch@yhetil.org Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20230601 header.b=QbNSEfSO; 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=1735237568; 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=OOSZAZ7wkWcfd6OJM+5kQSfdo3EBMn6IQXep4urrncI=; b=oz4KCZfE8AK+TOwN3znNZPviwfbgjI6uHjIPQnf9mdSr5/V4cHDWgJUafDUyGxckUknvo+ iv3L8lBVqpw5C3aQi3wkKXy1ypaBQh3nvGY10Kc2c+elxpAO4knJMThLWPhe3KnQky/cOK uEAW1O5AAcQpzT3Wy4ePV33BKw2nz70CfH8h4smarM0/mKMv+c4MqbQNMSq8kkF/OdeJry c00zf+jZO3kOayBQggfX6PpmMLIJoR4ka0TAKzHsU2wasKs8lFU9BqKEso9tx4IGMEBHHK RMnNAcI13OzT7kK4tG75/Ur/htZI2nzK3rotSj4jEjyp9nQdmZ5JqPHelE4GrA== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20230601 header.b=QbNSEfSO; 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-Seal: i=1; s=key1; d=yhetil.org; t=1735237568; a=rsa-sha256; cv=none; b=WSNt6WzKVcWHWvqfVEpcS30mVeKT6trie/H6IHJ1vq4fVya9mXGZoYNjBpPJ9RpJr7aPNi n34EmMK1s3K8P0+fAIsX7lOoGvrbmCnLP30nDkjPfRuCCVndKoksxPUkRbEGhXzRdpAT+e vscVlvFvD0ttC432I5ZShldiyixZYgpcELRkK1giopFT1TJnFKJfZHorwPA4CUAtP/oBqs AXuM6Fia7W4Ois/cz7nTDGmSN4CkGdhXHPRlxgu2Dgrfx6ip0adRc7E9NxjRhp/wI2YoM+ ANtbtgLKDOMSFRA939Fd4JgMM1u5zhHYcJkGvG3m314uQtAnNgZG9kI5/kUp7Q== 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 05BA665630 for ; Thu, 26 Dec 2024 19:26:07 +0100 (CET) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1tQsY6-0003xH-6H; Thu, 26 Dec 2024 13:25:30 -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 1tQsY4-0003x5-CU for emacs-orgmode@gnu.org; Thu, 26 Dec 2024 13:25:28 -0500 Received: from mail-pl1-x631.google.com ([2607:f8b0:4864:20::631]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1tQsY2-0000qA-SA for emacs-orgmode@gnu.org; Thu, 26 Dec 2024 13:25:28 -0500 Received: by mail-pl1-x631.google.com with SMTP id d9443c01a7336-2166360285dso78735795ad.1 for ; Thu, 26 Dec 2024 10:25:26 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1735237525; x=1735842325; darn=gnu.org; h=mime-version:message-id:date:references:in-reply-to:subject:cc:to :from:from:to:cc:subject:date:message-id:reply-to; bh=OOSZAZ7wkWcfd6OJM+5kQSfdo3EBMn6IQXep4urrncI=; b=QbNSEfSOvMBzWvnzaAC/CIhYTLV+hQECNQZllwL2Ff1zTXlUng4cjppTC/uHJ8crGn a0D9YrXorrE3tetAWP24ucMS3y9UxnkRydf7hLGEntxrGCipbLMUmp7387qCn4CUoHl5 ZcGGbcDUAYsnRhUU+0SrM+1PyzkhtfOKY8YD0quDsQIdRpyD/qx6PEzFs/Cg5GMozEfw ms7Si7roizt0tmQ/nx3rx238cMOZ+rY4Oqoc7r0SrsE1oTt5rIK/DrwDBfBpLNP84qxo XiN2zlBp2Lv8hMEeMxlxYxMfZEy/YW7t016rWtkVQ335ycsjWk7Cy1VV7pZG7Vc9h7B8 VvnQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1735237525; x=1735842325; h=mime-version: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=OOSZAZ7wkWcfd6OJM+5kQSfdo3EBMn6IQXep4urrncI=; b=A4F7HBgkOGAFwdTByXs/q7LKvE+5sL00Yx0y43YnfXMjcELsT5u7e0benp58k5Qyn4 noPAFgBRHGR+pvmwdgp88A1pa/hOq32gXXLmeamloGGs2Oe+oNlKFbHf67IeYpvtIH6x qJ4OcCL7ZvG0K6ghD9wcZoMYFnzyyj9MNrWMuzT2xjTASuQ5xexF23IpFt9exvoSOZi9 px4dMMrpKOuERh1eshIUp0PaIY2CjYXlgBeeGyWFLz0NdLIdlNVLv/5wdACxPZajZlVU y9lXC3QfPcug3c6prc4hqEU1x0IFO3d17SuiLNM+LSoPhGV8+2g6npib4PZJ8BOmi5Tb Rr5A== X-Gm-Message-State: AOJu0YzWe5nw5SA6KDl75KseqCGpCtrI4qa1vYZhya3Q0TesEuN0oCLH JWpQrquhCVhaPIAPgoLr7QEfVmhjqm/PuBZoo4I16BHo7sh8DM2g X-Gm-Gg: ASbGnctuGMb9/ESGMuNjDhfKA8yaMsjq3HCW5aAyiBCGZddhyV76vvfDH2m3SKitwfn I9um0FK3gy5JG2owJyhgXSukWS9RQQdfh4TkGkTmfa5DzIZlQtl9gxUD34Nz0pZC27RFV8hnGf4 rJJUo8DmujEQLegOAb0e39bCBziHt0xGRoP9wKlc01vLm2QIiRniLK8vOTh53g88QXbTmo5hZW/ dJAmbaa0dqRBlnVnGflrk22B9lGPgocBPaV2bl9YorfvwsFWlCJSHBO4R39JTpCDiaSbA== X-Google-Smtp-Source: AGHT+IFfsATsqE0JeH/6DQyD3eaoqgQI3CudYTkuL2K7EY1PhNQcI6kPMASE8+LrB7YnnDxXSokGQQ== X-Received: by 2002:a17:903:320a:b0:216:539d:37c3 with SMTP id d9443c01a7336-219e6e9e8d0mr344621025ad.24.1735237524796; Thu, 26 Dec 2024 10:25:24 -0800 (PST) Received: from localhost ([2600:8802:5726:2500:b0ad:16dc:5de1:fa47]) by smtp.gmail.com with ESMTPSA id d9443c01a7336-219dc9cde5bsm122857755ad.116.2024.12.26.10.25.24 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 26 Dec 2024 10:25:24 -0800 (PST) From: Karthik Chikmagalur To: Ihor Radchenko , Psionic K Cc: emacs-orgmode@gnu.org Subject: Re: Completions Registry In-Reply-To: <87v7v7zyn7.fsf@localhost> References: <87v7v7zyn7.fsf@localhost> Date: Thu, 26 Dec 2024 10:25:23 -0800 Message-ID: <8734ianvxo.fsf@gmail.com> MIME-Version: 1.0 Content-Type: text/plain Received-SPF: pass client-ip=2607:f8b0:4864:20::631; envelope-from=karthikchikmagalur@gmail.com; helo=mail-pl1-x631.google.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 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_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-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-Scanner: mx12.migadu.com X-Migadu-Spam-Score: -3.47 X-Spam-Score: -3.47 X-Migadu-Queue-Id: 05BA665630 X-TUID: S18o6gc9A/7/ >> Not just a problem for dslide but for org in general, any time a >> package adds keys to configure blocks or properties, these do not >> complete except through dabbrev etc. >> ... > > I am sorry, but it is not clear for me from your email what concrete > improvement you want to see. > > There are indeed sub-optimal historical decisions that could be improved > in the hindsight, but we are not going to remove the existing conventions. Maybe we can use this as a jump-off point to decide on a convention for libraries to supply keyword/special-property/babel-header-args documentation via Elisp? i.e. a Completions Registry. As discussed in the last Org meetup, I would like to write a CAPF that provides completions and annotations when typing in keywords provided by (loaded) Org libraries. The annotations providing inline documentation require this information to be available in the Elisp file. My understanding is that babel header-args are available in defvars like (defvar org-babel-header-args:sqlite '((db . :any) (header . :any) (echo . :any) (bail . :any) (csv . :any) (column . :any) (html . :any) (line . :any) (list . :any) (separator . :any) (nullvalue . :any) (readonly-p . ((yes no)))) "Sqlite specific header args.") and that the documentation for these cannot be included in the same variable as the cons-cell structure and the :any symbols have special meanings. Karthik