Update docs for new INFO, NOTICE, WARNING elog() levels.
authorBruce Momjian <bruce@momjian.us>
Wed, 6 Mar 2002 06:44:33 +0000 (06:44 +0000)
committerBruce Momjian <bruce@momjian.us>
Wed, 6 Mar 2002 06:44:33 +0000 (06:44 +0000)
doc/src/sgml/maintenance.sgml
doc/src/sgml/perform.sgml
doc/src/sgml/runtime.sgml
doc/src/sgml/spi.sgml
doc/src/sgml/trigger.sgml

index 537751a344a7fcc9cacb12f646b09cecf9d54293..f93279ed7c55a3b1372269e8b7b233518d59299e 100644 (file)
@@ -335,7 +335,7 @@ SELECT datname, age(datfrozenxid) FROM pg_database;
     <informalexample>
 <programlisting>
 play=# vacuum;
-NOTICE:  Some databases have not been vacuumed in 1613770184 transactions.
+WARNING:  Some databases have not been vacuumed in 1613770184 transactions.
         Better vacuum them within 533713463 transactions,
         or you may have a wraparound failure.
 VACUUM
index 10b46f16cb143ef4892120c0474653017ebd8cc4..54795628c19edeb8563abf351d39080caf18921f 100644 (file)
@@ -96,7 +96,7 @@ $Header$
 
     <programlisting>
 regression=# EXPLAIN SELECT * FROM tenk1;
-NOTICE:  QUERY PLAN:
+INFO:  QUERY PLAN:
 
 Seq Scan on tenk1  (cost=0.00..333.00 rows=10000 width=148)
     </programlisting>
@@ -120,7 +120,7 @@ SELECT * FROM pg_class WHERE relname = 'tenk1';
 
     <programlisting>
 regression=# EXPLAIN SELECT * FROM tenk1 WHERE unique1 &lt; 1000;
-NOTICE:  QUERY PLAN:
+INFO:  QUERY PLAN:
 
 Seq Scan on tenk1  (cost=0.00..358.00 rows=1007 width=148)
     </programlisting>
@@ -145,7 +145,7 @@ Seq Scan on tenk1  (cost=0.00..358.00 rows=1007 width=148)
 
     <programlisting>
 regression=# EXPLAIN SELECT * FROM tenk1 WHERE unique1 &lt; 50;
-NOTICE:  QUERY PLAN:
+INFO:  QUERY PLAN:
 
 Index Scan using tenk1_unique1 on tenk1  (cost=0.00..181.09 rows=49 width=148)
     </programlisting>
@@ -164,7 +164,7 @@ Index Scan using tenk1_unique1 on tenk1  (cost=0.00..181.09 rows=49 width=148)
     <programlisting>
 regression=# EXPLAIN SELECT * FROM tenk1 WHERE unique1 &lt; 50 AND
 regression-# stringu1 = 'xxx';
-NOTICE:  QUERY PLAN:
+INFO:  QUERY PLAN:
 
 Index Scan using tenk1_unique1 on tenk1  (cost=0.00..181.22 rows=1 width=148)
     </programlisting>
@@ -179,7 +179,7 @@ Index Scan using tenk1_unique1 on tenk1  (cost=0.00..181.22 rows=1 width=148)
     <programlisting>
 regression=# EXPLAIN SELECT * FROM tenk1 t1, tenk2 t2 WHERE t1.unique1 &lt; 50
 regression-# AND t1.unique2 = t2.unique2;
-NOTICE:  QUERY PLAN:
+INFO:  QUERY PLAN:
 
 Nested Loop  (cost=0.00..330.41 rows=49 width=296)
   -&gt;  Index Scan using tenk1_unique1 on tenk1 t1
@@ -227,7 +227,7 @@ regression=# set enable_nestloop = off;
 SET VARIABLE
 regression=# EXPLAIN SELECT * FROM tenk1 t1, tenk2 t2 WHERE t1.unique1 &lt; 50
 regression-# AND t1.unique2 = t2.unique2;
-NOTICE:  QUERY PLAN:
+INFO:  QUERY PLAN:
 
 Hash Join  (cost=181.22..564.83 rows=49 width=296)
   -&gt;  Seq Scan on tenk2 t2
@@ -260,7 +260,7 @@ Hash Join  (cost=181.22..564.83 rows=49 width=296)
 regression=# EXPLAIN ANALYZE
 regression-# SELECT * FROM tenk1 t1, tenk2 t2
 regression-# WHERE t1.unique1 &lt; 50 AND t1.unique2 = t2.unique2;
-NOTICE:  QUERY PLAN:
+INFO:  QUERY PLAN:
 
 Nested Loop  (cost=0.00..330.41 rows=49 width=296) (actual time=1.31..28.90 rows=50 loops=1)
   -&gt;  Index Scan using tenk1_unique1 on tenk1 t1
