From 5e69219fdaf37445e4508c3413084d66057bc99f Mon Sep 17 00:00:00 2001 From: Paul Eggert Date: Tue, 27 Feb 2018 20:13:00 -0800 Subject: [PATCH] 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 6172392274a..4c8a7473374 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 +@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 a8880d0f323..cb4048dee4a 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. @@ -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 -- 2.39.5