[nongnu] elpa/hyperdrive c740135a62 19/82: Change: (hyperdrive-org-link-full-url) Docstring

[ELPA Syncer]

branch: elpa/hyperdrive
commit c740135a628f72776f8a9af6585317b5c7fd2f77
Author: Joseph Turner <joseph@ushin.org>
Commit: Joseph Turner <joseph@ushin.org>

    Change: (hyperdrive-org-link-full-url) Docstring
---
 hyperdrive-org.el | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/hyperdrive-org.el b/hyperdrive-org.el
index 5aba1050a0..89626227ba 100644
--- a/hyperdrive-org.el
+++ b/hyperdrive-org.el
@@ -37,8 +37,15 @@
 (declare-function hyperdrive-dir--entry-at-point "hyperdrive-dir")
 
 (defcustom hyperdrive-org-link-full-url nil
-  "Use full \"hyper://\" URLs when storing and inserting links in Org files.
-Otherwise, follow setting in `org-link-file-path-type'."
+  "Always insert full \"hyper://\" URLs when linking to hyperdrive files.
+Otherwise, when inserting a link to the same hyperdrive Org file,
+
+- insert a relative path link when before the first heading, or
+- insert a heading text or CUSTOM_ID link when after the first heading
+
+Otherwise, when inserting a link to a different file in the same
+hyperdrive, insert a relative or absolute link according to
+`org-link-file-path-type'."
   :type 'boolean
   :group 'hyperdrive)