From a6927996be59ac329d65d41cf058d0b1b0978eeb Mon Sep 17 00:00:00 2001
From: Bruce Momjian <bruce@momjian.us>
Date: Sun, 12 May 2019 23:41:53 -0400
Subject: [PATCH] doc:  adjust PG 12 release note sections

Tighten section designations.
---
 doc/src/sgml/release-12.sgml | 67 ++++++++++++++++--------------------
 1 file changed, 29 insertions(+), 38 deletions(-)

diff --git a/doc/src/sgml/release-12.sgml b/doc/src/sgml/release-12.sgml
index e3f8741f1d..64e627822c 100644
--- a/doc/src/sgml/release-12.sgml
+++ b/doc/src/sgml/release-12.sgml
@@ -526,41 +526,6 @@ This prevents the creation of inconsistent partition hierarchies in rare cases.
 
     </sect4>
 
-    <sect4>
-     <title>Parallel Queries</title>
-
-     <itemizedlist>
-
-<listitem>
-<!--
-Author: Thomas Munro <tmunro@postgresql.org>
-2019-03-15 [bb16aba50] Enable parallel query with SERIALIZABLE isolation.
--->
-
-<para>
-Allow parallel query when in <link linkend="sql-set-transaction"><literal>SERIALIZABLE</literal></link> isolation mode (Thomas Munro)
-</para>
-
-<para>
-Previously, parallelism was disabled when in this mode.
-</para>
-</listitem>
-
-<listitem>
-<!--
-Author: Michael Paquier <michael@paquier.xyz>
-2019-03-27 [5bde1651b] Switch function current_schema[s]() to be parallel-unsaf
--->
-
-<para>
-Prevent <link linkend="functions-info-session-table"><function>current_schema()</function></link> and <function>current_schemas()</function> from being run by parallel workers (Michael Paquier)
-</para>
-</listitem>
-
-     </itemizedlist>
-
-    </sect4>
-
     <sect4>
      <title>Indexes</title>
 
@@ -980,6 +945,21 @@ Improve speed in converting strings to <type>int2</type>/<type>int4</type> integ
 </para>
 </listitem>
 
+<listitem>
+<!--
+Author: Thomas Munro <tmunro@postgresql.org>
+2019-03-15 [bb16aba50] Enable parallel query with SERIALIZABLE isolation.
+-->
+
+<para>
+Allow parallelized queries when in <link linkend="sql-set-transaction"><literal>SERIALIZABLE</literal></link> isolation mode (Thomas Munro)
+</para>
+
+<para>
+Previously, parallelism was disabled when in this mode.
+</para>
+</listitem>
+
 <listitem>
 <!--
 Author: Thomas Munro <tmunro@postgresql.org>
@@ -2016,6 +1996,17 @@ Allow the <literal>XML BY VALUE</literal> clause (Chapman Flack)
 <para>
 The clause has no effect.
 </para>
+</listitem>
+
+<listitem>
+<!--
+Author: Michael Paquier <michael@paquier.xyz>
+2019-03-27 [5bde1651b] Switch function current_schema[s]() to be parallel-unsaf
+-->
+
+<para>
+Prevent <link linkend="functions-info-session-table"><function>current_schema()</function></link> and <function>current_schemas()</function> from being run by parallel workers (Michael Paquier)
+</para>
 </listitem>
 
     </itemizedlist>
@@ -2023,7 +2014,7 @@ The clause has no effect.
    </sect3>
 
    <sect3>
-    <title>Server-Side Languages</title>
+    <title><link linkend="plpgsql">PL/pgSQL</link></title>
 
     <itemizedlist>
 
@@ -2035,7 +2026,7 @@ Author: Tom Lane <tgl@sss.pgh.pa.us>
 
 <para>
 Allow commands and variables with the same name as commands to be used in the same
-<link linkend="plpgsql">PL/pgSQL</link> function (Tom Lane)
+PL/pgSQL function (Tom Lane)
 </para>
 
 <para>
@@ -2621,7 +2612,7 @@ Require a C99-supported compiler, and <acronym>MSVC</acronym> 2013 or later on <
    </sect3>
 
    <sect3>
-    <title>Source Code</title>
+    <title>Documentation</title>
 
      <itemizedlist>