Markup changes for v6.5 release.
Clean out duplicate stuff in odbc.sgml resulting from a faulty patch.
This commit is contained in:
Thomas G. Lockhart
parent
214e8f3292
commit
f3d2b2e0c7
@ -1,11 +1,15 @@
|
||||
<!--
|
||||
$Header: /cvsroot/pgsql/doc/src/sgml/Attic/admin.sgml,v 1.14 1999/05/26 17:30:27 thomas Exp $
|
||||
$Header: /cvsroot/pgsql/doc/src/sgml/Attic/admin.sgml,v 1.15 1999/06/03 04:21:47 thomas Exp $
|
||||
|
||||
Postgres Administrator's Guide.
|
||||
Derived from postgres.sgml.
|
||||
- thomas 1998-10-27
|
||||
|
||||
$Log: admin.sgml,v $
|
||||
Revision 1.15 1999/06/03 04:21:47 thomas
|
||||
Markup changes for v6.5 release.
|
||||
Clean out duplicate stuff in odbc.sgml resulting from a faulty patch.
|
||||
|
||||
Revision 1.14 1999/05/26 17:30:27 thomas
|
||||
Add chapters on CVS access, MVCC, SQL theory to the docs.
|
||||
Add an appendix with more details on date/time attributes and handling.
|
||||
@ -108,7 +112,7 @@ Bigger updates to the installation instructions (install and config).
|
||||
|
||||
<LegalNotice>
|
||||
<Para>
|
||||
<ProductName>PostgreSQL</ProductName> is © 1998-9
|
||||
<ProductName>PostgreSQL</ProductName> is Copyright © 1996-9
|
||||
by the Postgres Global Development Group.
|
||||
</Para>
|
||||
</LegalNotice>
|
||||
|
||||
@ -1,10 +1,14 @@
|
||||
<!--
|
||||
$Header: /cvsroot/pgsql/doc/src/sgml/installation.sgml,v 1.4 1999/05/26 17:30:29 thomas Exp $
|
||||
$Header: /cvsroot/pgsql/doc/src/sgml/installation.sgml,v 1.5 1999/06/03 04:21:48 thomas Exp $
|
||||
|
||||
Postgres quick Installation Guide.
|
||||
- thomas 1998-10-26
|
||||
|
||||
$Log: installation.sgml,v $
|
||||
Revision 1.5 1999/06/03 04:21:48 thomas
|
||||
Markup changes for v6.5 release.
|
||||
Clean out duplicate stuff in odbc.sgml resulting from a faulty patch.
|
||||
|
||||
Revision 1.4 1999/05/26 17:30:29 thomas
|
||||
Add chapters on CVS access, MVCC, SQL theory to the docs.
|
||||
Add an appendix with more details on date/time attributes and handling.
|
||||
@ -37,7 +41,6 @@ First cut at standalone installation guide to replace INSTALL text source.
|
||||
<!entity y2k SYSTEM "y2k.sgml">
|
||||
|
||||
<!entity config SYSTEM "config.sgml">
|
||||
<!entity current SYSTEM "current.sgml">
|
||||
<!entity intro-ag SYSTEM "intro-ag.sgml">
|
||||
<!entity install SYSTEM "install.sgml">
|
||||
<!entity options SYSTEM "pg_options.sgml">
|
||||
@ -51,27 +54,27 @@ First cut at standalone installation guide to replace INSTALL text source.
|
||||
<!entity biblio SYSTEM "biblio.sgml">
|
||||
]>
|
||||
|
||||
<Book Id="installation">
|
||||
<book>
|
||||
|
||||
<!-- Title information -->
|
||||
|
||||
<Title>PostgreSQL Installation Guide</Title>
|
||||
<BookInfo>
|
||||
<ReleaseInfo>Covering v6.5 for general release</ReleaseInfo>
|
||||
<BookBiblio>
|
||||
<AuthorGroup>
|
||||
<CorpAuthor>The PostgreSQL Development Team</CorpAuthor>
|
||||
</AuthorGroup>
|
||||
<title>PostgreSQL Installation Guide</title>
|
||||
<bookinfo>
|
||||
<releaseinfo>Covering v6.5 for general release</releaseinfo>
|
||||
<bookbiblio>
|
||||
<authorgroup>
|
||||
<corpauthor>The PostgreSQL Development Team</corpauthor>
|
||||
</authorgroup>
|
||||
<!-- editor in authorgroup is not supported
|
||||
<AuthorGroup>
|
||||
-->
|
||||
<Editor>
|
||||
<FirstName>Thomas</FirstName>
|
||||
<SurName>Lockhart</SurName>
|
||||
<Affiliation>
|
||||
<OrgName>Caltech/JPL</OrgName>
|
||||
</Affiliation>
|
||||
</Editor>
|
||||
<editor>
|
||||
<firstname>Thomas</firstname>
|
||||
<surname>Lockhart</surname>
|
||||
<affiliation>
|
||||
<orgname>Caltech/JPL</orgname>
|
||||
</affiliation>
|
||||
</editor>
|
||||
<!--
|
||||
</AuthorGroup>
|
||||
-->
|
||||
@ -80,17 +83,17 @@ First cut at standalone installation guide to replace INSTALL text source.
|
||||
<AuthorInitials>TGL</AuthorInitials>
|
||||
-->
|
||||
|
||||
<Date>(last updated 1999-06-01)</Date>
|
||||
</BookBiblio>
|
||||
<date>(last updated 1999-06-01)</date>
|
||||
</bookbiblio>
|
||||
|
||||
<LegalNotice>
|
||||
<Para>
|
||||
<ProductName>PostgreSQL</ProductName> is © 1998-9
|
||||
<legalnotice>
|
||||
<para>
|
||||
<productname>PostgreSQL</productname> is © 1998-9
|
||||
by the Postgres Global Development Group.
|
||||
</Para>
|
||||
</LegalNotice>
|
||||
</para>
|
||||
</legalnotice>
|
||||
|
||||
</BookInfo>
|
||||
</bookinfo>
|
||||
|
||||
<!--
|
||||
<TOC> </TOC>
|
||||
@ -105,22 +108,22 @@ Your name here...
|
||||
</Dedication>
|
||||
-->
|
||||
|
||||
<Preface>
|
||||
<Title>Summary</Title>
|
||||
<preface>
|
||||
<title>Summary</title>
|
||||
|
||||
<Para>
|
||||
<ProductName>Postgres</ProductName>,
|
||||
<para>
|
||||
<productname>Postgres</productname>,
|
||||
developed originally in the UC Berkeley Computer Science Department,
|
||||
pioneered many of the object-relational concepts
|
||||
now becoming available in some commercial databases.
|
||||
It provides SQL92/SQL3 language support,
|
||||
transaction integrity, and type extensibility.
|
||||
<ProductName>PostgreSQL</ProductName> is a public-domain, open source descendant
|
||||
<productname>PostgreSQL</productname> is a public-domain, open source descendant
|
||||
of this original Berkeley code.
|
||||
</Para>
|
||||
</Preface>
|
||||
</para>
|
||||
</preface>
|
||||
|
||||
<chapter id="intro">
|
||||
<chapter>
|
||||
<title>Introduction</title>
|
||||
|
||||
<para>
|
||||
@ -129,24 +132,34 @@ and runtime environment for your system. This may be adequate for many installat
|
||||
and is almost certainly adequate for a first installation. But you may want to
|
||||
do an initial installation up to the point of unpacking the source tree
|
||||
and installing documentation, and then print or browse the
|
||||
<citetitle>Administrator's Guide</citetitle>.
|
||||
<citetitle>Administrator's Guide</citetitle>.</para>
|
||||
|
||||
</chapter>
|
||||
|
||||
&ports;
|
||||
&install;
|
||||
&config;
|
||||
|
||||
<chapter id="release">
|
||||
<title>Release Notes</title>
|
||||
|
||||
¤t;
|
||||
|
||||
</chapter>
|
||||
&release;
|
||||
|
||||
<!--
|
||||
<INDEX> </INDEX>
|
||||
-->
|
||||
|
||||
</Book>
|
||||
</book>
|
||||
|
||||
<!-- Keep this comment at the end of the file
|
||||
Local variables:
|
||||
mode: sgml
|
||||
sgml-omittag:nil
|
||||
sgml-shorttag:t
|
||||
sgml-minimize-attributes:nil
|
||||
sgml-always-quote-attributes:t
|
||||
sgml-indent-step:1
|
||||
sgml-indent-data:t
|
||||
sgml-parent-document:nil
|
||||
sgml-default-dtd-file:"./reference.ced"
|
||||
sgml-exposed-tags:nil
|
||||
sgml-local-catalogs:"/usr/lib/sgml/CATALOG"
|
||||
sgml-local-ecat-files:nil
|
||||
End:
|
||||
-->
|
||||
|
||||
@ -1,43 +1,59 @@
|
||||
<Sect1>
|
||||
<Title>Copyrights and Trademarks</Title>
|
||||
<sect1>
|
||||
<title>Copyrights and Trademarks</title>
|
||||
|
||||
<Para>
|
||||
<ProductName>PostgreSQL</ProductName> is copyright (C) 1996-8
|
||||
by the PostgreSQL Global Development Group,
|
||||
and is distributed under the terms of the Berkeley license.
|
||||
</Para>
|
||||
<para>
|
||||
<productname>PostgreSQL</productname> is Copyright © 1996-9
|
||||
by the PostgreSQL Global Development Group,
|
||||
and is distributed under the terms of the Berkeley license.
|
||||
</para>
|
||||
|
||||
<Para>
|
||||
<ProductName>Postgres95</ProductName> is copyright (C) 1994-5
|
||||
by the Regents of the University of California.
|
||||
Permission to use, copy, modify, and distribute this software and its documentation
|
||||
for any purpose, without fee, and without a written agreement is hereby granted,
|
||||
provided that the above copyright notice and this paragraph and the following two
|
||||
paragraphs appear in all copies.
|
||||
</Para>
|
||||
<Para>
|
||||
In no event shall the University of California be liable to
|
||||
any party for direct, indirect, special, incidental, or consequential
|
||||
damages, including lost profits, arising out of the use of this
|
||||
software and its documentation, even if the University of California
|
||||
has been advised of the possibility of such damage.
|
||||
</Para>
|
||||
<Para>
|
||||
The University of California specifically disclaims any
|
||||
warranties, including, but not limited to, the implied warranties
|
||||
of merchantability and fitness for a particular purpose.
|
||||
The software provided hereunder is on an "as-is" basis, and
|
||||
the University of California has no obligations to provide
|
||||
maintainance, support, updates, enhancements, or modifications.
|
||||
</Para>
|
||||
<para>
|
||||
<productname>Postgres95</productname> is Copyright © 1994-5
|
||||
by the Regents of the University of California.
|
||||
Permission to use, copy, modify, and distribute this software and its documentation
|
||||
for any purpose, without fee, and without a written agreement is hereby granted,
|
||||
provided that the above copyright notice and this paragraph and the following two
|
||||
paragraphs appear in all copies.
|
||||
</para>
|
||||
<para>
|
||||
In no event shall the University of California be liable to
|
||||
any party for direct, indirect, special, incidental, or consequential
|
||||
damages, including lost profits, arising out of the use of this
|
||||
software and its documentation, even if the University of California
|
||||
has been advised of the possibility of such damage.
|
||||
</para>
|
||||
<para>
|
||||
The University of California specifically disclaims any
|
||||
warranties, including, but not limited to, the implied warranties
|
||||
of merchantability and fitness for a particular purpose.
|
||||
The software provided hereunder is on an "as-is" basis, and
|
||||
the University of California has no obligations to provide
|
||||
maintainance, support, updates, enhancements, or modifications.
|
||||
</para>
|
||||
|
||||
<Para>
|
||||
<Acronym>UNIX</Acronym> is a trademark of X/Open, Ltd. Sun4, SPARC, SunOS
|
||||
and Solaris are trademarks of Sun Microsystems, Inc. DEC,
|
||||
DECstation, Alpha AXP and ULTRIX are trademarks of Digital
|
||||
Equipment Corp. PA-RISC and HP-UX are trademarks of
|
||||
Hewlett-Packard Co. OSF/1 is a trademark of the Open
|
||||
Software Foundation.
|
||||
</Para>
|
||||
</Sect1>
|
||||
<para>
|
||||
<acronym>UNIX</acronym> is a trademark of X/Open, Ltd. Sun4, SPARC, SunOS
|
||||
and Solaris are trademarks of Sun Microsystems, Inc. DEC,
|
||||
DECstation, Alpha AXP and ULTRIX are trademarks of Digital
|
||||
Equipment Corp. PA-RISC and HP-UX are trademarks of
|
||||
Hewlett-Packard Co. OSF/1 is a trademark of the Open
|
||||
Software Foundation.
|
||||
</para>
|
||||
</sect1>
|
||||
|
||||
<!-- Keep this comment at the end of the file
|
||||
Local variables:
|
||||
mode: sgml
|
||||
sgml-omittag:nil
|
||||
sgml-shorttag:t
|
||||
sgml-minimize-attributes:nil
|
||||
sgml-always-quote-attributes:t
|
||||
sgml-indent-step:1
|
||||
sgml-indent-data:t
|
||||
sgml-parent-document:nil
|
||||
sgml-default-dtd-file:"./reference.ced"
|
||||
sgml-exposed-tags:nil
|
||||
sgml-local-catalogs:"/usr/lib/sgml/CATALOG"
|
||||
sgml-local-ecat-files:nil
|
||||
End:
|
||||
-->
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
@ -1047,394 +1047,6 @@ database login and password to the standard Applix startup
|
||||
macro file. This is an example
|
||||
<filename>~/axhome/macros/login.am</filename> file:
|
||||
|
||||
=======
|
||||
<productname>ApplixWare</productname> must be configured correctly
|
||||
in order for it to
|
||||
be able to access the <productname>Postgres</productname>
|
||||
<acronym>ODBC</acronym> software drivers.
|
||||
</para>
|
||||
<procedure>
|
||||
<title>Enabling ApplixWare Database Access</title>
|
||||
|
||||
<para>
|
||||
Note that
|
||||
these instructions are for the 4.4.1 release of
|
||||
<productname>ApplixWare</productname> on <productname>Linux</productname>.
|
||||
Refer to the <citetitle>Linux Sys Admin</citetitle> on-line book
|
||||
for more detailed information.
|
||||
</para>
|
||||
<step performance="required">
|
||||
<para>
|
||||
You must modify <filename>axnet.cnf</filename> so that
|
||||
<filename>elfodbc</filename> can
|
||||
find <filename>libodbc.so</filename>
|
||||
(the <acronym>ODBC</acronym> driver manager) shared library.
|
||||
This library is included with the ApplixWare distribution,
|
||||
but <filename>axnet.cnf</filename> needs to be modified to point to the
|
||||
correct location.
|
||||
</para>
|
||||
<para>
|
||||
As root, edit the file
|
||||
<filename><replaceable>applixroot</replaceable>/applix/axdata/axnet.cnf</filename>.
|
||||
</para>
|
||||
<substeps>
|
||||
|
||||
<step performance="required">
|
||||
<para>
|
||||
At the bottom of <filename>axnet.cnf</filename>,
|
||||
find the line that starts with
|
||||
|
||||
<programlisting>
|
||||
#libFor elfodbc /ax/<replaceable>...</replaceable>
|
||||
</programlisting>
|
||||
</para>
|
||||
</step>
|
||||
|
||||
<step performance="required">
|
||||
<para>
|
||||
Change line to read
|
||||
|
||||
<programlisting>
|
||||
libFor elfodbc <replaceable>applixroot</replaceable>/applix/axdata/axshlib/lib
|
||||
</programlisting>
|
||||
|
||||
which will tell elfodbc to look in this directory
|
||||
for the <acronym>ODBC</acronym> support library.
|
||||
If you have installed applix somewhere else,
|
||||
change the path accordingly.
|
||||
</para>
|
||||
</step>
|
||||
|
||||
</substeps>
|
||||
</step>
|
||||
|
||||
<step performance="required">
|
||||
<para>
|
||||
Create <filename>.odbc.ini</filename> as
|
||||
described above. You may also want to add the flag
|
||||
|
||||
<programlisting>
|
||||
TextAsLongVarchar=0
|
||||
</programlisting>
|
||||
|
||||
to the database-specific portion of <filename>.odbc.ini</filename>
|
||||
so that text fields will not be shown as <literal>**BLOB**</literal>.
|
||||
</para>
|
||||
</step>
|
||||
|
||||
</procedure>
|
||||
|
||||
<procedure>
|
||||
<title>Testing ApplixWare ODBC Connections</title>
|
||||
|
||||
<step performance="required">
|
||||
<para>
|
||||
Bring up <application>Applix Data</application>
|
||||
</para>
|
||||
</step>
|
||||
|
||||
<step performance="required">
|
||||
<para>
|
||||
Select the <productname>Postgres</productname> database of interest.
|
||||
</para>
|
||||
|
||||
<substeps>
|
||||
|
||||
<step performance="required">
|
||||
<para>
|
||||
Select <command>Query->Choose Server</command>.
|
||||
</para>
|
||||
</step>
|
||||
|
||||
<step performance="required">
|
||||
<para>
|
||||
Select <acronym>ODBC</acronym>, and click <command>Browse</command>.
|
||||
The database you configured in <filename>.odbc.ini</filename>
|
||||
should be shown. Make sure that the <option>Host: field</option>
|
||||
is empty (if it is not, axnet will try to contact axnet on another machine
|
||||
to look for the database).
|
||||
</para>
|
||||
</step>
|
||||
|
||||
<step performance="required">
|
||||
<para>
|
||||
Select the database in the box that was launched by <command>Browse</command>,
|
||||
then click <command>OK</command>.
|
||||
</para>
|
||||
</step>
|
||||
|
||||
<step performance="required">
|
||||
<para>
|
||||
Enter username and password in the login identification dialog,
|
||||
and click <command>OK</command>.
|
||||
</para>
|
||||
</step>
|
||||
|
||||
</substeps>
|
||||
|
||||
<para>
|
||||
You should see <quote>Starting elfodbc server</quote>
|
||||
in the lower left corner of the
|
||||
data window. If you get an error dialog box, see the debugging section
|
||||
below.
|
||||
</para>
|
||||
</step>
|
||||
<step performance="required">
|
||||
<para>
|
||||
The 'Ready' message will appear in the lower left corner of the data
|
||||
window. This indicates that you can now enter queries.
|
||||
</para>
|
||||
</step>
|
||||
|
||||
<step performance="required">
|
||||
<para>
|
||||
Select a table from Query->Choose tables, and then select Query->Query
|
||||
to access the database. The first 50 or so rows from the table should
|
||||
appear.
|
||||
</para>
|
||||
</step>
|
||||
|
||||
</procedure>
|
||||
</sect2>
|
||||
|
||||
<sect2>
|
||||
<title>Common Problems</title>
|
||||
|
||||
<para>
|
||||
The following messages can appear while trying to make an
|
||||
<acronym>ODBC</acronym> connection through
|
||||
<productname>Applix Data</productname>:
|
||||
|
||||
<variablelist>
|
||||
<varlistentry>
|
||||
<term>
|
||||
Cannot launch gateway on server
|
||||
</term>
|
||||
<listitem>
|
||||
<para>
|
||||
<literal>elfodbc</literal> can't find <filename>libodbc.so</filename>.
|
||||
Check your <filename>axnet.cnf</filename>.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term>
|
||||
Error from ODBC Gateway:
|
||||
IM003::[iODBC][Driver Manager]Specified driver could not be loaded
|
||||
</term>
|
||||
|
||||
<listitem>
|
||||
<para>
|
||||
<filename>libodbc.so</filename> cannot find the driver listed in
|
||||
<filename>.odbc.ini</filename>. Verify the settings.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term>
|
||||
Server: Broken Pipe
|
||||
</term>
|
||||
|
||||
<listitem>
|
||||
<para>
|
||||
The driver process has terminated due to some other
|
||||
problem. You might not have an up-to-date version
|
||||
of the <productname>Postgres</productname>
|
||||
<acronym>ODBC</acronym> package.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
</variablelist>
|
||||
</para>
|
||||
</sect2>
|
||||
|
||||
<sect2>
|
||||
<title>Debugging ApplixWare ODBC Connections</title>
|
||||
|
||||
<para>
|
||||
One good tool for debugging connection problems uses the Unix system
|
||||
utility <application>strace</application>.
|
||||
</para>
|
||||
<procedure>
|
||||
<title>Debugging with strace</title>
|
||||
|
||||
<step performance="required">
|
||||
<para>
|
||||
Start applixware.
|
||||
</para>
|
||||
</step>
|
||||
<step performance="required">
|
||||
<para>
|
||||
Start an <application>strace</application> on
|
||||
the axnet process. For example, if
|
||||
|
||||
<programlisting>
|
||||
ps -aucx | grep ax
|
||||
</programlisting>
|
||||
|
||||
shows
|
||||
|
||||
<programlisting>
|
||||
cary 10432 0.0 2.6 1740 392 ? S Oct 9 0:00 axnet
|
||||
cary 27883 0.9 31.0 12692 4596 ? S 10:24 0:04 axmain
|
||||
</programlisting>
|
||||
</para>
|
||||
|
||||
<para>
|
||||
Then run
|
||||
|
||||
<programlisting>
|
||||
strace -f -s 1024 -p 10432
|
||||
</programlisting>
|
||||
</para>
|
||||
</step>
|
||||
<step performance="required">
|
||||
<para>
|
||||
Check the strace output.
|
||||
</para>
|
||||
|
||||
<note>
|
||||
<title>Note from Cary</title>
|
||||
|
||||
<para>
|
||||
Many of the error messages from <productname>ApplixWare</productname>
|
||||
go to <filename>stderr</filename>,
|
||||
but I'm not sure where <filename>stderr</filename>
|
||||
is sent, so <application>strace</application> is the way to find out.
|
||||
</para>
|
||||
</note>
|
||||
</step>
|
||||
</procedure>
|
||||
|
||||
<para>
|
||||
For example, after getting
|
||||
a <quote>Cannot launch gateway on server</quote>,
|
||||
I ran strace on axnet and got
|
||||
|
||||
<programlisting>
|
||||
[pid 27947] open("/usr/lib/libodbc.so", O_RDONLY) = -1 ENOENT
|
||||
(No such file or directory)
|
||||
[pid 27947] open("/lib/libodbc.so", O_RDONLY) = -1 ENOENT
|
||||
(No such file or directory)
|
||||
[pid 27947] write(2, "/usr2/applix/axdata/elfodbc:
|
||||
can't load library 'libodbc.so'\n", 61) = -1 EIO (I/O error)
|
||||
</programlisting>
|
||||
So what is happening is that applix elfodbc is searching for libodbc.so, but it
|
||||
can't find it. That is why axnet.cnf needed to be changed.
|
||||
</para>
|
||||
</sect2>
|
||||
<sect2>
|
||||
<title>Running the ApplixWare Demo</title>
|
||||
|
||||
<para>
|
||||
In order to go through the
|
||||
<citetitle>ApplixWare Data Tutorial</citetitle>, you need to create
|
||||
the sample tables that the Tutorial refers to. The ELF Macro used to
|
||||
create the tables tries to use a NULL condition
|
||||
on many of the database columns,
|
||||
and <productname>Postgres</productname> does not currently allow this option.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
To get around this problem, you can do the following:
|
||||
</para>
|
||||
|
||||
<procedure>
|
||||
<title>Modifying the ApplixWare Demo</title>
|
||||
|
||||
<step performance="required">
|
||||
<para>
|
||||
Copy <filename>/opt/applix/axdata/eng/Demos/sqldemo.am</filename>
|
||||
to a local directory.
|
||||
</para>
|
||||
</step>
|
||||
|
||||
<step performance="required">
|
||||
<para>
|
||||
Edit this local copy of <filename>sqldemo.am</filename>:
|
||||
</para>
|
||||
|
||||
<substeps>
|
||||
|
||||
<step performance="required">
|
||||
<para>
|
||||
Search for 'null_clause = "NULL"
|
||||
</para>
|
||||
</step>
|
||||
|
||||
<step performance="required">
|
||||
<para>
|
||||
Change this to null_clause = ""
|
||||
</para>
|
||||
</step>
|
||||
</substeps>
|
||||
</step>
|
||||
<step performance="required">
|
||||
<para>
|
||||
Start <application>Applix Macro Editor</application>.
|
||||
</para>
|
||||
</step>
|
||||
<step performance="required">
|
||||
<para>
|
||||
Open the sqldemo.am file from the <application>Macro Editor</application>.
|
||||
</para>
|
||||
</step>
|
||||
|
||||
<step performance="required">
|
||||
<para>
|
||||
Select <command>File->Compile and Save</command>.
|
||||
</para>
|
||||
</step>
|
||||
|
||||
<step performance="required">
|
||||
<para>
|
||||
Exit <application>Macro Editor</application>.
|
||||
</para>
|
||||
</step>
|
||||
|
||||
<step performance="required">
|
||||
<para>
|
||||
Start <application>Applix Data</application>.
|
||||
</para>
|
||||
</step>
|
||||
|
||||
<step performance="required">
|
||||
<para>
|
||||
Select <command>*->Run Macro</command>
|
||||
</para>
|
||||
</step>
|
||||
|
||||
<step performance="required">
|
||||
<para>
|
||||
Enter the value <quote>sqldemo</quote>, then click <command>OK</command>.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
You should see the progress in the status line of the data window
|
||||
(in the lower left corner).
|
||||
</para>
|
||||
</step>
|
||||
|
||||
<step performance="required">
|
||||
<para>
|
||||
You should now be able to access the demo tables.
|
||||
</para>
|
||||
</step>
|
||||
|
||||
</procedure>
|
||||
</sect2>
|
||||
|
||||
<sect2>
|
||||
<title>Useful Macros</title>
|
||||
|
||||
<para>
|
||||
You can add information about your
|
||||
database login and password to the standard Applix startup
|
||||
macro file. This is an example
|
||||
<filename>~/axhome/macros/login.am</filename> file:
|
||||
|
||||
<programlisting>
|
||||
macro login
|
||||
set_set_system_var@("sql_username@","tgl")
|
||||
|
||||
@ -1,11 +1,15 @@
|
||||
<!--
|
||||
$Header: /cvsroot/pgsql/doc/src/sgml/postgres.sgml,v 1.26 1999/06/01 17:26:18 thomas Exp $
|
||||
$Header: /cvsroot/pgsql/doc/src/sgml/postgres.sgml,v 1.27 1999/06/03 04:21:49 thomas Exp $
|
||||
|
||||
Postgres integrated documentation.
|
||||
Other subset docs should be copied and shrunk from here.
|
||||
thomas 1998-02-23
|
||||
|
||||
$Log: postgres.sgml,v $
|
||||
Revision 1.27 1999/06/03 04:21:49 thomas
|
||||
Markup changes for v6.5 release.
|
||||
Clean out duplicate stuff in odbc.sgml resulting from a faulty patch.
|
||||
|
||||
Revision 1.26 1999/06/01 17:26:18 thomas
|
||||
Make sure that only one intro is included in the integrated doc.
|
||||
Multiple intros cause trouble since they have some section elements
|
||||
@ -102,10 +106,11 @@ Move SQL reference pages up into the User's Guide.
|
||||
<!entity y2k SYSTEM "y2k.sgml">
|
||||
|
||||
<!-- tutorial -->
|
||||
<!entity intro SYSTEM "intro.sgml">
|
||||
<!entity arch SYSTEM "arch.sgml">
|
||||
<!entity start SYSTEM "start.sgml">
|
||||
<!entity intro SYSTEM "intro.sgml">
|
||||
<!entity query SYSTEM "query.sgml">
|
||||
<!entity sql SYSTEM "sql.sgml">
|
||||
<!entity start SYSTEM "start.sgml">
|
||||
|
||||
<!-- user's guide -->
|
||||
<!entity advanced SYSTEM "advanced.sgml">
|
||||
@ -121,7 +126,6 @@ Move SQL reference pages up into the User's Guide.
|
||||
<!entity oper SYSTEM "oper.sgml">
|
||||
<!entity pgaccess SYSTEM "pgaccess.sgml">
|
||||
<!entity psql SYSTEM "psql.sgml">
|
||||
<!entity sql SYSTEM "sql.sgml">
|
||||
<!entity query-ug SYSTEM "query-ug.sgml">
|
||||
<!entity storage SYSTEM "storage.sgml">
|
||||
<!entity syntax SYSTEM "syntax.sgml">
|
||||
@ -219,7 +223,7 @@ Move SQL reference pages up into the User's Guide.
|
||||
|
||||
<LegalNotice>
|
||||
<Para>
|
||||
<ProductName>PostgreSQL</ProductName> is © 1998-9
|
||||
<ProductName>PostgreSQL</ProductName> is Copyright © 1996-9
|
||||
by the Postgres Global Development Group.
|
||||
</Para>
|
||||
</LegalNotice>
|
||||
@ -254,20 +258,6 @@ Your name here...
|
||||
</Para>
|
||||
</Preface>
|
||||
|
||||
<part Id="part-tutorial">
|
||||
<Title>Tutorial</Title>
|
||||
<PartIntro>
|
||||
<Para>
|
||||
Introduction for new users.
|
||||
</Para>
|
||||
</PartIntro>
|
||||
&intro;
|
||||
&arch;
|
||||
&start;
|
||||
&query;
|
||||
&advanced;
|
||||
</Part>
|
||||
|
||||
<part Id="part-user">
|
||||
<Title>User's Guide</Title>
|
||||
<PartIntro>
|
||||
@ -276,7 +266,6 @@ Your name here...
|
||||
</Para>
|
||||
</PartIntro>
|
||||
|
||||
&sql;
|
||||
&syntax;
|
||||
&datatype;
|
||||
&oper;
|
||||
@ -383,6 +372,21 @@ Your name here...
|
||||
&page;
|
||||
</Part>
|
||||
|
||||
<part Id="part-tutorial">
|
||||
<Title>Tutorial</Title>
|
||||
<PartIntro>
|
||||
<Para>
|
||||
Introduction for new users.
|
||||
</Para>
|
||||
</PartIntro>
|
||||
&intro;
|
||||
&sql;
|
||||
&arch;
|
||||
&start;
|
||||
&query;
|
||||
&advanced;
|
||||
</Part>
|
||||
|
||||
<part Id="part-appendix">
|
||||
<Title>Appendices</Title>
|
||||
<PartIntro>
|
||||
|
||||
@ -1,10 +1,14 @@
|
||||
<!--
|
||||
$Header: /cvsroot/pgsql/doc/src/sgml/Attic/programmer.sgml,v 1.16 1999/05/26 17:30:30 thomas Exp $
|
||||
$Header: /cvsroot/pgsql/doc/src/sgml/Attic/programmer.sgml,v 1.17 1999/06/03 04:21:49 thomas Exp $
|
||||
|
||||
Postgres Programmer's Guide.
|
||||
- thomas 1998-10-27
|
||||
|
||||
$Log: programmer.sgml,v $
|
||||
Revision 1.17 1999/06/03 04:21:49 thomas
|
||||
Markup changes for v6.5 release.
|
||||
Clean out duplicate stuff in odbc.sgml resulting from a faulty patch.
|
||||
|
||||
Revision 1.16 1999/05/26 17:30:30 thomas
|
||||
Add chapters on CVS access, MVCC, SQL theory to the docs.
|
||||
Add an appendix with more details on date/time attributes and handling.
|
||||
@ -148,7 +152,7 @@ Bigger updates to the installation instructions (install and config).
|
||||
|
||||
<LegalNotice>
|
||||
<Para>
|
||||
<ProductName>PostgreSQL</ProductName> is © 1998-9
|
||||
<ProductName>PostgreSQL</ProductName> is Copyright © 1996-9
|
||||
by the Postgres Global Development Group.
|
||||
</Para>
|
||||
</LegalNotice>
|
||||
|
||||
@ -1,8 +1,8 @@
|
||||
<Chapter Id="release">
|
||||
<Title>Release Notes</Title>
|
||||
<chapter>
|
||||
<title>Release Notes</title>
|
||||
|
||||
<Sect1>
|
||||
<Title>Release 6.5</Title>
|
||||
<sect1>
|
||||
<title>Release 6.5</title>
|
||||
<!--
|
||||
<docinfo>
|
||||
<authorgroup>
|
||||
@ -15,84 +15,130 @@
|
||||
</docinfo>
|
||||
-->
|
||||
|
||||
<para>
|
||||
This release marks the development team's final mastery of the source
|
||||
code we inherited from Berkeley. You will see we are now easily adding
|
||||
major features, thanks to the increasing size and experience of our
|
||||
world-wide development team: Here is a brief, incomplete summary:
|
||||
<para>
|
||||
This release marks a major step in the development team's mastery of the source
|
||||
code we inherited from Berkeley. You will see we are now easily adding
|
||||
major features, thanks to the increasing size and experience of our
|
||||
world-wide development team.
|
||||
</para>
|
||||
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>
|
||||
Multi-version concurrency control(MVCC): This removes our old
|
||||
table-level locking, and replaces it with a locking system that is
|
||||
superior to most commercial database systems. In a traditional system,
|
||||
each row that is modified is locked until committed, preventing reads by
|
||||
other users. MVCC uses the natural multi-version nature of PostgreSQL
|
||||
to allow readers to continue reading consistent data during writer
|
||||
activity. Writers continue to use the compact pg_log transaction
|
||||
system. This is all preformed without having to allocate a lock for
|
||||
every row like traditional database systems. So, basically, we no
|
||||
longer have table-level locking, we have something better than row-level
|
||||
locking.
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>
|
||||
Numeric data type: We now have a true numeric data type, with
|
||||
user-specified precision.
|
||||
</para>
|
||||
</listitem>
|
||||
<para>
|
||||
Here is a brief summary of some of the more noticable changes:
|
||||
|
||||
<listitem>
|
||||
<para>
|
||||
Temporary tables: Temporary tables are guaranteed to have unique names
|
||||
within a database session, and are destroyed on session exit.
|
||||
</para>
|
||||
</listitem>
|
||||
<variablelist>
|
||||
<varlistentry>
|
||||
<term>
|
||||
Multi-version concurrency control(MVCC)
|
||||
</term>
|
||||
<listitem>
|
||||
<para>
|
||||
This removes our old
|
||||
table-level locking, and replaces it with a locking system that is
|
||||
superior to most commercial database systems. In a traditional system,
|
||||
each row that is modified is locked until committed, preventing reads by
|
||||
other users. MVCC uses the natural multi-version nature of PostgreSQL
|
||||
to allow readers to continue reading consistent data during writer
|
||||
activity. Writers continue to use the compact pg_log transaction
|
||||
system. This is all preformed without having to allocate a lock for
|
||||
every row like traditional database systems. So, basically, we no
|
||||
longer have table-level locking, we have something better than row-level
|
||||
locking.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<listitem>
|
||||
<para>
|
||||
New SQL features: We now have CASE, INTERSECT, and EXCEPT statement
|
||||
support. We have new LIMIT/OFFSET, SET TRANSACTION ISOLATION LEVEL,
|
||||
SELECT ... FOR UPDATE, and an improved LOCK command.
|
||||
</para>
|
||||
</listitem>
|
||||
<varlistentry>
|
||||
<term>
|
||||
Numeric data type
|
||||
</term>
|
||||
<listitem>
|
||||
<para>
|
||||
We now have a true numeric data type, with
|
||||
user-specified precision.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<listitem>
|
||||
<para>
|
||||
Speedups: We continue to speed up PostgreSQL, thanks to the variety of
|
||||
talents within our team. We have sped up memory allocation,
|
||||
optimization, table joins, and row transfers routines.
|
||||
</para>
|
||||
</listitem>
|
||||
<varlistentry>
|
||||
<term>
|
||||
Temporary tables
|
||||
</term>
|
||||
<listitem>
|
||||
<para>
|
||||
Temporary tables are guaranteed to have unique names
|
||||
within a database session, and are destroyed on session exit.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<listitem>
|
||||
<para>
|
||||
Other: We continue to expand our port list, this time including
|
||||
Win32/NT. Most interfaces have new versions, and existing functionality
|
||||
has been improved.
|
||||
</para>
|
||||
</listitem>
|
||||
<varlistentry>
|
||||
<term>
|
||||
New SQL features
|
||||
</term>
|
||||
<listitem>
|
||||
<para>
|
||||
We now have CASE, INTERSECT, and EXCEPT statement
|
||||
support. We have new LIMIT/OFFSET, SET TRANSACTION ISOLATION LEVEL,
|
||||
SELECT ... FOR UPDATE, and an improved LOCK command.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
</itemizedlist>
|
||||
</para>
|
||||
<varlistentry>
|
||||
<term>
|
||||
Speedups
|
||||
</term>
|
||||
<listitem>
|
||||
<para>
|
||||
We continue to speed up PostgreSQL, thanks to the variety of
|
||||
talents within our team. We have sped up memory allocation,
|
||||
optimization, table joins, and row transfer routines.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<sect2>
|
||||
<title>Migration to v6.5</title>
|
||||
<varlistentry>
|
||||
<term>
|
||||
Ports
|
||||
</term>
|
||||
<listitem>
|
||||
<para>
|
||||
We continue to expand our port list, this time including
|
||||
WinNT/ix86 and NetBSD/arm32.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<para>
|
||||
A dump/restore using <application>pg_dump</application>
|
||||
or <application>pg_dumpall</application>
|
||||
is required for those wishing to migrate data from any
|
||||
previous release of <productname>Postgres</productname>.
|
||||
</para>
|
||||
</sect2>
|
||||
<sect2>
|
||||
<title>Detailed Change List</title>
|
||||
<varlistentry>
|
||||
<term>
|
||||
Interfaces
|
||||
</term>
|
||||
<listitem>
|
||||
<para>
|
||||
Most interfaces have new versions, and existing functionality
|
||||
has been improved.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
</para>
|
||||
|
||||
<para>
|
||||
<programlisting>
|
||||
<sect2>
|
||||
<title>Migration to v6.5</title>
|
||||
|
||||
<para>
|
||||
A dump/restore using <application>pg_dump</application>
|
||||
or <application>pg_dumpall</application>
|
||||
is required for those wishing to migrate data from any
|
||||
previous release of <productname>Postgres</productname>.
|
||||
</para>
|
||||
</sect2>
|
||||
|
||||
<sect2>
|
||||
<title>Detailed Change List</title>
|
||||
|
||||
<para>
|
||||
<programlisting>
|
||||
Bug Fixes
|
||||
---------
|
||||
Fix text<->float8 and text<->float4 conversion functions(Thomas)
|
||||
@ -237,14 +283,14 @@ Add ARM32 support(Andrew McMurry)
|
||||
Better support for HPUX 11 and Unixware
|
||||
Improve file handling to be more uniform, prevent file descriptor leak(Tom)
|
||||
New install commands for plpgsql(Jan)
|
||||
</programlisting>
|
||||
</Para>
|
||||
</sect2>
|
||||
</Sect1>
|
||||
</programlisting>
|
||||
</para>
|
||||
</sect2>
|
||||
</sect1>
|
||||
|
||||
|
||||
<Sect1>
|
||||
<Title>Release 6.4.2</Title>
|
||||
<sect1>
|
||||
<title>Release 6.4.2</title>
|
||||
<!--
|
||||
<docinfo>
|
||||
<authorgroup>
|
||||
@ -278,14 +324,14 @@ A dump/restore is <emphasis>not</emphasis> required for those running
|
||||
<programlisting>
|
||||
Fix for datetime constant problem on some platforms(Thomas)
|
||||
</programlisting>
|
||||
</Para>
|
||||
</para>
|
||||
</sect2>
|
||||
</Sect1>
|
||||
</sect1>
|
||||
|
||||
|
||||
|
||||
<Sect1>
|
||||
<Title>Release 6.4.1</Title>
|
||||
<sect1>
|
||||
<title>Release 6.4.1</title>
|
||||
<!--
|
||||
<docinfo>
|
||||
<authorgroup>
|
||||
@ -348,14 +394,14 @@ Add routines to help with single-byte (internal) character type(Thomas)
|
||||
Compilation of libpq for Win32 fixes(Magnus)
|
||||
Upgrade to PyGreSQL 2.2(D'Arcy)
|
||||
</programlisting>
|
||||
</Para>
|
||||
</para>
|
||||
</sect2>
|
||||
</Sect1>
|
||||
</sect1>
|
||||
|
||||
|
||||
|
||||
<Sect1>
|
||||
<Title>Release 6.4</Title>
|
||||
<sect1>
|
||||
<title>Release 6.4</title>
|
||||
<!--
|
||||
<docinfo>
|
||||
<authorgroup>
|
||||
@ -374,7 +420,7 @@ Thanks to our developers and maintainers, nearly every aspect of the system
|
||||
has received some attention since the previous release.
|
||||
Here is a brief, incomplete summary:
|
||||
|
||||
<itemizedlist spacing="compact">
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<para>
|
||||
Views and rules are now functional thanks to extensive new code in the
|
||||
@ -652,12 +698,12 @@ smarter perl configuration(Brook)
|
||||
configure uses supplied install-sh if no install script found(Tom)
|
||||
new Makefile.shlib for shared library configuration(Tom)
|
||||
</programlisting>
|
||||
</Para>
|
||||
</para>
|
||||
</sect2>
|
||||
</Sect1>
|
||||
</sect1>
|
||||
|
||||
<Sect1>
|
||||
<Title>Release 6.3.2</Title>
|
||||
<sect1>
|
||||
<title>Release 6.3.2</title>
|
||||
<!--
|
||||
<docinfo>
|
||||
<authorgroup>
|
||||
@ -677,7 +723,7 @@ Refer to the release notes for v6.3 for a more complete summary of new features.
|
||||
<para>
|
||||
Summary:
|
||||
|
||||
<itemizedlist spacing="compact">
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<para>
|
||||
Repairs automatic configuration support for some platforms, including Linux,
|
||||
@ -693,7 +739,7 @@ Correctly handles function calls on the left side of BETWEEN and LIKE clauses.
|
||||
|
||||
</itemizedlist>
|
||||
</para>
|
||||
<Para>
|
||||
<para>
|
||||
A dump/restore is NOT required for those running 6.3 or 6.3.1. A
|
||||
'make distclean', 'make', and 'make install' is all that is required.
|
||||
This last step should be performed while the postmaster is not running.
|
||||
@ -733,8 +779,8 @@ ASSERT fixes(Bruce)
|
||||
</para>
|
||||
</sect2>
|
||||
</sect1>
|
||||
<Sect1>
|
||||
<Title>Release 6.3.1</Title>
|
||||
<sect1>
|
||||
<title>Release 6.3.1</title>
|
||||
<!--
|
||||
<docinfo>
|
||||
<authorgroup>
|
||||
@ -752,7 +798,7 @@ Mon Mar 23 10:21:52 EST 1998
|
||||
<para>
|
||||
Summary:
|
||||
|
||||
<itemizedlist spacing="compact">
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<para>
|
||||
Additional support for multi-byte character sets.
|
||||
@ -779,7 +825,7 @@ Improvements to the configuration autodetection for installation.
|
||||
|
||||
</itemizedlist>
|
||||
</para>
|
||||
<Para>
|
||||
<para>
|
||||
A dump/restore is NOT required for those running 6.3. A
|
||||
'make distclean', 'make', and 'make install' is all that is required.
|
||||
This last step should be performed while the postmaster is not running.
|
||||
@ -828,8 +874,8 @@ Better identify tcl and tk libs and includes(Bruce)
|
||||
</para>
|
||||
</sect2>
|
||||
</sect1>
|
||||
<Sect1>
|
||||
<Title>Release 6.3</Title>
|
||||
<sect1>
|
||||
<title>Release 6.3</title>
|
||||
<!--
|
||||
<docinfo>
|
||||
<authorgroup>
|
||||
@ -848,7 +894,7 @@ Sun Mar 1 14:57:30 EST 1998
|
||||
There are <emphasis>many</emphasis> new features and improvements in this release.
|
||||
Here is a brief, incomplete summary:
|
||||
|
||||
<itemizedlist spacing="compact">
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<para>
|
||||
Many new SQL features, including
|
||||
@ -1143,12 +1189,12 @@ Add string functions to regression suite(Thomas)
|
||||
Expand a few function names formerly truncated to 16 characters(Thomas)
|
||||
Remove un-needed malloc() calls and replace with palloc()(Bruce)
|
||||
</programlisting>
|
||||
</Para>
|
||||
</para>
|
||||
</sect2>
|
||||
</Sect1>
|
||||
</sect1>
|
||||
|
||||
<Sect1>
|
||||
<Title>Release 6.2.1</Title>
|
||||
<sect1>
|
||||
<title>Release 6.2.1</title>
|
||||
<!--
|
||||
<docinfo>
|
||||
<authorgroup>
|
||||
@ -1169,7 +1215,7 @@ v6.2.1 is a bug-fix and usability release on v6.2.
|
||||
<para>
|
||||
Summary:
|
||||
|
||||
<itemizedlist spacing="compact">
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<para>
|
||||
Allow strings to span lines, per <acronym>SQL92</acronym>.
|
||||
@ -1236,10 +1282,10 @@ Trigger function for inserting user names for INSERT/UPDATE(Brook Milligan)
|
||||
</programlisting>
|
||||
</para>
|
||||
</sect2>
|
||||
</Sect1>
|
||||
</sect1>
|
||||
|
||||
<Sect1>
|
||||
<Title>Release 6.2</Title>
|
||||
<sect1>
|
||||
<title>Release 6.2</title>
|
||||
<!--
|
||||
<docinfo>
|
||||
<authorgroup>
|
||||
@ -1399,8 +1445,8 @@ SPI and Trigger programming guides (Vadim & D'Arcy)
|
||||
</sect2>
|
||||
</sect1>
|
||||
|
||||
<Sect1>
|
||||
<Title>Release 6.1.1</Title>
|
||||
<sect1>
|
||||
<title>Release 6.1.1</title>
|
||||
<!--
|
||||
<docinfo>
|
||||
<authorgroup>
|
||||
@ -1455,8 +1501,8 @@ pg_dumpall now returns proper status, portability fix(Bruce)
|
||||
</sect2>
|
||||
</sect1>
|
||||
|
||||
<Sect1>
|
||||
<Title>Release 6.1</Title>
|
||||
<sect1>
|
||||
<title>Release 6.1</title>
|
||||
<!--
|
||||
<docinfo>
|
||||
<authorgroup>
|
||||
@ -1471,21 +1517,22 @@ Sun Jun 8 14:41:13 EDT 1997
|
||||
</docinfo>
|
||||
-->
|
||||
|
||||
<Para>
|
||||
<para>
|
||||
The regression tests have been adapted and extensively modified for the
|
||||
v6.1 release of <productname>Postgres</productname>.
|
||||
</Para>
|
||||
</para>
|
||||
|
||||
<Para>
|
||||
<para>
|
||||
Three new data types (datetime, timespan, and circle) have been added to
|
||||
the native set of <productname>Postgres</productname> types. Points, boxes, paths, and polygons
|
||||
have had their output formats made consistant across the data types.
|
||||
The polygon output in misc.out has only been spot-checked for correctness
|
||||
relative to the original regression output.
|
||||
</Para>
|
||||
</para>
|
||||
|
||||
<Para>
|
||||
<productname>Postgres</productname> v6.1 introduces a new, alternate optimizer which uses <FirstTerm>genetic</FirstTerm>
|
||||
<para>
|
||||
<productname>Postgres</productname> v6.1 introduces a new, alternate
|
||||
optimizer which uses <firstterm>genetic</firstterm>
|
||||
algorithms. These algorithms introduce a random behavior in the ordering
|
||||
of query results when the query contains multiple qualifiers or multiple
|
||||
tables (giving the optimizer a choice on order of evaluation). Several
|
||||
@ -1493,28 +1540,28 @@ Sun Jun 8 14:41:13 EDT 1997
|
||||
hence are insensitive to optimizer choices. A few regression tests are
|
||||
for data types which are inherently unordered (e.g. points and time
|
||||
intervals) and tests involving those types are explicitly bracketed with
|
||||
<Command>set geqo to 'off'</Command> and <Command>reset geqo</Command>.
|
||||
</Para>
|
||||
<command>set geqo to 'off'</command> and <command>reset geqo</command>.
|
||||
</para>
|
||||
|
||||
<Para>
|
||||
<para>
|
||||
The interpretation of array specifiers (the curly braces around atomic
|
||||
values) appears to have changed sometime after the original regression
|
||||
tests were generated. The current <FileName>./expected/*.out</FileName> files reflect this
|
||||
tests were generated. The current <filename>./expected/*.out</filename> files reflect this
|
||||
new interpretation, which may not be correct!
|
||||
</Para>
|
||||
</para>
|
||||
|
||||
<Para>
|
||||
<para>
|
||||
The float8 regression test fails on at least some platforms. This is due
|
||||
to differences in implementations of pow() and exp() and the signaling
|
||||
mechanisms used for overflow and underflow conditions.
|
||||
</Para>
|
||||
</para>
|
||||
|
||||
<Para>
|
||||
<para>
|
||||
The "random" results in the random test should cause the "random" test
|
||||
to be "failed", since the regression tests are evaluated using a simple
|
||||
diff. However, "random" does not seem to produce random results on my
|
||||
test machine (Linux/gcc/i686).
|
||||
</Para>
|
||||
</para>
|
||||
|
||||
<sect2>
|
||||
<title>Migration to v6.1</title>
|
||||
@ -2440,40 +2487,40 @@ Initial release.
|
||||
</para>
|
||||
</sect1>
|
||||
|
||||
<Sect1>
|
||||
<Title>Timing Results</Title>
|
||||
<sect1>
|
||||
<title>Timing Results</title>
|
||||
|
||||
<Para>
|
||||
<para>
|
||||
These timing results are from running the regression test with the commands
|
||||
|
||||
<ProgramListing>
|
||||
<programlisting>
|
||||
% cd src/test/regress
|
||||
% make all
|
||||
% time make runtest
|
||||
</ProgramListing>
|
||||
</programlisting>
|
||||
</para>
|
||||
<Para>
|
||||
<para>
|
||||
Timing under Linux 2.0.27 seems to have a roughly 5% variation from run
|
||||
to run, presumably due to the scheduling vagaries of multitasking systems.
|
||||
</para>
|
||||
<Sect2>
|
||||
<Title>v6.4beta</Title>
|
||||
<sect2>
|
||||
<title>v6.4beta</title>
|
||||
|
||||
<para>
|
||||
The times for this release are not directly comparable to those for previous releases
|
||||
since some additional regression tests have been included.
|
||||
In general, however, v6.4 should be slightly faster than the previous release (thanks, Bruce!).
|
||||
</para>
|
||||
<Para>
|
||||
<ProgramListing>
|
||||
<para>
|
||||
<programlisting>
|
||||
Time System
|
||||
02:26 Dual Pentium Pro 180, 96MB, UW-SCSI, Linux 2.0.30, gcc 2.7.2.1 -O2 -m486
|
||||
</ProgramListing>
|
||||
</programlisting>
|
||||
</para>
|
||||
</sect2>
|
||||
|
||||
<Sect2>
|
||||
<Title>v6.3</Title>
|
||||
<sect2>
|
||||
<title>v6.3</title>
|
||||
|
||||
<para>
|
||||
The times for this release are not directly comparable to those for previous releases
|
||||
@ -2481,26 +2528,43 @@ since some additional regression tests have been included and some obsolete test
|
||||
time travel have been removed.
|
||||
In general, however, v6.3 is substantially faster than previous releases (thanks, Bruce!).
|
||||
</para>
|
||||
<Para>
|
||||
<ProgramListing>
|
||||
<para>
|
||||
<programlisting>
|
||||
Time System
|
||||
02:30 Dual Pentium Pro 180, 96MB, UW-SCSI, Linux 2.0.30, gcc 2.7.2.1 -O2 -m486
|
||||
04:12 Dual Pentium Pro 180, 96MB, EIDE, Linux 2.0.30, gcc 2.7.2.1 -O2 -m486
|
||||
</ProgramListing>
|
||||
</programlisting>
|
||||
</para>
|
||||
</sect2>
|
||||
|
||||
<Sect2>
|
||||
<Title>v6.1</Title>
|
||||
<sect2>
|
||||
<title>v6.1</title>
|
||||
|
||||
<Para>
|
||||
<ProgramListing>
|
||||
<para>
|
||||
<programlisting>
|
||||
Time System
|
||||
06:12 Pentium Pro 180, 32MB, EIDE, Linux 2.0.30, gcc 2.7.2 -O2 -m486
|
||||
12:06 P-100, 48MB, Linux 2.0.29, gcc
|
||||
39:58 Sparc IPC 32MB, Solaris 2.5, gcc 2.7.2.1 -O -g
|
||||
</ProgramListing>
|
||||
</programlisting>
|
||||
</para>
|
||||
</sect2>
|
||||
</sect1>
|
||||
</Chapter>
|
||||
</chapter>
|
||||
|
||||
<!-- Keep this comment at the end of the file
|
||||
Local variables:
|
||||
mode: sgml
|
||||
sgml-omittag:nil
|
||||
sgml-shorttag:t
|
||||
sgml-minimize-attributes:nil
|
||||
sgml-always-quote-attributes:t
|
||||
sgml-indent-step:1
|
||||
sgml-indent-data:t
|
||||
sgml-parent-document:nil
|
||||
sgml-default-dtd-file:"./reference.ced"
|
||||
sgml-exposed-tags:nil
|
||||
sgml-local-catalogs:"/usr/lib/sgml/catalog"
|
||||
sgml-local-ecat-files:nil
|
||||
End:
|
||||
-->
|
||||
|
||||
@ -13,12 +13,13 @@
|
||||
<!entity notation SYSTEM "notation.sgml">
|
||||
<!entity y2k SYSTEM "y2k.sgml">
|
||||
|
||||
<!entity intro SYSTEM "intro.sgml">
|
||||
<!entity arch SYSTEM "arch.sgml">
|
||||
<!entity start SYSTEM "start.sgml">
|
||||
<!entity query SYSTEM "query.sgml">
|
||||
<!entity advanced SYSTEM "advanced.sgml">
|
||||
<!entity arch SYSTEM "arch.sgml">
|
||||
<!entity biblio SYSTEM "biblio.sgml">
|
||||
<!entity intro SYSTEM "intro.sgml">
|
||||
<!entity query SYSTEM "query.sgml">
|
||||
<!entity sql SYSTEM "sql.sgml">
|
||||
<!entity start SYSTEM "start.sgml">
|
||||
]>
|
||||
<Book Id="tutorial">
|
||||
|
||||
@ -54,7 +55,7 @@
|
||||
|
||||
<LegalNotice>
|
||||
<Para>
|
||||
<ProductName>PostgreSQL</ProductName> is copyright (©) 1998-9
|
||||
<ProductName>PostgreSQL</ProductName> is Copyright © 1996-9
|
||||
by the Postgres Global Development Group.
|
||||
</Para>
|
||||
</LegalNotice>
|
||||
@ -90,6 +91,7 @@ Your name here...
|
||||
</Preface>
|
||||
|
||||
&intro;
|
||||
&sql;
|
||||
&arch;
|
||||
&start;
|
||||
&query;
|
||||
|
||||
@ -1,11 +1,15 @@
|
||||
<!--
|
||||
$Header: /cvsroot/pgsql/doc/src/sgml/Attic/user.sgml,v 1.11 1999/05/26 17:30:30 thomas Exp $
|
||||
$Header: /cvsroot/pgsql/doc/src/sgml/Attic/user.sgml,v 1.12 1999/06/03 04:21:51 thomas Exp $
|
||||
|
||||
Postgres User's Manual.
|
||||
Derived from postgres.sgml.
|
||||
thomas 1998-02-24
|
||||
|
||||
$Log: user.sgml,v $
|
||||
Revision 1.12 1999/06/03 04:21:51 thomas
|
||||
Markup changes for v6.5 release.
|
||||
Clean out duplicate stuff in odbc.sgml resulting from a faulty patch.
|
||||
|
||||
Revision 1.11 1999/05/26 17:30:30 thomas
|
||||
Add chapters on CVS access, MVCC, SQL theory to the docs.
|
||||
Add an appendix with more details on date/time attributes and handling.
|
||||
@ -69,7 +73,6 @@ Move SQL reference pages up into the User's Guide.
|
||||
<!entity manage SYSTEM "manage.sgml">
|
||||
<!entity mvcc SYSTEM "mvcc.sgml">
|
||||
<!entity oper SYSTEM "oper.sgml">
|
||||
<!entity sql SYSTEM "sql.sgml">
|
||||
<!entity storage SYSTEM "storage.sgml">
|
||||
<!entity syntax SYSTEM "syntax.sgml">
|
||||
<!entity typeconv SYSTEM "typeconv.sgml">
|
||||
@ -113,7 +116,7 @@ Move SQL reference pages up into the User's Guide.
|
||||
|
||||
<LegalNotice>
|
||||
<Para>
|
||||
<ProductName>PostgreSQL</ProductName> is © 1998-9
|
||||
<ProductName>PostgreSQL</ProductName> is Copyright © 1996-9
|
||||
by the Postgres Global Development Group.
|
||||
</Para>
|
||||
</LegalNotice>
|
||||
@ -149,7 +152,6 @@ Your name here...
|
||||
</Preface>
|
||||
|
||||
&intro;
|
||||
&sql;
|
||||
&syntax;
|
||||
&datatype;
|
||||
&oper;
|
||||
|
||||
Loading…
Reference in New Issue
Block a user