From 66d17c3e2610a9b96509fbfa403280d44fc462d2 Mon Sep 17 00:00:00 2001
From: "Thomas G. Lockhart" <lockhart@fourpalms.org>
Date: Fri, 1 Oct 1999 15:24:09 +0000
Subject: [PATCH] Make TABLE an optional keyword, a la LOCK TABLE (gram.y fixes
 not yet  committed, but will be within a week or two). Actually include the
 reference page into the docs...

---
 doc/src/sgml/ref/allfiles.sgml |  3 ++-
 doc/src/sgml/ref/commands.sgml |  3 ++-
 doc/src/sgml/ref/truncate.sgml | 27 ++++++++++++++++-----------
 3 files changed, 20 insertions(+), 13 deletions(-)

diff --git a/doc/src/sgml/ref/allfiles.sgml b/doc/src/sgml/ref/allfiles.sgml
index 50e8c89490..d82a9be53f 100644
--- a/doc/src/sgml/ref/allfiles.sgml
+++ b/doc/src/sgml/ref/allfiles.sgml
@@ -1,5 +1,5 @@
 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/allfiles.sgml,v 1.11 1999/08/06 13:50:29 thomas Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/allfiles.sgml,v 1.12 1999/10/01 15:24:09 thomas Exp $
 Postgres documentation
 Complete list of usable sgml source files in this directory.
 -->
@@ -93,6 +93,7 @@ Complete list of usable sgml source files in this directory.
 <!entity selectInto         system "select_into.sgml">
 <!entity set                system "set.sgml">
 <!entity show               system "show.sgml">
+<!entity truncate           system "truncate.sgml">
 <!entity unlisten           system "unlisten.sgml">
 <!entity update             system "update.sgml">
 <!entity vacuum             system "vacuum.sgml">
diff --git a/doc/src/sgml/ref/commands.sgml b/doc/src/sgml/ref/commands.sgml
index bc16b4cf2a..9402b29f6a 100644
--- a/doc/src/sgml/ref/commands.sgml
+++ b/doc/src/sgml/ref/commands.sgml
@@ -1,5 +1,5 @@
 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/Attic/commands.sgml,v 1.18 1999/08/06 13:50:30 thomas Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/Attic/commands.sgml,v 1.19 1999/10/01 15:24:09 thomas Exp $
 Postgres documentation
 -->
 
@@ -67,6 +67,7 @@ Postgres documentation
    &selectInto;
    &set;
    &show;
+   &truncate;
    &unlisten;
    &update;
    &vacuum;
diff --git a/doc/src/sgml/ref/truncate.sgml b/doc/src/sgml/ref/truncate.sgml
index 998f826d9c..0459c92921 100644
--- a/doc/src/sgml/ref/truncate.sgml
+++ b/doc/src/sgml/ref/truncate.sgml
@@ -1,5 +1,5 @@
 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/truncate.sgml,v 1.1 1999/09/23 17:02:28 momjian Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/truncate.sgml,v 1.2 1999/10/01 15:24:09 thomas Exp $
 Postgres documentation
 -->
 
@@ -15,7 +15,7 @@ Postgres documentation
    TRUNCATE
   </refname>
   <refpurpose>
-   Close a cursor
+   Empty a table
   </refpurpose>
  </refnamediv>
  <refsynopsisdiv>
@@ -23,7 +23,7 @@ Postgres documentation
    <date>1999-07-20</date>
   </refsynopsisdivinfo>
   <synopsis>
-TRUNCATE TABLE <replaceable class="PARAMETER">table</replaceable>
+TRUNCATE [ TABLE ] <replaceable class="PARAMETER">name</replaceable>
   </synopsis>
   
   <refsect2 id="R2-SQL-TRUNCATE-1">
@@ -37,10 +37,10 @@ TRUNCATE TABLE <replaceable class="PARAMETER">table</replaceable>
 
     <variablelist>
      <varlistentry>
-      <term><replaceable class="PARAMETER">table</replaceable></term>
+      <term><replaceable class="PARAMETER">name</replaceable></term>
       <listitem>
        <para>
-	The table name to truncate.
+	The name of the table to be truncated.
        </para>
       </listitem>
      </varlistentry>
@@ -81,19 +81,24 @@ TRUNCATE
    Description
   </title>
   <para>
-   <command>TRUNCATE</command> quickly removes all rows from a table.
+   <command>TRUNCATE</command> quickly removes all rows from a
+   table. It has the same effect as an unqualified
+   <command>DELETE</command> but since it does not actually scan the
+   table it is faster. This is most effective on large tables.
   </para>
-  
+ </refsect1>
+
  <refsect1 id="R1-SQL-TRUNCATE-2">
   <title>
    Usage
   </title>
   <para>
-   Truncate the table bigtable.
-  </para>
-  <programlisting>
+   Truncate the table <literal>bigtable</literal>:
+
+   <programlisting>
 TRUNCATE TABLE bigtable;
-  </programlisting>
+   </programlisting>
+  </para>
  </refsect1>
  
  <refsect1 id="R1-SQL-TRUNCATE-3">
-- 
2.40.0