From 192ce19d361b1a6ee5a6d7198ddb38780ec0cab8 Mon Sep 17 00:00:00 2001
From: Peter Eisentraut <peter_e@gmx.net>
Date: Mon, 5 Feb 2001 19:21:45 +0000
Subject: [PATCH] Document BETWEEN.

---
 doc/src/sgml/func.sgml | 25 ++++++++++++++++++++++++-
 1 file changed, 24 insertions(+), 1 deletion(-)

diff --git a/doc/src/sgml/func.sgml b/doc/src/sgml/func.sgml
index cf4ac7f7ac..5e10ded524 100644
--- a/doc/src/sgml/func.sgml
+++ b/doc/src/sgml/func.sgml
@@ -1,4 +1,4 @@
-<!-- $Header: /cvsroot/pgsql/doc/src/sgml/func.sgml,v 1.49 2001/01/21 22:02:01 petere Exp $ -->
+<!-- $Header: /cvsroot/pgsql/doc/src/sgml/func.sgml,v 1.50 2001/02/05 19:21:45 petere Exp $ -->
 
 <chapter id="functions">
  <title>Functions and Operators</title>
@@ -185,6 +185,29 @@
    <literal>3</literal>).
   </para>
 
+  <para>
+   In addition to the comparison operators, the special
+   <token>BETWEEN</token> construct is available.
+<synopsis>
+<replaceable>a</replaceable> BETWEEN <replaceable>x</replaceable> AND <replaceable>y</replaceable>
+</synopsis>
+   is equivalent to
+<synopsis>
+<replaceable>a</replaceable> &gt;= <replaceable>x</replaceable> AND <replaceable>a</replaceable> &lt;= <replaceable>y</replaceable>
+</synopsis>
+   Similarly,
+<synopsis>
+<replaceable>a</replaceable> NOT BETWEEN <replaceable>x</replaceable> AND <replaceable>y</replaceable>
+</synopsis>
+   is equivalent to
+<synopsis>
+<replaceable>a</replaceable> &lt; <replaceable>x</replaceable> OR <replaceable>a</replaceable> &gt; <replaceable>y</replaceable>
+</synopsis>
+   There is no difference between the two respective forms apart from
+   the <acronym>CPU</acronym> cycles required to rewrite the first one
+   into the second one internally.
+  </para>
+
   <para>
    To check whether a value is or is not NULL, use the constructs
 <synopsis>