From adce8912e63ade2ca5bba674fcbad860a73888fd Mon Sep 17 00:00:00 2001
From: Peter Eisentraut <peter_e@gmx.net>
Date: Tue, 22 Aug 2017 19:55:21 -0400
Subject: [PATCH] doc: Mention identity column feature in section on serial

Reported-by: Basil Bourque <basil.bourque@pobox.com>
---
 doc/src/sgml/datatype.sgml | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/doc/src/sgml/datatype.sgml b/doc/src/sgml/datatype.sgml
index 5f881a0b74b..512756df4af 100644
--- a/doc/src/sgml/datatype.sgml
+++ b/doc/src/sgml/datatype.sgml
@@ -837,6 +837,14 @@ FROM generate_series(-3.5, 3.5, 1) as x;
      <secondary>and serial type</secondary>
     </indexterm>
 
+    <note>
+     <para>
+      This section describes a PostgreSQL-specific way to create an
+      autoincrementing column.  Another way is to use the SQL-standard
+      identity column feature, described at <xref linkend="sql-createtable">.
+     </para>
+    </note>
+
     <para>
      The data types <type>smallserial</type>, <type>serial</type> and
      <type>bigserial</type> are not true types, but merely