* doc/lispref/streams.texi (Output Variables): Document `pp-default-function`

diff --git a/doc/lispref/streams.texi b/doc/lispref/streams.texi
index 89046a682492d8037bb197e1f33f058c7aa63d45..896cf4caab5a3cde118335b205e53f7610e7c577 100644 (file)
--- a/doc/lispref/streams.texi
+++ b/doc/lispref/streams.texi
@@ -981,6 +981,15 @@ Letter, Number, Punctuation, Symbol and Private-use
 having their own escape syntax such as newline.
 @end defvar
 
+@defopt pp-default-function
+This user variable specifies the function used by @code{pp} to prettify
+its output.  By default it uses @code{pp-fill} which attempts to
+strike a good balance between speed and generating natural looking output
+that fits within @code{fill-column}.  The previous default was
+@code{pp-28}, which tends to be faster but generate output that looks
+less natural and is less compact.
+@end defopt
+
 @node Output Overrides
 @section Overriding Output Variables
 @cindex overrides, in output functions

diff --git a/etc/NEWS b/etc/NEWS
index 61e6e161665dcef6897cf2373280272078b69401..2170323e74a9a237f9848fa27ad90356860d04db 100644 (file)
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -396,6 +396,13 @@ name as a string.  The new function
 'dictionary-completing-read-dictionary' can be used to prompt with
 completion based on dictionaries that the server supports.
 
+** Pp
+*** New 'pp-default-function' custom variable replaces 'pp-use-max-width'.
+
+*** New default pretty printing function, which tries to obey 'fill-column'.
+
+*** 'pp-to-string' takes an additional 'pp-function' argument.
+This arg specifies the prettifying algorithm to use.
 \f
 * New Modes and Packages in Emacs 30.1