From 017475a70ed51b69ebe41610e0dd1299bda1bfe3 Mon Sep 17 00:00:00 2001 From: Stefan Monnier Date: Fri, 16 Jun 2023 13:35:36 -0400 Subject: [PATCH] * doc/lispref/streams.texi (Output Variables): Document `pp-default-function` --- doc/lispref/streams.texi | 9 +++++++++ etc/NEWS | 7 +++++++ 2 files changed, 16 insertions(+) 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 -- 2.39.2