summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorRobert Haas2011-01-20 02:15:45 +0000
committerRobert Haas2011-01-20 02:19:53 +0000
commit92f7eebbbd6554f0414ab869abd8733cef751249 (patch)
treef3eaad9e31f4b54d4fd75524f64d5028fcbcbd26
parent357faea82e93712937cd109b48ce006789ec7a8f (diff)
Document that WITH queries are also called Common Table Expressions.
Peter Geoghegan, reviewed by Stephen Frost
-rw-r--r--doc/src/sgml/acronyms.sgml9
-rw-r--r--doc/src/sgml/queries.sgml5
2 files changed, 12 insertions, 2 deletions
diff --git a/doc/src/sgml/acronyms.sgml b/doc/src/sgml/acronyms.sgml
index 23ab3b410bd..5dad0db1378 100644
--- a/doc/src/sgml/acronyms.sgml
+++ b/doc/src/sgml/acronyms.sgml
@@ -99,6 +99,15 @@
</varlistentry>
<varlistentry>
+ <term><acronym>CTE</acronym></term>
+ <listitem>
+ <para>
+ <link linkend="queries-with">Common Table Expression</link>
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
<term><acronym>CVE</acronym></term>
<listitem>
<para>
diff --git a/doc/src/sgml/queries.sgml b/doc/src/sgml/queries.sgml
index f6e081ea732..693fce531f4 100644
--- a/doc/src/sgml/queries.sgml
+++ b/doc/src/sgml/queries.sgml
@@ -1525,7 +1525,7 @@ SELECT <replaceable>select_list</replaceable> FROM <replaceable>table_expression
<sect1 id="queries-with">
- <title><literal>WITH</literal> Queries</title>
+ <title><literal>WITH</literal> Queries (Common Table Expressions)</title>
<indexterm zone="queries-with">
<primary>WITH</primary>
@@ -1539,7 +1539,8 @@ SELECT <replaceable>select_list</replaceable> FROM <replaceable>table_expression
<para>
<literal>WITH</> provides a way to write subqueries for use in a larger
- query. The subqueries can be thought of as defining
+ query. The subqueries, which are often referred to as Common Table
+ Expressions or <acronym>CTE</acronym>s, can be thought of as defining
temporary tables that exist just for this query. One use of this feature
is to break down complicated queries into simpler parts. An example is: