Add Y2K statement for intros.

Make sure notation section is included in most intros.

diff --git a/doc/src/sgml/admin.sgml b/doc/src/sgml/admin.sgml
index 31c026d27a87694cf081650d83d2ba93100897ec..c2da76e1961ec95db0a5b1aec78fb0c8addee507 100644 (file)
--- a/doc/src/sgml/admin.sgml
+++ b/doc/src/sgml/admin.sgml
@@ -16,6 +16,7 @@ $log$
 
 
 
+
 
 
 

diff --git a/doc/src/sgml/intro-ag.sgml b/doc/src/sgml/intro-ag.sgml
index d54187b72bb469756a03592fa93d75b70694b0fd..9693d3a68ededaf00057b9c3e97aebe9461e4e7e 100644 (file)
--- a/doc/src/sgml/intro-ag.sgml
+++ b/doc/src/sgml/intro-ag.sgml
@@ -17,8 +17,12 @@ The Postgres project,
      Foundation (NSF), and ESL, Inc.
 
 
+&info;
+
 ¬ation;
 
+&y2k;
+
 &legal;
 
 

diff --git a/doc/src/sgml/intro-pg.sgml b/doc/src/sgml/intro-pg.sgml
index cd9b98073f9786bed32159c1a4b8a19ca3076d99..98b16b1601e362d01aa84ca9e3bb49a4ddaf1541 100644 (file)
--- a/doc/src/sgml/intro-pg.sgml
+++ b/doc/src/sgml/intro-pg.sgml
@@ -2,10 +2,10 @@
 Introduction
 
 
-     This document is the programmer's  manual  for  the  
-     PostgreSQL
-     database  management system, originally developed at the University
-     of California at  Berkeley.
+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
      
@@ -18,16 +18,16 @@ The Postgres project,
 
 
 
-     The first part of this manual 
-     explains  the Postgres  
+The first part of this manual 
+explains  the Postgres  
 approach  to  extensibility  and describe how
-     users can extend Postgres 
+users can extend Postgres 
 by adding user-defined types,
-     operators, aggregates, and both query language and programming 
+operators, aggregates, and both query language and programming 
 language functions.
-     After an extremely  brief
-     overview  of  the Postgres rule system, we discuss
-     the trigger and SPI interfaces.
+     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.
@@ -37,8 +37,12 @@ the programming interfaces and
      We assume proficiency with UNIX and C programming.
 
 
+&info;
+
 ¬ation;
 
+&y2k;
+
 &legal;
 
 

diff --git a/doc/src/sgml/intro.sgml b/doc/src/sgml/intro.sgml
index b777099bcf3166298a22887d0bd1929e1e2e3815..e283a5e5b8928ac0de5b88e05189ea75eb4572e6 100644 (file)
--- a/doc/src/sgml/intro.sgml
+++ b/doc/src/sgml/intro.sgml
@@ -74,6 +74,10 @@ have recently incorporated features pioneered by Postgres
 
 &info;
 
+¬ation;
+
+&y2k;
+
 &legal;
 
 

diff --git a/doc/src/sgml/notation.sgml b/doc/src/sgml/notation.sgml
index f31a9c0858368f572534026f521cb9097eab6557..5bde955945139b35ce44186084fc645553e6fb99 100644 (file)
--- a/doc/src/sgml/notation.sgml
+++ b/doc/src/sgml/notation.sgml
@@ -14,22 +14,23 @@ particular set of installed
 
 
 The 
-Postgres super-user
+Postgres superuser
 is the user named postgres
  who owns the Postgres
-binaries and database files.  As the database super-user, all
+binaries and database files.  As the database superuser, all
 protection mechanisms may be bypassed and any data accessed
 arbitrarily.  
-In addition, the Postgres super-user is allowed to execute
+In addition, the Postgres superuser is allowed to execute
 some support programs which are generally not available to all users.
-Note that the Postgres super-user is
+Note that the Postgres superuser is
 not
-the same as the Unix super-user (root),
-and should have a non-zero userid for security reasons.
+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 base administrator
+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
@@ -62,12 +63,34 @@ site.
 Notation
 
 
