From 77f16a7f5f6348e80411b2b7a4421b094be95434 Mon Sep 17 00:00:00 2001 From: Fujii Masao Date: Tue, 17 Mar 2026 23:17:49 +0900 Subject: [PATCH v4] doc: Clarify BUFFERS behavior without ANALYZE in EXPLAIN This commit clarifies the documentation for the BUFFERS option of EXPLAIN by explicitly describing its behavior when ANALYZE is not specified. Author: Ryo Matsumura Reviewed-by: Fujii Masao Discussion: https://postgr.es/m/TYRPR01MB13457D31085CB5B246DBBA1AFE845A@TYRPR01MB13457.jpnprd01.prod.outlook.com --- doc/src/sgml/ref/explain.sgml | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/doc/src/sgml/ref/explain.sgml b/doc/src/sgml/ref/explain.sgml index 7dee77fd366..5b8b521802e 100644 --- a/doc/src/sgml/ref/explain.sgml +++ b/doc/src/sgml/ref/explain.sgml @@ -202,7 +202,10 @@ ROLLBACK; The number of blocks shown for an upper-level node includes those used by all its child nodes. In text format, only non-zero values are printed. Buffers information is - automatically included when ANALYZE is used. + included by default when ANALYZE is used but + otherwise is not included by default. When this parameter is + TRUE without ANALYZE, + only buffer usage during the query planning phase is reported. -- 2.51.2