diff --git a/doc/src/sgml/Makefile b/doc/src/sgml/Makefile index 0c7c1589faa..888b9bc6d64 100644 --- a/doc/src/sgml/Makefile +++ b/doc/src/sgml/Makefile @@ -8,7 +8,7 @@ # # # IDENTIFICATION -# $Header: /cvsroot/pgsql/doc/src/sgml/Makefile,v 1.28 2001/01/06 16:54:16 petere Exp $ +# $Header: /cvsroot/pgsql/doc/src/sgml/Makefile,v 1.29 2001/02/03 19:03:26 petere Exp $ # #---------------------------------------------------------------------------- @@ -85,7 +85,7 @@ man: $(ALLSGML) ## HTML ## -JADE.html = $(JADE) $(JADEFLAGS) $(SGMLINCLUDE) -d $(HDSL) -V %use-id-as-filename% -t sgml +JADE.html = $(JADE) $(JADEFLAGS) $(SGMLINCLUDE) -d $(HDSL) -V %use-id-as-filename% -V %generate-legalnotice-link% -t sgml postgres.html: postgres.sgml $(ALLSGML) @rm -f *.htm diff --git a/doc/src/sgml/about.sgml b/doc/src/sgml/about.sgml deleted file mode 100644 index 1d562fab7a3..00000000000 --- a/doc/src/sgml/about.sgml +++ /dev/null @@ -1,37 +0,0 @@ - - About This Release - - - PostgreSQL is available without cost. This manual - describes version &version; of PostgreSQL. - - - - We will use Postgres - to mean the version distributed as PostgreSQL. - - - - Check the Administrator's Guide for a list of currently supported machines. - In general, - Postgres is portable to any Unix/Posix-compatible system - with full libc library support. - - - - diff --git a/doc/src/sgml/admin.sgml b/doc/src/sgml/admin.sgml index fc8fe193236..51a78b3b306 100644 --- a/doc/src/sgml/admin.sgml +++ b/doc/src/sgml/admin.sgml @@ -1,55 +1,27 @@ - <![%single-book;[PostgreSQL &version;]]> Administrator's Guide + PostgreSQL &version; Administrator's Guide + The PostgreSQL Global Development Group - - - Thomas - Lockhart - - Caltech/JPL - - - - - - PostgreSQL is Copyright © 1996-2001 - by PostgreSQL Global Development Group - - - + &legal; - - Summary - - - Postgres, - 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/SQL99 language support, - transaction integrity, and type extensibility. - PostgreSQL is an open-source descendant - of this original Berkeley code. - - - + &installation; &installw; &runtime; @@ -62,6 +34,7 @@ $Header: /cvsroot/pgsql/doc/src/sgml/Attic/admin.sgml,v 1.31 2001/01/24 23:15:19 &recovery; ®ress; &release; + diff --git a/doc/src/sgml/developer.sgml b/doc/src/sgml/developer.sgml index 4cd9a876856..59d4c15db88 100644 --- a/doc/src/sgml/developer.sgml +++ b/doc/src/sgml/developer.sgml @@ -1,18 +1,19 @@ - + - <![%single-book;[PostgreSQL &version;]]> Developer's Guide + PostgreSQL &version; Developer's Guide + The PostgreSQL Global Development Group + &legal; + This document contains assorted information that can be of use to PostgreSQL developers. - - The PostgreSQL Global Development Group &sources; diff --git a/doc/src/sgml/filelist.sgml b/doc/src/sgml/filelist.sgml index 21174ae420c..ae27be1999a 100644 --- a/doc/src/sgml/filelist.sgml +++ b/doc/src/sgml/filelist.sgml @@ -1,6 +1,5 @@ - + - @@ -45,7 +44,6 @@ - @@ -63,7 +61,6 @@ - diff --git a/doc/src/sgml/history.sgml b/doc/src/sgml/history.sgml index df55881665e..ae4f1cb4d27 100644 --- a/doc/src/sgml/history.sgml +++ b/doc/src/sgml/history.sgml @@ -1,22 +1,22 @@ A Short History of <productname>Postgres</productname> - The Object-Relational Database Management System now known as + The object-relational database management system now known as PostgreSQL (and briefly called Postgres95) is derived from the - Postgres package written at Berkeley. - With over a decade of + Postgres package written at the University of + California at Berkeley. With over a decade of development behind it, PostgreSQL is the most advanced open-source database available anywhere, offering multi-version concurrency control, supporting almost all SQL constructs (including subselects, transactions, and user-defined types and functions), and having a wide range of - language bindings available (including C, C++, Java, perl, tcl, and python). + language bindings available (including C, C++, Java, Perl, Tcl, and Python). diff --git a/doc/src/sgml/info.sgml b/doc/src/sgml/info.sgml index 753bdd2f795..195e56e7f36 100644 --- a/doc/src/sgml/info.sgml +++ b/doc/src/sgml/info.sgml @@ -1,165 +1,163 @@ - Resources + Documentation Resources This manual set is organized into several parts: + + + + Tutorial + + + An introduction for new users. Does not cover advanced features. + + + + + + User's Guide + + + Documents the SQL query language environment, including data types + and functions. + + + + + + Programmer's Guide + + + Advanced information for application programmers. Topics include + type and function extensibility, library interfaces, + and application design issues. + + + + + + Administrator's Guide + + + Installation and server management information + + + + + + Reference Manual + + + Reference pages for SQL command syntax and client and server programs + + + + + + Developer's Guide + + + Information for Postgres developers. + This is intended for those who are contributing to the + Postgres project; + application development information should appear in the + Programmer's Guide. + + + + - - - Tutorial - - - An introduction for new users. Does not cover advanced features. - - - - - - User's Guide - - - General information for users, including available commands and data types. - - - - - - Programmer's Guide - - - Advanced information for application programmers. Topics include - type and function extensibility, library interfaces, - and application design issues. - - - - - - Administrator's Guide - - - Installation and management information. List of supported machines. - - - - - - Developer's Guide - - - Information for Postgres developers. - This is intended for those who are contributing to the - Postgres project; - application development information should appear in the - Programmer's Guide. - Currently included in the Programmer's Guide. - - - - - - Reference Manual - - - Detailed reference information on command syntax. - Currently included in the User's Guide. - - - - - In addition to this manual set, there are other resources to help you with Postgres installation and use: + + + + man pages + + + The Reference Manual's pages in the traditional + Unix man format. + + + + + + FAQs + + + Frequently Asked Questions (FAQ) lists document both general issues + and some platform-specific issues. + + + + + + READMEs + + + README files are available for some contributed packages. + + + + + + Web Site + + + The PostgreSQL + web site carries details on the latest release, upcoming + features, and other information to make your work or play with + PostgreSQL more productive. + + + + + + Mailing Lists + + + The pgsql-general@postgresql.org (archive) + mailing list is a good place to have user questions answered. + Other mailing lists are available; consult the User's + Lounge section of the PostgreSQL web site for details. + + + + + + Yourself! + + + PostgreSQL is an open source effort. + As such, it depends on the user community for ongoing support. + As you begin to use PostgreSQL, you + will rely on others for help, either through the documentation + or through the mailing lists. Consider contributing your + knowledge back. If you learn something which is not in the + documentation, write it up and contribute it. If you add + features to the code, contribute it. + + + + Even those without a lot of experience can provide corrections + and minor changes in the documentation, and that is a good way + to start. The pgsql-docs@postgresql.org (archive) + mailing list is the place to get going. + + + + - - - - man pages - - - The man pages have general information on command syntax. - - - - - - FAQs - - - The Frequently Asked Questions (FAQ) documents address both general issues - and some platform-specific issues. - - - - - - READMEs - - - README files are available for some contributed packages. - - - - - - Web Site - - - The - Postgres - web site might have some information not appearing in the distribution. - There is a mhonarc catalog of mailing list traffic - which is a rich resource for many topics. - - - - - - Mailing Lists - - - The - pgsql-general@postgresql.org - (archive) - mailing list is a good place to have user questions answered. - Other mailing lists are available; consult the Info Central section of the - PostgreSQL web site for details. - - - - - - Yourself! - - - Postgres is an open source product. - As such, it depends on the user community for ongoing support. - As you begin to use Postgres, - you will rely on others for help, either through the - documentation or through the mailing lists. - Consider contributing your knowledge back. If you learn something - which is not in the documentation, write it up and contribute it. - If you add features to the code, contribute it. - - - - Even those without a lot of experience can provide corrections and - minor changes in the documentation, and that is a good way to start. - The - pgsql-docs@postgresql.org - (archive) - mailing list is the place to get going. - - - - - - - - Introduction - - - This document is the Administrator's Manual for the - PostgreSQL - database management system, originally developed at the University - of California at Berkeley. - - PostgreSQL is based on - - Postgres release 4.2. - The Postgres project, - led by Professor Michael Stonebraker, was sponsored by the - Defense Advanced Research Projects Agency (DARPA), the - Army Research Office (ARO), the National Science - Foundation (NSF), and ESL, Inc. - - - &info; - ¬ation; - &problems; - &y2k; - &legal; - - - - diff --git a/doc/src/sgml/intro-pg.sgml b/doc/src/sgml/intro-pg.sgml deleted file mode 100644 index c9d45834306..00000000000 --- a/doc/src/sgml/intro-pg.sgml +++ /dev/null @@ -1,67 +0,0 @@ - - - - Introduction - - - This document is the programmer's manual for the - PostgreSQL - database management system, originally developed at the University - of California at Berkeley. - - PostgreSQL is based on - - Postgres release 4.2. - The Postgres project, - led by Professor Michael Stonebraker, has been sponsored by the - Defense Advanced Research Projects Agency (DARPA), the - Army Research Office (ARO), the National Science - Foundation (NSF), and ESL, Inc. - - - - The first part of this manual - explains the Postgres - approach to extensibility and describe how - users can extend Postgres - by adding user-defined types, - operators, aggregates, and both query language and programming - language functions. - After a discussion of the Postgres - 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. - - - - We assume proficiency with Unix and C programming. - - - &info; - ¬ation; - &problems; - &y2k; - &legal; - - - - diff --git a/doc/src/sgml/intro.sgml b/doc/src/sgml/intro.sgml index bdc1e935a07..50819cdb773 100644 --- a/doc/src/sgml/intro.sgml +++ b/doc/src/sgml/intro.sgml @@ -1,33 +1,39 @@ - - Introduction - - - This document is the user manual for the - PostgreSQL - database management system, originally developed at the University - of California at Berkeley. - - PostgreSQL is based on - - Postgres release 4.2. - The Postgres project, - led by Professor Michael Stonebraker, was sponsored by the - Defense Advanced Research Projects Agency - (DARPA), the - Army Research Office (ARO), the National Science - Foundation (NSF), and ESL, Inc. - + + Preface - What is <productname>Postgres</productname>? + What is <productname>PostgreSQL</productname>? + PostgreSQL is an object-relational + database management system (ORDBMS) based on + + POSTGRES, Version 4.2, + developed at the University of California at Berkeley Computer + Science Department. The POSTGRES + project, led by Professor Michael Stonebraker, was sponsored by + the Defense Advanced Research Projects Agency + (DARPA), the Army Research Office + (ARO), the National Science Foundation + (NSF), and ESL, Inc. + + + + PostgreSQL is an open-source descendant of + this original Berkeley code. It provides SQL92/SQL99 language support + and other modern features. + + + + POSTGRES pioneered many of the + object-relational concepts now becoming available in some commercial + databases. Traditional relational database management systems - (DBMSs) support a data model consisting of a collection + (RDBMS) support a data model consisting of a collection of named relations, containing attributes of a specific type. In current commercial systems, possible types include floating point numbers, integers, character @@ -35,18 +41,17 @@ $Header: /cvsroot/pgsql/doc/src/sgml/intro.sgml,v 1.13 2001/01/13 23:58:55 peter that this model is inadequate for future data processing applications. The relational model successfully replaced previous - models in part because of its "Spartan simplicity". + models in part because of its Spartan simplicity. However, as mentioned, this simplicity often makes the implementation of certain applications very difficult. Postgres offers substantial additional - power by incorporating the following four additional - basic concepts in such a way that users can easily + power by incorporating the following additional + concepts in such a way that users can easily extend the system: - tables inheritance - types + data types functions @@ -78,14 +83,12 @@ $Header: /cvsroot/pgsql/doc/src/sgml/intro.sgml,v 1.13 2001/01/13 23:58:55 peter &history; - &about; &info; ¬ation; &problems; &y2k; - &legal; - + - - Copyrights and Trademarks + + 1996-2001 + PostgreSQL Global Development Group + + + + Legal Notice PostgreSQL is Copyright © 1996-2001 - by PostgreSQL Global Development Group - and is distributed under the terms of the Berkeley license. + by the PostgreSQL Global Development Group and is distributed under + the terms of the license of the University of California below. Postgres95 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. + - 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. + 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. + - 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. + 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. + + + + 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. + + - - Terminology - - - The - Postgres superuser - is the user named postgres - who owns the Postgres - binaries and database files. As the database superuser, all - protection mechanisms may be bypassed and any data accessed - arbitrarily. - In addition, the Postgres superuser is - allowed to execute - some support programs which are generally not available to all users. - Note that the Postgres superuser is - not - the same as the Unix superuser (which will be referred to as - root). - The superuser should have a non-zero user identifier - (UID) for security reasons. - - - - The - database administrator - or DBA, is the person who is responsible for installing - Postgres with mechanisms to - enforce a security policy for a site. The DBA can add new users by - the method described below - and maintain a set of template databases for use by - createdb. - - - - The postmaster - is the process that acts as a clearing-house for requests - to the Postgres system. - Frontend applications connect to the postmaster, - which keeps tracks of any system errors and communication between the - backend processes. The postmaster - can take several command-line arguments to tune its behavior. - However, supplying arguments is necessary only if you intend to run multiple - sites or a non-default site. - - - - The Postgres backend - (the actual executable program postgres) may be executed - directly from the user shell by the - Postgres super-user - (with the database name as an argument). However, - doing this bypasses the shared buffer pool and lock table associated - with a postmaster/site, therefore this is not recommended in a multiuser - site. - - - - Notation + Terminology and Notation - "..." or /usr/local/pgsql/ - at the front of a file name is used to represent the - path to the Postgres superuser's home directory. + The terms Postgres and PostgreSQL will be + used interchangeably to refer to the software that accompanies this + documentation. + + + + An administrator is generally a person who is + in charge of installing and running the server. A user + could be anyone who is using, or wants to use, any part of the + PostgreSQL system. These terms should not + be interpreted too narrowly; this documentation set does not have fixed + presumptions about system administration procedures. + + + + /usr/local/pgsql/ is generally used as the root + directory of the installation and /usr/local/pgsql/data + as the directory with the database files. These directories may vary + on your site, details can be derived in the Administrator's Guide. @@ -77,28 +36,19 @@ $Header: /cvsroot/pgsql/doc/src/sgml/notation.sgml,v 1.13 2000/12/22 21:51:58 pe indicates that you must choose one. - - In examples, parentheses ("(" and ")") are - used to group boolean - expressions. "|" is the boolean operator OR. - - Examples will show commands executed from various accounts and programs. - Commands executed from the root account will be preceeded with - ">". - Commands executed from the Postgres - superuser account will be preceeded with "%", while commands - executed from an unprivileged user's account will be preceeded with - "$". - SQL commands will be preceeded with "=>" + Commands executed from a Unix shell may be preceeded with a dollar sign + ($). Commands executed from particular user + accounts such as root or postgres are specially flagged and explained. + SQL commands may be preceeded with + => or will have no leading prompt, depending on the context. - At the time of writing (Postgres 7.0) - the notation for + The notation for flagging commands is not universally consistant throughout the documentation set. Please report problems to the documentation mailing list diff --git a/doc/src/sgml/postgres.sgml b/doc/src/sgml/postgres.sgml index 28532e6252b..22d8bec6de3 100644 --- a/doc/src/sgml/postgres.sgml +++ b/doc/src/sgml/postgres.sgml @@ -1,5 +1,5 @@ The PostgreSQL Global Development Group + &legal; &tutorial; diff --git a/doc/src/sgml/problems.sgml b/doc/src/sgml/problems.sgml index 2bc5148115e..1267994d65e 100644 --- a/doc/src/sgml/problems.sgml +++ b/doc/src/sgml/problems.sgml @@ -1,9 +1,9 @@ - - Problem Reporting Guidelines + + Bug Reporting Guidelines - When you encounter a problem in PostgreSQL we want to - hear about it. Your bug reports are an important part in making + When you find a bug in PostgreSQL we want to + hear about it. Your bug reports play an important part in making PostgreSQL more reliable because even the utmost care cannot guarantee that every part of PostgreSQL will work on every platform under every circumstance. @@ -21,7 +21,7 @@ could also happen that we tell you to update to a newer version to see if the bug happens there. Or we might decide that the bug cannot be fixed before some major rewrite we might be planning is done. Or - perhaps it's simply too hard and there are more important things on the agenda. + perhaps it is simply too hard and there are more important things on the agenda. If you need help immediately, consider obtaining a commercial support contract. @@ -29,21 +29,21 @@ Identifying Bugs - Before you ask "Is this a bug?", please read and re-read the + Before you report a bug, please read and re-read the documentation to verify that you can really do whatever it is you are trying. If it is not clear from the documentation whether you can do - something or not, please report that too; it's a bug in the documentation. + something or not, please report that too; it is a bug in the documentation. If it turns out that the program does something different from what the - documentation says, that's a bug. That might include, but is not limited to, + documentation says, that is a bug. That might include, but is not limited to, the following circumstances: A program terminates with a fatal signal or an operating system - error message that would point to a problem in the program (a - counterexample might be a "disk full" message, - since that must be fixed outside of Postgres). + error message that would point to a problem in the program. (A + counterexample might be a disk full message, + since you have to fix that yourself.) @@ -55,13 +55,15 @@ - A program refuses to accept valid input. + A program refuses to accept valid input (as defined in the documentation). A program accepts invalid input without a notice or error message. + Keep in mind that your idea of invalid input might be our idea of + an extension or compatibility with traditional practice. @@ -73,7 +75,7 @@ - Here "program" refers to any executable, not only the backend server. + Here program refers to any executable, not only the backend server. @@ -85,7 +87,7 @@ Before you continue, check on the TODO list and in the FAQ to see if your bug is - already known. If you can't decode the information on the TODO list, report your + already known. If you cannot decode the information on the TODO list, report your problem. The least we can do is make the TODO list clearer. @@ -104,7 +106,7 @@ Reporting the bare facts is relatively straightforward (you can probably copy and paste them from the screen) but all too often important details are left out because someone - thought it doesn't matter or the report would be understood + thought it does not matter or the report would be understood anyway. @@ -127,11 +129,11 @@ that shows the problem. (Be sure to not have anything in your ~/.psqlrc start-up file.) You are encouraged to minimize the size of your example, but this is not absolutely necessary. - If the bug is reproduceable, we'll find it either way. + If the bug is reproduceable, we will find it either way. If your application uses some other client interface, such as PHP, then - please try to isolate the offending queries. We probably won't set up a + please try to isolate the offending queries. We will probably not set up a web server to reproduce your problem. In any case remember to provide the exact input files, do not guess that the problem happens for "large files" or "mid-size databases", etc. since this @@ -141,9 +143,9 @@ - The output you got. Please do not say that it "didn't work" or - "failed". If there is an error message, - show it, even if you don't understand it. If the program terminates with + The output you got. Please do not say that it didn't work or + crashed. If there is an error message, + show it, even if you do not understand it. If the program terminates with an operating system error, say which. If nothing at all happens, say so. Even if the result of your test case is a program crash or otherwise obvious it might not happen on our platform. The easiest thing is to copy the output @@ -164,7 +166,7 @@ The output you expected is very important to state. If you just write "This command gives me that output." or "This is not what I expected.", we might run it ourselves, scan the output, and - think it looks okay and is exactly what we expected. We shouldn't have to + think it looks okay and is exactly what we expected. We should not have to spend the time to decode the exact semantics behind your commands. Especially refrain from merely saying that "This is not what SQL says/Oracle does." Digging out the correct behavior from SQL @@ -194,19 +196,26 @@ The PostgreSQL version. You can run the command SELECT version(); to - find out what version you are currently running. - If this function does not exist, say so, then we know that - your version is old enough. If you can't start up the server or a - client, look into the README file in the source directory or at the - name of your distribution file or package name. If your version is older - than 7.0 we will almost certainly tell you to upgrade. There are tons - of bug fixes in each new version, that's why we write them. - - + find out the version of the server you are connected to. Most executable + programs also support a option; at least + postmaster --version and psql --version + should work. + If the function or the options do not exist then your version is probably + old enough. You can also look into the README file + in the source directory or at the + name of your distribution file or package name. If you run a pre-packaged version, such as RPMs, say so, including any subversion the package may have. If you are talking about a CVS snapshot, mention that, including its date and time. + + + If your version is older than &version; we will almost certainly tell + you to upgrade. There are tons + of bug fixes in each new release, that is why we make new releases. + + + @@ -222,7 +231,7 @@ Do not be afraid if your bug report becomes rather lengthy. That is a fact of life. - It's better to report everything the first time than us having to squeeze the + It is better to report everything the first time than us having to squeeze the facts out of you. On the other hand, if your input files are huge, it is fair to ask first whether somebody is interested in looking into it. @@ -230,9 +239,9 @@ Do not spend all your time to figure out which changes in the input make the problem go away. This will probably not help solving it. If it turns - out that the bug can't be fixed right away, you will still have time to + out that the bug cannot be fixed right away, you will still have time to find and share your work around. Also, once again, do not waste your time - guessing why the bug exists. We'll find that out soon enough. + guessing why the bug exists. We will find that out soon enough. @@ -240,7 +249,7 @@ The software package as such is called "PostgreSQL", sometimes "Postgres" for short. (Sometimes the abbreviation "Pgsql" is used but don't do that.) When you - are specifically talking about the backend server, mention that, don't + are specifically talking about the backend server, mention that, do not just say "Postgres crashes". The interactive frontend is called "psql" and is for all intends and purposes completely separate from the backend. diff --git a/doc/src/sgml/programmer.sgml b/doc/src/sgml/programmer.sgml index f326af433e7..81bbf426539 100644 --- a/doc/src/sgml/programmer.sgml +++ b/doc/src/sgml/programmer.sgml @@ -1,51 +1,41 @@ - <![%single-book;[PostgreSQL &version;]]> Programmer's Guide + PostgreSQL &version; Programmer's Guide The PostgreSQL Global Development Group - - - Thomas - Lockhart - - Caltech/JPL - - - - - - PostgreSQL is Copyright © 1996-2001 - by PostgreSQL Global Development Group - - - + &legal; - - Summary + + + + Organization - Postgres, - 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/SQL99 language support, - transaction integrity, and type extensibility. - PostgreSQL is an - open-source descendant of this original Berkeley code. + The first part of this manual is the description of the client-side + programming interfaces and support libraries for various languages. + The second part explains the PostgreSQL + approach to extensibility and describe how users can extend + PostgreSQL by adding user-defined types, + operators, aggregates, and both query language and programming + language functions. After a discussion of the + PostgreSQL rule system, we discuss the + trigger and SPI interfaces. + + + + Proficiency with Unix and C programming is assumed. - - Client Interfaces &libpq; diff --git a/doc/src/sgml/reference.sgml b/doc/src/sgml/reference.sgml index 0683e5d825b..803cd0843dc 100644 --- a/doc/src/sgml/reference.sgml +++ b/doc/src/sgml/reference.sgml @@ -1,21 +1,15 @@ - <![%single-book;[PostgreSQL &version;]]> Reference Manual + PostgreSQL &version; Reference Manual The PostgreSQL Global Development Group - - - - PostgreSQL is © 1998-2000 - by PostgreSQL Global Development Group - - + &legal; diff --git a/doc/src/sgml/tutorial.sgml b/doc/src/sgml/tutorial.sgml index ef411cb76ec..07e4ca67d5b 100644 --- a/doc/src/sgml/tutorial.sgml +++ b/doc/src/sgml/tutorial.sgml @@ -1,45 +1,15 @@ - <![%single-book;[PostgreSQL &version;]]> Tutorial + PostgreSQL &version; Tutorial The PostgreSQL Global Development Group - - - Thomas - Lockhart - - Caltech/JPL - - - - - - PostgreSQL is Copyright © 1996-2001 - by PostgreSQL Global Development Group - - - + &legal; - - Summary - - - Postgres, - 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/SQL99 language support, - transaction integrity, and type extensibility. - PostgreSQL is an open-source descendant - of this original Berkeley code. - - - diff --git a/doc/src/sgml/user.sgml b/doc/src/sgml/user.sgml index 6bc09ed78d2..f0b3f4e5e3b 100644 --- a/doc/src/sgml/user.sgml +++ b/doc/src/sgml/user.sgml @@ -1,48 +1,20 @@ - <![%single-book;[PostgreSQL &version;]]> User's Guide + PostgreSQL &version; User's Guide + - The PostgreSQL Development Team - - - Thomas - Lockhart - - Caltech/JPL - - - - - - PostgreSQL is Copyright © 1996-2001 - by PostgreSQL Global Development Group - - - + The PostgreSQL Global Development Group + &legal; - - Summary - - - Postgres, - 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/SQL99 language support, - transaction integrity, and type extensibility. - PostgreSQL is an open-source descendant - of this original Berkeley code. - - - &intro; + &syntax; &queries; &datatype; diff --git a/doc/src/sgml/y2k.sgml b/doc/src/sgml/y2k.sgml index 4d3f0f8ccad..9d9b7b4a63c 100644 --- a/doc/src/sgml/y2k.sgml +++ b/doc/src/sgml/y2k.sgml @@ -1,5 +1,5 @@ @@ -16,8 +16,8 @@ $Header: /cvsroot/pgsql/doc/src/sgml/Attic/y2k.sgml,v 1.8 2000/12/22 21:51:58 pe - The PostgreSQL Global Development Team provides - the Postgres software code tree as a public service, + The PostgreSQL Global Development Group provides + the PostgreSQL software code tree as a public service, without warranty and without liability for it's behavior or performance. However, at the time of writing: @@ -48,8 +48,7 @@ $Header: /cvsroot/pgsql/doc/src/sgml/Attic/y2k.sgml,v 1.8 2000/12/22 21:51:58 pe To the best of the author's knowledge, the assumptions Postgres makes about dates specified with a two-digit year - are documented in the current - User's Guide + are documented in the current User's Guide in the chapter on data types. For two-digit years, the significant transition year is 1970, not 2000; e.g. "70-01-01" is interpreted as 1970-01-01,