Commit Graph

5545 Commits

Author SHA1 Message Date
Bruce Momjian
b92767d525 Update "encode" documentation to mention that 'escape' only changes null
bytes and backslashes, remove "ASCII" mention.  Backpatch to 8.2.X.
2007-02-20 19:59:04 +00:00
Bruce Momjian
298de77d51 Update pgpass Win32 wording. 2007-02-20 19:35:17 +00:00
Bruce Momjian
8e1ccad519 Update information_schema documentation to match system tables.
Backpatch to 8.2.X.
2007-02-20 18:47:25 +00:00
Bruce Momjian
ddd8817f45 Wording improvement. 2007-02-20 18:18:05 +00:00
Bruce Momjian
571df93cff More clearly document that most PostgreSQL utilities support libpq
environment variables.  Backpatch to 8.2.X.
2007-02-20 18:10:59 +00:00
Tom Lane
ecba519d4e Adjust user-facing documentation to explain why we don't check pgpass
file permissions on Windows.
2007-02-20 17:47:04 +00:00
Bruce Momjian
71b0cf2f6b Remove, item not needed for Win32:
< 	o Check .pgpass file permissions
>
2007-02-20 15:21:42 +00:00
Bruce Momjian
b16dab66a7 Remove "History" sections for pg_dump and pg_restore. I don't think
anyone cares because the last history change was for PostgreSQL 7.1.
2007-02-20 15:01:17 +00:00
Bruce Momjian
ff0d71e263 Spell check on array patch. 2007-02-20 14:54:47 +00:00
Bruce Momjian
bfc53d7da4 Add for WIN32:
<
> 	o Check .pgpass file permissions
2007-02-20 14:48:47 +00:00
Bruce Momjian
1b52359d90 Update array slice documentation to be clearer. 2007-02-20 14:34:25 +00:00
Bruce Momjian
265124e7e0 Add:
> * Fix IS OF so it matches the ISO specification, and add documentation
>
>   http://archives.postgresql.org/pgsql-patches/2003-08/msg00060.php
>   http://archives.postgresql.org/pgsql-hackers/2007-02/msg00060.php
2007-02-20 14:17:24 +00:00
Bruce Momjian
8272fc3f7b Comment-out documentation for IS OF because it doesn't conform to the
ISO SQL behavior. Backpatch removal to 8.2.X.
2007-02-20 14:04:50 +00:00
Bruce Momjian
2673961659 Remove item:
< 	o ARRAY[[1,2],[3,4]])[1] should return the same values as
< 	  ARRAY[[1,2],[3,4]])[1:1];
<
2007-02-20 03:47:03 +00:00
Bruce Momjian
6126d3e70b Document IS [NOT] OF, which was added in 7.3. 2007-02-20 00:25:05 +00:00
Bruce Momjian
077d753a57 Add FAQ text about Makefile.custom:
<P><I>src/Makefile.custom</I> can be used to set environment variables,
    like <I>CUSTOM_COPT</I>, that are used for every compile.
