Mention highlight-confusing-reorderings in doc string

* src/xdisp.c (Fbidi_find_overridden_directionality): Mention
highlight-confusing-reorderings.

2 files changed, 5 insertions, 1 deletions

diff --git a/etc/NEWS b/etc/NEWS
index cddf0111873..0cf11b741fe 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -450,6 +450,7 @@ the corresponding deleted frame.
 By default, it contains 'C-c <left>' and 'C-c <right>' to browse
 the history of tab window configurations back and forward.
 
+---
 ** Better detection of text suspiciously reordered on display.
 The function 'bidi-find-overridden-directionality' has been extended
 to detect reordering effects produced by embeddings and isolates
diff --git a/src/xdisp.c b/src/xdisp.c
index 1e766e4a192..62c8f9d4d93 100644
--- a/src/xdisp.c
+++ b/src/xdisp.c
@@ -25012,7 +25012,10 @@ function `get-char-code-property' for a way to inquire about the
 directionality is weak or neutral, such as numbers or punctuation
 characters, can be forced to display in a very different place with
 respect of its surrounding characters, so as to make the surrounding
-text confuse the user regarding what the text says.  */)
+text confuse the user regarding what the text says.
+
+Also see the `highlight-confusing-reorderings' function, which can be
+useful in similar circumstances as this function.  */)
   (Lisp_Object from, Lisp_Object to, Lisp_Object object, Lisp_Object base_dir)
 {
   struct buffer *buf = current_buffer;