From 164f76a4740d813f024d83173503b1cd5fdd0bae Mon Sep 17 00:00:00 2001 From: Eli Zaretskii Date: Sat, 6 Dec 2025 14:18:55 +0200 Subject: [PATCH] ; Improve documentation of 'fill-region-as-paragraph' * lisp/textmodes/fill.el (fill-region-as-paragraph-default) (fill-separate-heterogeneous-words-with-space): Doc fixes. (Bug#79575) --- lisp/textmodes/fill.el | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/lisp/textmodes/fill.el b/lisp/textmodes/fill.el index a6858fdea8b..b291cbef390 100644 --- a/lisp/textmodes/fill.el +++ b/lisp/textmodes/fill.el @@ -50,7 +50,7 @@ A value of nil means that any change in indentation starts a new paragraph." :safe #'booleanp) (defcustom fill-separate-heterogeneous-words-with-space nil - "Non-nil means to use a space to separate words of a different kind. + "Non-nil means to use a space to separate words of different scripts. For example, when an English word at the end of a line and a CJK word at the beginning of the next line are joined into a single line, they will be separated by a space if this variable is non-nil. @@ -657,6 +657,10 @@ functions. (In most cases, the variable `fill-column' controls the width.) It leaves point at the beginning of the line following the region. +Note that how paragraph breaks are removed in text that includes +characters from different scripts is affected by the value +of `fill-separate-heterogeneous-words-with-space', which see. + Normally, the command performs justification according to the `current-justification' function, but with a prefix arg, it does full justification instead.