2007-02-19 23:45:38 +00:00
Bruce Momjian
c62de15bec Document that to_char('J'/Julian) is midnight-based, per report that
Julian technically is noon to noon.
2007-02-19 22:51:44 +00:00
Bruce Momjian
9772e0007c Wording improvement. 2007-02-19 22:10:52 +00:00
Bruce Momjian
e3285f32e8 Update PQfree() documentation to be clearer, backpatch to 8.2.X. 2007-02-19 22:06:23 +00:00
Bruce Momjian
4acc4aa871 Update wording:
< * Consider allowing configuration of TOAST thresholds
> * Allow user configuration of TOAST thresholds
2007-02-19 21:08:48 +00:00
Bruce Momjian
bba9ec141f Add:
> * Consider allowing configuration of TOAST thresholds
>
>   http://archives.postgresql.org/pgsql-hackers/2007-02/msg00213.php
>
2007-02-19 21:07:25 +00:00
Bruce Momjian
6042bb498c Add newlines. 2007-02-19 20:42:33 +00:00
Bruce Momjian
5855d2b593 Add:
> * Allow UPDATEs on only non-referential integrity columns not to conflict
>   with referential integrity locks
>
>   http://archives.postgresql.org/pgsql-hackers/2007-02/msg00073.php
2007-02-19 20:41:40 +00:00
Bruce Momjian
c7116a4112 Add:
> * Allow INSERT/UPDATE ... RETURNING inside a SELECT 'FROM' clause
>
>   http://archives.postgresql.org/pgsql-general/2006-09/msg00803.php
>   http://archives.postgresql.org/pgsql-hackers/2006-10/msg00693.php
>
2007-02-19 20:06:56 +00:00
Bruce Momjian
11fa6f59da Clarify documentation that initdb -A or editing pg_hba.conf is required
if you do not trust local users.
2007-02-19 18:57:18 +00:00
Bruce Momjian
70007b4dd5 Clarify documentation for "day of the week" handling for to_char() and
EXTRACT().
2007-02-19 18:20:06 +00:00
Bruce Momjian
107062e008 Done:
> * -Add ISO day of week format 'ID' to to_char() where Monday = 1
2007-02-19 17:58:32 +00:00
Bruce Momjian
3e803f7273 Add "isodow" option to EXTRACT() and date_part() where Sunday = 7. 2007-02-19 17:41:39 +00:00
Bruce Momjian
27d6ee04b8 Done:
> * -Add a field 'isoyear' to extract(), based on the ISO week
2007-02-19 17:21:24 +00:00
Bruce Momjian
68c7cb5ed5 Done:
< 	o Add long file support for binary pg_dump output
<
< 	  While Win32 supports 64-bit files, the MinGW API does not,
< 	  meaning we have to build an fseeko replacement on top of the
< 	  Win32 API, and we have to make sure MinGW handles it.  Another
< 	  option is to wait for the MinGW project to fix it, or use the
< 	  code from the LibGW32C project as a guide.
<
< 	  http://archives.postgresql.org/pgsql-hackers/2006-12/msg00551.php
<
> 	o -Add long file support for binary pg_dump output
2007-02-19 16:36:17 +00:00
Bruce Momjian
aa728d5f4b Document limitation of SPI_execute() using multiple queries in a single
string.
2007-02-18 01:47:40 +00:00
Bruce Momjian
9f6ed2f47f Update wording:
<   Currently, ALTER USER and ALTER DATABASE support per-user and
>   Currently ALTER USER and ALTER DATABASE support per-user and
< 	  Currently, subtracting one date from another that crosses a
> 	  Currently subtracting one date from another that crosses a
<   Currently, SQL-language functions can only refer to parameters via $1, etc
>   Currently SQL-language functions can only refer to dollar parameters,
>   e.g. $1
<   Currently, queries prepared via the libpq API are planned on first
>   Currently queries prepared via the libpq API are planned on first
< 	  Currently, SET <tab> causes a database lookup to check all
> 	  Currently SET <tab> causes a database lookup to check all
< 	  Currently, all statement results are transferred to the libpq
> 	  Currently all statement results are transferred to the libpq
2007-02-18 01:34:35 +00:00
Bruce Momjian
0e461f275b Add:
* Allow SQL-language functions to reference parameters by parameter name

  Currently SQL-language functions can only refer to parameters via $1, etc