-... at the front of a file name is used to represent the
-path to the Postgres super-user's home directory.  
-Anything in brackets
-[ and ]) is optional.  Anything in braces
-({ and }) can be repeated 0 or more times.
-Parentheses (( and )) are used to group boolean
+... or /usr/local/pgsql/ 
+at the front of a file name is used to represent the
+path to the Postgres superuser's home directory.
+
+
+In a command synopsis, brackets
+[ and ]) indicate an optional phrase or keyword.
+Anything in braces
+({ and }) and containing vertical bars (|)
+ indicates that you must choose one.
+
+
+In examples, parentheses (( and )) are used to group boolean
 expressions.  | is the boolean operator OR.
 
-
\ No newline at end of file
+
+Examples will show commands executed from various accounts and programs.
+Commands executed from the root account will be preceeded with >.
+Commands executed from the superuser account will be preceeded with $.
+SQL commands will be preceeded with =>
+or will have no leading prompt.
+
+
+
+At the time of writing (Postgres v6.4) 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 f5e35668bbdb49b26dea58b7bd75310d4491e4c2..b17691465ef01016be4a17afc33aa650201d1fe7 100644 (file)
--- a/doc/src/sgml/postgres.sgml
+++ b/doc/src/sgml/postgres.sgml
@@ -1,11 +1,15 @@
 
 
@@ -221,6 +226,7 @@ Installation and maintenance information.
 &intro-ag;
 &ports;
 &install;
+&runtime;
 &options;
 &start-ag;
 &recovery;

diff --git a/doc/src/sgml/programmer.sgml b/doc/src/sgml/programmer.sgml
index 7f62767ef5f589a28a09758dea04496e4919c4ba..060066dc3bcd9a542c9117060f8e3de5c65da198 100644 (file)
--- a/doc/src/sgml/programmer.sgml
+++ b/doc/src/sgml/programmer.sgml
@@ -16,6 +16,7 @@ $log$
 
 
 
+
 
 
 
@@ -152,6 +153,7 @@ It provides SQL92/SQL3 language support,
 &xaggr;
 &rules;
 &xindex;
+&xplang;
 &gist;
 &dfunc;
 
@@ -167,11 +169,19 @@ It provides SQL92/SQL3 language support,
 &ecpg;
 &odbc;
 &jdbc;
-&xplang;
 
 
 
-&arch-dev;
+
+
 &geqo;
 &protocol;
 &signals;

diff --git a/doc/src/sgml/y2k.sgml b/doc/src/sgml/y2k.sgml
new file mode 100644 (file)
index 0000000..a2d9f2e
--- /dev/null
+++ b/doc/src/sgml/y2k.sgml
@@ -0,0 +1,64 @@
+
+Y2K Statement
+
+
+
+Author
+
+
+Written by 
+Thomas Lockhart
+on 1998-10-22.
+
+
+
+The PostgreSQL Global Development Team provides
+the Postgres software code tree as a public service,
+without warranty and without liability for it's behavior or performance.
+However, at the time of writing:
+
+
+
+
+The author of this statement, a volunteer on the Postgres
+ support team since November, 1996, is not aware of 
+any problems in the Postgres code base related
+to time transitions around Jan 1, 2000 (Y2K).
+
+
+
+The author of this statement is not aware of any reports of Y2K problems 
+uncovered in regression testing
+or in other field use of recent or current versions
+of Postgres. We might have expected
+to hear about problems if they existed, given the installed base and
+the active participation of users on the support mailing lists.
+
+
+
+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
+ in the chapter on data types.
+For two-digit years, the significant transition year is 1970, not 2000;
+i.e. 70-01-01 is interpreted as 1970-01-01,
+whereas 69-01-01 is interpreted as 2069-01-01.
+
+
+
+Any Y2K problems in the underlying OS related to obtaining "the
+current time" may propagate into apparent Y2K problems in
+Postgres.
+
+
+
+
+Refer to 
+The Gnu Project
+and
+The Perl Institute
+for further discussion of Y2K issues, particularly
+ as it relates to open source, no fee software.
+
+
\ No newline at end of file