head	1.9;
access;
symbols
	REL7_1_BETA3:1.8
	REL7_1_BETA2:1.8
	REL7_1:1.8
	REL7_0_PATCHES:1.8.0.2
	REL7_0:1.8
	REL6_5_PATCHES:1.5.0.2
	REL6_5:1.5
	REL6_4:1.4.0.2
	release-6-3:1.1;
locks; strict;
comment	@# @;


1.9
date	2001.02.03.19.03.26;	author petere;	state dead;
branches;
next	1.8;

1.8
date	2000.03.31.03.27.40;	author thomas;	state Exp;
branches;
next	1.7;

1.7
date	2000.03.30.22.22.40;	author thomas;	state Exp;
branches;
next	1.6;

1.6
date	99.10.04.15.18.54;	author thomas;	state Exp;
branches;
next	1.5;

1.5
date	99.06.01.17.26.18;	author thomas;	state Exp;
branches;
next	1.4;

1.4
date	98.10.25.00.24.35;	author thomas;	state Exp;
branches;
next	1.3;

1.3
date	98.09.30.05.41.44;	author thomas;	state Exp;
branches;
next	1.2;

1.2
date	98.07.29.06.35.16;	author thomas;	state Exp;
branches;
next	1.1;

1.1
date	98.03.01.08.15.55;	author thomas;	state Exp;
branches;
next	;


desc
@@


1.9
log
@Update, polish, consistencify preface/intro sections.
@
text
@<!--
$Header: /home/projects/pgsql/cvsroot/pgsql/doc/src/sgml/intro-pg.sgml,v 1.8 2000/03/31 03:27:40 thomas Exp $
-->

 <chapter id="intro-pg">
  <title>Introduction</title>

  <para>
   This document is the programmer's  manual  for  the  
   <ulink url="http://postgresql.org/"><productname>PostgreSQL</productname></ulink>
   database  management system, originally developed at the University
   of California at Berkeley.

   <productname>PostgreSQL</productname>  is  based  on
   <ulink url="http://s2k-ftp.CS.Berkeley.EDU:8000/postgres/postgres.html">
    <productname>Postgres release 4.2</productname></ulink>. 
   The <productname>Postgres</productname> project, 
   led by Professor Michael Stonebraker, has been sponsored  by  the
   Defense  Advanced Research Projects Agency (<acronym>DARPA</acronym>), the
   Army Research Office (<acronym>ARO</acronym>), the National Science  
   Foundation (<acronym>NSF</acronym>), and ESL, Inc.
  </para>

  <para>
   The first part of this manual 
   explains  the <productname>Postgres</productname>  
   approach  to  extensibility  and describe how
   users can extend <productname>Postgres</productname> 
   by adding user-defined types,
   operators, aggregates, and both query language and programming 
   language functions.
   After a discussion  of  the <productname>Postgres</productname> 
   rule system, we discuss
   the trigger and SPI interfaces.
   The manual concludes with a detailed description of 
   the programming interfaces and
   support libraries for various languages.
  </para>

  <para>
   We assume proficiency with Unix and C programming.
  </para>

   &info;
   &notation;
   &problems;
   &y2k;
   &legal;

 </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:
-->
@


1.8
log
@Minor markup changes. Refer to (".../catalog") in the emacs hints.
@
text
@d2 1
a2 1
$Header$
@


1.7
log
@Accumulated fixups.
Add some chapters on new topics.
Change to referencing OASIS/Docbook v3.1 rather than Davenport/Docbook v3.0
Grepped for and fixed apparent tag mangling from emacs
 "Normalize" operation. Should be the last of those.
@
text
@d1 4
d64 1
a64 1
sgml-local-catalogs:("/usr/lib/sgml/CATALOG")
@