index fac8306f5f05f5d62bea8fe2e50178eeafe81a6c..aeecd3cb0efb40f1bb911fde85a513ca3fe9ad56 100644 (file)
@@ -139,13 +139,13 @@ postgres$ <userinput>initdb -D /usr/local/pgsql/data</userinput>
    One surprise you might encounter while running <command>initdb</command> is
    a notice similar to this one:
 <screen>
-NOTICE:  Initializing database with en_US collation order.
+WARNING:  Initializing database with en_US collation order.
         This locale setting will prevent use of index optimization for
         LIKE and regexp searches.  If you are concerned about speed of
         such queries, you may wish to set LC_COLLATE to "C" and
         re-initdb.  For more information see the Administrator's Guide.
 </screen>
-   This notice is intended to warn you that the currently selected locale
+   This is intended to warn you that the currently selected locale
    will cause indexes to be sorted in an order that prevents them from
    being used for LIKE and regular-expression searches.  If you need
    good performance of such searches, you should set your current locale
@@ -821,10 +821,10 @@ env PGOPTIONS='-c geqo=off' psql
         default is <literal>NOTICE</>. Valid values are <literal>DEBUG5</>,
         <literal>DEBUG4</>, <literal>DEBUG3</>, <literal>DEBUG2</>,
         <literal>DEBUG1</>, <literal>INFO</>, <literal>NOTICE</>,
-        <literal>ERROR</>, <literal>LOG</>, <literal>FATAL</>,
-        <literal>PANIC</>. Later values send less detail to the logs.
-        <literal>LOG</> has a different precedence here than in
-        <literal>CLIENT_MIN_MESSAGES</>.
+        <literal>WARNING</>, <literal>ERROR</>, <literal>LOG</>, 
+       <literal>FATAL</>, and <literal>PANIC</>. Later values send less 
+       detail to the logs. <literal>LOG</> has a different precedence 
+       here than in <literal>CLIENT_MIN_MESSAGES</>.
        </para>
       </listitem>
      </varlistentry>
@@ -834,13 +834,13 @@ env PGOPTIONS='-c geqo=off' psql
       <listitem>
        <para>
         This controls how much detail is written to the client. The
-        default is <literal>INFO</>. Valid values are
+        default is <literal>NOTICE</>. Valid values are
         <literal>DEBUG5</>, <literal>DEBUG4</>, <literal>DEBUG3</>,
         <literal>DEBUG2</>, <literal>DEBUG1</>, <literal>LOG</>,
-        <literal>INFO</>, <literal>NOTICE</>, <literal>ERROR</>,
-        <literal>FATAL</>, <literal>PANIC</>. Later values send less
-        information to the user. literal>LOG</> has a different
-        precedence here than in <literal>SERVER_MIN_MESSAGES</>.
+        <literal>NOTICE</>, <literal>WARNING</>, and <literal>ERROR</>. 
+       Later values send less information to the user. <literal>LOG</> 
+       has a different precedence here than in 
+       <literal>SERVER_MIN_MESSAGES</>.
        </para>
       </listitem>
      </varlistentry>
index f7559a1928401c0a944158e73275857edb0205fd..66b5d43418409c98662c42dabc783e1d8a579e19 100644 (file)
@@ -3801,7 +3801,7 @@ execq(text *sql, int cnt)
     proc = SPI_processed;
     /*
      * If this is SELECT and some tuple(s) fetched -
-     * returns tuples to the caller via elog (NOTICE).
+     * returns tuples to the caller via elog (INFO).
      */
     if ( ret == SPI_OK_SELECT && SPI_processed > 0 )
     {
@@ -3818,7 +3818,7 @@ execq(text *sql, int cnt)
                 sprintf(buf + strlen (buf), " %s%s",
                         SPI_getvalue(tuple, tupdesc, i),
                         (i == tupdesc->natts) ? " " : " |");
-            elog (NOTICE, "EXECQ: %s", buf);
+            elog (INFO, "EXECQ: %s", buf);
         }
     }
 
@@ -3850,9 +3850,9 @@ execq
 vac=> INSERT INTO a VALUES (execq('INSERT INTO a VALUES (0)',0));
 INSERT 167631 1
 vac=> SELECT execq('SELECT * FROM a',0);
-NOTICE:EXECQ:  0 <<< inserted by execq
+INFO:  EXECQ:  0 <<< inserted by execq
 
-NOTICE:EXECQ:  1 <<< value returned by execq and inserted by upper INSERT
+INFO:  EXECQ:  1 <<< value returned by execq and inserted by upper INSERT
 
 execq
 -----
@@ -3866,11 +3866,11 @@ execq
 (1 row)
 
 vac=> SELECT execq('SELECT * FROM a', 10);
-NOTICE:EXECQ:  0 
+INFO:  EXECQ:  0 
 
-NOTICE:EXECQ:  1 
+INFO:  EXECQ:  1 
 
