Document print-escape-control-characters

* doc/lispref/streams.texi, etc/NEWS: Add doc.

diff --git a/doc/lispref/streams.texi b/doc/lispref/streams.texi
index 6172392274ade63a918df4c63dc6fa0c0393d546..4c8a747337488d3845e7df4296035ad1d3e63ef7 100644 (file)
--- a/doc/lispref/streams.texi
+++ b/doc/lispref/streams.texi
@@ -778,6 +778,13 @@ In the second expression, the local binding of
 @code{prin1}, but not during the printing of the result.
 @end defvar
 
+@defvar print-escape-control-characters
+If this variable is non-@code{nil}, control characters in strings are
+printed as backslash sequences by the print functions @code{prin1} and
+@code{print} that print with quoting.  If this variable and
+@code{print-escape-newlines} are both non-@code{nil}, the latter takes
+precedences for newlines and formfeeds.
+
 @defvar print-escape-nonascii
 If this variable is non-@code{nil}, then unibyte non-@acronym{ASCII}
 characters in strings are unconditionally printed as backslash sequences

diff --git a/etc/NEWS b/etc/NEWS
index a8880d0f323a40a87ea74cfd07bfe32f422f6abf..cb4048dee4a29060ae672fcddc0d187045f7113a 100644 (file)
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -1219,7 +1219,7 @@ backend", which has been updated to benefit from the new UI features.
 ** Term
 
 ---
-*** `term-char-mode' now makes its buffer read-only.
+*** 'term-char-mode' now makes its buffer read-only.
 
 The buffer is made read-only to prevent changes from being made by
 anything other than the process filter; and movements of point away
@@ -1228,8 +1228,8 @@ correct position after each command.  This is needed to avoid states
 which are inconsistent with the state of the terminal understood by
 the inferior process.
 
-New user options `term-char-mode-buffer-read-only' and
-`term-char-mode-point-at-process-mark' control these behaviors, and
+New user options 'term-char-mode-buffer-read-only' and
+'term-char-mode-point-at-process-mark' control these behaviors, and
 are non-nil by default.  Customize these options to nil if you want
 the previous behavior.
 
@@ -1746,6 +1746,10 @@ instead of 0.8, to avoid rounding glitches.
 when a symbol's value is changed.  This is used to implement the new
 debugger command 'debug-on-variable-change'.
 
++++
+** New variable 'print-escape-control-characters' causes 'prin1' and
+'print' to output control characters as backslash sequences.
+
 +++
 ** Time conversion functions that accept a time zone rule argument now
 allow it to be OFFSET or a list (OFFSET ABBR), where the integer