Home • Explore • Blog • CI
☰



postgresql
1st chunk of `doc/src/sgml/release.sgml`
c7bcc8b8f64d080cabab6621b370b0c2bbbfed51f03762a40000000100000c70
<!-- doc/src/sgml/release.sgml -->
<!--

Typical markup:

&<>                             use & escapes
PostgreSQL                      <productname>
postgresql.conf, pg_hba.conf    <filename>
\<[A-Z][A-Z_ ]+[A-Z_]\>         <command>, <literal>, <envar>, <acronym>
\<[A-Za-z_][A-Za-z0-9_]+()      <function>
\-\-?[A-Za-z_]+[-A-Za-z_]*      <option> (use backslashes to avoid SGML markup)
\<[A-Za-z_]+/[A-Za-z_]+\>       <filename>
psql                            <application>
pg_[A-Za-z0-9_]+                <application>, <structname>
\<[A-Z][A-Z][A-Z_ ]*\>          <type>
\<[a-z]+_[a-z_]+\>              <varname>, <structfield>
                                <systemitem class="osname">

wrap long lines

For new features, add links to the documentation sections.

-->

<appendix id="release">
 <title>Release Notes</title>

  <para>
   The release notes contain the significant changes in each
   <productname>PostgreSQL</productname> release, with major features and migration
   issues listed at the top.  The release notes do not contain changes
   that affect only a few users or changes that are internal and therefore not
   user-visible.  For example, the optimizer is improved in almost every
   release, but the improvements are usually observed by users as simply
   faster queries.
  </para>

  <para>
   A complete list of changes for each release can be obtained by
   viewing the <link linkend="git">Git</link> logs for each release.
   The <ulink
   url="https://www.postgresql.org/list/pgsql-committers/"><literal>pgsql-committers</literal>
   email list</ulink> records all source code changes as well.  There is also
   a <ulink url="https://git.postgresql.org/gitweb/?p=postgresql.git;a=summary">web
   interface</ulink> that shows changes to specific files.
  </para>

  <para>
   The name appearing next to each item represents the major developer for
   that item.  Of course all changes involve community discussion and patch
   review, so each item is truly a community effort.
  </para>

  <para id="release-commit-links">
   Section markers (&sect;) in the release notes link to <ulink
   url="https://git.postgresql.org/gitweb/?p=postgresql.git"><application>gitweb</application></ulink>
   pages which show the primary <application>git</application> commit
   messages and source tree changes responsible for the release note item.
   There might be additional <application>git</application> commits which
   are not shown.
  </para>

<!--
  When beginning a new major-release series, create a new release-NN.sgml
  file, removing the previous one, and change the &-reference here.
  Don't forget to update filelist.sgml.

  The reason for keeping each branch's release notes in a differently-named
  file is to reduce confusion when preparing minor-release updates.
  All the active branches have to be edited concurrently when doing that.
-->

&release-18;

 <sect1 id="release-prior">
  <title>Prior Releases</title>

  <para>
   Release notes for prior release branches can be found at
   <ulink url="https://www.postgresql.org/docs/release/"><literal>https://www.postgresql.org/docs/release/</literal></ulink>
  </para>
 </sect1>

</appendix>
Title: PostgreSQL Release Notes Overview
Summary
This section introduces the release notes for PostgreSQL, explaining their purpose and structure. The notes highlight significant changes, major features, and migration issues for each PostgreSQL release. They do not include minor changes affecting few users or internal modifications. The document outlines how to access a complete list of changes through Git logs, the pgsql-committers email list, and a web interface. It also explains the format of the release notes, including the use of section markers that link to gitweb pages showing primary git commit messages and source tree changes. The document mentions that release notes for prior versions can be found on the PostgreSQL website.