From: Stefan Monnier <monnier@iro.umontreal.ca>
Date: Fri, 16 Jun 2023 17:35:36 +0000 (-0400)
Subject: * doc/lispref/streams.texi (Output Variables): Document `pp-default-function`
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=017475a70ed51b69ebe41610e0dd1299bda1bfe3;p=emacs.git

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

diff --git a/doc/lispref/streams.texi b/doc/lispref/streams.texi
index 89046a68249..896cf4caab5 100644
--- 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 61e6e161665..2170323e74a 100644
--- 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.
 
 * New Modes and Packages in Emacs 30.1