diff --git a/doc/src/sgml/brin.sgml b/doc/src/sgml/brin.sgml
index 2202b7a..c1b6e1a 100644
--- a/doc/src/sgml/brin.sgml
+++ b/doc/src/sgml/brin.sgml
@@ -58,6 +58,24 @@
store more index entries), but at the same time the summary data stored can
be more precise and more data blocks can be skipped during an index scan.
+
+
+ Index Maintenance
+
+
+ At the time of creation, all existing index pages are scanned and a
+ summary is created for each range, including the possibly-incomplete
+ range at the end. As new pages are filled with data, page ranges that
+ are already summarized will cause the summary information to be updated
+ with the new tuples. When a new page is created that does not fall
+ into the last summarized range, that range does not automatically
+ acquire a summary tuple; those insertions remain unsummarized until
+ a summarization run is invoked later, which creates initial summaries
+ for all unsummarized ranges. This process can be invoked manually
+ by the brin_summarize_new_pages(regclass) function,
+ or automatically when VACUUM processes the table.
+
+
diff --git a/doc/src/sgml/func.sgml b/doc/src/sgml/func.sgml
index 81c1d3f..577d3bd 100644
--- a/doc/src/sgml/func.sgml
+++ b/doc/src/sgml/func.sgml
@@ -18281,6 +18281,48 @@ SELECT (pg_stat_file('filename')).modification;
+
+ Indexing Helper Functions
+
+
+ brin_summarize_new_values
+
+
+
+ shows the functions
+ available for index maintenance tasks.
+
+
+
+ Indexing Helper Functions
+
+
+ Name Return Type Description
+
+
+
+
+
+ brin_summarize_new_values(index_oid)
+
+ integer
+ summarize page ranges not already summarized
+
+
+
+
+
+
+ brin_summarize_new_values receives a BRIN index OID as
+ argument; it scans the table that the index is for, looking for pages
+ that are not currently summarized. Then the data in those pages is
+ scanned and a new summary index tuple is constructed and inserted into
+ the index. It returns the number of new page range summaries that were
+ inserted into the index.
+
+
+
+