2010-09-20 22:08:53 +02:00
|
|
|
<!-- doc/src/sgml/release.sgml -->
|
2000-03-31 05:27:42 +02:00
|
|
|
<!--
|
2005-08-24 21:31:46 +02:00
|
|
|
|
|
|
|
Typical markup:
|
2005-08-24 21:34:34 +02:00
|
|
|
|
2006-09-18 23:45:10 +02:00
|
|
|
&<> use & escapes
|
2009-03-29 05:01:56 +02:00
|
|
|
PostgreSQL <productname>
|
2018-11-25 16:31:16 +01:00
|
|
|
postgresql.conf, pg_hba.conf <filename>
|
2020-05-15 04:36:21 +02:00
|
|
|
\<[A-Z][A-Z_ ]+[A-Z_]\> <command>, <literal>, <envar>, <acronym>
|
|
|
|
\<[A-Za-z_][A-Za-z0-9_]+() <function>
|
2017-04-25 01:04:28 +02:00
|
|
|
\-\-?[A-Za-z_]+[-A-Za-z_]* <option> (use backslashes to avoid SGML markup)
|
2020-05-15 04:36:21 +02:00
|
|
|
\<[A-Za-z_]+/[A-Za-z_]+\> <filename>
|
2010-03-21 01:43:40 +01:00
|
|
|
psql <application>
|
2010-03-20 04:12:52 +01:00
|
|
|
pg_[A-Za-z0-9_]+ <application>, <structname>
|
2020-05-15 04:36:21 +02:00
|
|
|
\<[A-Z][A-Z][A-Z_ ]*\> <type>
|
|
|
|
\<[a-z]+_[a-z_]+\> <varname>, <structfield>
|
2017-04-25 01:04:28 +02:00
|
|
|
<systemitem class="osname">
|
2006-09-22 17:41:12 +02:00
|
|
|
|
2012-05-09 04:51:17 +02:00
|
|
|
non-ASCII characters find using grep -P '[\x80-\xFF]'
|
2012-05-10 18:22:22 +02:00
|
|
|
convert to HTML4 named entity (&) escapes
|
2006-09-22 17:41:12 +02:00
|
|
|
|
|
|
|
official: http://www.w3.org/TR/html4/sgml/entities.html
|
|
|
|
one page: http://www.zipcon.net/~swhite/docs/computers/browsers/entities_page.html
|
|
|
|
other lists: http://www.zipcon.net/~swhite/docs/computers/browsers/entities.html
|
|
|
|
http://www.zipcon.net/~swhite/docs/computers/browsers/entities_page.html
|
2018-07-16 10:44:06 +02:00
|
|
|
https://en.wikipedia.org/wiki/List_of_XML_and_HTML_character_entity_references
|
2006-09-22 17:41:12 +02:00
|
|
|
|
2018-05-01 15:26:11 +02:00
|
|
|
We cannot use UTF8 because back branches still use SGML Docbook,
|
2018-05-02 14:33:36 +02:00
|
|
|
which does not support it. Also, rendering engines have to
|
|
|
|
support the referenced characters.
|
2006-09-22 17:41:12 +02:00
|
|
|
|
2018-05-01 15:26:11 +02:00
|
|
|
Do not use numeric _UTF_ numeric character escapes (&#nnn;),
|
|
|
|
we can only use Latin1.
|
2012-05-10 18:22:22 +02:00
|
|
|
|
|
|
|
Example: Alvaro Herrera is Álvaro Herrera
|
2020-05-05 18:42:55 +02:00
|
|
|
Find non-ASCII characters (remove 'X'):
|
|
|
|
grep -X-color='auto' -P -n "[\x80-\xFF]"
|
2011-10-12 23:20:05 +02:00
|
|
|
|
2006-09-19 01:19:50 +02:00
|
|
|
wrap long lines
|
2005-11-15 23:16:03 +01:00
|
|
|
|
2014-02-11 02:48:04 +01:00
|
|
|
For new features, add links to the documentation sections.
|
2005-11-15 23:16:03 +01:00
|
|
|
|
2000-03-31 05:27:42 +02:00
|
|
|
-->
|
|
|
|
|
2001-12-23 19:20:05 +01:00
|
|
|
<appendix id="release">
|
|
|
|
<title>Release Notes</title>
|
1998-03-01 09:16:16 +01:00
|
|
|
|
2007-12-11 00:37:49 +01:00
|
|
|
<para>
|
2008-01-03 22:35:25 +01:00
|
|
|
The release notes contain the significant changes in each
|
2017-10-09 03:44:17 +02:00
|
|
|
<productname>PostgreSQL</productname> release, with major features and migration
|
2008-01-03 22:35:25 +01:00
|
|
|
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.
|
2007-12-11 00:37:49 +01:00
|
|
|
</para>
|
|
|
|
|
|
|
|
<para>
|
|
|
|
A complete list of changes for each release can be obtained by
|
2010-09-22 20:10:28 +02:00
|
|
|
viewing the <link linkend="git">Git</link> logs for each release.
|
2008-01-03 22:35:25 +01:00
|
|
|
The <ulink
|
2018-07-16 10:44:06 +02:00
|
|
|
url="https://www.postgresql.org/list/pgsql-committers/"><literal>pgsql-committers</literal>
|
2009-03-12 23:35:48 +01:00
|
|
|
email list</ulink> records all source code changes as well. There is also
|
2018-07-16 10:44:06 +02:00
|
|
|
a <ulink url="https://git.postgresql.org/gitweb/?p=postgresql.git;a=summary">web
|
2007-12-11 00:37:49 +01:00
|
|
|
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
|
2008-01-03 22:35:25 +01:00
|
|
|
review, so each item is truly a community effort.
|
2007-12-11 00:37:49 +01:00
|
|
|
</para>
|
|
|
|
|
1998-07-08 15:53:15 +02:00
|
|
|
<!--
|
2019-02-05 01:18:49 +01:00
|
|
|
When beginning a new major-release series, create a new release-NN.sgml
|
|
|
|
file, removing the previous one, and change the &-reference here.
|
2019-05-03 18:32:06 +02:00
|
|
|
Don't forget to update filelist.sgml.
|
2019-02-05 01:18:49 +01:00
|
|
|
|
|
|
|
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.
|
2009-05-02 22:17:19 +02:00
|
|
|
-->
|
2019-02-05 01:18:49 +01:00
|
|
|
|
2021-06-28 17:31:16 +02:00
|
|
|
&release-15;
|
2019-02-05 01:18:49 +01:00
|
|
|
|
|
|
|
<sect1 id="release-prior">
|
|
|
|
<title>Prior Releases</title>
|
|
|
|
|
|
|
|
<para>
|
2019-03-10 00:42:19 +01:00
|
|
|
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>
|
2019-02-05 01:18:49 +01:00
|
|
|
</para>
|
|
|
|
</sect1>
|
1998-03-01 09:16:16 +01:00
|
|
|
|
2001-01-27 12:12:53 +01:00
|
|
|
</appendix>
|