Add information on SET SESSION CHARACTERISTICS.
Fix references to pg_hba.conf(5) since that is no longer a man page.
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/datatype.sgml,v 1.30 2000/05/02 20:01:51 thomas Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/datatype.sgml,v 1.31 2000/07/14 15:26:21 thomas Exp $
-->
<chapter id="datatype">
</row>
<row>
<entry>time</entry>
- <entry>time</entry>
+ <entry>time [ without time zone ]</entry>
<entry>time of day</entry>
</row>
<row>
</row>
<row>
<entry>timestamp</entry>
- <entry>timestamp with time zone</entry>
+ <entry>timestamp [ with time zone ]</entry>
<entry>date/time</entry>
</row>
<row>
<entry>1 microsec / 14 digits</entry>
</row>
<row>
- <entry><type>timestamp with time zone</type></entry>
+ <entry><type>timestamp [ with time zone ]</type></entry>
<entry>date and time with time zone</entry>
<entry>8 bytes</entry>
<entry>1903 AD</entry>
<entry>1 day</entry>
</row>
<row>
- <entry><type>time</type></entry>
+ <entry><type>time [ without time zone ]</type></entry>
<entry>times of day only</entry>
<entry>4 bytes</entry>
<entry>00:00:00.00</entry>
</sect3>
<sect3>
- <title>time</title>
+ <title>time [ without time zone ]</title>
+
+ <para>
+ Per SQL99, this type can be referenced as <type>time</type> and
+ as <type>time without time zone</type>.
+ </para>
+
<para>
The following are valid <type>time</type> inputs.
</sect1>
<sect1>
-
<title id="aggregate-funcs">Aggregate Functions</title>
<note>
<firstterm>Aggregate functions</firstterm> allow the generation of simple
statistics about the values of particular columns over the selected set
of rows.
- See also the chapter on aggregates in
- <citetitle>The PostgreSQL Tutorial</citetitle>
<!--
- <xref linkend="sql" endterm="aggregates-tutorial">
--->
- and
+ See also <xref linkend="sql" endterm="aggregates-tutorial"> and
<xref linkend="syntax" endterm="aggregates-syntax">.
+-->
+ See also <xref linkend="syntax" endterm="aggregates-syntax">;
+ refer to
+ the <citetitle>PostgreSQL Tutorial</citetitle> for additional
+ introductory information.
</para>
<para>
</table>
</para>
</sect1>
-
</chapter>
<!-- Keep this comment at the end of the file
<Para>
A frontend sends a startup packet to the postmaster. This includes the names
of the user and the database the user wants to connect to. The postmaster then
-uses this, and the information in the pg_hba.conf(5) file to determine what
+uses this, and the information in the <filename>pg_hba.conf</filename>
+file
+to determine what
further authentication information it requires the frontend to send (if any)
and responds to the frontend accordingly.
</para>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/release.sgml,v 1.55 2000/06/14 13:12:52 thomas Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/release.sgml,v 1.56 2000/07/14 15:26:21 thomas Exp $
-->
<chapter id="release">
<title>Release Notes</title>
+ <sect1>
+ <title>Release 7.1</title>
+ <!--
+ <docinfo>
+ <authorgroup>
+ <author>
+ <firstname>Bruce</firstname>
+ <surname>Momjian</surname>
+ </author>
+ </authorgroup>
+ <date>2000-07-13</date>
+ </docinfo>
+ -->
+
+ <para>
+ Release date 2000-xx-xx.
+
+ <para>
+ Major changes in this release:
+
+ <variablelist>
+ <varlistentry>
+ <term>
+ Nested block comments
+ </term>
+ <listitem>
+ <para>
+ SQL99 defines C-style block comments, and allows them to be nested.
+ </para>
+ </listitem>
+ </varlistentry>
+ </para>
+
+ <sect2>
+ <title>Migration to v7.1</title>
+
+ <para>
+ A dump/restore is required for those running any previous version.
+ </para>
+ </sect2>
+
+ <sect2>
+ <title>Changes</title>
+
+ <para>
+ <programlisting>
+Implement WITHOUT TIME ZONE date/time type qualifier per SQL99 (Thomas)
+Implement nested block comments per SQL99 (Thomas)
+Implement SET SESSION CHARACTERISTICS per SQL99 (Thomas)
+Set session-wide transaction mode READ COMMITTED or SERIALIZABLE (Thomas)
+ </programlisting>
+ </para>
+ </sect2>
+ </sect1>
+
<sect1>
<title>Release 7.0.2</title>
<!--
</para>
<para>
We now have passwords definable independent of any Unix file. There are
- new SQL USER commands. See the pg_hba.conf manual page for more
+ new SQL USER commands.
+ See the <citetitle>Administrator's Guide</citetitle> for more
information. There is a new table, pg_shadow, which is used to store
user information and user passwords, and it by default only SELECT-able
by the postgres super-user. pg_user is now a view of pg_shadow, and is
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/syntax.sgml,v 1.22 2000/06/20 18:04:18 momjian Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/syntax.sgml,v 1.23 2000/07/14 15:26:21 thomas Exp $
-->
<chapter id="syntax">
FETCH FLOAT FOR FROM FULL
GRANT
HAVING
-IN INNER INSERT INTERVAL INTO IS
+IN INNER INSERT INTERVAL INTO INOUT IS
JOIN
LEADING LEFT LIKE LOCAL
NAMES NATIONAL NATURAL NCHAR NO NOT NULL
-ON OR OUTER
+ON OR OUT OUTER
PARTIAL PRIMARY PRIVILEGES PROCEDURE PUBLIC
REFERENCES REVOKE RIGHT ROLLBACK
-SELECT SET SUBSTRING
+SELECT SESSION SET SUBSTRING
TO TRAILING TRIM
UNION UNIQUE UPDATE USING
VALUES VARCHAR VARYING VIEW
-WHERE WITH WORK
+WHERE WITH WITHOUT WORK
</programlisting>
</para>
<programlisting>
ABSOLUTE ACTION
-CONSTRAINTS
+CHARACTERISTICS CONSTRAINTS
DAY DEFERRABLE DEFERRED
HOUR
IMMEDIATE INITIALLY INSENSITIVE ISOLATION
MATCH MINUTE MONTH
NEXT
OF ONLY OPTION
-PENDANT PRIOR PRIVILEGES
+PATH PENDANT PRIOR PRIVILEGES
READ RELATIVE RESTRICT
-SCROLL SECOND
+SCHEMA SCROLL SECOND
TIME TIMESTAMP TIMEZONE_HOUR TIMEZONE_MINUTE TRIGGER
YEAR
ZONE
<programlisting>
-- This is a standard SQL comment
</programlisting>
+ </para>
-We also support C-style block comments, e.g.:
+ <para>
+ We also support C-style block comments, e.g.:
<programlisting>
-/* multi
- line
- comment
+/* multi-line comment
+ * with nesting: /* nested block comment */
*/
</programlisting>
-A comment beginning with "/*" extends to the first occurrence of "*/".
-
+ where the comment begins with "<literal>/*</literal>" and extends
+ to the first occurrence of "<literal>*/</literal>". These block
+ comments nest, as specified in SQL99, so that one can comment out
+ larger blocks of code which may contain existing block comments.
</para>
</sect1>