2007-02-18 01:32:55 +00:00
Bruce Momjian
9b9cd9c205 Update "Conflicting lock modes" to show as conflict, add
current/requested headings, add link to table from text.
2007-02-18 01:21:49 +00:00
Bruce Momjian
37a22932f2 Add:
> * Allow holdable cursors in SPI
2007-02-17 02:01:02 +00:00
Bruce Momjian
c6ed4ead01 Add:
>
> 		o Allow row and record variables to be set to NULL constants,
> 		  and allow NULL tests on such variables
>
> 		  Because a row is not scalar, do not allow assignment
> 		  from NULL-valued scalars.
2007-02-17 01:35:41 +00:00
Bruce Momjian
0bc81a5b58 Remove installation mention that integer timestamps is less stable that
floating point.
2007-02-17 01:26:24 +00:00
Bruce Momjian
46bd3bff62 Add:
> 	o Consider reducing on-disk varlena length from four to two
> 	  because a heap row cannot be more than 64k in length
2007-02-16 22:20:02 +00:00
Tom Lane
5ce7599bcd Fix markup, spelling, grammar, and explanations for SSLKEY patch. 2007-02-16 16:37:29 +00:00
Peter Eisentraut
355e05ab41 Functions for mapping table data and table schemas to XML (a.k.a. XML export) 2007-02-16 07:46:55 +00:00
Bruce Momjian
bb0a8a3ad4 Remove extra character erroneously added. 2007-02-16 03:56:45 +00:00
Bruce Momjian
4ab7ea5ace Remove tabs from SGML files to help tag alingment and improve
detection of tabs are added in the future.
2007-02-16 03:50:29 +00:00
Bruce Momjian
4ebb0cf9c3 Add two new format fields for use with to_char(), to_date() and
to_timestamp():
    - ID for day-of-week
    - IDDD for day-of-year

This makes it possible to convert ISO week dates to and from text
fully represented in either week ('IYYY-IW-ID') or day-of-year
('IYYY-IDDD') format.

I have also added an 'isoyear' field for use with extract / date_part.

Brendan Jurd
2007-02-16 03:39:46 +00:00
Bruce Momjian
c7b08050d9 SSL improvements:
o read global SSL configuration file
	o add GUC "ssl_ciphers" to control allowed ciphers
	o add libpq environment variable PGSSLKEY to control SSL hardware keys

Victor B. Wagner
2007-02-16 02:59:41 +00:00
Alvaro Herrera
68046a20c7 Remove useless database name from bootstrap argument processing (including
startup and bgwriter processes), and the -y flag.  It's not used anywhere.
2007-02-16 02:10:07 +00:00
Bruce Momjian
01191c7177 Add:
>
> 	o Use LC_TIME for localized weekday/month names, rather than
> 	  LC_MESSAGES
>
> 	  http://archives.postgresql.org/pgsql-hackers/2006-11/msg00390.php
2007-02-14 21:00:17 +00:00
Tom Lane
5b68dfb06d Add some discussion of sort ordering to indices.sgml, which curiously
had never touched the subject before.
2007-02-14 20:47:15 +00:00
Peter Eisentraut
2f8ee82964 Fix typo 2007-02-14 18:46:08 +00:00
Tom Lane
5c63829f2f Minor editorialization on operator-family documentation: put some
copied-and-pasted text in a more useful location.
2007-02-14 04:30:26 +00:00
Bruce Momjian
33d72c7351 Add:
> * Clean up casting in /contrib/isn
>
>   http://archives.postgresql.org/pgsql-hackers/2006-11/msg00245.php
>
2007-02-14 04:24:42 +00:00
Bruce Momjian
7de3375f78 Add:
> * Improve logging of prepared statements recovered during startup
>
>   http://archives.postgresql.org/pgsql-hackers/2006-11/msg00092.php
>
2007-02-14 04:19:37 +00:00
Bruce Momjian
d7250994e6 Add URL for:
* Allow SQL-language functions to return results from RETURNING queries
>
>   http://archives.postgresql.org/pgsql-hackers/2006-10/msg00665.php
>
2007-02-14 02:49:37 +00:00
Tom Lane
7bddca3450 Fix up foreign-key mechanism so that there is a sound semantic basis for the
equality checks it applies, instead of a random dependence on whatever
operators might be named "=".  The equality operators will now be selected
from the opfamily of the unique index that the FK constraint depends on to
enforce uniqueness of the referenced columns; therefore they are certain to be
consistent with that index's notion of equality.  Among other things this
should fix the problem noted awhile back that pg_dump may fail for foreign-key
constraints on user-defined types when the required operators aren't in the
search path.  This also means that the former warning condition about "foreign
key constraint will require costly sequential scans" is gone: if the
comparison condition isn't indexable then we'll reject the constraint
entirely. All per past discussions.

