diff --git a/doc/src/sgml/func.sgml b/doc/src/sgml/func.sgml
new file mode 100644
index eb2a0c5..bef458a
*** a/doc/src/sgml/func.sgml
--- b/doc/src/sgml/func.sgml
*************** WHERE EXISTS (SELECT 1 FROM tab2 WHERE c
*** 14590,14596 ****
     Boolean (true/false) results.
    </para>
  
!   <sect2>
     <title><literal>IN</literal></title>
  
  <synopsis>
--- 14590,14596 ----
     Boolean (true/false) results.
    </para>
  
!   <sect2 id="functions-comparisons-in">
     <title><literal>IN</literal></title>
  
  <synopsis>
diff --git a/doc/src/sgml/ref/values.sgml b/doc/src/sgml/ref/values.sgml
new file mode 100644
index 0fb3cd7..b992ce3
*** a/doc/src/sgml/ref/values.sgml
--- b/doc/src/sgml/ref/values.sgml
*************** WHERE ip_address IN (VALUES('192.168.0.1
*** 219,225 ****
    <tip>
     <para>
      For simple <literal>IN</> tests, it's better to rely on the
!     list-of-scalars form of <literal>IN</> than to write a <command>VALUES</>
      query as shown above.  The list of scalars method requires less writing
      and is often more efficient.
     </para>
--- 219,226 ----
    <tip>
     <para>
      For simple <literal>IN</> tests, it's better to rely on the
!     <link linkend="functions-comparisons-in">list-of-scalars</link> form
!     of <literal>IN</> than to write a <command>VALUES</>
      query as shown above.  The list of scalars method requires less writing
      and is often more efficient.
     </para>