Rename explain's "size" to "rows".

diff --git a/doc/src/sgml/ref/explain.sgml b/doc/src/sgml/ref/explain.sgml
index 5f4a8063f437f82b38a92780d8c0e587b7ff1535..a1914c75ce38a093eae9a6d7826244889c0ea168 100644 (file)
--- a/doc/src/sgml/ref/explain.sgml
+++ b/doc/src/sgml/ref/explain.sgml
@@ -102,6 +102,8 @@ Description
 <PARA>
    This command outputs details about the supplied query.
    The default output is the computed query cost. 
+   The cost value is only meaningful to the optimizer in comparing
+   various query plans.
    VERBOSE displays the full query plan and cost to your screen,
    and pretty-prints the plan to the postmaster log file.   
 </para>
@@ -135,7 +137,7 @@ To show a query plan for a simple query:
 postgres=> explain select * from foo;
 NOTICE:  QUERY PLAN:
 
-Seq Scan on foo  (cost=0.00 size=0 width=4)
+Seq Scan on foo  (cost=0.00 rows=0 width=4)
 
 EXPLAIN
 </ProgramListing>

diff --git a/src/backend/commands/explain.c b/src/backend/commands/explain.c
index 0983097ace651be1907646b8b74a961973e6d02d..6745b4f1f38af12a26e6c5b7176fb9f238b79730 100644 (file)
--- a/src/backend/commands/explain.c
+++ b/src/backend/commands/explain.c
@@ -4,7 +4,7 @@
  *
  * Copyright (c) 1994-5, Regents of the University of California
  *
- *       $Id: explain.c,v 1.33 1999/03/23 16:50:46 momjian Exp $
+ *       $Id: explain.c,v 1.34 1999/04/23 21:23:48 momjian Exp $
  *
  */
 #include <stdio.h>
@@ -234,7 +234,7 @@ explain_outNode(StringInfo str, Plan *plan, int indent, ExplainState *es)
        }
        if (es->printCost)
        {
-               appendStringInfo(str, "  (cost=%.2f size=%d width=%d)",
+               appendStringInfo(str, "  (cost=%.2f rows=%d width=%d)",
                                plan->cost, plan->plan_size, plan->plan_width);
        }
        appendStringInfo(str, "\n");

diff --git a/src/man/explain.l b/src/man/explain.l
index 9bc0925bf2d78034e52204a7434f7a56a4fda366..04c87da9ee7df7c85ddf4aeac516fd3009956b7f 100644 (file)
--- a/src/man/explain.l
+++ b/src/man/explain.l
@@ -1,6 +1,6 @@
 .\" This is -*-nroff-*-
 .\" XXX standard disclaimer belongs here....
-.\" $Header: /cvsroot/pgsql/src/man/Attic/explain.l,v 1.10 1998/08/04 15:00:28 momjian Exp $
+.\" $Header: /cvsroot/pgsql/src/man/Attic/explain.l,v 1.11 1999/04/23 21:23:49 momjian Exp $
 .TH EXPLAIN SQL 06/12/97 PostgreSQL PostgreSQL
 .SH NAME
 explain - explains statement execution details
@@ -10,21 +10,22 @@ explain - explains statement execution details
 .fi
 .SH DESCRIPTION
 This command outputs details about the supplied query.  The default
-output is the computed query cost.  \f2verbose\f1 displays the full query
-plan and cost to your screen, and pretty-prints the plan to the postmaster
-log file.
+output is the computed query cost.  The cost value is only meaningful to
+the optimizer in comparing various query plans. \f2verbose\f1 displays
+the full query plan and cost to your screen, and pretty-prints the plan
+to the postmaster log file.
 
 .SH EXAMPLES
 In the examples, the table has a single column of float4.
 \fBcost\fR is the cost of scanning a base/join relation,
-\fBsize\fR is the expected number of tuples from a scan,
+\fBrows\fR is the expected number of rows from a scan,
 \fBwidth\fR is the length of a tuple.
 
 .nf
 tgl=> explain select a from test\g
 NOTICE:QUERY PLAN:
 
-Seq Scan on test  (cost=0.00 size=0 width=4)
+Seq Scan on test  (cost=0.00 rows=0 width=4)
 
 EXPLAIN
 tgl=> explain verbose select sum(a) from test;
@@ -41,8 +42,8 @@ NOTICE:QUERY PLAN:
   :expr {VAR :varno 1 :varattno 1 :vartype 700 :varnoold 1 :varoattno 1}})
  :qpqual <> :lefttree <> :righttree <> :scanrelid 1} :righttree <> :numagg 1 }
 
-Aggregate  (cost=0.00 size=0 width=0)
-  ->   Seq Scan on test  (cost=0.00 size=0 width=4)
+Aggregate  (cost=0.00 rows=0 width=0)
+  ->   Seq Scan on test  (cost=0.00 rows=0 width=4)
 .fi
 
 The Postgres optimizer has chosen to use a sequential scan to retrieve rows from