Along the way, make the RI triggers look into pg_constraint for their
information, instead of using pg_trigger.tgargs; and get rid of the always
error-prone fixed-size string buffers in ri_triggers.c in favor of building up
the RI queries in StringInfo buffers.

initdb forced due to columns added to pg_constraint and pg_trigger.
2007-02-14 01:58:58 +00:00
Bruce Momjian
65e2f55031 Add URL for:
>
>   http://archives.postgresql.org/pgsql-performance/2006-10/msg00222.php
>
2007-02-14 00:47:05 +00:00
Bruce Momjian
e4f45d29be Add URL for:
* Update Bonjour to work with newer cross-platform SDK

>   http://archives.postgresql.org/pgsql-patches/2006-10/msg00048.php
2007-02-13 23:23:11 +00:00
Bruce Momjian
6e5c64b551 Add:
> * Improve failure message when DROP DATABASE is used on a database that
>   has prepared transactions
2007-02-13 19:57:09 +00:00
Bruce Momjian
b9c65aed82 Add URL for:
* Update Bonjour to work with newer cross-platform SDK

>
>   http://archives.postgresql.org/pgsql-hackers/2006-09/msg02238.php
>
2007-02-13 18:08:39 +00:00
Bruce Momjian
954eb25a11 Add:
> * Update our code to handle 64-bit timezone files to match the zic
>   source code, which now uses them
2007-02-13 17:03:16 +00:00
Tom Lane
4d160018d2 Improve documentation for CREATE CONSTRAINT TRIGGER. 2007-02-10 20:43:59 +00:00
Neil Conway
fc7de7c2cb Unbreak the SGML doc build: ":=" is needed to assign to variables if
the RHS of the assignment expands to a reference to the LHS.
2007-02-09 20:40:13 +00:00
Peter Eisentraut
c138b966d4 Replace useless uses of := by = in makefiles. 2007-02-09 15:56:00 +00:00
Bruce Momjian
bc6fb5436f Update FAQ for new 24-byte header, down from 28. 2007-02-09 03:43:22 +00:00
Bruce Momjian
1ad2f04bf2 Add blank line. 2007-02-09 03:39:59 +00:00
Bruce Momjian
9eddc28197 Add URL for:
<
>   http://archives.postgresql.org/pgsql-hackers/2007-02/msg00435.php
2007-02-09 03:39:39 +00:00
Bruce Momjian
19d561cbd0 Done!
< * Merge xmin/xmax/cmin/cmax back into three header fields
<
<   Before subtransactions, there used to be only three fields needed to
<   store these four values. This was possible because only the current
<   transaction looks at the cmin/cmax values. If the current transaction
<   created and expired the row the fields stored where xmin (same as
<   xmax), cmin, cmax, and if the transaction was expiring a row from a
<   another transaction, the fields stored were xmin (cmin was not
<   needed), xmax, and cmax. Such a system worked because a transaction
<   could only see rows from another completed transaction. However,
<   subtransactions can see rows from outer transactions, and once the
<   subtransaction completes, the outer transaction continues, requiring
<   the storage of all four fields. With subtransactions, an outer
<   transaction can create a row, a subtransaction expire it, and when the
<   subtransaction completes, the outer transaction still has to have
<   proper visibility of the row's cmin, for example, for cursors.
<
<   One possible solution is to create a phantom cid which represents a
<   cmin/cmax pair and is stored in local memory.  Another idea is to
<   store both cmin and cmax only in local memory.
<
> * -Merge xmin/xmax/cmin/cmax back into three header fields
2007-02-09 03:37:45 +00:00
Bruce Momjian
aba039df66 Update:
< * Consider placing all sequences in a single table
> * Consider placing all sequences in a single table, or create a system
>   view
2007-02-09 01:29:48 +00:00
Bruce Momjian
5bdf44c647 Update:
< * Consider placing all sequences in a single table, now that system
<   tables are full transactional
> * Consider placing all sequences in a single table
2007-02-09 00:34:31 +00:00
Bruce Momjian
18d36f9e19 Add:
> * Consider placing all sequences in a single table, now that system
>   tables are full transactional
2007-02-09 00:32:15 +00:00
Bruce Momjian
2737f304ca Add URL for:
* Add support for SQL-standard GENERATED/IDENTITY columns
>   http://archives.postgresql.org/pgsql-hackers/2006-08/msg00038.php
2007-02-08 21:51:50 +00:00
Bruce Momjian
a37b006d89 This patch fixes shared_preload_libraries on Windows hosts. It forces
ach backend to re-load all shared_preload_libraries.

