diff --git a/doc/src/sgml/Makefile b/doc/src/sgml/Makefile index ad8c15aa78..b3c95e6978 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.35 2001/03/25 08:32:24 petere Exp $ +# $Header: /cvsroot/pgsql/doc/src/sgml/Makefile,v 1.36 2001/04/20 15:52:33 thomas Exp $ # #---------------------------------------------------------------------------- @@ -20,7 +20,7 @@ include $(top_builddir)/src/Makefile.global .NOTPARALLEL: ifndef DOCBOOKSTYLE -DOCBOOKSTYLE = /home/projects/pgsql/developers/thomas/db143.d/docbook +DOCBOOKSTYLE = /home/projects/pgsql/developers/thomas/db162.d/docbook endif ifndef JADE diff --git a/doc/src/sgml/biblio.sgml b/doc/src/sgml/biblio.sgml index fc33e9bc8a..fd97287870 100644 --- a/doc/src/sgml/biblio.sgml +++ b/doc/src/sgml/biblio.sgml @@ -1,5 +1,5 @@ @@ -236,7 +236,7 @@ $Header: /cvsroot/pgsql/doc/src/sgml/biblio.sgml,v 1.13 2000/05/02 20:01:51 thom Lockhart - 2000-05-01 + 2001-04-13 The PostgreSQL Global Development Group @@ -262,7 +262,7 @@ $Header: /cvsroot/pgsql/doc/src/sgml/biblio.sgml,v 1.13 2000/05/02 20:01:51 thom Lockhart - 2000-05-01 + 2001-04-13 The PostgreSQL Global Development Group @@ -288,7 +288,7 @@ $Header: /cvsroot/pgsql/doc/src/sgml/biblio.sgml,v 1.13 2000/05/02 20:01:51 thom Lockhart - 2000-05-01 + 2001-04-13 The PostgreSQL Global Development Group @@ -314,7 +314,7 @@ $Header: /cvsroot/pgsql/doc/src/sgml/biblio.sgml,v 1.13 2000/05/02 20:01:51 thom Lockhart - 2000-05-01 + 2001-04-13 The PostgreSQL Global Development Group @@ -340,7 +340,7 @@ $Header: /cvsroot/pgsql/doc/src/sgml/biblio.sgml,v 1.13 2000/05/02 20:01:51 thom Lockhart - 2000-05-01 + 2001-04-13 The PostgreSQL Global Development Group diff --git a/doc/src/sgml/catalogs.sgml b/doc/src/sgml/catalogs.sgml index c856c792b8..1738a5bf1d 100644 --- a/doc/src/sgml/catalogs.sgml +++ b/doc/src/sgml/catalogs.sgml @@ -1,6 +1,6 @@ @@ -1193,7 +1193,7 @@ lancompiler text - not useful + not currently used diff --git a/doc/src/sgml/charset.sgml b/doc/src/sgml/charset.sgml index d348030e9e..41301153f0 100644 --- a/doc/src/sgml/charset.sgml +++ b/doc/src/sgml/charset.sgml @@ -1,4 +1,4 @@ - + Localization</> @@ -108,7 +108,7 @@ export LANG=sv_SE </row> <row> <entry>LC_CTYPE</> - <entry>Character classification (What is a letter? What is the upper-case equivalent of this letter?)</> + <entry>Character classification (What is a letter? The upper-case equivalent?)</> </row> <row> <entry>LC_MESSAGES</> diff --git a/doc/src/sgml/docguide.sgml b/doc/src/sgml/docguide.sgml index 893ea8d463..192991c196 100644 --- a/doc/src/sgml/docguide.sgml +++ b/doc/src/sgml/docguide.sgml @@ -1,4 +1,4 @@ -<!-- $Header: /cvsroot/pgsql/doc/src/sgml/docguide.sgml,v 1.31 2001/02/17 16:52:53 tgl Exp $ --> +<!-- $Header: /cvsroot/pgsql/doc/src/sgml/docguide.sgml,v 1.32 2001/04/20 15:52:33 thomas Exp $ --> <appendix label="DG2" id="docguide"> <title>Documentation @@ -36,8 +36,8 @@ - The documentation is organized into several books - with varyingly confusing names: + The documentation is organized into several books: + @@ -49,6 +49,11 @@ User's Guide: documents the query language environment + + + Reference Manual: documents the query language + + Administrator's Guide: installation and server maintenance @@ -68,8 +73,8 @@ - All five books are available as HTML and Postscript. The - User's Guide contains reference entries which + All books are available as HTML and Postscript. The + Reference Manual contains reference entries which are also shipped as man pages. diff --git a/doc/src/sgml/func.sgml b/doc/src/sgml/func.sgml index d8dde6270a..a22d1eb8d2 100644 --- a/doc/src/sgml/func.sgml +++ b/doc/src/sgml/func.sgml @@ -1,4 +1,4 @@ - + Functions and Operators @@ -440,15 +440,15 @@ abs(x) - (same as argument type) + (same as x) absolute value abs(-17.4) 17.4 - cbrt(double precision) - double precision + cbrt(dp) + dp cube root cbrt(27.0) 3.0 @@ -463,17 +463,17 @@ - degrees(double precision) - double precision - convert radians to degrees + degrees(dp) + dp + radians to degrees degrees(0.5) 28.6478897565412 - exp(double precision) - double precision - exponential function + exp(dp) + dp + exponential exp(1.0) 2.71828182845905 @@ -487,25 +487,26 @@ - ln(double precision) - double precision + ln(dp) + dp natural logarithm ln(2.0) 0.693147180559945 - log(double precision) - double precision + log(dp) + dp base 10 logarithm log(100.0) 2.0 - log(base numeric, x numeric) + log(b numeric, + x numeric) numeric - logarithm to specified base + logarithm to base b log(2.0, 64.0) 6.0 @@ -513,55 +514,56 @@ mod(y, x) (same as argument types) - remainder (modulo) of the division y/x + remainder of y/x mod(9,4) 1 pi() - double precision + dp Pi constant pi() 3.14159265358979 - pow(double precision, double precision) - double precision - raise a number to the specified exponent + pow(e dp, + n dp) + dp + raise a number to exponent e pow(9.0, 3.0) 729.0 - radians(double precision) - double precision - convert degrees to radians + radians(dp) + dp + degrees to radians radians(45.0) 0.785398163397448 random() - double precision - a pseudo-random value between 0.0 to 1.0 + dp + value between 0.0 to 1.0 random() - round(double precision) - double precision + round(dp) + dp round to nearest integer round(42.4) 42 - round(value numeric, scale integer) + round(v numeric, s integer) numeric - round to specified number of decimal places + round to s decimal places round(42.4382, 2) 42.44 @@ -574,25 +576,25 @@ --> - sqrt(double precision) - double precision + sqrt(dp) + dp square root sqrt(2.0) 1.4142135623731 - trunc(double precision) - double precision - truncate (toward zero) + trunc(dp) + dp + truncate toward zero trunc(42.8) 42 - trunc(value numeric, scale integer) + trunc(numeric, s integer) numeric - truncate to specified number of decimal places + truncate to s decimal places round(42.4382, 2) 42.43 @@ -602,12 +604,16 @@ + In the table above, "dp" indicates double precision. The functions exp, ln, log, pow, round (1 argument), sqrt, and trunc (1 argument) are also available for the type numeric in place of double - precision. Many of these functions are implemented on top + precision. + Functions returning a numeric result take + numeric input arguments, unless otherwise specified. + Many of these functions are implemented on top of the host system's C library and behavior in boundary cases could therefore vary depending on the operating system. @@ -800,7 +806,7 @@ Function - Return type + Return Type Description Example Result @@ -840,8 +846,8 @@ initcap(text) text Converts first letter of each word (whitespace separated) to upper case. - initcap('hello thomas') - Hello Thomas + initcap('hi thomas') + Hi Thomas @@ -1362,9 +1368,14 @@ or bounded repetitions are nested. An RE like, say, ((((a{1,100}){1,100}){1,100}){1,100}){1,100} will (eventually) run almost any existing machine out of swap - space.This was written in 1994, mind you. The - numbers have probably changed, but the problem - persists. + space. + + + This was written in 1994, mind you. The + numbers have probably changed, but the problem + persists. + + @@ -2026,8 +2037,8 @@ 'Good number: 485' - to_char(485.8,'"Pre-decimal:"999" Post-decimal:" .999') - 'Pre-decimal: 485 Post-decimal: .800' + to_char(485.8,'"Pre:"999" Post:" .999') + 'Pre: 485 Post: .800' to_char(12,'99V999') @@ -2075,15 +2086,10 @@ - age(timestamp) interval - Subtract argument from current date, preserve years and months and days + Subtract from today age(timestamp '1957-06-13') 43 years 8 mons 3 days @@ -2091,17 +2097,15 @@ reasonable at all for that matter. age(timestamp, timestamp) interval - preserve months and years - age('now', timestamp '1957-06-13') - + Subtract arguments + age('2001-04-10', timestamp '1957-06-13') + 43 years 9 mons 27 days -]]> current_date date - - returns current date; see also Today's date; see below @@ -2111,8 +2115,7 @@ reasonable at all for that matter. current_time time - - returns current time (of day); see also Time of day; see below @@ -2122,8 +2125,7 @@ reasonable at all for that matter. current_timestamp timestamp - - returns current date and time; see also date and time; see also below @@ -2133,8 +2135,7 @@ reasonable at all for that matter. date_part(text, timestamp) double precision - - extract subfield from date/time value (equivalent to + Get subfield (equivalent to extract); see also below @@ -2145,8 +2146,7 @@ reasonable at all for that matter. date_part(text, interval) double precision - - extract subfield from interval value (equivalent to + Get subfield (equivalent to extract); see also below @@ -2157,8 +2157,7 @@ reasonable at all for that matter. date_trunc(text, timestamp) timestamp - - truncate date to specified precision; see also Truncate to specified precision; see also below date_trunc('hour', timestamp '2001-02-16 20:38:40') @@ -2166,10 +2165,9 @@ reasonable at all for that matter. - extract(identifier from timestamp) + extract(field from timestamp) double precision - - extract subfield from date/time value; see also Get subfield; see also below extract(hour from timestamp '2001-02-16 20:38:40') @@ -2177,10 +2175,9 @@ reasonable at all for that matter. - extract(identifier from interval) + extract(field from interval) double precision - - extract subfield from interval value; see also Get subfield; see also below extract(month from interval '2 years 3 months') @@ -2190,7 +2187,7 @@ reasonable at all for that matter. isfinite(timestamp) boolean - Returns true if the time stamp is finite (neither invalid nor infinity) + Test for finite time stamp (neither invalid nor infinity) isfinite(timestamp '2001-02-16 21:28:30') true @@ -2198,7 +2195,7 @@ reasonable at all for that matter. isfinite(interval) boolean - Returns true if the interval is finite in length + Test for finite interval isfinite(interval '4 hours') true @@ -2206,8 +2203,7 @@ reasonable at all for that matter. now() timestamp - - returns current date and time (equivalent to + Current date and time (equivalent to current_timestamp); see also below @@ -2218,8 +2214,7 @@ reasonable at all for that matter. timeofday() text - - returns high-precision date and time; see also High-precision date and time; see also below timeofday() @@ -2229,7 +2224,7 @@ reasonable at all for that matter. timestamp(date) timestamp - convert date to timestamp + Date to timestamp timestamp(date '2000-12-25') 2000-12-25 00:00:00 @@ -2237,7 +2232,7 @@ reasonable at all for that matter. timestamp(date, time) timestamp - combine date and time into a timestamp + Date and time to a timestamp timestamp(date '1998-02-24',time '23:07') 1998-02-24 23:07:00 @@ -2260,8 +2255,8 @@ EXTRACT (field FROM source evaluates to type timestamp or interval. (Expressions of type date or time will be cast to timestamp and can therefore be used as - well.) field is an identifier (not a - string!) that selects what field to extract from the source value. + well.) field is an identifier or + string that selects what field to extract from the source value. The extract function returns values of type double precision. The following are valid values: @@ -2283,7 +2278,9 @@ SELECT EXTRACT(CENTURY FROM TIMESTAMP '2001-02-16 20:38:40'); - Note that this is not really the century that the date is in. + Note that the result for the century field is simply the year field + divided by 100, and not the conventional definition which puts most + years in the 1900's in the twentieth century. @@ -2422,7 +2419,9 @@ SELECT EXTRACT(MILLENNIUM FROM TIMESTAMP '2001-02-16 20:38:40'); - Note that this is not really the millennium that the date is in. + Note that the result for the millennium field is simply the year field + divided by 1000, and not the conventional definition which puts + years in the 1900's in the second millennium. @@ -2577,8 +2576,8 @@ tz_minute - The date_part function is the traditional - Postgres equivalent to the + The date_part function is modeled on the traditional + Ingres equivalent to the SQL-function extract: date_part('field', source) @@ -3459,7 +3458,7 @@ SELECT NULLIF(value, '(none)') ... Miscellaneous Functions</> <tgroup cols="3"> <thead> - <row><entry>Name</> <entry>Return type</> <entry>Description</></row> + <row><entry>Name</> <entry>Return Type</> <entry>Description</></row> </thead> <tbody> diff --git a/doc/src/sgml/geqo.sgml b/doc/src/sgml/geqo.sgml index 19ecca700e..969c1820b3 100644 --- a/doc/src/sgml/geqo.sgml +++ b/doc/src/sgml/geqo.sgml @@ -1,5 +1,5 @@ <!-- -$Header: /cvsroot/pgsql/doc/src/sgml/geqo.sgml,v 1.15 2000/12/22 21:51:57 petere Exp $ +$Header: /cvsroot/pgsql/doc/src/sgml/geqo.sgml,v 1.16 2001/04/20 15:52:33 thomas Exp $ Genetic Optimizer --> @@ -28,7 +28,7 @@ Genetic Optimizer <date>1997-10-02</date> </docinfo> - <title>Genetic Query Optimization in Database Systems + Genetic Query Optimization diff --git a/doc/src/sgml/libpgeasy.sgml b/doc/src/sgml/libpgeasy.sgml index a8dac2a67d..e7195ae476 100644 --- a/doc/src/sgml/libpgeasy.sgml +++ b/doc/src/sgml/libpgeasy.sgml @@ -1,9 +1,9 @@ - libpgeasy - Simplified C Binding Library + libpgeasy - Simplified C Library Author diff --git a/doc/src/sgml/mvcc.sgml b/doc/src/sgml/mvcc.sgml index d0e020b982..ee7778807a 100644 --- a/doc/src/sgml/mvcc.sgml +++ b/doc/src/sgml/mvcc.sgml @@ -1,5 +1,5 @@ @@ -101,6 +101,7 @@ $Header: /cvsroot/pgsql/doc/src/sgml/mvcc.sgml,v 2.12 2001/03/28 20:46:34 tgl Ex + Isolation Level Dirty Read diff --git a/doc/src/sgml/user-manag.sgml b/doc/src/sgml/user-manag.sgml index c1830560b0..12b4bfe9a5 100644 --- a/doc/src/sgml/user-manag.sgml +++ b/doc/src/sgml/user-manag.sgml @@ -1,5 +1,5 @@ - Database User and Permission Management + Database Users and Permissions Managing database users and their privileges is in concept similar