On 11/24/25 2:57 AM, Ihor Radchenko wrote:
Your guess is plausible, although org-archive pre-dates git history records. Do you want to fix the docstring yourself and send a patch?
Sure. I updated the docstring please check the patch in attachment.
I will still provide more specific comments inline for instruction purposes.
Thanks for the detailed instruction. I learned a lot. All my best Xiaoduan Chang
From 201053694cb00f81ffe71aac11c489dc31cef383 Mon Sep 17 00:00:00 2001 From: Xiaoduan Chang <[email protected]> Date: Tue, 25 Nov 2025 23:28:37 +0800 Subject: [PATCH] lisp/org-archive.el: Update org-archive-subtree docstring. * lisp/org-archive.el (org-archive-subtree): Update docstring to reflect that TODO state is only changed when org-archive-mark-done is set to non-nil. TINYCHANGE --- lisp/org-archive.el | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/lisp/org-archive.el b/lisp/org-archive.el index e3d5c423b..dc1a6ca57 100644 --- a/lisp/org-archive.el +++ b/lisp/org-archive.el @@ -221,8 +221,9 @@ an error if LOCATION is not a valid archive location." "Move the current subtree to the archive. The archive can be a certain top-level heading in the current file, or in a different file. The tree will be moved to that -location, the subtree heading be marked DONE, and the current -time will be added. +location. If `org-archive-mark-done' is non-nil and the subtree +has a TODO keyword, the subtree heading will be marked DONE. +And the current time will be added. When called with a single prefix argument FIND-DONE, find whole trees without any open TODO items and archive them (after getting -- 2.51.0
