David Rowley 530050d8d2 Add code comment explaining ins_since_vacuum and aborted inserts Sami complained that there's a discrepancy between n_mod_since_analyze and n_ins_since_vacuum, as the former only accounts for committed changes and the latter tracks committed and aborted inserts. Nobody seemed overly concerned that this would cause any concerning issues. The repercussions, from what I can tell, are limited to causing an autovacuum to trigger for inserts sooner than it otherwise might. For typical ratios of commits to aborts, it's unlikely to ever be noticed. Fixing things to make it so n_ins_since_vacuum only displays committed inserts would require an additional field in PgStat_TableCounts, which does not quite seem worthwhile at this stage. This commit just adds a comment with some details to mention that we know about it, which will hopefully prevent repeat discussions. Reported-by: Sami Imseih <samimseih@gmail.com> Author: David Rowley <drowleyml@gmail.com> Reviewed-by: Sami Imseih <samimseih@gmail.com> Discussion: https://postgr.es/m/CAApHDvpgV3a-R2EGmPOh0L-x3pHbZpM3y4dySWfy+UqUazwDQA@mail.gmail.com		10 months ago
.github	Add CODE_OF_CONDUCT.md, CONTRIBUTING.md, and SECURITY.md.	2 years ago
config	Update config.guess and config.sub	10 months ago
contrib	Improve various new-to-v18 appendStringInfo calls	10 months ago
doc	Doc: remove long-obsolete advice about generated constraint names.	10 months ago
src	Add code comment explaining ins_since_vacuum and aborted inserts	10 months ago
.cirrus.star	Remove duplicate words in docs and code comments.	2 years ago
.cirrus.tasks.yml	ci: Check for missing dependencies in meson builds	10 months ago
.cirrus.yml	ci: Test NetBSD and OpenBSD	12 months ago
.dir-locals.el	…
.editorconfig	Add script to keep .editorconfig in sync with .gitattributes	1 year ago
.git-blame-ignore-revs	Add commit `e1a8b1ad58` to .git-blame-ignore-revs.	10 months ago
.gitattributes	Add script to keep .editorconfig in sync with .gitattributes	1 year ago
.gitignore	Update top-level .gitignore.	3 years ago
.mailmap	Add a Git .mailmap file	1 year ago
COPYRIGHT	Update copyright for 2025	1 year ago
GNUmakefile.in	Allow selecting the git revision to be packaged by "make dist".	2 years ago
HISTORY	…
Makefile	Remove AIX support	2 years ago
README.md	Revise the style of a paragraph in README.md.	2 years ago
aclocal.m4	autoconf: Move export_dynamic determination to configure	3 years ago
configure	Add support for basic NUMA awareness	10 months ago
configure.ac	Add support for basic NUMA awareness	10 months ago
meson.build	Add support for basic NUMA awareness	10 months ago
meson_options.txt	Add support for basic NUMA awareness	10 months ago

README.md

PostgreSQL Database Management System

This directory contains the source code distribution of the PostgreSQL database management system.

PostgreSQL is an advanced object-relational database management system that supports an extended subset of the SQL standard, including transactions, foreign keys, subqueries, triggers, user-defined types and functions. This distribution also contains C language bindings.

General documentation about this version of PostgreSQL can be found at https://www.postgresql.org/docs/devel/. In particular, information about building PostgreSQL from the source code can be found at https://www.postgresql.org/docs/devel/installation.html.

The latest version of this software, and related software, may be obtained at https://www.postgresql.org/download/. For more information look at our web site located at https://www.postgresql.org/.