Michael Paquier f98dbdeb51 Add "ABI_compatibility" regions to wait_event_names.txt The current design behind the automatic generation of the C code and documentation related to wait events introduced in `fa88928470` does not offer a way to attach new wait events without breaking ABI compatibility, as all the events are forcibly reordered for each section in the input file wait_event_names.txt. Adding new wait events to stable branches is something that has happened in the past, `0b6517a3b7` being a recent example of that with VERSION_FILE_SYNC, so we need a way to generate any C code for wait events while maintaining compatibility on stable branches already released. This commit solves this issue by adding a new region called "ABI_compatibility" (keyword could be updated to something else if someone had a better idea) to each section of wait_event_names.txt, so as one can add new wait events to stable branches in wait_event_names.txt while keeping the code ABI-compatible. "ABI_compatibility" has no impact on the documentation generated: all the wait events of one section are still alphabetically ordered. LWLock and Lock sections generate their C code elsewhere, so they do not need an "ABI_compatibility" region. For example, let's imagine a wait_event_names.txt like that: Section: ClassName - Foo FOO_1 "Waiting in Foo 1" FOO_2 "Waiting in Foo 2" ABI_compatibility: NEW_FOO_1 "Waiting in New Foo 1" NEW_BAR_1 "Waiting in New Bar 1" This results in the following enum, where the events in the ABI region are listed last with the same ordering as in wait_event_names.txt: typedef enum { WAIT_EVENT_FOO_1, WAIT_EVENT_FOO_2, WAIT_EVENT_NEW_FOO_1, WAIT_EVENT_NEW_BAR_1 } WaitEventFoo; New wait events added in stable branches should be added at the end of each ABI_compatibility region, and ABI_compatibility should remain empty on HEAD and unreleased stable branches. This design has been suggested by Noah Misch and me. Reported-by: Noah Misch Author: Bertrand Drouvot Reviewed-by: Michael Paquier Discussion: https://postgr.es/m/20240317183114.16@rfd.leadboat.com		2 years ago
config	Remove AIX support	2 years ago
contrib	postgres_fdw: Remove useless ternary expression.	2 years ago
doc	Add basic JSON_TABLE() functionality	2 years ago
src	Add "ABI_compatibility" regions to wait_event_names.txt	2 years ago
.cirrus.star	Remove duplicate words in docs and code comments.	2 years ago
.cirrus.tasks.yml	ci: macos: Choose python version	2 years ago
.cirrus.yml	ci: Make compute resources for CI configurable	2 years ago
.dir-locals.el	Make Emacs perl-mode indent more like perltidy.	7 years ago
.editorconfig	Add .editorconfig	6 years ago
.git-blame-ignore-revs	Add commit `64e401b62b` to .git-blame-ignore-revs.	2 years ago
.gitattributes	Remove non-existing file from .gitattributes	2 years ago
.gitignore	Update top-level .gitignore.	3 years ago
COPYRIGHT	Update copyright for 2024	2 years ago
GNUmakefile.in	make dist uses git archive	2 years ago
HISTORY	Canonicalize some URLs	6 years ago
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 --copy-file-range option to pg_upgrade.	2 years ago
configure.ac	Add --copy-file-range option to pg_upgrade.	2 years ago
meson.build	Silence meson warning	2 years ago
meson_options.txt	Add backend support for injection points	2 years 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/.