Korry Douglas
2007-02-08 15:46:04 +00:00
Bruce Momjian
eea3749d2e Add lock matrix to documentation.
Teodor Sigaev
2007-02-08 15:32:11 +00:00
Bruce Momjian
b227448d0b Update URL for "Generalized Partial Indexes" paper to point to a cached
version.

Backpatch to 8.2.X.
2007-02-08 04:31:37 +00:00
Bruce Momjian
d78f76896b Document that wal_sync_method open_* methods use O_DIRECT, if available.
Backpatch to 8.2.X.
2007-02-08 03:56:42 +00:00
Tom Lane
aec4cf1c8c Add a function pg_stat_clear_snapshot() that discards any statistics snapshot
already collected in the current transaction; this allows plpgsql functions to
watch for stats updates even though they are confined to a single transaction.
Use this instead of the previous kluge involving pg_stat_file() to wait for
the stats collector to update in the stats regression test.  Internally,
decouple storage of stats snapshots from transaction boundaries; they'll
now stick around until someone calls pgstat_clear_snapshot --- which xact.c
still does at transaction end, to maintain the previous behavior.  This makes
the logic a lot cleaner, at the price of a couple dozen cycles per transaction
exit.
2007-02-07 23:11:30 +00:00
Bruce Momjian
cf230f2299 Stamp releases notes for 8.2.3, 8.1.8, 8.0.12. 2007-02-07 04:22:44 +00:00
Bruce Momjian
ced5269a8b Update for 8.2.3. 2007-02-07 03:16:22 +00:00
Bruce Momjian
09f9553daf Update for 8.2.2 as most recent release. 2007-02-06 18:36:26 +00:00
Bruce Momjian
63b7afbe4f Update workding for daylight savings time. 2007-02-06 18:33:20 +00:00
Bruce Momjian
a85a290dad Update timezone FAQ item:
<P>USA saving time changes are included in PostgreSQL release 8.0.[4+],
    and all later major releases, e.g. 8.1.  Canada and Western Australia
    changes are included in 8.0.[10+], 8.1.[6+], and all later major
    releases.  PostgreSQL releases prior to 8.0 use the operating system's
    timezone database for daylight saving information.</P>
2007-02-06 18:31:26 +00:00
Bruce Momjian
869585cc8f Split apart entries, one done now:
* -Move NAMEDATALEN from postgres_ext.h to pg_config_manual.h
* Consider making NAMEDATALEN more configurable in future releases
2007-02-06 16:44:14 +00:00
Peter Eisentraut
037f8413fa Move NAMEDATALEN definition from postgres_ext.h to pg_config_manual.h. It
used to be part of libpq's exported interface many releases ago, but now
it's no longer necessary to make it accessible to clients.
2007-02-06 09:16:08 +00:00
Tom Lane
91e18dbbcc Docs updates for cross-type hashing. 2007-02-06 04:38:31 +00:00
Tom Lane
b259924e9f Not only did we agree that this 'hint' doesn't belong here, but the
markup's broken.  So just remove it...
2007-02-06 03:03:11 +00:00
Bruce Momjian
b70e536e4d Trim down environment variable instructions for Win32, backpatch to 8.2.X. 2007-02-05 22:18:11 +00:00
Bruce Momjian
fdd4a1ff0d Updated TODO item:
> 	o Add a \set variable to control whether \s displays line numbers