-NOTICE:EXECQ:  2 <<< 0 + 2, only one tuple inserted - as specified
+INFO:  EXECQ:  2 <<< 0 + 2, only one tuple inserted - as specified
 
 execq
 -----
@@ -3888,7 +3888,7 @@ x
 (1 row)
 
 vac=> INSERT INTO a VALUES (execq('SELECT * FROM a', 0) + 1);
-NOTICE:EXECQ:  0 
+INFO:  EXECQ:  0 
 INSERT 167713 1
 vac=> SELECT * FROM a;
 x
 --   This demonstrates data changes visibility rule:
 
 vac=> INSERT INTO a SELECT execq('SELECT * FROM a', 0) * x FROM a;
-NOTICE:EXECQ:  1 
-NOTICE:EXECQ:  2 
-NOTICE:EXECQ:  1 
-NOTICE:EXECQ:  2 
-NOTICE:EXECQ:  2 
+INFO:  EXECQ:  1 
+INFO:  EXECQ:  2 
+INFO:  EXECQ:  1 
+INFO:  EXECQ:  2 
+INFO:  EXECQ:  2 
 INSERT 0 2
 vac=> SELECT * FROM a;
 x
index 9ed44bb85171517bc3fdc8ad009851f90482d085..d7408fc7cd3d541a0624796ccedc2420daf5583c 100644 (file)
@@ -487,7 +487,7 @@ trigf(PG_FUNCTION_ARGS)
        
        /* Connect to SPI manager */
        if ((ret = SPI_connect()) < 0)
-               elog(NOTICE, "trigf (fired %s): SPI_connect returned %d", when, ret);
+               elog(INFO, "trigf (fired %s): SPI_connect returned %d", when, ret);
        
        /* Get number of tuples in relation */
        ret = SPI_exec("SELECT count(*) FROM ttest", 0);
@@ -535,7 +535,7 @@ vac=> CREATE TRIGGER tafter AFTER INSERT OR UPDATE OR DELETE ON ttest
 FOR EACH ROW EXECUTE PROCEDURE trigf();
 CREATE
 vac=> INSERT INTO ttest VALUES (NULL);
-NOTICE:trigf (fired before): there are 0 tuples in ttest
+WARNING:  trigf (fired before): there are 0 tuples in ttest
 INSERT 0 0
 
 -- Insertion skipped and AFTER trigger is not fired
@@ -546,8 +546,8 @@ x
 (0 rows)
 
 vac=> INSERT INTO ttest VALUES (1);
-NOTICE:trigf (fired before): there are 0 tuples in ttest
-NOTICE:trigf (fired after ): there are 1 tuples in ttest
+INFO:  trigf (fired before): there are 0 tuples in ttest
+INFO:  trigf (fired after ): there are 1 tuples in ttest
                                        ^^^^^^^^
                              remember what we said about visibility.
 INSERT 167793 1
@@ -558,8 +558,8 @@ x
 (1 row)
 
 vac=> INSERT INTO ttest SELECT x * 2 FROM ttest;
-NOTICE:trigf (fired before): there are 1 tuples in ttest
-NOTICE:trigf (fired after ): there are 2 tuples in ttest
+INFO:  trigf (fired before): there are 1 tuples in ttest
+INFO:  trigf (fired after ): there are 2 tuples in ttest
                                        ^^^^^^^^
                              remember what we said about visibility.
 INSERT 167794 1
@@ -571,11 +571,11 @@ x
 (2 rows)
 
 vac=> UPDATE ttest SET x = null WHERE x = 2;
-NOTICE:trigf (fired before): there are 2 tuples in ttest
+INFO:  trigf (fired before): there are 2 tuples in ttest
 UPDATE 0
 vac=> UPDATE ttest SET x = 4 WHERE x = 2;
-NOTICE:trigf (fired before): there are 2 tuples in ttest
-NOTICE:trigf (fired after ): there are 2 tuples in ttest
+INFO:  trigf (fired before): there are 2 tuples in ttest
+INFO:  trigf (fired after ): there are 2 tuples in ttest
 UPDATE 1
 vac=> SELECT * FROM ttest;
 x
@@ -585,10 +585,10 @@ x
 (2 rows)
 
 vac=> DELETE FROM ttest;
-NOTICE:trigf (fired before): there are 2 tuples in ttest
-NOTICE:trigf (fired after ): there are 1 tuples in ttest
-NOTICE:trigf (fired before): there are 1 tuples in ttest
-NOTICE:trigf (fired after ): there are 0 tuples in ttest
+INFO:  trigf (fired before): there are 2 tuples in ttest
+INFO:  trigf (fired after ): there are 1 tuples in ttest
+INFO:  trigf (fired before): there are 1 tuples in ttest
+INFO:  trigf (fired after ): there are 0 tuples in ttest
                                        ^^^^^^^^
                              remember what we said about visibility.
 DELETE 2