[Emacs-diffs] emacs-26 5e69219: Document print-escape-control-characters

[Paul Eggert]

branch: emacs-26
commit 5e69219fdaf37445e4508c3413084d66057bc99f
Author: Paul Eggert <address@hidden>
Commit: Paul Eggert <address@hidden>

    Document print-escape-control-characters
    
    * doc/lispref/streams.texi, etc/NEWS: Add doc.
---
 doc/lispref/streams.texi |  7 +++++++
 etc/NEWS                 | 10 +++++++---
 2 files changed, 14 insertions(+), 3 deletions(-)

diff --git a/doc/lispref/streams.texi b/doc/lispref/streams.texi
index 6172392..4c8a747 100644
--- 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
 
address@hidden print-escape-control-characters
+If this variable is address@hidden, control characters in strings are
+printed as backslash sequences by the print functions @code{prin1} and
address@hidden that print with quoting.  If this variable and
address@hidden are both address@hidden, the latter takes
+precedences for newlines and formfeeds.
+
 @defvar print-escape-nonascii
 If this variable is address@hidden, then unibyte address@hidden
 characters in strings are unconditionally printed as backslash sequences
diff --git a/etc/NEWS b/etc/NEWS
index a8880d0..cb4048d 100644
--- 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.
 
@@ -1747,6 +1747,10 @@ 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
 OFFSET is a count of seconds east of Universal Time, and the string