From 5086dfceba79ecd5d1eb28b8f4ed5221838ff3a6 Mon Sep 17 00:00:00 2001
From: Bruce Momjian <bruce@momjian.us>
Date: Tue, 28 Apr 2015 20:31:08 -0400
Subject: [PATCH] doc: recommend use of GUC server_version_num for version
checks
Patch by Craig Ringer
---
doc/src/sgml/func.sgml | 9 +++++++--
1 file changed, 7 insertions(+), 2 deletions(-)
diff --git a/doc/src/sgml/func.sgml b/doc/src/sgml/func.sgml
index 5f7bf6aa13..0053d7d410 100644
--- a/doc/src/sgml/func.sgml
+++ b/doc/src/sgml/func.sgml
@@ -14617,7 +14617,7 @@ SELECT * FROM pg_ls_dir('.') WITH ORDINALITY AS t(ls,n);
<row>
<entry><literal><function>version()</function></literal></entry>
<entry><type>text</type></entry>
- <entry><productname>PostgreSQL</> version information</entry>
+ <entry><productname>PostgreSQL</> version information. See also <xref linkend="guc-server-version-num"> for a machine-readable version.</entry>
</row>
</tbody>
</tgroup>
@@ -14804,7 +14804,12 @@ SET search_path TO <replaceable>schema</> <optional>, <replaceable>schema</>, ..
<para>
<function>version</function> returns a string describing the
- <productname>PostgreSQL</productname> server's version.
+ <productname>PostgreSQL</productname> server's version. You can also
+ get this information from <xref linkend="guc-server-version"> or
+ for a machine-readable version, <xref linkend="guc-server-version-num">.
+ Software developers should use <literal>server_version_num</literal>
+ (available since 8.2) or <xref linkend="libpq-pqserverversion"> instead
+ of parsing the text version.
</para>
<indexterm>