Commit Graph

1188 Commits

Author SHA1 Message Date
Bruce Momjian
ea283f1555 Remove last-updated date stamp for 7.1. 2001-04-03 13:38:08 +00:00
Bruce Momjian
39f0357b77 Update HISTORY/release.sgml to current. 2001-04-02 17:59:17 +00:00
Thomas G. Lockhart
53de19647f Update info for platforms BeOS, Tru64, Linux/MIPS, Linux/x86, NetBSD/Alpha,
NetBSD/arm, NetBSD/VAX, OpenBSD/Sparc, Solaris, Ultrix.
2001-04-02 15:19:15 +00:00
Peter Eisentraut
fdf1319d22 small fixes 2001-03-29 18:25:10 +00:00
Tom Lane
0cadec788e Correct erroneous description of MVCC Read Committed semantics. 2001-03-28 20:46:34 +00:00
Tom Lane
39ceedf5e0 The regexp pattern characters ^ and $ should be explained as matching
at the beginning and end of the input string, not the beginning and end
of "a line", since Postgres does not allow them to match at newline
characters in the data.
2001-03-25 18:14:31 +00:00
Peter Eisentraut
bdff9d80dc spell fix 2001-03-25 10:16:12 +00:00
Peter Eisentraut
b67e7bb1f7 Allow building documentation outside source tree.
from Ian Lance Taylor
2001-03-25 08:32:24 +00:00
Peter Eisentraut
0967057b5d minor copy editing 2001-03-24 23:03:26 +00:00
Peter Eisentraut
b420c47434 Disable pg_upgrade. 2001-03-24 13:21:14 +00:00
Tom Lane
1a9840cd63 Update info about mailing lists, make a few other minor improvements. 2001-03-24 03:40:44 +00:00
Thomas G. Lockhart
f7a4db10b2 Update to the current state of platform support.
Still need some tested for the 7.1 release.
2001-03-24 02:36:01 +00:00
Thomas G. Lockhart
15dc7d11ea Fix up wording slightly. No change in content. 2001-03-24 02:35:25 +00:00
Tom Lane
27b5a8ef0f Miscellaneous updates and minor copy-editing. 2001-03-24 00:24:26 +00:00
Tom Lane
3311e250cd Doc update from Roberto Mello: improved versions of instr() examples. 2001-03-23 22:07:50 +00:00
Tom Lane
4e911c847c Fix SPI example to reflect new-style calling convention for textout(). 2001-03-23 01:51:08 +00:00
Peter Eisentraut
6cf8707b82 correction 2001-03-21 19:09:03 +00:00
Tom Lane
40dc76e315 Recommend CREATE TABLE AS in preference to SELECT INTO. Remove the
(inadequate anyway) mention of SELECT INTO from the main SELECT ref page.
Point out that SELECT INTO means something else in plpgsql and ecpg.
2001-03-20 20:54:41 +00:00
Tom Lane
ca03b551fc Discuss LOCALE differences as a reason for regression test failure. 2001-03-20 00:09:36 +00:00
Peter Eisentraut
6ea087b243 Add missing TO. 2001-03-19 16:20:52 +00:00
Peter Eisentraut
1088e72054 Add note about saving large objects during upgrade. 2001-03-19 16:19:26 +00:00
Peter Eisentraut
11fd91579a Repair. 2001-03-17 18:08:14 +00:00
Peter Eisentraut
406183fbed Tuning for docbook2man. 2001-03-17 16:27:31 +00:00
Thomas G. Lockhart
3d4fda8d19 New updates from Roberto Mello sent privately today due to email troubles. 2001-03-17 01:53:22 +00:00
Tom Lane
9d645fd84c Support syncing WAL log to disk using either fsync(), fdatasync(),
O_SYNC, or O_DSYNC (as available on a given platform).  Add GUC parameter
to control sync method.
Also, add defense to XLogWrite to prevent it from going nuts if passed
a target write position that's past the end of the buffers so far filled
by XLogInsert.
2001-03-16 05:44:33 +00:00
Tom Lane
25f03eb30c Update sample error messages to agree with current code. 2001-03-15 20:01:32 +00:00
Tom Lane
d584bf4867 Improve description of to_char templates. 2001-03-15 01:07:51 +00:00
Peter Eisentraut
2736ad31dc Fix markup. 2001-03-14 22:20:02 +00:00
Philip Warner
704d7fa800 Document changed features of pg_dump, including:
- Large Object dumps
- Compressed custom format
- Requirement to use template0 when creating DB
2001-03-13 14:08:18 +00:00
Tom Lane
4d14fe0048 XLOG (and related) changes:
* Store two past checkpoint locations, not just one, in pg_control.
  On startup, we fall back to the older checkpoint if the newer one
  is unreadable.  Also, a physical copy of the newest checkpoint record
  is kept in pg_control for possible use in disaster recovery (ie,
  complete loss of pg_xlog).  Also add a version number for pg_control
  itself.  Remove archdir from pg_control; it ought to be a GUC
  parameter, not a special case (not that it's implemented yet anyway).

* Suppress successive checkpoint records when nothing has been entered
  in the WAL log since the last one.  This is not so much to avoid I/O
  as to make it actually useful to keep track of the last two
  checkpoints.  If the things are right next to each other then there's
  not a lot of redundancy gained...

* Change CRC scheme to a true 64-bit CRC, not a pair of 32-bit CRCs
  on alternate bytes.  Polynomial borrowed from ECMA DLT1 standard.

* Fix XLOG record length handling so that it will work at BLCKSZ = 32k.

* Change XID allocation to work more like OID allocation.  (This is of
  dubious necessity, but I think it's a good idea anyway.)

* Fix a number of minor bugs, such as off-by-one logic for XLOG file
  wraparound at the 4 gig mark.

* Add documentation and clean up some coding infelicities; move file
  format declarations out to include files where planned contrib
  utilities can get at them.

* Checkpoint will now occur every CHECKPOINT_SEGMENTS log segments or
  every CHECKPOINT_TIMEOUT seconds, whichever comes first.  It is also
  possible to force a checkpoint by sending SIGUSR1 to the postmaster
  (undocumented feature...)

* Defend against kill -9 postmaster by storing shmem block's key and ID
  in postmaster.pid lockfile, and checking at startup to ensure that no
  processes are still connected to old shmem block (if it still exists).

* Switch backends to accept SIGQUIT rather than SIGUSR1 for emergency
  stop, for symmetry with postmaster and xlog utilities.  Clean up signal
  handling in bootstrap.c so that xlog utilities launched by postmaster
  will react to signals better.

* Standalone bootstrap now grabs lockfile in target directory, as added
  insurance against running it in parallel with live postmaster.
2001-03-13 01:17:06 +00:00
Peter Eisentraut
671be61916 Add uninstall target to Java build.
Respect default port setting in JDBC driver.
Pick up version number from Makefile.global.
Change installation directory to share/java/.
Document.
2001-03-11 11:07:01 +00:00
Tom Lane
af129857c4 BOX documentation disagreed with code about corner order. 2001-03-10 21:16:32 +00:00
Peter Eisentraut
06351c36a6 Document --with-java. 2001-03-10 16:57:18 +00:00
Peter Eisentraut
7ad278817c Eliminate some hackery when creating text files (INSTALL) with a few lines
of DSSSL.
2001-03-10 16:05:35 +00:00
Peter Eisentraut
f975590f69 Integrate "Porting from Oracle PL/SQL" HOWTO from Roberto Mello. 2001-03-09 19:09:00 +00:00
Peter Eisentraut
4eaa654bd6 Sync rule for making INSTALL file. 2001-03-06 20:41:06 +00:00
Peter Eisentraut
0dcd17702a Some editing, enhance markup, move description section before options list. 2001-03-06 18:55:57 +00:00
Bruce Momjian
4888d077be Shorten TOAST mention 2001-03-06 18:11:39 +00:00
Peter Eisentraut
668c598a30 Update/correct/refine. 2001-03-06 17:43:56 +00:00
Philip Warner
3df52c0c2a - Reflect change of option -U to -L 2001-03-06 05:22:50 +00:00
Philip Warner
d3464631e3 - Minor correction to usage 2001-03-06 05:22:18 +00:00
Peter Eisentraut
0ab27ad5e0 Add missing space, change some markup. 2001-03-05 19:00:39 +00:00
Peter Eisentraut
27d8dcd55f Sorry, that change was not correct. 2001-03-05 19:00:01 +00:00
Bruce Momjian
47065aec11 I'm attaching those diffs for the Reference Guide in a tar file, as
not all of them attached properly in the post I made a few minutes
ago. Please disregard those earlier files. The diffs in the tar file
replace them.

Pierce Tyler
2001-03-05 18:42:57 +00:00
Peter Eisentraut
5bbad66e0e PyGreSQL documentation. Based on the README, converted to DocBook by
Mikhail Terekhov <terekhov@emc.com>.
2001-03-04 18:54:07 +00:00
Tom Lane
aee52a6de3 Document TEMP option. 2001-03-03 22:11:40 +00:00
Tom Lane
9c9936587c Implement COMMIT_SIBLINGS parameter to allow pre-commit delay to occur
only if at least N other backends currently have open transactions.  This
is not a great deal of intelligence about whether a delay might be
profitable ... but it beats no intelligence at all.  Note that the default
COMMIT_DELAY is still zero --- this new code does nothing unless that
setting is changed.
Also, mark ENABLEFSYNC as a system-wide setting.  It's no longer safe to
allow that to be set per-backend, since we may be relying on some other
backend's fsync to have synced the WAL log.
2001-02-26 00:50:08 +00:00
Peter Eisentraut
60774e8210 Even better example for operator precedence mis-parsing. 2001-02-25 16:05:21 +00:00
Peter Eisentraut
3460181c3c Choose a more suitable example for the operator precedence mis-parsing
example.
2001-02-24 18:09:51 +00:00
Peter Eisentraut
2db9d5e53a Markup, spell check, refine JDBC documentation. 2001-02-24 12:40:27 +00:00
Thomas G. Lockhart
a9a047e347 Freshen with a few recent platform reports:
Linux/Alpha, Linux/Sparc, MacOS-X.
2001-02-23 02:17:27 +00:00
Tom Lane
e14a9deb93 Document timeofday(), mention start-of-transaction vs. current-time
semantics, a few other small improvements.
2001-02-21 23:15:24 +00:00
Peter Eisentraut
496373e2e4 Fix markup. (A <keyword> isn't what it is in SQL.) Add jungle of more
markup. ;-)
2001-02-21 17:50:38 +00:00
Peter Eisentraut
3a65e4fca6 Add more details. 2001-02-20 22:27:56 +00:00
Peter Eisentraut
824648afae Turn on section numbering. 2001-02-20 22:27:26 +00:00
Tom Lane
f35252de28 Fix pg_passwd's failure to cope with usernames > 8 chars. 2001-02-20 01:16:49 +00:00
Tom Lane
2884073848 Document --enable-cassert. 2001-02-19 22:25:43 +00:00
Tom Lane
414f94f262 Change plpgsql's GET DIAGNOSTICS statement to use SQL99-compatible
syntax.  Fix the RESULT_OID case, which never worked.  Add documentation.
2001-02-19 19:49:53 +00:00
Tom Lane
a276392e52 Update example of partially constraining join order to use a subselect
in FROM instead of an auxiliary view.  We didn't have subselect-in-FROM
when I wrote this originally...
2001-02-19 00:24:30 +00:00
Tom Lane
fa0cd643d2 AND/OR truth table needs another row IMHO. 2001-02-19 00:01:18 +00:00
Tom Lane
c3b00e7e29 Add --template option to createdb script to allow access to WITH TEMPLATE
option of CREATE DATABASE.  In pg_regress, create regression database
from template0 to ensure that any installation-local cruft in template1
will not mess up the tests.
2001-02-18 17:53:55 +00:00
Peter Eisentraut
48d03278a2 Enhance documentation of date/time functions. Add extract, current_date,
current_time, current_timestamp.  Add more examples.  Remove age(), because
it doesn't work like it is documented, and no one could explain it to me.
2001-02-18 17:17:17 +00:00
Peter Eisentraut
b9c7d371ed Make <lineannotation> italic. Fix syntax error in print style. 2001-02-18 17:15:03 +00:00
Tom Lane
df8186b282 Add note that partial indices are not currently supported. 2001-02-18 06:07:37 +00:00
Tom Lane
c3151c29de Update description of fsync option for 7.1. 2001-02-18 05:30:12 +00:00
Tom Lane
57e0847180 Change default commit_delay to zero, update documentation. 2001-02-18 04:50:43 +00:00
Tom Lane
81ff09eeb5 Catch some stray references to .htm files. 2001-02-17 16:52:53 +00:00
Bruce Momjian
64a1b6263d Update bsdi shared memory stuff. 2001-02-16 19:43:52 +00:00
Bruce Momjian
88c55990ce Update BSDI FAQ. 2001-02-16 19:27:19 +00:00
Bruce Momjian
016f0eed24 Update BSDI SGML. 2001-02-16 16:10:06 +00:00
Tom Lane
bf0078d257 Update obsolete wording of error message. 2001-02-15 21:11:17 +00:00
Tom Lane
5341cddba8 Further polishing of documentation about new fmgr call convention. 2001-02-15 19:03:35 +00:00
Bruce Momjian
4c2b0f1d73 Update for Tatsuo. 2001-02-15 13:31:44 +00:00
Tom Lane
21deb42897 Clarify meaning of GEQO_THRESHOLD parameter. 2001-02-15 04:28:50 +00:00
Tom Lane
52cacf46b4 Improve documentation of JOIN syntax. Explain NATURAL as an alternative
to ON and USING for specifying the join condition, not as an independent
kind of join semantics.
2001-02-15 04:10:54 +00:00
Peter Eisentraut
d42d31e78e Alter documentation of boolean type, add example. Someone figured that it
wasn't clear that the "boolean type" was actually called "boolean".  Add
tip about "casting" booleans using CASE.

Spell check whole file.
2001-02-14 19:37:26 +00:00
Peter Eisentraut
41b4628916 Format <structname>, <structfield>, and <type> mono-spaced. 2001-02-14 19:35:14 +00:00
Peter Eisentraut
22aeb5306e Hmm, so referencing a CSS stylesheet when there isn't one doesn't work
everywhere.
2001-02-13 22:35:15 +00:00
Peter Eisentraut
fe4da2ffe8 Fix markup. 2001-02-13 22:05:47 +00:00
Peter Eisentraut
ab66098841 Didn't work when Makefile.custom is missing. 2001-02-13 21:51:17 +00:00
Peter Eisentraut
702f1235b9 Custom DSSSL stylesheet. Style changes included here:
HTML:
* make .html the default extension
* allow use of CSS stylesheet ("stylesheet.css", not included)
* make <set> TOC two levels deep
* put time of creation into meta header
Print:
* make print output justified by default
* footnotes at bottom of each page
* allow TeX to hyphenate
2001-02-13 21:27:05 +00:00
Peter Eisentraut
b08e00b2ae Fix tag. 2001-02-13 21:13:11 +00:00
Bruce Momjian
8824741f99 User Manual
Chapter 4
   String Operators
    Table 4.7: Other String Functions
      strpos is missing the result in the result column, it should be 2
      Also to_ascii might need a result but maybe not.

Appendix A
In the Time Zone Table
 Greenwich is spelled Greenwish

David Aldrich
2001-02-12 14:21:27 +00:00
Bruce Momjian
69f506c01d New release format, Peter E style. 2001-02-12 13:09:33 +00:00
Bruce Momjian
f6abf4e84b Move release date into release heading. 2001-02-11 14:20:30 +00:00
Bruce Momjian
3f8e30651b Clean up HISTORY file, add dates to releases. 2001-02-11 01:48:51 +00:00
Peter Eisentraut
31d3e21edf Repair markup. 2001-02-11 01:41:00 +00:00
Peter Eisentraut
be274f47d0 Document that NetBSD's libedit can be used instead of readline. 2001-02-10 18:24:14 +00:00
Peter Eisentraut
88517a2d9e Add note about the availability of contrib/mac for the macaddr data type. 2001-02-10 18:02:35 +00:00
Bruce Momjian
d3fb67db26 Back out addition. Seems grammar doesn't handle CONSTRAINT as optional. 2001-02-10 16:41:30 +00:00
Bruce Momjian
a5dbde8b0a Add mention of CONSTRAINT in ADD CONSTRAINT section. 2001-02-10 16:39:07 +00:00
Tom Lane
a25a785f6d Minor improvements and copy-editing. 2001-02-10 08:30:13 +00:00
Tom Lane
08265ef9c2 Fix example of syntactic ambiguity between prefix/infix/postfix operators
--- Postgres now accepts the example we claimed it wouldn't.  Miscellaneous
copy-editing as well.
2001-02-10 07:08:44 +00:00
Tom Lane
618733de1a Fix documentation of EXECUTE, add documentation of FOR ... EXECUTE. 2001-02-10 05:32:33 +00:00
Tom Lane
d08741eab5 Restructure the key include files per recent pghackers discussion: there
are now separate files "postgres.h" and "postgres_fe.h", which are meant
to be the primary include files for backend .c files and frontend .c files
respectively.  By default, only include files meant for frontend use are
installed into the installation include directory.  There is a new make
target 'make install-all-headers' that adds the whole content of the
src/include tree to the installed fileset, for use by people who want to
develop server-side code without keeping the complete source tree on hand.
Cleaned up a whole lot of crufty and inconsistent header inclusions.
2001-02-10 02:31:31 +00:00
Peter Eisentraut
cf21985ab5 Update section about how to start server from boot scripts. 2001-02-10 00:50:18 +00:00
Peter Eisentraut
a1d28be831 Avoid a particular <simplelist>. jadetex has formatting problems,
apparently when the content is long enough to require line breaks.
2001-02-09 20:38:15 +00:00
Bruce Momjian
f835a4f1f7 Large object manual updates. 2001-02-09 19:24:09 +00:00
Bruce Momjian
98d66c722c Mention NetBSD 2001-02-09 17:55:48 +00:00
Bruce Momjian
14f6445534 Remove pg_service mention. 2001-02-09 17:53:44 +00:00
Bruce Momjian
b483ad84f8 Add -g as synonmym for --globals-only in pg_dumpall. Add info about
-c,--clean option to manual page.
2001-02-09 17:16:57 +00:00
Tom Lane
467f43d2fa Document PL/TclU language variant, and do some minor copy-editing. 2001-02-09 03:06:38 +00:00
Tom Lane
1f78ad262e Restructure discussion of PL installation to emphasize createlang as the
recommended install procedure, rather than mentioning it as an afterthought.
2001-02-09 02:20:52 +00:00
Peter Eisentraut
088c0b9546 Make -w the default for shut down, add -W option to specify no wait.
Add -l option to name log file.  Set umask to 077.
Proper file descriptor redirection to allow postmaster to detach from
shell's process group.
Add -s option to turn off informational messages.
2001-02-08 19:39:24 +00:00
Tom Lane
2394083bd6 Minor copy-editing. 2001-02-07 20:46:55 +00:00
Peter Eisentraut
192ce19d36 Document BETWEEN. 2001-02-05 19:21:45 +00:00
Peter Eisentraut
ab29852224 Move PL docs to programmer's guide, "storage" chapter to admin guide,
clean up some things in the affected areas.
2001-02-04 15:28:18 +00:00
Peter Eisentraut
72813984da Must run jadetex three times to get correct page numbers. Add support for
pdfjadetex.
2001-02-04 12:23:11 +00:00
Peter Eisentraut
c1f5ed6394 When making xrefs to refsects, the linkend should point to the refsect and
the endterm to the title element, not both to the title.  At least
docbook2man prefers it that way.
2001-02-04 12:18:08 +00:00
Bruce Momjian
930b283a89 Re-add Peter E's changes. 2001-02-03 21:50:45 +00:00
Peter Eisentraut
251de13afd Improved wording, from Albert REINER <areiner@tph.tuwien.ac.at>. 2001-02-03 19:09:46 +00:00
Peter Eisentraut
7c164dca0b Update, polish, consistencify preface/intro sections. 2001-02-03 19:03:27 +00:00
Bruce Momjian
a1c68b4e6b A patch for the GROUP BY/HAVING example. p.date should be s.date.
Robert B. Easter
2001-02-01 19:13:47 +00:00
Bruce Momjian
8255fc1716 Update HISTORY/release with current changes. 2001-01-29 18:58:45 +00:00
Peter Eisentraut
94bf45265f Make into appendix, correct some items. 2001-01-27 11:12:53 +00:00
Peter Eisentraut
dc7a0009f0 Add permission check for CHECKPOINT. 2001-01-27 10:19:52 +00:00
Bruce Momjian
76beb79d27 in the tutorial, chapter 2., "Relational Data Model Formalities"
(sql490.htm), there is

"set of all k-tuples v1, v2, ... vk, such that v1 [isin] D1, v1 [isin] D1"

i assume it should be
"set of all k-tuples v1, v2, ... vk, such that v1 [isin] D1, v2 [isin] D2"

Divide by Zero
2001-01-27 05:07:28 +00:00
Peter Eisentraut
1c63587f24 Clean up markup, add description of contrib/array operators by Joel Burton
<jburton@scw.org>.
2001-01-26 23:40:39 +00:00
Peter Eisentraut
61737a7b47 Add some links from data type chapter to section on literal constants. 2001-01-26 22:04:22 +00:00
Peter Eisentraut
7b9dc71405 WAL documentation, from Oliver Elphick and Vadim Mikheev. 2001-01-24 23:15:19 +00:00
Peter Eisentraut
43bac8406a Update based on documentation written by Vadim Mikheev and Oliver Elphick. 2001-01-24 21:56:23 +00:00
Bruce Momjian
623bf843d2 Change Copyright from PostgreSQL, Inc to PostgreSQL Global Development Group. 2001-01-24 19:43:33 +00:00
Bruce Momjian
87070ccc13 It looks Ok, but it has one unnecessary step. There is no need to do the "mv
privkey.pem cert.pem.pw" if you just use "privkey.pem" in the following
openssl command (e.g. openssl rsa -in privkey.pem -out cert.pem".
But there is nothing wrong with it as it is now, as far as I can see.


//Magnus
2001-01-24 15:19:36 +00:00
Bruce Momjian
80d24370e0 Oops, had .o file in there. 2001-01-24 05:06:15 +00:00
Bruce Momjian
a939e97451 Update 2001-01-24 03:40:33 +00:00
Peter Eisentraut
21a3857f1f Rip out table expression section from SQL syntax chapter and develop it
into new chapter on query (SELECT) syntax.  In the end this should become
a narrative and example-filled counterpart to the SELECT reference page.
2001-01-22 23:34:33 +00:00
Tom Lane
7e0919136a Minor fixes. 2001-01-22 16:11:17 +00:00
Peter Eisentraut
4f34f55d3d Description of table expressions, including join syntax, from Robert B.
Easter <reaster@comptechnews.com>, heavily massaged by me.  Also cleaned up
value expressions a bit.
2001-01-21 22:02:01 +00:00
Tom Lane
a2405d5554 Get rid of initdb -t bugs by the simple expedient of getting rid of
initdb -t.  This option is obsoleted by 7.1's ability to drop and
recreate template1 during normal operation.
2001-01-20 22:09:24 +00:00
Peter Eisentraut
74bbe8097d Replace some oldish, non-SQL'ish elements with more standard forms. (cast
syntax, type names, function names, etc.)
2001-01-20 20:59:29 +00:00
Bruce Momjian
923513b52f Move anoncvs to top of docs, then put cvs tree. Hope that is OK. Seems
more logical.
2001-01-20 04:16:55 +00:00
Bruce Momjian
d128852358 In the Programmer's Guide, the sample code for accessing large objects
from libpq has two functions with memory leaks.

The functions pickout() and overwrite() malloc space for buf which is
never freed.

See
http://www.postgresql.org/users-lounge/docs/7.0/programmer/largeobjects3207.htm

This problem is also in the 6.5 docs at
http://www.postgresql.org/users-lounge/docs/6.5/programmer/x3184.htm

Nishad Prakash
2001-01-20 00:05:54 +00:00
Tom Lane
1073123baa Update docs to explain that 7.1 locks down LC_COLLATE and LC_CTYPE at
initdb time.  A few copy-editing cleanups, too.
2001-01-19 04:47:50 +00:00
Thomas G. Lockhart
6439de1752 Fix incorrect placeholder name in example. 2001-01-18 07:18:39 +00:00
Thomas G. Lockhart
7705581e49 Replace contraction with long form. Cosmetic only. 2001-01-18 07:11:36 +00:00
Bruce Momjian
392793b1ac Functions -> Function's 2001-01-17 22:13:33 +00:00
Bruce Momjian
9a342d2035 There are misprints in postgres doc., in :
Chapter 10. PL/pgSQL - SQL Procedural Language (c40914117.htm)

Statements
...
(resulting in a PL/pgSQL internal SELECT).
But there are cases where someone isn't interested int
-----------------------------------------(have to be)-->
But there are cases where someone isn't interested in
     the functions result.

 RAISE level format''
--(have to be)-->
 RAISE level 'format'
2001-01-17 16:34:34 +00:00
Peter Eisentraut
1ced7f3b30 Adjust file names. 2001-01-15 21:17:27 +00:00
Peter Eisentraut
027f144e39 Terminology cleanup: class -> table, instance -> row, attribute -> column,
etc.
2001-01-13 23:58:55 +00:00
Peter Eisentraut
526427f6d3 Add information about bit types. Adjust some other things to promote
SQL type names over internal type names.
2001-01-13 18:34:51 +00:00
Peter Eisentraut
2a6c08228f New shell for the to be written CHECKPOINT documentation, so the summary
shows up in psql now.
2001-01-13 03:11:12 +00:00
Peter Eisentraut
a32542a1c0 Update information about compiling extension modules. 2001-01-12 22:15:32 +00:00
Tom Lane
359459a44d Bring CREATE TABLE syntax synopsis into line with reality; update a
bunch of old or poorly-worded documentation.
2001-01-12 05:06:40 +00:00
Bruce Momjian
f906597e50 Apply proper sql.sgml change. 2001-01-09 16:05:21 +00:00
Bruce Momjian
777137b7a9 Attached is a doc patch for doc/src/sgml/sql.sgml.
It adds information about SQL JOIN that is implemented in 7.1.

--
-------- Robert B. Easter
2001-01-09 15:48:18 +00:00
Bruce Momjian
5d42c0f3ac A patch for doc/src/sgml/plsql.sgml to add a little more info about PL/pgSQL
EXECUTE.

--
-------- Robert B. Easter
2001-01-09 15:26:16 +00:00
Bruce Momjian
df389d161d Approaching the current documentation from a position of ignorance, I
find it ambiguous.  I propose something along the lines of the
following patch to clarify it.  Thanks.

(Alternatively, perhaps the code could maintain a count of nested
calls to SPI_connect/SPI_finish.  But I didn't try to write that
patch.)

Ian Lance Taylor
2001-01-09 14:23:40 +00:00
Tom Lane
10fb290aca Document the system attributes ctid and tableoid, which for some reason
were never yet mentioned anywhere in our documentation.  Improve
explanations of the other system attributes, too.
2001-01-08 22:07:47 +00:00
Tom Lane
6334ef86a7 Document that we don't support ORDER BY with general expressions on
the output of UNION/INTERSECT/EXCEPT.
2001-01-08 21:30:37 +00:00
Peter Eisentraut
005ad6cdd6 Add rudimentary section about controlling kernel's file and process limits. 2001-01-08 21:01:54 +00:00
Peter Eisentraut
8c3d7715bc Simplify rules to build man pages so they run a lot faster and create less
noise.
2001-01-06 16:54:16 +00:00
Peter Eisentraut
bc0afb715d EXECUTE documentation, from "Robert B. Easter" <reaster@comptechnews.com>.
I threw in spell check run over the whole file.
2001-01-06 12:26:08 +00:00
Peter Eisentraut
3942ee389c Update section on SQL syntax. (Still a lot to be done though.) Add
appendix with comprehensive list of key words.
2001-01-06 11:58:56 +00:00
Tom Lane
96bd67f61d Bring CREATE RULE reference page into some semblance of agreement with
what's actually implemented.
2001-01-06 04:14:35 +00:00
Tom Lane
2fb6cc9045 Remove not-really-standard implementation of CREATE TABLE's UNDER clause,
and revert documentation to describe the existing INHERITS clause
instead, per recent discussion in pghackers.  Also fix implementation
of SQL_inheritance SET variable: it is not cool to look at this var
during the initial parsing phase, only during parse_analyze().  See
recent bug report concerning misinterpretation of date constants just
after a SET TIMEZONE command.  gram.y really has to be an invariant
transformation of the query string to a raw parsetree; anything that
can vary with time must be done during parse analysis.
2001-01-05 06:34:23 +00:00
Tom Lane
676cf18c5b New file format for COPY BINARY, in accordance with pghackers discussions
of early December 2000.  COPY BINARY is now TOAST-safe.
2001-01-03 20:04:10 +00:00
Tom Lane
3bdadd0426 Document tuple ordering differences as a possible cause of
regression test 'failures'.
2001-01-02 05:56:02 +00:00
Peter Eisentraut
eedfac64dd Correct UNDER syntax. 2000-12-30 19:11:45 +00:00
Peter Eisentraut
59e2bf3c69 Correct UNDER syntax. 2000-12-30 19:00:11 +00:00
Peter Eisentraut
8188a9bebf Refinements 2000-12-30 17:11:32 +00:00
Peter Eisentraut
2783bd50da Add mention of sysctl(8) for IPC tuning on Linux. 2000-12-30 15:03:09 +00:00
Tom Lane
0a8da82576 Correct erroneous documentation of PQsetnonblocking(). 2000-12-28 00:16:11 +00:00
Peter Eisentraut
f4e995e17f Add id attribute to sect1 tag. 2000-12-26 20:12:49 +00:00
Peter Eisentraut
fa1640aea0 Fix some cross reference links. 2000-12-26 00:10:37 +00:00
Peter Eisentraut
dccfd74935 Refine some things to create better looking man pages. 2000-12-25 23:15:27 +00:00
Peter Eisentraut
37c55f9849 Some of the stuff documented here hasn't existed since Postgres95. 2000-12-23 16:24:29 +00:00
Peter Eisentraut
de3379503a Remove unused file (the information is already contained elsewhere). 2000-12-23 11:10:55 +00:00
Peter Eisentraut
7558da669f Make use of <email> tag for marking up email addresses. 2000-12-22 21:51:58 +00:00
Peter Eisentraut
387d43113c Avoid using the terms 'installation', 'site', or 'instance' when referring
to the thing you get from running initdb.  That's called a database cluster
(per SQL).
2000-12-22 19:31:56 +00:00
Peter Eisentraut
1b555ce791 Replace incorrect uses of 'which' with 'that'. (so-called "wicked which") 2000-12-22 18:57:50 +00:00
Tom Lane
f4eef66741 Fix broken markup. 2000-12-22 18:06:46 +00:00
Tom Lane
61784c54b5 Change default output formatting for CIDR to be unabbreviated, per
recommendation from Paul Vixie.  Add a new abbrev() function to produce
abbreviated format as text.  No forced initdb, but new function is not
available unless you do an initdb or add the pg_proc row manually.
2000-12-22 18:00:24 +00:00
Peter Eisentraut
b2145e9365 Get rid of the little "v"s in front of version numbers, substituting the
full word "version" where appropriate.
2000-12-21 22:55:27 +00:00
Peter Eisentraut
8f89113d4b Updates 2000-12-21 22:30:39 +00:00
Bruce Momjian
2905a2c54b >openssl req -new -text -out cert.req (you will have to enter a password)
>mv privkey.pem cert.pem.pw
  >openssl rsa -in cert.pem.pw -out cert.pem  (this removes the password)
  >openssl req -x509 -in cert.req -text -key cert.pem -out cert.cert

then

  cp cert.pem $PGDATA/server.key
  cp cert.cert $PGDATA/server.crt

Thank you; this works.

Oliver Elphick
2000-12-21 19:08:05 +00:00
Bruce Momjian
1db9cce39f responce->response
Alfred Perlstein
2000-12-21 18:47:05 +00:00
Thomas G. Lockhart
e4d97cb70e Update info for BeOS and MacOS-X-darwin as supported platforms. 2000-12-20 17:23:39 +00:00
Bruce Momjian
1d46fb8035 Fix typo. 2000-12-20 15:44:00 +00:00
Bruce Momjian
c6fc6cfa08 On Sunday 17 December 2000 15:07, Bruce Momjian wrote:
> We need additions to alter_table.sgml for the new OWNER option mention
> in the features list.

Here it is.

--
Mark Hollomon
2000-12-20 03:19:24 +00:00
Bruce Momjian
827414276c Add mention of Alpha 2000-12-20 03:02:52 +00:00
Bruce Momjian
e19f386116 Holloman -> Hollomon. Sorry. 2000-12-20 02:15:20 +00:00
Tatsuo Ishii
89996974a7 Add description about automatic encoding conversion
between Unicode and other encodings.
2000-12-20 00:44:49 +00:00
Peter Eisentraut
28e9e9a24e Rename --accounts-only to --globals-only, polish documentation. 2000-12-19 22:12:47 +00:00
Peter Eisentraut
f824d4a363 Polish PL/Perl documentation. The README file got shrunk to being a
pointer into the real documentation.
2000-12-19 18:16:26 +00:00
Peter Eisentraut
f9698a938f Correct results of usage examples. 2000-12-19 17:35:46 +00:00
Tom Lane
e34d442dbb Mention fallback case for type coercion in description
of function resolution procedure.
2000-12-19 00:54:59 +00:00
Tom Lane
e4eb91048c Document the array_dims() function, and make some other small improvements
in the docs for arrays.
2000-12-18 23:39:37 +00:00
Bruce Momjian
cf35a70495 Large objects in single "table". 2000-12-18 04:32:09 +00:00
Bruce Momjian
708c1114ea Updates from Tom Lane. 2000-12-18 04:20:44 +00:00
Peter Eisentraut
8c8ed4f456 Add missing tags. 2000-12-17 17:50:46 +00:00
Peter Eisentraut
ec6a367e90 Bump version to 7.1. (No "beta1", since we're just going to forget to
change it again anyway.)
2000-12-17 11:25:58 +00:00
Peter Eisentraut
a4e29286b3 Update SysV IPC information. 2000-12-17 11:22:00 +00:00
Tom Lane
7b9fe96812 Update type-coercion discussions to reflect current reality. 2000-12-17 05:55:26 +00:00
Tom Lane
c501e9aabe Misc. cleanups. 2000-12-17 05:50:23 +00:00
Tom Lane
96ff0cb0c4 Outer join updates, miscellaneous polishing. 2000-12-17 05:47:57 +00:00
Tom Lane
0c2629efaa Update some obsolete info about GEQO. 2000-12-16 22:44:47 +00:00
Bruce Momjian
a238cb5a8a Add 7.1 features list 2000-12-16 20:12:42 +00:00
Tom Lane
6a0f486a25 A little wordsmithing in the pattern-matching section. 2000-12-16 19:33:23 +00:00
Tom Lane
d316f22267 Add note that COALESCE and NULLIF are shorthand forms of CASE. 2000-12-16 18:33:13 +00:00
Tom Lane
cf00d59335 Clean up some bogosities in description of target lists. 2000-12-16 18:22:53 +00:00
Tom Lane
ad4fd77a5f Restructure performance tips into a single chapter ('populating a
database' was way too small to make a chapter).  Add a section about
using JOIN syntax to direct the planner.
2000-12-16 02:29:36 +00:00
Peter Eisentraut
c3641483c3 Merge functions and operators chapters. Lots of updates. 2000-12-14 22:30:56 +00:00
Bruce Momjian
36da236eb3 In 'Joins between classes' in Section 5 of the tutorial we have, in
the first paragraph:

    As an example, say we wish to find all the records that
    are in the  temperature  range  of  other records. In
    effect, we need to compare the temp_lo and temp_hi
    attributes of each EMP instance to the temp_lo and
    temp_hi  attributes of all other EMP instances.

I believe that EMP should read WEATHER, as the example query that
follows joins WEATHER to itself.

EMP is often used in Oracle examples.

Regards,
Graham

Other RULE cleanups
2000-12-12 16:47:52 +00:00
Tom Lane
1045304a3b Revise SELECT reference page for outer joins, subselect in FROM,
ISO-compliant UNION/INTERSECT/EXCEPT.  Revise discussion of rule
rewriter to reflect new subselect-in-FROM implementation of views.
Miscellaneous other cleanups.
2000-12-12 05:07:59 +00:00
Bruce Momjian
0cbfde72fe Change to Negator. 2000-12-11 18:26:37 +00:00
Bruce Momjian
e19c8acce1 Backout right-hand/left-hand. 2000-12-10 22:37:27 +00:00
Bruce Momjian
d5470aba5c in catalog.sgml
line 1324:
"left-hand" should be "right-hand"

BTW: new document looks very good!
And the new configure/build process seems much better then before!

Thanks!

Laser
2000-12-10 22:35:56 +00:00
Bruce Momjian
8651dc10a5 Add mention of \d+ to comment. 2000-12-10 21:56:00 +00:00
Bruce Momjian
7c1959cbd9 Fix typo 2000-12-10 20:47:34 +00:00
Bruce Momjian
10f400ccee Fixes for examples from Thomas Diffenbach 2000-12-09 22:59:25 +00:00
Bruce Momjian
57c499a463 Fix Westwood/Westward, from Wessel van Norel. 2000-12-08 20:11:11 +00:00
Tom Lane
b44e46cfce Remove error check that disallowed setval() on a sequence with cache
value greater than one.  The behavior this sought to disallow doesn't
seem any less confusing than the other behaviors of cached sequences.
Improve wording of some error messages, too.
Update documentation accordingly.  Also add an explanation that
aborted transactions do not roll back their nextval() calls; this
seems to be a FAQ, so it ought to be mentioned here...
2000-12-08 20:06:58 +00:00
Peter Eisentraut
288afd95a3 typo correction 2000-12-07 22:37:08 +00:00
Thomas G. Lockhart
1131261270 Clarify the allowed length of the text data type. 2000-12-03 14:47:18 +00:00
Thomas G. Lockhart
48781d44e4 Support IBM S/390. Patches from Neale Ferguson@softwareAG-usa.com. 2000-12-03 14:41:47 +00:00
Peter Eisentraut
13dbd0276a Final(?) GUC clean-up. Update psql tab completion. 2000-12-03 14:36:47 +00:00
Tom Lane
b7c3784417 Repair residual sillinesses from UUNET virtual host/socket path patch.
I hope all the dust has settled out now ...
2000-11-30 23:20:51 +00:00
Tom Lane
796754778d Correct obsolete entry for strpos(). 2000-11-30 23:02:04 +00:00
Peter Eisentraut
6f09df7f40 Minor tweaks in installation instructions, regenerate INSTALL file. 2000-11-30 21:44:07 +00:00
Peter Eisentraut
59a9735fc8 Sort out things after fe-connect.c cleanup after unix socket patch. 2000-11-30 18:34:36 +00:00
Peter Eisentraut
1efd7330cb Rewrite system catalog documentation man page in DocBook with more recent
information.
2000-11-29 20:15:59 +00:00
Tom Lane
c715fdea26 Significant cleanups in SysV IPC handling (shared mem and semaphores).
IPC key assignment will now work correctly even when multiple postmasters
are using same logical port number (which is possible given -k switch).
There is only one shared-mem segment per postmaster now, not 3.
Rip out broken code for non-TAS case in bufmgr and xlog, substitute a
complete S_LOCK emulation using semaphores in spin.c.  TAS and non-TAS
logic is now exactly the same.
When deadlock is detected, "Deadlock detected" is now the elog(ERROR)
message, rather than a NOTICE that comes out before an unhelpful ERROR.
2000-11-28 23:27:57 +00:00
Bruce Momjian
5173fc411f Remove PQunixsocket, per Peter's recommendation. PQhost shows the socket directory. 2000-11-28 06:53:33 +00:00
Tom Lane
bbea3643a3 Store current LC_COLLATE and LC_CTYPE settings in pg_control during initdb;
re-adopt these settings at every postmaster or standalone-backend startup.
This should fix problems with indexes becoming corrupt due to failure to
provide consistent locale environment for postmaster at all times.  Also,
refuse to start up a non-locale-enabled compilation in a database originally
initdb'd with a non-C locale.  Suppress LIKE index optimization if locale
is not "C" or "POSIX" (are there any other locales where it's safe?).
Issue NOTICE during initdb if selected locale disables LIKE optimization.
2000-11-25 20:33:54 +00:00
Peter Eisentraut
c25b4dbf03 Update pg_ctl ref page, help output, messages. Some repair to work better
with current postmaster.
2000-11-25 17:17:30 +00:00
Peter Eisentraut
f4710020d6 Repair markup 2000-11-25 13:20:05 +00:00
Bruce Momjian
3f1998727d here is a patch for formatting.c (to_char/timestampt()), for 7.1
it fixing Y,YY,YYY,YYYY conversion, the docs and regress tests update
 are included too.

  During the patch testing I found small bug in miscadmin.h in
convertstr() declaration. Here it's fixed too.

 Thanks

        Karel
2000-11-25 05:00:33 +00:00
Peter Eisentraut
5b00ea9e50 Make SET SESSION CHARACTERISTICS compliant with SQL 99. Remove redundant,
non-standard clauses.  Allow CHARACTERISTICS as unquoted identifier.
Merge related reference pages.
2000-11-24 20:16:40 +00:00
Peter Eisentraut
b2e76d570b Revive Reference Manual, remove reference pages from User's Guide.
Make version.sgml the central place for updating version numbers in the
documentation.  Document titles now contain the version number of the
release they belong to.

filelist.sgml is the central (and only) place to declare system entities
(i.e., sgml files).  No longer a need to declare them in each document
header.

There is no longer any need to maintain duplicate chapter lists in
postgres.sgml and user/admin/etc.sgml, everything is build from the same
sources.  Some parameter entities allow for different text to be included
when the integrated or a single doc set is generated, which eliminates the
problems that had caused this to fail in the past.
2000-11-24 17:44:22 +00:00
Bruce Momjian
98e195d23b Make socket option specify just the directory, not the full path. 2000-11-22 01:41:14 +00:00
Tom Lane
11391685d1 Tweak resultmap documentation, add to README too. 2000-11-22 00:58:47 +00:00
Peter Eisentraut
90cfa9ac19 Allow for different result files when using GCC versus native compiler. 2000-11-21 23:40:28 +00:00
Tom Lane
c1257d4c5c Improve comments in pg_hba.conf.sample and the associated SGML
documentation.
2000-11-21 20:44:32 +00:00
Philip Warner
aec962d864 Update for new pg_dump with blobs etc 2000-11-21 15:39:09 +00:00
Peter Eisentraut
5350ff2523 Correct directory names.
Thanks to Martin A. Marques <martin@math.unl.edu.ar> for the tip.
2000-11-20 22:01:21 +00:00
Tom Lane
5bb2300b59 Revise handling of oldstyle/newstyle functions per recent discussions
in pghackers list.  Support for oldstyle internal functions is gone
(no longer needed, since conversion is complete) and pg_language entry
'internal' now implies newstyle call convention.  pg_language entry
'newC' is gone; both old and newstyle dynamically loaded C functions
are now called language 'C'.  A newstyle function must be identified
by an associated info routine.  See src/backend/utils/fmgr/README.
2000-11-20 20:36:57 +00:00
Peter Eisentraut
f6bc98679a Refinements 2000-11-18 19:05:58 +00:00
Bruce Momjian
5a0152b3fd I think in datatype.sgml line 506 or so:
<entry>varchar(n)</entry>
        <entry>(4+x) bytes</entry>

should be
   <entry>varchar(n)</entry>
        <entry>(4+n) bytes</entry>

or
   <entry>varchar(x)</entry>
        <entry>(4+x) bytes</entry>

Regards

Laser Henry
2000-11-16 06:03:40 +00:00
Peter Eisentraut
d807129503 Repair markup 2000-11-15 19:43:39 +00:00
Peter Eisentraut
76920de895 Rename parameter "hostname" to "virtual_host". Seemed very ambiguous... 2000-11-15 18:36:06 +00:00
Peter Eisentraut
0937bf9544 Small polishing of syslog facility and ident settings. Only allow setting
at postmaster start, rename syslog_progid to syslog_ident, since syslog
itself uses that term, fix doc markup.
2000-11-14 19:13:27 +00:00
Tom Lane
2cf48ca04b Extend CREATE DATABASE to allow selection of a template database to be
cloned, rather than always cloning template1.  Modify initdb to generate
two identical databases rather than one, template0 and template1.
Connections to template0 are disallowed, so that it will always remain
in its virgin as-initdb'd state.  pg_dumpall now dumps databases with
restore commands that say CREATE DATABASE foo WITH TEMPLATE = template0.
This allows proper behavior when there is user-added data in template1.
initdb forced!
2000-11-14 18:37:49 +00:00
Peter Eisentraut
8a9315ca92 Update and polish postmaster and postgres help output and man pages. 2000-11-14 18:11:32 +00:00
Bruce Momjian
8f3b2b3a5c Add mention of new leading-slash handling of hostname to libpq docs. 2000-11-14 01:53:37 +00:00
Bruce Momjian
ab47254757 Add mention of hostname leading slash handling to all manual pages that use -h. 2000-11-13 23:57:20 +00:00
Bruce Momjian
ebd61ac03f Remove -k unix socketpath option from client side, allow hostname with
leading slash to behave as a unix socket path.
2000-11-13 23:37:54 +00:00
Bruce Momjian
d63a762f79 Ok, You guys are probably tired of me, BUT, here is another one, that
adds the facility to set the program name used in syslog.
(this includes the other ones).

One gotcha, the parser doesn't like special characters in strings.
For example, i tried to use pg-test, and if failed the parse coming
from the postgresql.conf file.

I don't think it's a showstopper..

Larry Rosenman
2000-11-13 21:35:03 +00:00
Bruce Momjian
2150c2edf1 UUNET is looking into offering PostgreSQL as a part of a managed web
hosting product, on both shared and dedicated machines.  We currently
offer Oracle and MySQL, and it would be a nice middle-ground.
However, as shipped, PostgreSQL lacks the following features we need
that MySQL has:

1. The ability to listen only on a particular IP address.  Each
   hosting customer has their own IP address, on which all of their
   servers (http, ftp, real media, etc.) run.
2. The ability to place the Unix-domain socket in a mode 700 directory.
   This allows us to automatically create an empty database, with an
   empty DBA password, for new or upgrading customers without having
   to interactively set a DBA password and communicate it to (or from)
   the customer.  This in turn cuts down our install and upgrade times.
3. The ability to connect to the Unix-domain socket from within a
   change-rooted environment.  We run CGI programs chrooted to the
   user's home directory, which is another reason why we need to be
   able to specify where the Unix-domain socket is, instead of /tmp.
4. The ability to, if run as root, open a pid file in /var/run as
   root, and then setuid to the desired user.  (mysqld -u can almost
   do this; I had to patch it, too).

The patch below fixes problem 1-3.  I plan to address #4, also, but
haven't done so yet.  These diffs are big enough that they should give
the PG development team something to think about in the meantime :-)
Also, I'm about to leave for 2 weeks' vacation, so I thought I'd get
out what I have, which works (for the problems it tackles), now.

With these changes, we can set up and run PostgreSQL with scripts the
same way we can with apache or proftpd or mysql.

In summary, this patch makes the following enhancements:

1. Adds an environment variable PGUNIXSOCKET, analogous to MYSQL_UNIX_PORT,
   and command line options -k --unix-socket to the relevant programs.
2. Adds a -h option to postmaster to set the hostname or IP address to
   listen on instead of the default INADDR_ANY.
3. Extends some library interfaces to support the above.
4. Fixes a few memory leaks in PQconnectdb().

The default behavior is unchanged from stock 7.0.2; if you don't use
any of these new features, they don't change the operation.

David J. MacKenzie
2000-11-13 15:18:15 +00:00
Bruce Momjian
c48025e799 Add new 7.0.3 item to all places. 2000-11-12 14:26:48 +00:00
Peter Eisentraut
609f9199af Repair markup 2000-11-11 23:27:48 +00:00