Re: pgsql: Add documention on ARRAY() function. - Mailing list pgsql-committers

From Bruce Momjian
Subject Re: pgsql: Add documention on ARRAY() function.
Date
Msg-id 200412031833.iB3IXs523875@candle.pha.pa.us
Whole thread Raw
In response to Re: pgsql: Add documention on ARRAY() function.  (Tom Lane <tgl@sss.pgh.pa.us>)
List pgsql-committers
Tom Lane wrote:
> momjian@svr1.postgresql.org (Bruce Momjian) writes:
> > Add documention on ARRAY() function.
>
> This description doesn't have anything whatever to do with reality.
> ARRAY() does not take anyarray, it does not return a setof, and it's
> not very much like a table function.  Other than the point about \df
> I'm having a hard time finding any true statement in the note.

Patch backed out.  The submitter can adjust and resubmit if they desire.

--
  Bruce Momjian                        |  http://candle.pha.pa.us
  pgman@candle.pha.pa.us               |  (610) 359-1001
  +  If your life is a hard drive,     |  13 Roberts Road
  +  Christ can be your backup.        |  Newtown Square, Pennsylvania 19073
Index: func.sgml
===================================================================
RCS file: /cvsroot/pgsql/doc/src/sgml/func.sgml,v
retrieving revision 1.227
retrieving revision 1.228
diff -c -c -r1.227 -r1.228
*** func.sgml    2 Dec 2004 17:39:54 -0000    1.227
--- func.sgml    2 Dec 2004 21:04:47 -0000    1.228
***************
*** 1,5 ****
  <!--
! $PostgreSQL: pgsql/doc/src/sgml/func.sgml,v 1.227 2004/12/02 17:39:54 momjian Exp $
  PostgreSQL documentation
  -->

--- 1,5 ----
  <!--
! $PostgreSQL: pgsql/doc/src/sgml/func.sgml,v 1.228 2004/12/02 21:04:47 momjian Exp $
  PostgreSQL documentation
  -->

***************
*** 6930,6935 ****
--- 6930,6947 ----
        </tbody>
       </tgroup>
      </table>
+   <note>
+   <para>
+     Although it is not strictly a function and does not appear in \df
+     in psql, <command>ARRAY()</command>, mentioned in <xref
+     linkend="sql-syntax-array-constructors"> acts much like a
+     <literal>table function</literal> (equivalently, a
+     <literal>set-returning function</literal> or a
+     <acronym>SRF</acronym>--see <xref linkend="queries-tablefunctions">)
+     which takes <type>anyarray</type> and returns a set of
+     <type>anyelement</type>.
+   </para>
+   </note>
    </sect1>

   <sect1 id="functions-aggregate">

pgsql-committers by date:

Previous
From: Tom Lane
Date:
Subject: Re: pgsql: Add documention on ARRAY() function.
Next
From: momjian@svr1.postgresql.org (Bruce Momjian)
Date:
Subject: pgsql: Back out ARRAY() patch.