Max Nikulin <maniku...@gmail.com> writes: >> I guess we can just make it into a command. I see no downsides. > > At least it was an intentional change: > > commit 471ddbd14e2bb3e7689cdca5e6a461e54b8be9d8 > Author: Bastien Guerry > Date: Thu Jan 26 09:18:10 2012 +0100 > > Improve `org-insert-drawer' and related documentation.
Thanks for checking! I still don't understand why it was turned into a function since I cannot find the relevant discussion. Bastien? If not making `org-insert-property-drawer' a command back, we can amend the manual, as suggested. See the attached patch.
>From 3b930ccaf4f53d203cbbe84001d4d861cbcbb262 Mon Sep 17 00:00:00 2001 Message-Id: <3b930ccaf4f53d203cbbe84001d4d861cbcbb262.1672911565.git.yanta...@posteo.net> From: Ihor Radchenko <yanta...@posteo.net> Date: Thu, 5 Jan 2023 12:38:26 +0300 Subject: [PATCH] org-manual.org: Clarify that `org-insert-property-drawer' is not a command * doc/org-manual.org (Drawers): Emphasize that `org-insert-property-drawer' is not interactive command, but a function. Reported-by: alain.coch...@unistra.fr Link: https://orgmode.org/list/tp3pbi$dk$1...@ciao.gmane.io --- doc/org-manual.org | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/doc/org-manual.org b/doc/org-manual.org index f3b77ebad..4466af8e4 100644 --- a/doc/org-manual.org +++ b/doc/org-manual.org @@ -1253,11 +1253,12 @@ ** Drawers #+findex: org-insert-drawer You can interactively insert a drawer at point by calling ~org-insert-drawer~, which is bound to {{{kbd(C-c C-x d)}}}. With an -active region, this command puts the region inside the drawer. With -a prefix argument, this command calls ~org-insert-property-drawer~, -which creates a =PROPERTIES= drawer right below the current headline. -Org mode uses this special drawer for storing properties (see -[[*Properties and Columns]]). You cannot use it for anything else. +active region, this command puts the region inside the drawer. With a +prefix argument, this command calls non-interactive function +~org-insert-property-drawer~, which creates a =PROPERTIES= drawer +right below the current headline. Org mode uses this special drawer +for storing properties (see [[*Properties and Columns]]). You cannot use +it for anything else. Completion over drawer keywords is also possible using {{{kbd(M-TAB)}}}[fn:6]. -- 2.38.1
-- Ihor Radchenko // yantar92, Org mode contributor, Learn more about Org mode at <https://orgmode.org/>. Support Org development at <https://liberapay.com/org-mode>, or support my work at <https://liberapay.com/yantar92>
