mirror of
https://git.postgresql.org/git/postgresql.git
synced 2024-09-15 22:00:20 +02:00
c29c578908
For DocBook XML compatibility, don't use SGML empty tags (</>) anymore, replace by the full tag name. Add a warning option to catch future occurrences. Alexander Lakhin, Jürgen Purtz
94 lines
3.2 KiB
Plaintext
94 lines
3.2 KiB
Plaintext
<!-- doc/src/sgml/release.sgml -->
|
|
<!--
|
|
|
|
Typical markup:
|
|
|
|
&<> use & escapes
|
|
PostgreSQL <productname>
|
|
postgresql.conf, pg_hba.conf,
|
|
recovery.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">
|
|
|
|
non-ASCII characters find using grep -P '[\x80-\xFF]'
|
|
convert to HTML4 named entity (&) escapes
|
|
|
|
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
|
|
http://en.wikipedia.org/wiki/List_of_XML_and_HTML_character_entity_references
|
|
|
|
we cannot use UTF8 because SGML Docbook does not support it
|
|
|
|
do not use numeric _UTF_ numeric character escapes (&#nnn;),
|
|
we can only use Latin1
|
|
|
|
Example: Alvaro Herrera is Álvaro Herrera
|
|
|
|
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://archives.postgresql.org/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>
|
|
|
|
<!--
|
|
To add a new major-release series, add an entry here and in filelist.sgml.
|
|
|
|
The reason for splitting the release notes this way is so that appropriate
|
|
subsets can easily be copied into back branches.
|
|
-->
|
|
&release-10;
|
|
&release-9.6;
|
|
&release-9.5;
|
|
&release-9.4;
|
|
&release-9.3;
|
|
&release-9.2;
|
|
&release-9.1;
|
|
&release-9.0;
|
|
&release-8.4;
|
|
&release-8.3;
|
|
&release-8.2;
|
|
&release-8.1;
|
|
&release-8.0;
|
|
&release-7.4;
|
|
&release-old;
|
|
|
|
</appendix>
|