branch: externals/denote
commit 2193501cef4e91bb7b8d4d436484ea429ddd2084
Author: Protesilaos Stavrou <i...@protesilaos.com>
Commit: Protesilaos Stavrou <i...@protesilaos.com>
Change default value of denote-link-use-org-id
This ensures that we provide the best experience for Org users
out-of-the-box. The 'id:' hyperlink type is standard, making our notes
interoperable.
This change should not have negative implications for existing users.
We have already taken care to ensure that links from Org notes to other
file type notes (e.g. Markdown) use the 'denote:' hyperlink type. In
other words, we apply the standard when appropriate, else fall back to
our own mechanism.
Thanks to Kaushal Modi and Peter Prevos for the feedback in issue 27
over at the GitHub mirror:
<https://github.com/protesilaos/denote/issues/27>.
---
README.org | 7 +++++--
denote-link.el | 8 ++++----
2 files changed, 9 insertions(+), 6 deletions(-)
diff --git a/README.org b/README.org
index c91d70cb00..6b8181d029 100644
--- a/README.org
+++ b/README.org
@@ -641,9 +641,12 @@ When ~denote-link~ is called with a prefix argument (=C-u=
by default)
it formats links like =[[denote:IDENTIFIER]]=. The user might prefer
its simplicity.
+[ Default value of ~denote-link-use-org-id~ changed as part of
+ {{{development-version}}} ]
+
#+vindex: denote-link-use-org-id
-When the user option ~denote-link-use-org-id~ is set to non-nil (default
-is nil), inserted links in Org notes that target other Org notes will
+When the user option ~denote-link-use-org-id~ is set to non-nil (the
+default), inserted links in Org notes that target other Org notes will
use the standard =id:= type so the format is =[[id:IDENTIFIER][TITLE]]=
(the title is omitted is ~denote-link~ is called with a prefix argument,
as explained above). When, however, an Org note links to a note in
diff --git a/denote-link.el b/denote-link.el
index 66b886640e..2003d2cecf 100644
--- a/denote-link.el
+++ b/denote-link.el
@@ -200,8 +200,8 @@ and/or the documentation string of `display-buffer'."
alist)
:group 'denote-link)
-(defcustom denote-link-use-org-id nil
- "When non-nil use the ID link type in Org files if appropriate.
+(defcustom denote-link-use-org-id t
+ "When non-nil use the ID link type in Org files, if appropriate.
Newly created links from Org notes which target other Org notes
will use the standard `id:' hyperlink type instead of the custom
@@ -213,9 +213,9 @@ other tools in the Org ecosystem.
When the value is nil, Denote links rely on the custom `denote:'
hyperlink type (which should behave the same as the standard
-`file:' type).
+`file:' link).
-Other files types beside Org always use the `denote:' links."
+Other file types beside Org always use the `denote:' links."
:type 'boolean
:group 'denote-link)
;;;###autoload (put 'denote-link-use-org-id 'safe-local-variable 'booleanp)
