branch: externals-release/org
commit ee4f5416c4772cf27b466c53197a652a896040d1
Author: Ihor Radchenko <yanta...@posteo.net>
Commit: Ihor Radchenko <yanta...@posteo.net>
org-emphasis-regexp-components: Clarify that it does not affect parser
* lisp/org.el (org-emphasis-regexp-components): Make it clear in the
docstring that changing this variable only affects visuals.
Reported-by: Christoffer Stjernlöf <a...@xkqr.org>
Link: https://orgmode.org/list/87wm97d7v0.fsf@localhost
---
lisp/org.el | 6 +++++-
1 file changed, 5 insertions(+), 1 deletion(-)
diff --git a/lisp/org.el b/lisp/org.el
index fe5f0a746f..4689016c83 100644
--- a/lisp/org.el
+++ b/lisp/org.el
@@ -3773,7 +3773,11 @@ After a match, the match groups contain these elements:
;; https://orgmode.org/list/b72cdc2b-72f6-43a8-ac70-e6e629576...@gmail.com
(defvar org-emphasis-regexp-components
'("-[:space:]('\"{" "-[:space:].,:!?;'\")}\\[" "[:space:]" "." 1)
- "Components used to build the regular expression for emphasis.
+ "Components used to build the regular expression for FONTIFYING emphasis.
+WARNING: This variable only affects visual fontification, but does not
+change Org markup. For example, it does not affect how emphasis markup
+is interpreted on export.
+
This is a list with five entries. Terminology: In an emphasis string
like \" *strong word* \", we call the initial space PREMATCH, the final
space POSTMATCH, the stars MARKERS, \"s\" and \"d\" are BORDER characters
