From: Marc-Oliver Ihm <marc@ihm.name>
To: "emacs-orgmode@gnu.org" <emacs-orgmode@gnu.org>
Subject: [PATCH] choices in org-id-find for handling missing ids
Date: Sat, 12 Jun 2021 16:16:28 +0200 (CEST) [thread overview]
Message-ID: <1607921150.924467.1623507388932@www.ud-mail.de> (raw)
[-- Attachment #1: Type: text/plain, Size: 1706 bytes --]
Hi,
please find attached a patch to allow more flexible handling of missing ids in org-id-find; some people (like me) tend to lose ids now and then and may benefit from more choices.
The current behaviour of calling org-id-update-id-locations is pretty perfect for situations where the id has been moved to another file (which will be the case in most situations, I guess). However, sometimes an id has simply been deleted and then searching for it in all files can not be helpful. Especially lisp-code calling org-id-find might want to handle things on its own.
To this goal, a new custom org-id-action-on-missing-id has been added; reproducing its description from the patch:
> (defcustom org-id-action-on-missing-id 'update
> "Special action to be taken, if `org-id-find' cannot find an id.
>
> With 'update (default), org-id-find will silently call
> `org-id-update-id-locations' and try again; this will help,
> e.g. if you have moved the id to another file.
>
> With 'exception, the exception 'not-found will be thrown, which
> can be useful, if `org-id-find' is called from within lisp and
> the caller wants to handle the situation.
>
> With 'error, a descriptive error will be raised, causing the
> current command to terminate."
> :group 'org-id
> :type '(choice
> (const :tag "Run `org-id-update-id-locations' if an id cannot be found" update)
> (const :tag "Throw exception `not-found'" exception)
> (const :tag "Raise an error" error)
> ))
the handling in org-id-find is straightforward.
The default corresponds to the current behaviour.
I would like to ask for opinions/discussion on this patch and maybe see it applied if found fit.
Best regards
Marc Ihm
[-- Attachment #2: 0001-choices-in-org-id-find-for-handling-missing-ids.patch --]
[-- Type: application/octet-stream, Size: 1993 bytes --]
From 70fb6f4ab26e9fae67d7b7900a0c6ec132199112 Mon Sep 17 00:00:00 2001
From: Marc Ihm <marc@ihm.name>
Date: Sat, 12 Jun 2021 15:49:50 +0200
Subject: [PATCH] choices in org-id-find for handling missing ids
---
lisp/org-id.el | 26 +++++++++++++++++++++++++-
1 file changed, 25 insertions(+), 1 deletion(-)
diff --git a/lisp/org-id.el b/lisp/org-id.el
index 784f41ccd..d5b818f85 100644
--- a/lisp/org-id.el
+++ b/lisp/org-id.el
@@ -248,6 +248,27 @@ This variable is only relevant when `org-id-track-globally' is set."
:group 'org-id
:type 'boolean)
+(defcustom org-id-action-on-missing-id 'update
+ "Special action to be taken, if `org-id-find' cannot find an id.
+
+With 'update (default), org-id-find will silently call
+`org-id-update-id-locations' and try again; this will help,
+e.g. if you have moved the id to another file.
+
+With 'exception, the exception 'not-found will be thrown, which
+can be useful, if `org-id-find' is called from within lisp and
+the caller wants to handle the situation.
+
+With 'error, a descriptive error will be raised, causing the
+current command to terminate."
+ :group 'org-id
+ :type '(choice
+ (const :tag "Run `org-id-update-id-locations' if an id cannot be found" update)
+ (const :tag "Throw exception `not-found'" exception)
+ (const :tag "Raise an error" error)
+ ))
+
+
;;; The API functions
;;;###autoload
@@ -347,7 +368,10 @@ With optional argument MARKERP, return the position as a new marker."
(when file
(setq where (org-id-find-id-in-file id file markerp)))
(unless where
- (org-id-update-id-locations nil t)
+ (cl-case org-id-action-on-missing-id
+ ('exception (throw 'not-found id))
+ ('error (error "Could not find id '%s'; but running `org-id-update-id-locations' might help" id))
+ (t (org-id-update-id-locations nil t)))
(setq file (org-id-find-id-file id))
(when file
(setq where (org-id-find-id-in-file id file markerp))))
--
2.30.2
next reply other threads:[~2021-06-12 14:17 UTC|newest]
Thread overview: 3+ messages / expand[flat|nested] mbox.gz Atom feed top
2021-06-12 14:16 Marc-Oliver Ihm [this message]
2021-06-13 5:51 ` [PATCH] choices in org-id-find for handling missing ids Marc Ihm
2021-09-26 6:24 ` Bastien
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
List information: https://www.orgmode.org/
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=1607921150.924467.1623507388932@www.ud-mail.de \
--to=marc@ihm.name \
--cc=emacs-orgmode@gnu.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).