1.6
log
@Expunge "UNIX" in favor of "Unix".
A few other changes, but I forget what :(
@
text
@d42 1
d50 1
a50 1
mode: sgml
d60 1
a60 1
sgml-local-catalogs:"/usr/lib/sgml/CATALOG"
@


1.5
log
@Make sure that only one intro is included in the integrated doc.
Multiple intros cause trouble since they have some section elements
 (e.g. "y2k.sgml") in common leading to duplicate labels.
Include emacs formatting hints in the intro*.sgml sources.
@
text
@d37 1
a37 1
   We assume proficiency with UNIX and C programming.
@


1.4
log
@Add Y2K statement for intros.
Make sure notation section is included in most intros.
@
text
@d1 2
a2 2
<Chapter Id="intro-pg">
<TITLE>Introduction</TITLE>
d4 59
a62 45
<Para>
This document is the programmer's  manual  for  the  
<Ulink url="http://postgresql.org/"><ProductName>PostgreSQL</ProductName></Ulink>
database  management system, originally developed at the University
of California at Berkeley.

<ProductName>PostgreSQL</ProductName>  is  based  on
     <Ulink url="http://s2k-ftp.CS.Berkeley.EDU:8000/postgres/postgres.html">
     <ProductName>Postgres release 4.2</ProductName></Ulink>. 
The <ProductName>Postgres</ProductName> project, 
     led by Professor Michael Stonebraker, has been sponsored  by  the
     Defense  Advanced Research Projects Agency (<Acronym>DARPA</Acronym>), the
     Army Research Office (<Acronym>ARO</Acronym>), the National Science  
     Foundation (<Acronym>NSF</Acronym>), and ESL, Inc.
</Para>

<Para>
The first part of this manual 
explains  the <ProductName>Postgres</ProductName>  
approach  to  extensibility  and describe how
users can extend <ProductName>Postgres</ProductName> 
by adding user-defined types,
operators, aggregates, and both query language and programming 
language functions.
     After a discussion  of  the <ProductName>Postgres</ProductName> 
rule system, we discuss
the trigger and SPI interfaces.
     The manual concludes with a detailed description of 
the programming interfaces and
     support libraries for various languages.
</Para>

<Para>
     We assume proficiency with UNIX and C programming.
</Para>

&info;

&notation;

&y2k;

&legal;

</Chapter>
@


1.3
log
@Clean up pages. Add information for operator precedence.
Split introduction sections into separate files to allow the legal notice
 and notation sections appear in all documents without having the history
 show up everplace too.
Add full list of reserved and non-reserved key words in syntax.sgml.
Add a separate chapter to the admin guide on security.
@
text
@d5 4
a8 4
     This document is the programmer's  manual  for  the  
     <Ulink url="http://postgresql.org/"><ProductName>PostgreSQL</ProductName></Ulink>
     database  management system, originally developed at the University
     of California at  Berkeley.
d21 2
a22 2
     The first part of this manual 
     explains  the <ProductName>Postgres</ProductName>  
d24 1
a24 1
     users can extend <ProductName>Postgres</ProductName> 
d26 1
a26 1
     operators, aggregates, and both query language and programming 
d28 3
a30 3
     After an extremely  brief
     overview  of  the <ProductName>Postgres</ProductName> rule system, we discuss
     the trigger and SPI interfaces.
d40 2
d43 2
@


1.2
log
@Add port information for NS32532.
Fix Id tag in chapter headings to allow meaningful file names in html.
@
text
@d8 3
a10 1
     of California at  Berkeley.   <ProductName>PostgreSQL</ProductName>  is  based  on
d22 6
a27 4
     explains  the
     <ProductName>Postgres</ProductName>  approach  to  extensibility  and describe how
     users can extend <ProductName>Postgres</ProductName> by adding user-defined types,
     operators, aggregates, and both query language and programming language functions.
d31 2
a32 1
     The manual concludes with a detailed description of the programming interfaces and
d40 1
a40 29
<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>
<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>
d42 1
a42 8
<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>
@


1.1
log
@SGML source for new documentation.
@
text
@d1 1
a1 1
<Chapter>
@