> 	  Another option is to add \# which lists line numbers, and
> 	  allows command execution.
> 	  http://archives.postgresql.org/pgsql-hackers/2006-12/msg00255.php
2007-02-05 17:17:13 +00:00
Bruce Momjian
fcbddea8b7 Modify:
< 	o Add \# to list command history like \s, but with line numbers
> 	o Add \# to list and execute command history
2007-02-05 16:49:13 +00:00
Bruce Momjian
03d442ca60 Add:
>
> * Allow custom variable classes that can restrict who can set the values
>
>   http://archives.postgresql.org/pgsql-hackers/2006-11/msg00911.php
>
2007-02-04 04:06:08 +00:00
Bruce Momjian
1a476a6145 Update wording. 2007-02-04 04:00:28 +00:00
Bruce Momjian
43aa1e59f5 Add documentation for Windows on how to set an environment variable.
Backpatch to 8.2.X.
2007-02-04 03:55:51 +00:00
Bruce Momjian
1d6653ee80 Update URL for:
* Allow sequential scans to take advantage of other concurrent
  sequential scans, also called "Synchronised Scanning"
2007-02-04 02:32:03 +00:00
Bruce Momjian
28019984e9 Add:
>
> 	o Add \# to list command history like \s, but with line numbers
>
> 	  http://archives.postgresql.org/pgsql-hackers/2006-12/msg00255.php
>
2007-02-04 01:50:59 +00:00
Bruce Momjian
300c43e303 Add URLs for:
* Allow sequential scans to take advantage of other concurrent
  sequential scans, also called "Synchronised Scanning"
>   http://archives.postgresql.org/pgsql-patches/2006-12/msg00076.php
>   http://archives.postgresql.org/pgsql-hackers/2006-12/msg00408.php
2007-02-03 23:52:19 +00:00
Bruce Momjian
1a641c0cee Document that a client-only install using:
gmake -C src/bin install

does install a few server-only binaries.
2007-02-03 23:01:06 +00:00
Bruce Momjian
b6f6284802 Add:
> 	  o Allow recovery.conf to allow the same syntax as
> 	    postgresql.conf, including quoting
>
> 	    http://archives.postgresql.org/pgsql-hackers/2006-12/msg00497.php
2007-02-03 22:32:49 +00:00
Peter Eisentraut
4c488e857e Update SQL conformance information about XML features. 2007-02-03 17:59:36 +00:00
Bruce Momjian
b1b9c364cc Add patches thread for:
* Reduce checkpoint performance degredation by forcing data to disk
  more evenly

>   http://archives.postgresql.org/pgsql-patches/2006-12/msg00104.php
2007-02-03 01:59:27 +00:00
Bruce Momjian
635425d845 Add URL for:
* Allow sequential scans to take advantage of other concurrent
  sequential scans, also called "Synchronised Scanning"
>
>   http://archives.postgresql.org/pgsql-hackers/2006-12/msg00784.php
2007-02-02 23:05:36 +00:00
Bruce Momjian
69b90c49bc Add:
> * Reduce checkpoint performance degredation by forcing data to disk
>   more evenly
>
>   http://archives.postgresql.org/pgsql-hackers/2006-12/msg00337.php
>   http://archives.postgresql.org/pgsql-hackers/2007-01/msg00079.php
2007-02-02 22:55:08 +00:00
Bruce Momjian
99be3fa3ee Add URL for:
o Fix RENAME to work on variables other than OLD/NEW
> 		  http://archives.postgresql.org/pgsql-hackers/2007-01/msg01587.php
2007-02-02 21:34:39 +00:00
Neil Conway
ee84009cb0 Reword suggestion that libpq.dll be installed in WINNT\SYSTEM32 under
Windows. Per Magnus Hagander, this is not recommended.
2007-02-02 16:10:08 +00:00