[elpa] externals/org-transclusion 18b81641e6 01/18: docs: Update docstring for org-transclusion-with-inhibit-read-only

[ELPA Syncer]

branch: externals/org-transclusion
commit 18b81641e622b8d8ce740d7bb0949551e12f87db
Author: Joseph Turner <joseph@breatheoutbreathe.in>
Commit: Joseph Turner <joseph@breatheoutbreathe.in>

    docs: Update docstring for org-transclusion-with-inhibit-read-only
---
 org-transclusion.el | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/org-transclusion.el b/org-transclusion.el
index 9015a851ee..a4930a1ff8 100644
--- a/org-transclusion.el
+++ b/org-transclusion.el
@@ -274,7 +274,9 @@ specific keybindings; namely:
 ;;;; Definining macros before they are used in the rest of package
 ;;;; Flycheck warns with "macro X defined too late"
 (defmacro org-transclusion-with-inhibit-read-only (&rest body)
-  "Run BODY with `'inhibit-read-only` t."
+  "Run BODY with `'inhibit-read-only` t.
+This macro is used instead of `with-silent-modifications' because
+Org mode's caching relies upon modification hooks to function."
   (declare (debug t) (indent 0))
   (let ((modified (make-symbol "modified")))
     `(let* ((,modified (buffer-modified-p))