[elpa] externals/denote 158d94735f 19/32: Expand denote-org-link-to-heading doc string to explain some technicalities

[ELPA Syncer]

branch: externals/denote
commit 158d94735f1f740192f980ef9b68b347b7ac16b2
Author: Protesilaos Stavrou <info@protesilaos.com>
Commit: Protesilaos Stavrou <info@protesilaos.com>

    Expand denote-org-link-to-heading doc string to explain some technicalities
---
 denote-org.el | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/denote-org.el b/denote-org.el
index 0afc9f9c56..37ea542f7c 100644
--- a/denote-org.el
+++ b/denote-org.el
@@ -97,7 +97,18 @@ See the `:link' property of `denote-file-types'."
 
 The resulting link has the following pattern:
 
-[[denote:IDENTIFIER::#ORG-HEADING-CUSTOM-ID]][File title::Heading text]]."
+[[denote:IDENTIFIER::#ORG-HEADING-CUSTOM-ID]][File title::Heading text]].
+
+Because only Org files can have links to individual headings,
+limit the list of possible files to those which include the .org
+file extension (remember that Denote works with many file types,
+per the user option `denote-file-type').
+
+The user option `denote-org-store-link-to-heading' determined
+whether the `org-store-link' function can save a link to the
+current heading.  Such links look the same as those of this
+command, though the functionality defined herein is independent
+of it."
   (declare (interactive-only t))
   (interactive)
   (when-let ((file (denote-file-prompt ".*\\.org"))