Commit Graph

8464 Commits

Author SHA1 Message Date
Tom Lane
53ae7acbba Add SGML documentation for contrib/spi and contrib/test_parser.
The spi documentation is pretty rudimentary, but it's a start.
2007-12-03 04:18:47 +00:00
Tom Lane
0d4c3855f1 Update SGML contrib documentation to catch up with recent changes to
the former README files.  Albert Cervera i Areny
2007-12-03 03:05:47 +00:00
Tom Lane
01434d41d4 Stamp 8.3beta4. 2007-12-03 00:11:01 +00:00
Tom Lane
3b3251cb95 Ensure that all <sect1> and <refentry> tags have IDs. This is needed
to ensure that the resulting webpages have predictable URLs, instead of
ever-changing numeric IDs.  The new contrib docs were the biggest
offender, but some old stuff had the problem too.  Also, rename a couple
of new contrib sgml files for consistency's sake.
2007-12-02 22:33:20 +00:00
Tom Lane
ec2ff52045 Add SGML docs for contrib/dict_int and contrib/dict_xsyn.
Albert Cervera i Areny
2007-12-02 21:13:34 +00:00
Tom Lane
43da837eda Improve the manual's discussion of partitioning. Recommend using a
trigger instead of a rule to redirect insertions, use NEW.* notation
where appropriate, some other updates and adjustments.  David Fetter
and Tom Lane
2007-12-02 19:20:32 +00:00
Tom Lane
8ee076325f Mention hash opclasses in 'System Dependencies on Operator Classes',
which previously only talked about btree opclasses.
2007-12-02 04:36:40 +00:00
Tom Lane
7cac32534f Sync release notes with CVS HEAD; various editorial improvements. 2007-12-02 03:47:11 +00:00
Bruce Momjian
c2d30556a1 Update release notes to current CVS. 2007-11-30 03:27:48 +00:00
Bruce Momjian
c3facf0041 Update Japanese FAQ.
Jun Kuwamura
2007-11-29 17:09:21 +00:00
Bruce Momjian
6559c4a202 Add additional PITR documentation.
Simon Riggs
2007-11-28 22:35:54 +00:00
Bruce Momjian
664782ee74 RETURN NEXT doc improvement, per Alvaro. 2007-11-28 21:47:39 +00:00
Bruce Momjian
5cbf206c79 Update RETURN NEXT documentation for plpgsql. 2007-11-28 20:56:35 +00:00
Bruce Momjian
62312ce36d Plpgsql doc cleanup.
Guillaume Lelarge
2007-11-28 20:13:06 +00:00
Peter Eisentraut
9293425819 spell checker run 2007-11-28 15:42:31 +00:00
Peter Eisentraut
c1c772225d Add credit to Pavel Stehule for XML functionality 2007-11-28 11:03:50 +00:00
Peter Eisentraut
87ce0fa369 Fix column number 2007-11-28 10:10:14 +00:00
Bruce Momjian
492ae18f0d Add a few current_* variable index entries to the docs.
Guillaume Lelarge
2007-11-28 05:13:41 +00:00
Bruce Momjian
497365f48a Add comments about VACUUM to free space map docs.
Joshua D. Drake
2007-11-28 05:01:24 +00:00
Tom Lane
3f89964234 Add quote_literal(anyelement) to preserve (and, in fact, extend) a
useful consequence of the former liberal implicit casting to text;
namely that you can feed non-string values to quote_literal() and get
unsurprising results.  Per discussion.
2007-11-27 18:29:11 +00:00
Bruce Momjian
a0a9c5bcb9 Add example of MONEY casting to numeric if locale is known. 2007-11-27 16:46:36 +00:00
Bruce Momjian
8fb93b757d Wording improvement for MONEY casting. 2007-11-27 06:05:57 +00:00
Bruce Momjian
ee13b734fa Add documentation about the issues of casting MONEY to/from numeric
types.
2007-11-27 05:49:58 +00:00
Bruce Momjian
91e95588af Add:
< * -Make 64-bit version of the MONEY data type
< * Add locale-aware MONEY type, and support multiple currencies
<
<   http://archives.postgresql.org/pgsql-general/2005-08/msg01432.php
<   http://archives.postgresql.org/pgsql-hackers/2007-03/msg01181.php
<
< * MONEY dumps in a locale-specific format making it difficult to
<   restore to a system with a different locale
>
> * MONEY data type
>
> 	o -Make 64-bit version of the MONEY data type
> 	* Add locale-aware MONEY type, and support multiple currencies
>
> 	  http://archives.postgresql.org/pgsql-general/2005-08/msg01432.php
> 	  http://archives.postgresql.org/pgsql-hackers/2007-03/msg01181.php
>
> 	* MONEY dumps in a locale-specific format making it difficult to
> 	  restore to a system with a different locale
> 	* Allow MONEY to be cast to/from other numeric data types
2007-11-26 23:31:09 +00:00
Peter Eisentraut
c534ba182c Change index_name to name for consistency. 2007-11-26 21:36:33 +00:00
Tom Lane
07daff63c5 Fix select_common_type() so that it can select a domain type, if all inputs
to a UNION, CASE, or related construct are of the same domain type.  The
main part of this routine smashes domains to their base types, which seems
necessary because the logic involves TypeCategory() and IsPreferredType(),
neither of which work usefully on domains.  However, we can add a first
pass that just detects whether all the inputs are exactly the same type,
and if so accept that without question (so long as it's not UNKNOWN).
Per recent gripe from Dean Rasheed.

In passing, remove some tests for InvalidOid, which have clearly been dead
code for quite some time now, because getBaseType() would fail on that input.

Also, clarify the manual's not-very-precise description of the existing
algorithm's behavior.
2007-11-26 16:46:51 +00:00
Bruce Momjian
ba2b2a2c4e Update text:
< * Prevent long-lived temporary tables from causing frozen-Xid advancement
> * Prevent long-lived temporary tables from causing frozen-xid advancement
>
>    The problem is that autovacuum cannot vacuum them to set frozen xids;
>    only the session that created them can do that.
>
>
>
2007-11-23 16:37:55 +00:00
Tatsuo Ishii
d8e8a495da Fix "Overall Page Layout" table. The second row should be ItemIdData, not
ItemPointerData.
2007-11-23 00:24:12 +00:00
Bruce Momjian
73f9089045 Document that doc builds now build indexes by default, unless "draft" is
used.
2007-11-22 15:04:52 +00:00
Tom Lane
fec1d72dd1 Clarify the syntax rules for raw tsvector input. 2007-11-21 04:01:37 +00:00
Bruce Momjian
9eced0031c Split release notes up into smaller sections; easier to read. 2007-11-20 17:10:25 +00:00
Tom Lane
e66d0c6299 Fix some missed usages of 'HTML tag' and 'HTML entity'. 2007-11-20 15:58:52 +00:00
Bruce Momjian
aff5c589fa Make "contrib/" tag consistent. 2007-11-20 05:23:20 +00:00
Bruce Momjian
56696745a8 Split out data types and function entries into separate sections in the
release notes.
2007-11-20 05:16:31 +00:00
Bruce Momjian
726226b128 Release note adjustments suggested by IRC users. 2007-11-20 05:00:24 +00:00
Bruce Momjian
ee891817fb Reorder a few release notes items for consistency. 2007-11-20 04:00:27 +00:00
Bruce Momjian
0af4bb87d3 Trim down release section headings (no need for Changes).
Re-order some items as migration changes.
2007-11-20 03:34:14 +00:00
Andrew Dunstan
1157f3cc81 Change descriptions of entity and tag objects to "XML entity" and "XML tag".
Allow tag and entity names that follow XML rules. Provide for hexadecimal
as well as decimal numeric entities. Adjust code names to coincide with
new descriptions.
2007-11-20 02:25:22 +00:00
Bruce Momjian
a262394c8c Split "server changes" up into smaller sections in release notes. 2007-11-20 01:42:37 +00:00
Bruce Momjian
c37e357978 Markup fix. 2007-11-20 01:19:30 +00:00
Bruce Momjian
1037ab75b2 More release notes wording cleanups. 2007-11-20 01:13:00 +00:00
Bruce Momjian
5276950874 Update COMMENT item:
< 	o Prevent COMMENT ON dbname from issuing a warning when loading
< 	  into a database with a different name, perhaps using COMMENT ON
< 	  CURRENT DATABASE
> 	o Change pg_dump so that a comment on the dumped database is
> 	  applied to the loaded database, even if the database has a
> 	  different name.  This will require new backend syntax, perhaps
> 	  COMMENT ON CURRENT DATABASE.
2007-11-20 00:18:46 +00:00
Bruce Momjian
d29e9725a7 Update wording:
< 	o Allow COMMENT ON dbname to work when loading into a database
< 	  with a different name, perhaps using COMMENT ON CURRENT
<           DATABASE
> 	o Prevent COMMENT ON dbname from issuing a warning when loading
> 	  into a database with a different name, perhaps using COMMENT ON
> 	  CURRENT DATABASE
2007-11-19 23:48:46 +00:00
Bruce Momjian
f59f8aedd8 Add suggested syntax for COMMENT ON DATABASE:
< 	  with a different name
> 	  with a different name, perhaps using COMMENT ON CURRENT
>           DATABASE
>
2007-11-19 19:27:03 +00:00
Bruce Momjian
5e996e4a76 Add:
> 	o Allow COMMENT ON dbname to work when loading into a database
> 	  with a different name
2007-11-19 18:42:11 +00:00
Tom Lane
d4205295aa Improve description of implicit-text-casting compatibility issue.
A bunch of other desultory copy-editing, too.
2007-11-19 03:47:14 +00:00
Tom Lane
3ebb8867aa Minor improvement in documentation of temp_tablespaces: avoid grammatical
ambiguity and say what the default value is.
2007-11-19 02:26:10 +00:00
Tom Lane
7129f26be0 Remove no-longer-accurate claim that REINDEX won't invalidate cached
plans.
2007-11-18 18:42:03 +00:00
Bruce Momjian
b13602c6d0 Wordsmith improvements to first half of release notes, move TEXT cast
item to #1 imcompatibility slot.
2007-11-17 21:13:42 +00:00
Bruce Momjian
fbab505216 Simplify TEXT cast working; spelling fixes to release notes. 2007-11-17 15:17:16 +00:00
Bruce Momjian
bb4a78c070 Fix a few mentions of "Postgres" that slipped into the release notes. 2007-11-16 17:22:21 +00:00
Bruce Momjian
2230944e30 Add release note that "Postgres" is now documented as an acceptable
alias.
2007-11-16 16:12:14 +00:00
Bruce Momjian
6fcfd14697 Simplify wording. 2007-11-16 15:53:57 +00:00
Bruce Momjian
5633da000f Add FAQ items about "Postgres" alias usage, remove old reference. 2007-11-16 15:50:31 +00:00
Tom Lane
2f1e7ffb76 Fix markup that doesn't work in HISTORY generation. 2007-11-16 06:28:07 +00:00
Marc G. Fournier
2a174e45dd update files for beta3 2007-11-16 04:29:45 +00:00
Tom Lane
fb8b38e4bf Add a couple of notes pointing out that GIN index build time is very
sensitive to maintenance_work_mem (something I just learned the hard
way).
2007-11-16 03:23:07 +00:00
Bruce Momjian
ee214defa0 Add more detail for non-TEXT cast release item. 2007-11-15 20:10:32 +00:00
Bruce Momjian
f15c08f055 Document that /contrib/tsearch2 now contains a compatibility interface. 2007-11-15 17:09:40 +00:00
Tom Lane
a1715ac8f7 Adjust example to reduce confusion between a tsvector column and
an index, per Simon.
2007-11-14 23:48:55 +00:00
Tom Lane
866bad9543 Add a rank/(rank+1) normalization option to ts_rank(). While the usefulness
of this seems a bit marginal, if it's useful enough to be shown in the manual
then we probably ought to support doing it without double evaluation of the
ts_rank function.  Per my proposal earlier today.
2007-11-14 23:43:27 +00:00
Tom Lane
ca450a07ee Add an Accept parameter to "simple" dictionaries. The default of true
gives the old behavior; selecting false allows the dictionary to be used
as a filter ahead of other dictionaries, because it will pass on rather
than accept words that aren't in its stopword list.
Jan Urbanski
2007-11-14 18:36:37 +00:00
Bruce Momjian
a44c81d1b7 Mention that GSSAPI is preferred over Kerberos authentication because
GSSAPI is industry-standard.
2007-11-14 14:38:30 +00:00
Magnus Hagander
9394059261 Add note about deprecating krb5 authentication in favour of GSSAPI,
per discussions (a long time ago). Documentation only, we keep full
support in the code.
2007-11-14 14:25:55 +00:00
Bruce Momjian
144c519842 Capitalize "Migration to Version". 2007-11-14 14:06:54 +00:00
Bruce Momjian
1a339a3939 Properly capitalize "Migrate To Version"; seems we always had that
wrong.
2007-11-14 12:36:34 +00:00
Bruce Momjian
ec67a91106 Markup cleanup. 2007-11-14 03:39:53 +00:00
Bruce Momjian
4ba85c1e24 Reference pgfoundry instead of gborg. 2007-11-14 03:39:17 +00:00
Bruce Momjian
2d7090bc56 Remove reference to gborg, instead reference pgfoundry. 2007-11-14 03:37:30 +00:00
Tom Lane
de085820bf Update discussion of tsearch2 migration. I'm not entirely sure about
the division of material between here and the tsearch2 contrib page,
but at least it's not obviously unfinished any more.
2007-11-14 03:26:24 +00:00
Tom Lane
42e3ab3f11 Move contrib docs to an appendix (next door to External Projects).
Change title to Additional Supplied Modules.  Improve discussion of
how to build and install 'em.
2007-11-14 02:36:43 +00:00
Tom Lane
21fec14941 Clean up some now-obsolete references to GBorg. 2007-11-14 01:58:18 +00:00
Tom Lane
4c2d0cd5e4 Add some quick documentation for tsearch2 compatibility module. 2007-11-14 01:09:50 +00:00
Bruce Momjian
c027fa5757 Update release notes to current CVS. 2007-11-14 00:16:27 +00:00
Tom Lane
b40c0a4bb0 Clean up some stray references to tsearch2. 2007-11-13 23:36:26 +00:00
Bruce Momjian
6832927ce3 Add link to Postgres-R glossary from our documentation (has helpful
terms defined).
2007-11-13 18:44:20 +00:00
Bruce Momjian
2ce1a60bfa No master server overhead for middleware replication. 2007-11-12 18:01:44 +00:00
Bruce Momjian
f4294090ae Change replication chart title to "No waiting for multiple servers". 2007-11-12 17:02:14 +00:00
Bruce Momjian
e1829591cb Trim trailing whitespace --- needed commit to update anoncvs. 2007-11-12 01:37:34 +00:00
Bruce Momjian
6b8cc88268 Remove tabs from SGML files. 2007-11-11 14:23:18 +00:00
Bruce Momjian
926bbab448 Make /contrib install/uninstall script consistent:
remove transactions
	use create or replace function
	make formatting consistent
	set search patch on first line

Add documentation on modifying *.sql to set the search patch, and
mention that major upgrades should still run the installation scripts.

Some of these issues were spotted by Tom today.
2007-11-11 03:25:35 +00:00
Bruce Momjian
c3c69ab4fd Move most /contrib README files into SGML. Some still need conversion
or will never be converted.
2007-11-10 23:30:46 +00:00
Bruce Momjian
6e414a171e Add pg_ctl -t/timeout parameter to control amount of time to wait for
start/shutdown.
2007-11-10 21:48:51 +00:00
Tom Lane
c6722d7211 Add an example of a SQL function with output parameters returning
multiple rows.  I had thought this case was covered, but there was
no example in the obvious section to look in.
2007-11-10 20:14:36 +00:00
Bruce Momjian
20a8825778 High availability wording fix. 2007-11-10 19:19:36 +00:00
Bruce Momjian
455fa463ad Update high availability documentation with comments from Markus Schiltknecht. 2007-11-10 19:14:02 +00:00
Bruce Momjian
d009992ba3 Have text search thesaurus files use "?" for stop words.
Throw an error for actual stop words, rather than a warning.  This fixes
problems with cache reloading causing warning messages.

Re-enable stop words in regression tests;  was disabled by Tom.

Document "?" as API change.
2007-11-10 15:39:34 +00:00
Bruce Momjian
a341b876d8 Fix markup problem with recent pg_ctl change. 2007-11-10 14:07:18 +00:00
Bruce Momjian
f19c8577eb Properly order pg_ctl -c option alphabetically in docs. 2007-11-10 04:52:17 +00:00
Bruce Momjian
4521207390 Remove tabs from SGML files. 2007-11-09 23:52:08 +00:00
Alvaro Herrera
83290b678d Point to our own UUID page instead of to Wikipedia. 2007-11-09 22:22:46 +00:00
Magnus Hagander
4b606ee444 Add parameter krb_realm used by GSSAPI, SSPI and Kerberos
to validate the realm of the connecting user. By default
it's empty meaning no verification, which is the way
Kerberos authentication has traditionally worked in
PostgreSQL.
2007-11-09 17:31:07 +00:00
Bruce Momjian
a7cd5a4aa0 Move pl/proxy into Multi-server parallel query execution documentation
section.
2007-11-09 16:36:04 +00:00
Bruce Momjian
f55e6c07c3 Wording improvement for pl/proxy mention. 2007-11-08 22:14:18 +00:00
Bruce Momjian
4a2077efe4 Add mention of pl/proxy toolset to docs. 2007-11-08 22:08:18 +00:00
Bruce Momjian
f1528b5154 Properly indent SGML file. 2007-11-08 19:18:23 +00:00
Bruce Momjian
621e14dcb2 Add "High Availability, Load Balancing, and Replication Feature Matrix"
table to docs.
2007-11-08 19:16:30 +00:00
Bruce Momjian
5db1c58a1a Move NFS section into "Creating Cluster" documentation section because
it seems more logical there.
2007-11-08 15:21:03 +00:00
Peter Eisentraut
b7210a07a9 Mention text search instead of tsearch2 2007-11-08 13:13:51 +00:00
Peter Eisentraut
d624f94a88 Small fixes 2007-11-08 13:13:28 +00:00
Peter Eisentraut
371d7bc7c0 <optional> cannot be used here, because psql doesn't handle it. 2007-11-07 14:07:53 +00:00
Peter Eisentraut
0e3c27538a Specify putting two spaces after sentence-ending period, which is current
practice also.
2007-11-07 13:12:21 +00:00
Peter Eisentraut
5f9869d0ee Use "alternative" instead of "alternate" where it is clearer. 2007-11-07 12:24:24 +00:00
Bruce Momjian
c1a03bee08 Document that configure option only affects contrib:
--with-ossp-uuid        use OSSP UUID library when building /contrib/uuid-ossp
2007-11-05 17:43:20 +00:00
Tom Lane
faac769a6b Minor editorial improvements to txid functions' documentation: put back
some text that got dropped, improve markup, improve descriptions of
snapshot components.
2007-11-05 17:40:21 +00:00
Bruce Momjian
c00055ea80 Document that syncronhous commit can be turned off in a single
multi-statement transaction.
2007-11-05 17:35:38 +00:00
Bruce Momjian
11d740ed9e Remove <sect1> of txid functions. 2007-11-05 16:57:23 +00:00
Bruce Momjian
bd2ef63aa8 Move txid snapshot field description table from datatype to functions section. 2007-11-05 16:45:52 +00:00
Magnus Hagander
f5f375330e Fix typos.
Guillaume Lelarge
2007-11-05 15:55:53 +00:00
Bruce Momjian
ec1aafca7d Document txid functions.
Marko Kreen
2007-11-05 14:51:08 +00:00
D'Arcy J.M. Cain
f00e542746 Remove deprecation notice and add comment about safely restoring backups.
As per discussion on hackers.
2007-11-05 12:02:20 +00:00
Bruce Momjian
1e941153a2 Working improvement. 2007-11-04 21:50:28 +00:00
Bruce Momjian
c066d27f36 Add link to NFS section from "creating a database cluster. 2007-11-04 21:48:03 +00:00
Bruce Momjian
3372380cc4 Document possible problems with NFS tablespaces. 2007-11-04 21:40:02 +00:00
Bruce Momjian
729d2b08c0 Properly indent tablespace SGML section. 2007-11-04 19:43:33 +00:00
Bruce Momjian
38fe3a9646 Mention "replication" in the title of the high availability and load
balancing chapter because some people were looking for 'replication' and
didn't realize that chapter addressed it.
2007-11-04 19:23:24 +00:00
Bruce Momjian
f96e1e0faa Update wording for xsl configure option. 2007-11-04 18:53:39 +00:00
Bruce Momjian
ede83e04aa Document that configure --with-libxslt controls just /contrib/xml2.
Nikolay Samokhvalov
2007-11-04 18:10:42 +00:00
Bruce Momjian
65bd783614 Mention that internal hash functions changed in 8.3 release notes. 2007-11-01 22:38:36 +00:00
Tom Lane
9423be4449 Some corrections/improvements to new acronym list. 2007-11-01 20:27:33 +00:00
Tom Lane
388c7e28c5 Update discussion of shared memory sizing for 8.3: adjust multipliers,
mention autovacuum_max_workers.  Minor copy-editing too.
2007-11-01 19:06:01 +00:00
Bruce Momjian
5c996884a0 Update Czech FAQ.
Pavel Stehule
2007-11-01 17:28:03 +00:00
Bruce Momjian
6287c31b5a Acronym spelling fix. 2007-11-01 17:16:36 +00:00
Bruce Momjian
53e3f9dcfd Add documentation mention that FSM == Free Space Map, so the config
parameter name makes more sense.
2007-11-01 17:06:30 +00:00
Bruce Momjian
61c8163957 Add acronym section to our documentation. 2007-11-01 17:00:46 +00:00
Bruce Momjian
f0cd76fcc4 Add:
> * Prevent long-lived temporary tables from causing frozen-Xid advancement
>    starvation
2007-10-31 20:12:44 +00:00
Peter Eisentraut
e07904b0a4 Add note on PostgreSQL vs. Postgres. 2007-10-30 23:06:06 +00:00
Tom Lane
406ee67c9a Update some obsolete stuff in the GRANT and REVOKE reference pages:
simplify the syntax examples by unifying user and group cases, and fix
no-longer-correct example of psql \z output.  Per Erwin Brandstetter.
2007-10-30 19:43:30 +00:00
Tom Lane
897313e824 Add a note pointing out that some other databases make GREATEST and
LEAST handle NULL arguments differently than we do.  Per a discussion
on 30-Jun that somehow didn't get done.
2007-10-30 19:06:56 +00:00
Bruce Momjian
f7967d4c69 Documentation wording fixes.
Guillaume Lelarge
2007-10-29 17:29:59 +00:00
Bruce Momjian
e1f55afe7d Update Russian FAQ.
corochoone@gmail.com
2007-10-29 17:27:10 +00:00
Bruce Momjian
96805a18c6 Clarify restart is of the "database" server, in FAQ. 2007-10-29 17:22:20 +00:00
Tom Lane
f9e83a5588 Remove claim that ts_headline knows how to generate multiple ellipsis-separated
excerpts of a document.  That's clearly desirable, but the functionality
is not there yet.
2007-10-29 01:55:11 +00:00
Tom Lane
3fe266207b Ooops, fat-fingered last commit message. Should have
mentioned updating FAQ_IRIX for information about buggy MIPSPro
compiler version, now confirmed by Herve Boulouis.
2007-10-28 22:33:25 +00:00
Tom Lane
d034a268a2 FAQ_IRIX 2007-10-28 22:30:21 +00:00
Tom Lane
d015d08b43 Rename default text search parser's "uri" token type to "url_path",
per recommendation from Alvaro.  This doesn't force initdb since the
numeric token type in the catalogs doesn't change; but note that
the expected regression test output changed.
2007-10-27 16:01:09 +00:00
Tom Lane
5b5a70aedf Stamp 8.3beta2. 2007-10-27 00:22:42 +00:00
Tom Lane
2aac6f10f6 Minor wording improvements per suggestion from Jeff Davis. Also tweak
hyphenated-word parser examples per earlier discussion with Alvaro.
2007-10-27 00:19:45 +00:00
Bruce Momjian
ffda32e9fd Remove second-in-paragraph usage of "Postgres" in FAQ_DEV. 2007-10-26 19:08:57 +00:00
Bruce Momjian
f201257991 Remove use of "Postgres" aliases in the FAQ in second-in-paragraph
cases.
2007-10-26 19:04:37 +00:00
Bruce Momjian
350196df4a Set Japanese FAQ character code to UTF-8.
Jun Kuwamura
2007-10-26 03:59:22 +00:00
Bruce Momjian
fa9eb3152e Add plpgsql doc example of RETURN NEXT.
Ulrich Kroener
2007-10-26 01:11:09 +00:00
Tom Lane
9ddfe034c7 Fix ALTER SEQUENCE so that it does not affect the value of currval() for
the sequence.  Also, make setval() with is_called = false not affect the
currval state, either.  Per report from Kris Jurka that an implicit
ALTER SEQUENCE OWNED BY unexpectedly caused currval() to become valid.
Since this isn't 100% backwards compatible, it will go into HEAD only;
I'll put a more limited patch into 8.2.
2007-10-25 18:54:03 +00:00
Alvaro Herrera
0e3ddc8dd5 Use more real-world examples in the text search parser documentation. 2007-10-25 13:06:35 +00:00
Bruce Momjian
41f207620a Update release notes to current CVS. 2007-10-25 02:50:26 +00:00
Tom Lane
048efc25e4 Disallow scrolling of FOR UPDATE/FOR SHARE cursors, so as to avoid problems
in corner cases such as re-fetching a just-deleted row.  We may be able to
relax this someday, but let's find out how many people really care before
we invest a lot of work in it.  Per report from Heikki and subsequent
discussion.

While in the neighborhood, make the combination of INSENSITIVE and FOR UPDATE
throw an error, since they are semantically incompatible.  (Up to now we've
accepted but just ignored the INSENSITIVE option of DECLARE CURSOR.)
2007-10-24 23:27:08 +00:00
Tom Lane
8a35b07e18 Remove obsolete statement that you can't update through a cursor. 2007-10-24 22:55:52 +00:00
Tom Lane
592c88a0d2 Remove the aggregate form of ts_rewrite(), since it doesn't work as desired
if there are zero rows to aggregate over, and the API seems both conceptually
and notationally ugly anyway.  We should look for something that improves
on the tsquery-and-text-SELECT version (which is also pretty ugly but at
least it works...), but it seems that will take query infrastructure that
doesn't exist today.  (Hm, I wonder if there's anything in or near SQL2003
window functions that would help?)  Per discussion.
2007-10-24 02:24:49 +00:00
Tom Lane
dbaec70c15 Rename and slightly redefine the default text search parser's "word"
categories, as per discussion.  asciiword (formerly lword) is still
ASCII-letters-only, and numword (formerly word) is still the most general
mixed-alpha-and-digits case.  But word (formerly nlword) is now
any-group-of-letters-with-at-least-one-non-ASCII, rather than all-non-ASCII as
before.  This is no worse than before for parsing mixed Russian/English text,
which seems to have been the design center for the original coding; and it
should simplify matters for parsing most European languages.  In particular
it will not be necessary for any language to accept strings containing digits
as being regular "words".  The hyphenated-word categories are adjusted
similarly.
2007-10-23 20:46:12 +00:00
Tom Lane
f551348417 Clarify example of planner cost computation, per a suggestion from
James Shaw.  Also update a couple of examples to reflect 8.3's improved
plan-printing code.
2007-10-22 21:34:33 +00:00
Tom Lane
3e17ef1cfa Adjust ts_debug's output as per my proposal of yesterday: show the
active dictionary and its output lexemes as separate columns, instead
of smashing them into one text column, and lowercase the column names.
Also, define the output rowtype using OUT parameters instead of a
composite type, to be consistent with the other built-in functions.
2007-10-22 20:13:37 +00:00
Tom Lane
6088bfb8b6 Create a quick-and-dirty list of known migration issues for pre-8.3
users of tsearch.  This isn't meant to be permanent documentation,
but to call out the areas that need either fixing or real documentation.
2007-10-22 03:37:04 +00:00
Tom Lane
dfc6f130b4 Editorial overhaul for text search documentation. Organize the info
more clearly, improve a lot of unclear descriptions, add some missing
material.  We still need a migration guide though.
2007-10-21 20:04:37 +00:00
Bruce Momjian
6cb00e67ef Update Japanese FAQ.
Jun Kuwamura
2007-10-20 23:59:15 +00:00
Bruce Momjian
b002af5698 More release note word-smithing. 2007-10-20 23:41:23 +00:00
Bruce Momjian
24f3a77112 Fix release tag spelling typo. 2007-10-20 20:19:06 +00:00
Bruce Momjian
1ba96ef04f More release note wording improvements. 2007-10-20 16:41:09 +00:00
Bruce Momjian
7b98f6be6e Update German FAQ.
Ian Barwick
2007-10-20 15:49:09 +00:00
Tom Lane
41a312a1f6 Add a note pointing out that you can't log to syslog without tweaking
the syslog configuration file (at least not on most known Unixen).
I dunno why we hadn't had that info in the docs all along ...
2007-10-20 04:00:38 +00:00
Bruce Momjian
6fe5885cdf More indenting cleanup for release notes. 2007-10-19 01:56:06 +00:00
Bruce Momjian
35dab98e1b Consistently indent release notes for prior releases. 2007-10-18 23:34:54 +00:00
Bruce Momjian
decff24fe2 More release wording adjustments. 2007-10-18 23:05:06 +00:00
Bruce Momjian
52c51a45e6 More indenting cleanup, tag additions. 2007-10-18 16:47:58 +00:00
Bruce Momjian
f031610297 Move a few items into migration from the main changes section. Indent
8.3 consistently.
2007-10-18 16:45:05 +00:00
Neil Conway
35342395c0 Minor fixes for the release notes. 2007-10-18 06:07:23 +00:00
Bruce Momjian
403b6fd9a9 Small changes to release note descriptions. 2007-10-18 05:39:06 +00:00
Bruce Momjian
62c99fc289 First pass over release documentation. I trimmed down some of the
entries and removed a few.
2007-10-18 05:15:48 +00:00
Bruce Momjian
6bec963aa5 Re-add FAQ item:
<H3 id="item4.19">4.19) Why do I get "relation with OID #####
    does not exist" errors when accessing temporary tables in PL/PgSQL
    functions?</H3>
2007-10-17 17:34:51 +00:00
Tom Lane
6efae5bf2a Another round of editorialization on the text search documentation.
Notably, standardize on using "token" for the strings output by a parser,
while "lexeme" is reserved for the normalized strings produced by a
dictionary.
2007-10-17 01:01:28 +00:00
Bruce Momjian
cb0d539d05 Mention Slony as just an example. 2007-10-16 19:44:18 +00:00
Magnus Hagander
d8c5edae3b Fix the URL properly per Robert Treat. 2007-10-16 19:04:34 +00:00
Bruce Momjian
4fef90dfed Add doc clarifications for warm standby. 2007-10-16 14:56:51 +00:00
Magnus Hagander
aad991b41b Update URLs to a couple of external projects 2007-10-16 12:14:33 +00:00
Bruce Momjian
59dc5d0e11 Slony switch is only seconds of downtime. 2007-10-16 05:37:40 +00:00
Bruce Momjian
e61d252152 Add mention of Slony for in-place upgrades. 2007-10-16 02:48:57 +00:00
Tom Lane
4b21d1f09b Remove obsolete examples of add-on parsers and dictionary templates;
these are more easily and usefully maintained as contrib modules.
Various other wordsmithing, markup improvement, etc.
2007-10-15 21:39:57 +00:00
Tom Lane
18e3fcc31e Migrate the former contrib/txid module into core. This will make it easier
for Slony and Skytools to depend on it.  Per discussion.
2007-10-13 23:06:28 +00:00
Bruce Momjian
bf673f2525 Attached some minor corrections, mainly completion of removal of
the  "relation with OID ##### does not exist" item, and some URL
corrections.

Ian Barwick
2007-10-13 03:37:12 +00:00
Bruce Momjian
05c609b3d4 Add missing word. 2007-10-11 20:35:56 +00:00
Bruce Momjian
70680211de Add missing word. 2007-10-11 20:04:59 +00:00
Bruce Momjian
1246fcd02a Update release notes in "major" and "migration" sections. Still have
remainder of release notes to review.
2007-10-11 19:46:21 +00:00
Bruce Momjian
68b08b2512 Whitespace cleanup. 2007-10-11 02:43:55 +00:00
Neil Conway
f83a9303a6 Minor correction for full-text search limitations docs.
Heikki Linnakangas.
2007-10-10 21:48:22 +00:00
Neil Conway
8230895313 Fix typo in REVOKE reference page. Guillaume Lelarge. 2007-10-10 21:38:51 +00:00
Bruce Momjian
29eece51a8 Back out release changes that weren't ready for commit. 2007-10-10 14:09:49 +00:00
Bruce Momjian
688b3aac49 Update Japanese FAQ.
Jun Kuwamura
2007-10-10 13:43:42 +00:00
Bruce Momjian
e1caa90406 Add mention of full text indexing for word searches. 2007-10-09 20:13:11 +00:00
Bruce Momjian
db962bb14d Remove FAQ item about temp tables in plpsql having invalid oid problems,
per suggestions from Pavel Stehule.
2007-10-09 20:08:04 +00:00
Bruce Momjian
cd2cf74584 Update sequence FAQ items, per suggestion from Pavel Stehule. 2007-10-09 19:55:36 +00:00
Neil Conway
81f285da7c Replace a reference to "start_log_collector" with "logging_collector",
per Guillaume Lelarge.
2007-10-09 18:14:01 +00:00
Bruce Momjian
535b07873d Update Brazilian FAQ.
Euler Taveira de Oliveira
2007-10-09 03:21:00 +00:00
Bruce Momjian
30b6622ecc Typo fix.
Euler Taveira de Oliveira
2007-10-09 03:20:09 +00:00
Bruce Momjian
f7c6cb0be8 Add:
> * MONEY dumps in a locale-specific format making it difficult to
>   restore to a system with a different locale
2007-10-09 02:31:40 +00:00
Bruce Momjian
d63790d726 Clarify user of "postmaster" vs. "server" in FAQs.
Brendan Jurd
2007-10-09 01:28:24 +00:00
Bruce Momjian
7121cc9021 Add:
> 	o Have ALTER SEQUENCE RENAME rename the sequence name stored
> 	  in the sequence table
>
> 	  http://archives.postgresql.org/pgsql-bugs/2007-09/msg00092.php
> 	  http://archives.postgresql.org/pgsql-bugs/2007-10/msg00007.php
>
2007-10-08 18:01:17 +00:00
Alvaro Herrera
2a997a7065 A few improvements to analyze and vacuum sections in documentation: add "see
also" entries for autovacuum in analyze and vacuum reference pages, and
enhance usage of cross-references in the maintenance page.
2007-10-07 01:16:42 +00:00
Alvaro Herrera
a3ff937359 Change &pi; to plain "pi" in index entry, to avoid double escaping issues. 2007-10-07 01:13:30 +00:00
Alvaro Herrera
2816b2cdd2 Clean up the doc makefile for draft HTML generation. It no longer works
to do "make DRAFT=Y html"; you need to use "make draft" (which was also
supported previously).
2007-10-07 00:32:11 +00:00
Alvaro Herrera
4718358fe7 Remove stylesheet.css file on "make clean", created only on VPATH builds. 2007-10-07 00:23:21 +00:00
Alvaro Herrera
f5e2911144 Fix missing parenthesis, per Guillaume Lelarge. 2007-10-06 17:45:49 +00:00
Alvaro Herrera
c880ed0afb Fix SGML markup, from Guillaume Lelarge. 2007-10-06 15:50:43 +00:00
Tom Lane
3a38ea2616 Remove some cross-references that don't seem to work in HISTORY
generation ... we should figure this out later ...
2007-10-05 04:03:41 +00:00
Tom Lane
3c2d497f8d Some desultory markup improvements in the new release notes. 2007-10-04 22:55:49 +00:00
Tom Lane
87dfa0d9ae Stamp 8.3beta1, except in configure.in/configure. 2007-10-04 19:12:04 +00:00
Neil Conway
0b3f5ac43d Two fixes for the release notes from Guillaume Smet. In passing, make
a minor markup improvement.
2007-10-04 07:53:07 +00:00
Neil Conway
77b0f459c8 First pass at SGML-ifying the 8.3 release notes. Plenty of improvements
left to made, but this is a start.
2007-10-04 03:53:58 +00:00
Tom Lane
0a04109d60 Second pass at 8.3 release notes: put items in a bit more logical order
where possible, add overview and incompatibilities lists, minor cleanups.
The SGML-ification still leaves much to be desired.
2007-10-03 23:02:16 +00:00
Neil Conway
a522db7d62 Various minor improvements to the 8.3 release notes. 2007-10-03 22:06:13 +00:00
Tom Lane
bda5750a33 Some editorial improvements for recently-added ALTER SEQUENCE/VIEW
documentation.  Heikki and Tom
2007-10-03 16:48:43 +00:00
Tom Lane
6d673a63ed First cut at 8.3 release notes. SGML markup is nonexistent, and
the 'overview' and 'incompatibilities' summary lists remain to be
written.  But I think all the raw info is there (indeed maybe too
verbose).
2007-10-03 03:32:31 +00:00
Tom Lane
eb9f280ca7 Add catalogs.sgml documentation for text search catalogs. 2007-10-01 21:10:40 +00:00
Tom Lane
5a95c560f0 Add note warning against use of pre-8.4 multithreaded Tcl. 2007-10-01 16:43:28 +00:00
Tom Lane
27b8922221 Add an extra header byte to TOAST-pointer datums to represent their size
explicitly.  This means a TOAST pointer takes 18 bytes instead of 17 --- still
smaller than in 8.2 --- which seems a good tradeoff to ensure we won't have
painted ourselves into a corner if we want to support multiple types of TOAST
pointer later on.  Per discussion with Greg Stark.
2007-09-30 19:54:58 +00:00
Tom Lane
b46bd55a6c Make archive recovery always start a new timeline, rather than only when a
recovery stop time was used.  This avoids a corner-case risk of trying to
overwrite an existing archived copy of the last WAL segment, and seems
simpler and cleaner all around than the original definition.  Per example
from Jon Colverson and subsequent analysis by Simon.
2007-09-29 01:36:10 +00:00
Tom Lane
70b9b9b788 Change initdb and CREATE DATABASE to actively reject attempts to create
databases with encodings that are incompatible with the server's LC_CTYPE
locale, when we can determine that (which we can on most modern platforms,
I believe).  C/POSIX locale is compatible with all encodings, of course,
so there is still some usefulness to CREATE DATABASE's ENCODING option,
but this will insulate us against all sorts of recurring complaints
caused by mismatched settings.

I moved initdb's existing LC_CTYPE-to-encoding mapping knowledge into
a new src/port/ file so it could be shared by CREATE DATABASE.
2007-09-28 22:25:49 +00:00
Bruce Momjian
ae0b90f223 Remove:
< * SQL*Net listener that makes PostgreSQL appear as an Oracle database
<   to clients
2007-09-28 21:32:29 +00:00
Tom Lane
77c166ba6c Add virtual transaction IDs to CSVLOG output, so that messages coming from
the same transaction can be identified even when no regular XID was assigned.
This seems essential after addition of the lazy-XID patch.  Also some
minor code cleanup in write_csvlog().
2007-09-27 18:15:36 +00:00
Bruce Momjian
03a91e0d10 Lowercase all mentions of "PostgreSQL" in URLs, per Magnus. 2007-09-27 06:14:47 +00:00
Tom Lane
f18dfc4835 Minor improvements in backup and recovery:
- create a separate archive_mode GUC, on which archive_command is dependent

- %r option in recovery.conf sends last restartpoint to recovery command

- %r used in pg_standby, updated README

- minor other code cleanup in pg_standby

- doc on Warm Standby now mentions pg_standby and %r

- log_restartpoints recovery option emits LOG message at each restartpoint

- end of recovery now displays last transaction end time, as requested
  by Warren Little; also shown at each restartpoint

- restart archiver if needed to carry away WAL files at shutdown

Simon Riggs
2007-09-26 22:36:30 +00:00
Bruce Momjian
80963144ad Rename "PostgreSQL" to "Postgres" in 3 places. 2007-09-26 20:38:28 +00:00
Bruce Momjian
9692324734 Rename "PostgreSQL" to "Postgres" in 7 places in the FAQ. 2007-09-26 20:36:50 +00:00
Bruce Momjian
10e1b9df5c Add:
> * Implement Boyer-Moore searching in strpos()
>
>   http://archives.postgresql.org/pgsql-patches/2007-08/msg00012.php
2007-09-26 08:47:43 +00:00
Bruce Momjian
1b57b8bfdc Document that libpq's PQntuples() might overflow. 2007-09-26 08:45:50 +00:00
Tom Lane
6f5c38dcd0 Just-in-time background writing strategy. This code avoids re-scanning
buffers that cannot possibly need to be cleaned, and estimates how many
buffers it should try to clean based on moving averages of recent allocation
requests and density of reusable buffers.  The patch also adds a couple
more columns to pg_stat_bgwriter to help measure the effectiveness of the
bgwriter.

Greg Smith, building on his own work and ideas from several other people,
in particular a much older patch from Itagaki Takahiro.
2007-09-25 20:03:38 +00:00
Tom Lane
48f7e64395 Simplify and rename some GUC variables, per various recent discussions:
* stats_start_collector goes away; we always start the collector process,
unless prevented by a problem with setting up the stats UDP socket.

* stats_reset_on_server_start goes away; it seems useless in view of the
availability of pg_stat_reset().

* stats_block_level and stats_row_level are merged into a single variable
"track_counts", which controls all reports sent to the collector process.

* stats_command_string is renamed to track_activities.

* log_autovacuum is renamed to log_autovacuum_min_duration to better reflect
its meaning.

The log_autovacuum change is not a compatibility issue since it didn't exist
before 8.3 anyway.  The other changes need to be release-noted.
2007-09-24 03:12:23 +00:00
Andrew Dunstan
02138357ff Remove "convert 'blah' using conversion_name" facility, because if it
produces text it is an encoding hole and if not it's incompatible
with the spec, whatever the spec means (which we're not sure about anyway).
2007-09-24 01:29:30 +00:00
Bruce Momjian
d16f270e59 Typo fix from Brendan Jurd. 2007-09-23 18:06:47 +00:00
Tom Lane
90c156f0d1 Document the translations from Postgres message severity levels to
syslog and eventlog severity levels, per suggestion from Josh Drake.
Also, some wordsmithing for the csvlog documentation.
2007-09-22 19:10:44 +00:00
Tom Lane
cc59049daf Improve handling of prune/no-prune decisions by storing a page's oldest
unpruned XMAX in its header.  At the cost of 4 bytes per page, this keeps us
from performing heap_page_prune when there's no chance of pruning anything.
Seems to be necessary per Heikki's preliminary performance testing.
2007-09-21 21:25:42 +00:00
Bruce Momjian
754838caa3 Done:
> * -Consider shrinking expired tuples to just their headers
> * -Allow heap reuse of UPDATEd rows if no indexed columns are changed,
>   and old and new versions are on the same heap page

Not needed anymore:

< * Reuse index tuples that point to heap tuples that are not visible to
<   anyone?
2007-09-20 18:54:19 +00:00
Tom Lane
282d2a03dd HOT updates. When we update a tuple without changing any of its indexed
columns, and the new version can be stored on the same heap page, we no longer
generate extra index entries for the new version.  Instead, index searches
follow the HOT-chain links to ensure they find the correct tuple version.

In addition, this patch introduces the ability to "prune" dead tuples on a
per-page basis, without having to do a complete VACUUM pass to recover space.
VACUUM is still needed to clean up dead index entries, however.

Pavan Deolasee, with help from a bunch of other people.
2007-09-20 17:56:33 +00:00
Bruce Momjian
4893eadc3c Remove tabs from SGML file. 2007-09-19 03:13:57 +00:00
Andrew Dunstan
55613bf9cd Close previously open holes for invalidly encoded data to enter the
database via builtin functions, as recently discussed on -hackers.

chr() now returns a character in the database encoding. For UTF8 encoded databases
the argument is treated as a Unicode code point. For other multi-byte encodings
the argument must designate a strict ascii character, or an error is raised,
as is also the case if the argument is 0.

ascii() is adjusted so that it remains the inverse of chr().

The two argument form of convert() is gone, and the three argument form now
takes a bytea first argument and returns a bytea. To cover this loss three new
functions are introduced:
. convert_from(bytea, name) returns text - converts the first argument from the
  named encoding to the database encoding
. convert_to(text, name) returns bytea - converts the first argument from the
  database encoding to the named encoding
. length(bytea, name) returns int - gives the length of the first argument in
  characters in the named encoding
2007-09-18 17:41:17 +00:00
Tom Lane
e92da1a9d1 Update release notes for last-minute fix. 2007-09-16 03:03:00 +00:00
Bruce Momjian
9a36a09f2e Update Japanese FAQ.
Jun Kuwamura
2007-09-15 00:58:19 +00:00
Bruce Momjian
c16ffbc677 Add:
>
> 	o Prevent long-lived temporary tables from causing frozen-xid
> 	  advancement starvation
>
> 	  http://archives.postgresql.org/pgsql-general/2007-06/msg01645.php
2007-09-14 19:02:46 +00:00
Bruce Momjian
dc8a8a0463 Add:
>
> * Make it possible to use RETURNING together with conditional DO INSTEAD
>   rules, such as for partitioning setups
>
>   http://archives.postgresql.org/pgsql-hackers/2007-09/msg00577.php
2007-09-14 18:50:48 +00:00
Bruce Momjian
18cad61e67 Fix markup. 2007-09-14 18:39:58 +00:00
Bruce Momjian
637878cd85 Update pronunciation FAQ item. 2007-09-14 18:38:44 +00:00
Bruce Momjian
23221f4eea Update to mention alternate project name is "Postgres". 2007-09-14 18:29:59 +00:00
Tom Lane
b2acd633e4 Fix markup that doesn't work in back branches. 2007-09-14 16:15:35 +00:00
Bruce Momjian
12afe7bc76 Document atan2() as y/x, rather than x/y, to conform to general usage.
Andrew Maclean
2007-09-14 15:53:48 +00:00
Tom Lane
9b2afa90bf Minor editorialization on release notes. 2007-09-14 15:50:51 +00:00
Bruce Momjian
4b836d8312 Add some links for escape strings.
Brendan Jurd

Fix markup in previous commit.
2007-09-14 14:54:25 +00:00
Bruce Momjian
f6a168e2c3 Add LDAP URL documentation.
Albe Laurenz
2007-09-14 14:31:22 +00:00
Bruce Momjian
13e26073bd Update documentation to mention that autovacuum also does analyze so we
don't need to recommend nightly analyzes anymore unless autovacuum is off.
2007-09-14 13:43:03 +00:00
Bruce Momjian
fc79628641 Clarify tar documentation about return error codes.
Backpatch to 8.2.X.
2007-09-14 13:26:22 +00:00
Bruce Momjian
ae36e0d589 Update tsearch include location in example.
Oleg.
2007-09-14 13:21:30 +00:00
Bruce Momjian
c0f2b109bc This is small patch fixes a spi example (PG_MODULE_MAGIC is required as
of PostgreSQL 8.2) and provides a link to compiling and linking section.

Euler Taveira de Oliveira
2007-09-14 04:18:27 +00:00
Bruce Momjian
edc18429bd Update GNU tar error code documentation.
Backpatch to 8.2.X.
2007-09-14 04:15:50 +00:00
Bruce Momjian
6c9e4d7e08 Mentino that PAM doesn't work for Unix system authentication because of
the problems non-root reading /etc/shadow.
2007-09-14 03:53:54 +00:00
Bruce Momjian
aa33bdd783 Update documented error text.
Fujii Masao
2007-09-14 02:43:18 +00:00
Bruce Momjian
dfe2e3f7a5 Clarify age() 'months' calculation documentation. 2007-09-14 00:52:45 +00:00
Bruce Momjian
f307fe4c9b Update documentation to emphasize autovacuum rather than
administrator-scheduled vacuums.
2007-09-13 23:43:35 +00:00
Bruce Momjian
e8e2bd799f Update Japanese FAQ, backpatch.
Jun Kuwamura
2007-09-13 03:34:11 +00:00
Bruce Momjian
8049626ee2 Update Japanese FAQ to current release number. 2007-09-12 03:11:42 +00:00
Bruce Momjian
0735264aab Upcoming most recent release will be 8.2.5. 2007-09-11 17:34:12 +00:00
Bruce Momjian
da7192d1d4 Stamp 2007-09-11 17:19:49 +00:00
Tom Lane
82a47982f3 Arrange for SET LOCAL's effects to persist until the end of the current top
transaction, unless rolled back or overridden by a SET clause for the same
variable attached to a surrounding function call.  Per discussion, these
seem the best semantics.  Note that this is an INCOMPATIBLE CHANGE: in 8.0
through 8.2, SET LOCAL's effects disappeared at subtransaction commit
(leading to behavior that made little sense at the SQL level).

I took advantage of the opportunity to rewrite and simplify the GUC variable
save/restore logic a little bit.  The old idea of a "tentative" value is gone;
it was a hangover from before we had a stack.  Also, we no longer need a stack
entry for every nesting level, but only for those in which a variable's value
actually changed.
2007-09-11 00:06:42 +00:00
Tom Lane
f243a1a1bd Revert temporary patch that made synchronous_commit default to OFF. 2007-09-10 02:01:19 +00:00
Tom Lane
b7adf47eda Set the correct context (PGC_SIGHUP) for log_autovacuum, per ITAGAKI Takahiro.
Fix grammatical errors in its description.
2007-09-10 01:39:19 +00:00
Bruce Momjian
85e79a4a83 Add Hash thread URL:
>   http://archives.postgresql.org/pgsql-hackers/2007-09/msg00051.php
2007-09-07 19:07:58 +00:00
Tom Lane
cd1aae5864 Allow CREATE INDEX CONCURRENTLY to disregard transactions in other
databases, per gripe from hubert depesz lubaczewski.  Patch from
Simon Riggs.
2007-09-07 00:58:57 +00:00
Bruce Momjian
190df8a4cf Done:
< * Reduce XID consumption of read-only queries
<
<    http://archives.postgresql.org/pgsql-hackers/2007-08/msg00516.php
<
<
> * -Reduce XID consumption of read-only queries
2007-09-05 21:58:47 +00:00
Tom Lane
295e63983d Implement lazy XID allocation: transactions that do not modify any database
rows will normally never obtain an XID at all.  We already did things this way
for subtransactions, but this patch extends the concept to top-level
transactions.  In applications where there are lots of short read-only
transactions, this should improve performance noticeably; not so much from
removal of the actual XID-assignments, as from reduction of overhead that's
driven by the rate of XID consumption.  We add a concept of a "virtual
transaction ID" so that active transactions can be uniquely identified even
if they don't have a regular XID.  This is a much lighter-weight concept:
uniqueness of VXIDs is only guaranteed over the short term, and no on-disk
record is made about them.

Florian Pflug, with some editorialization by Tom.
2007-09-05 18:10:48 +00:00
Tom Lane
fcc6756341 Sync examples of psql \dF output with current CVS HEAD behavior.
Random other wordsmithing.
2007-09-04 03:46:36 +00:00
Tom Lane
e7889b83b7 Support SET FROM CURRENT in CREATE/ALTER FUNCTION, ALTER DATABASE, ALTER ROLE.
(Actually, it works as a plain statement too, but I didn't document that
because it seems a bit useless.)  Unify VariableResetStmt with
VariableSetStmt, and clean up some ancient cruft in the representation of
same.
2007-09-03 18:46:30 +00:00
Tom Lane
2abae34a2e Implement function-local GUC parameter settings, as per recent discussion.
There are still some loose ends: I didn't do anything about the SET FROM
CURRENT idea yet, and it's not real clear whether we are happy with the
interaction of SET LOCAL with function-local settings.  The documentation
is a bit spartan, too.
2007-09-03 00:39:26 +00:00
Bruce Momjian
fcfe801ab8 Clean up whitespace. 2007-09-02 01:13:55 +00:00
Bruce Momjian
e6c36081c2 More SGML alignment cleanups. 2007-09-01 23:06:29 +00:00
Bruce Momjian
87ee7857ea Properly indent SGML source of libpq.sgml. 2007-09-01 22:08:41 +00:00
Bruce Momjian
a55eab8921 Only use SGML indexterm "zone" when we want to get the entire section.
Some alignment cleanups.
2007-08-31 21:33:48 +00:00
Bruce Momjian
45ebcbcc1f Make Gin/Gist text search tertiary index entries in the documentation. 2007-08-31 20:55:57 +00:00
Bruce Momjian
42e9e26066 Add comment on why SGML -wfully-tagged flag is needed (for older SGML
tool chains).
2007-08-31 16:41:52 +00:00
Bruce Momjian
a8b5d6dc26 Place GiST and GIN text search indexes as secondary items under the main
"index" entries for GIN/GiST.
2007-08-31 16:33:36 +00:00
Bruce Momjian
9907b2a74c Again improve text search index entries. 2007-08-31 05:04:03 +00:00
Bruce Momjian
99a01bfd1e In text search docs, properly use indexterm _zone_ only when we want an
entire section, per Peter.
2007-08-31 04:52:29 +00:00
Bruce Momjian
6e832b059e Fix docs so indexes can be built by commenting out GiST/GIN index
entries in textsearch.sgml.
2007-08-31 03:26:27 +00:00
Bruce Momjian
ac20d3dfbe Add openjade warning -wfully-tagged to warn about missing close tags on
older SGML toolchains.
2007-08-31 02:03:02 +00:00
Bruce Momjian
24cba4ee5c Make more logical index sections for text search. 2007-08-30 20:37:26 +00:00
Tatsuo Ishii
c9bfabe24d Fix broken markup. 2007-08-30 01:29:52 +00:00
Bruce Momjian
25188c4f7d Update tsearch documentation wording. 2007-08-29 23:25:47 +00:00
Bruce Momjian
09c29cc57b Text search documentation word improvements; move configuration section
to be more logical.
2007-08-29 21:51:45 +00:00
Bruce Momjian
bb8f629c7a Move full text search operators, functions, and data type sections into
the main documentation, out of its own text search chapter.
2007-08-29 20:37:14 +00:00
Bruce Momjian
f145de27c3 Properly indent SGML in textsearch.sgml. 2007-08-29 02:37:04 +00:00
Bruce Momjian
baf3a134d9 Mention configurations early in text search documentation to table/index
section makes a little more sense.
2007-08-28 03:10:45 +00:00
Bruce Momjian
56cbd29328 Please ignore. Fresh checkout to see if this fixes it. 2007-08-28 03:09:01 +00:00
Bruce Momjian
29412cc0a7 Commit test, please ignore. 2007-08-28 03:06:07 +00:00
Bruce Momjian
97a6d34ab1 CVS commit test, ignore. 2007-08-28 03:05:31 +00:00
Bruce Momjian
b5187f1893 CVS commit test for TODO. Please ignore. 2007-08-28 03:03:36 +00:00
Bruce Momjian
0ba76faf79 Small commit test for TODO. 2007-08-28 03:01:39 +00:00
Bruce Momjian
69b1242775 Update TODO.html. 2007-08-28 03:01:08 +00:00
Bruce Momjian
76534c61b3 Update TODO with lost change, mostly completed items and whitespace
corrections.  Not sure why these were not in CVS.  Researching.
2007-08-28 03:00:36 +00:00
Bruce Momjian
28662b850c Batch of TODO updates, mostly completed item marking and whitespace
fixes.  Not sure how these weren't comitted before.
2007-08-28 02:57:10 +00:00
Tom Lane
75d5f6fe79 Adjust with-system-tzdata patch to not attempt to install a symlink,
but just hardwire the specified timezone database path into the executable.
Per discussion, this avoids some packaging disadvantages of using a
symlink.
2007-08-25 20:29:25 +00:00
Tom Lane
52a0830c40 Some more tsearch docs work --- sync names with CVS-tip reality, some
minor rewording, some markup fixups.  Lots left to do here ...
2007-08-25 06:26:57 +00:00
Bruce Momjian
2ae8825a8e Fix typo in FAQ_DEV. 2007-08-23 00:10:07 +00:00
Bruce Momjian
ef74900704 Add book to FAQ_DEV:
Transactional Information Systems by Gerhard Weikum, Kaufmann
2007-08-23 00:09:34 +00:00
Tom Lane
9f28588b42 Fix cut-n-paste-o. 2007-08-22 06:26:32 +00:00
Tom Lane
8a5592daf1 Remove option to change parser of an existing text search configuration.
This prevents needing to do complex and poorly-defined updates of the
mapping table if the new parser has different token types than the old.
Per discussion.
2007-08-22 05:13:50 +00:00
Tom Lane
40c1d7c10e Text search doc updates --- first cut at
syncing the existing docs with the final syntax decisions.
2007-08-22 04:45:20 +00:00
Tom Lane
d321421d0a Simplify the syntax of CREATE/ALTER TEXT SEARCH DICTIONARY by treating the
init options of the template as top-level options in the syntax.  This also
makes ALTER a bit easier to use, since options can be replaced individually.
I also made these statements verify that the tmplinit method will accept
the new settings before they get stored; in the original coding you didn't
find out about mistakes until the dictionary got invoked.

Under the hood, init methods now get options as a List of DefElem instead
of a raw text string --- that lets tsearch use existing options-pushing code
instead of duplicating functionality.
2007-08-22 01:39:46 +00:00
Tom Lane
3e3bb36ee9 First rough cut at text search documentation: bare bones reference
pages for the new SQL commands.  I also committed Bruce's text search
introductory chapter, as-is except for fixing some markup errors,
so that there would be a place for the reference pages to link to.
2007-08-21 21:08:47 +00:00
Bruce Momjian
bbde090330 Remove tabs from SGML files. 2007-08-21 15:13:16 +00:00
Tom Lane
140d4ebcb4 Tsearch2 functionality migrates to core. The bulk of this work is by
Oleg Bartunov and Teodor Sigaev, but I did a lot of editorializing,
so anything that's broken is probably my fault.

Documentation is nonexistent as yet, but let's land the patch so we can
get some portability testing done.
2007-08-21 01:11:32 +00:00
Peter Eisentraut
4e94d1f952 Add configure option --with-system-tzdata to use operating system time zone
database.
2007-08-20 08:53:12 +00:00
Andrew Dunstan
e1a1da9f4b minor typo fixes in CSVlog docs, per Michael Glaesemann 2007-08-19 03:23:30 +00:00
Bruce Momjian
de56b7cbdf Done:
< * Allow server log information to be output as INSERT statements
> * -Allow server log information to be output as CSV format
2007-08-19 02:36:08 +00:00
Andrew Dunstan
fd801f4faa Provide for logfiles in machine readable CSV format. In consequence, rename
redirect_stderr to logging_collector.
Original patch from Arul Shaji, subsequently modified by Greg Smith, and then
heavily modified by me.
2007-08-19 01:41:25 +00:00
Bruce Momjian
e53a548794 Add:
>
> * Reduce XID consumption of read-only queries
>
>    http://archives.postgresql.org/pgsql-hackers/2007-08/msg00516.php
>
2007-08-16 19:02:15 +00:00
Bruce Momjian
5ff95e6b8e Add third idea about pulling data from indexes.
>   A third idea would be for a heap scan to check if all rows are visible
>   and if so set a per-table flag which can be checked by index scans.
>   Any change to the table would have to clear the flag.  To detect
>   changes during the heap scan a counter could be set at the start and
>   checked at the end --- if it is the same, the table has not been
>   modified --- any table change would increment the counter.
2007-08-15 15:53:30 +00:00
Bruce Momjian
811f91cf5a Fix whitespace in TODO. 2007-08-15 15:36:31 +00:00
Bruce Momjian
6ccc262d6d Done for ecpg:
< 	o Use backend PREPARE/EXECUTE facility for ecpg where possible
2007-08-14 17:02:42 +00:00
Tom Lane
b83bd31bd9 TEMPORARILY make synchronous_commit default to OFF, so that we can get more
thorough testing of async-commit mode from the buildfarm.  This patch MUST
get reverted before 8.3 release!
2007-08-13 19:27:12 +00:00
Tom Lane
a44af6df85 Document that the regexp split functions ignore zero-length matches in
certain corner cases.  Per discussion, the code does what we want, but
it really needs to be documented that these functions act differently
from regexp_matches.
2007-08-13 01:18:47 +00:00
Tom Lane
1b70619311 Code review for regexp_matches/regexp_split patch. Refactor to avoid assuming
that cached compiled patterns will still be there when the function is next
called.  Clean up looping logic, thereby fixing bug identified by Pavel
Stehule.  Share setup code between the two functions, add some comments, and
avoid risky mixing of int and size_t variables.  Clean up the documentation a
tad, and accept all the flag characters mentioned in table 9-19 rather than
just a subset.
2007-08-11 03:56:24 +00:00
Magnus Hagander
3605c8c877 Fix incorrect URI for cvs rsync 2007-08-06 07:58:06 +00:00
Tom Lane
bdd6b62245 Switch over to using the src/timezone functions for formatting timestamps
displayed in the postmaster log.  This avoids Windows-specific problems with
localized time zone names that are in the wrong encoding, and generally seems
like a good idea to forestall other potential platform-dependent issues.
To preserve the existing behavior that all backends will log in the same time
zone, create a new GUC variable log_timezone that can only be changed on a
system-wide basis, and reference log-related calculations to that zone instead
of the TimeZone variable.

This fixes the issue reported by Hiroshi Saito that timestamps printed by
xlog.c startup could be improperly localized on Windows.  We still need a
simpler patch for that problem in the back branches, however.
2007-08-04 01:26:54 +00:00
Magnus Hagander
3f0245cb24 Update supported standalone VC++ version to 7.1+ only, and fix
some bad data leftover in win32.mak.

Per request from Hiroshi Saito.
2007-08-03 10:47:11 +00:00
Andrew Dunstan
63872601e8 Move session_start out of MyProcPort stucture and make it a global called MyStartTime,
so that we will be able to create a cookie for all processes for CSVlogs.
It is set wherever MyProcPid is set. Take the opportunity to remove the now
unnecessary session-only restriction on the %s and %c escapes in log_line_prefix.
2007-08-02 23:39:45 +00:00
Bruce Momjian
c441e26ee8 Done:
< * Allow buffered WAL writes and fsync
2007-08-01 23:13:31 +00:00
Tom Lane
4a78cdeb6b Support an optional asynchronous commit mode, in which we don't flush WAL
before reporting a transaction committed.  Data consistency is still
guaranteed (unlike setting fsync = off), but a crash may lose the effects
of the last few transactions.  Patch by Simon, some editorialization by Tom.
2007-08-01 22:45:09 +00:00
Bruce Momjian
3bc619342f Remove links to old Win32 source code ports. 2007-08-01 00:24:55 +00:00
Peter Eisentraut
dc6dc0f63a Update conformance information about bigint type
found by Michael Glaesemann
2007-07-27 10:37:52 +00:00
Neil Conway
b2b9b4d59c Implement RETURN QUERY for PL/PgSQL. This provides some convenient syntax
sugar for PL/PgSQL set-returning functions that want to return the result
of evaluating a query; it should also be more efficient than repeated
RETURN NEXT statements. Based on an earlier patch from Pavel Stehule.
2007-07-25 04:19:09 +00:00
Tom Lane
ad4295728e Create a new dedicated Postgres process, "wal writer", which exists to write
and fsync WAL at convenient intervals.  For the moment it just tries to
offload this work from backends, but soon it will be responsible for
guaranteeing a maximum delay before asynchronously-committed transactions
will be flushed to disk.

This is a portion of Simon Riggs' async-commit patch, committed to CVS
separately because a background WAL writer seems like it might be a good idea
independently of the async-commit feature.  I rebased walwriter.c on
bgwriter.c because it seemed like a more appropriate way of handling signals;
while the startup/shutdown logic in postmaster.c is more like autovac because
we want walwriter to quit before we start the shutdown checkpoint.
2007-07-24 04:54:09 +00:00
Alvaro Herrera
53d2951be7 Set a default autovacuum vacuum_cost_delay value of 20ms, to avoid excessive
I/O utilization, per discussion.

While at it, lower the autovacuum vacuum and analyze threshold values to 50
tuples.  It is a bit higher (i.e. more conservative) than what I originally
proposed but much better than the old values for small tables.
2007-07-24 01:53:56 +00:00
Alvaro Herrera
aa81c558ee Reword paragraph about the autovacuum_max_workers setting. Patch from
Jim Nasby.
2007-07-23 17:22:00 +00:00
Magnus Hagander
f70866fb23 SSPI authentication on Windows. GSSAPI compatible client when doing Kerberos
against a Unix server, and Windows-specific server-side authentication
using SSPI "negotiate" method (Kerberos or NTLM).

Only builds properly with MSVC for now.
2007-07-23 10:16:54 +00:00
Tom Lane
ddb93cac24 Provide a bit more high-level documentation for the GEQO planner.
Per request from Luca Ferrari.
2007-07-21 04:02:41 +00:00
Magnus Hagander
dc32d2cefa GSSAPI documentation 2007-07-18 12:00:47 +00:00
Bruce Momjian
9e19063abc Document that 'deleted' is also tracked by autovacuum. 2007-07-18 03:39:01 +00:00
Bruce Momjian
df7128bd34 Document that age() adds days, then full months. 2007-07-18 03:12:42 +00:00
Bruce Momjian
27d074923d Add:
>
> 	o Allow GLOBAL temporary tables to exist as empty by default in
> 	  all sessions
>
> 	  http://archives.postgresql.org/pgsql-hackers/2007-07/msg00006.php
>
2007-07-18 00:16:21 +00:00
Bruce Momjian
a5ca334a21 Remove http://www.benchmarkresources.com, no longer resolves to a
meaningful site.
2007-07-17 05:03:55 +00:00
Neil Conway
474774918b Implement CREATE TABLE LIKE ... INCLUDING INDEXES. Patch from NikhilS,
based in part on an earlier patch from Trevor Hardcastle, and reviewed
by myself.
2007-07-17 05:02:03 +00:00
Bruce Momjian
77d27e43e5 Add CVS Wiki URL to docs. 2007-07-17 01:52:34 +00:00
Bruce Momjian
74fbe9ccd1 Add:
> * Allow multiple indexes to be created concurrently, ideally via a
>   single heap scan, and have a restore of a pg_dump somehow use it
>
>   http://archives.postgresql.org/pgsql-general/2007-05/msg01274.php

Small blank line additions.
2007-07-17 00:07:54 +00:00
Bruce Momjian
5fb01d829a Update docs that GNU tar versions >=1.16 exit with 1 on files changed, 2
on other errors.
2007-07-16 22:20:51 +00:00
Tom Lane
ae1b7e298c Allow plpgsql function parameter names to be qualified with the function's
name.  With this patch, it is always possible for the user to qualify a
plpgsql variable name if needed to avoid ambiguity.  While there is much more
work to be done in this area, this simple change removes one unnecessary
incompatibility with Oracle.  Per discussion.
2007-07-16 17:01:11 +00:00
Tom Lane
a69f9028b5 Note incompatibility with Oracle's version of FOR ... REVERSE, per
Andrew Dunstan.  Minor other improvements in documentation of integer
FOR loops.
2007-07-15 00:45:16 +00:00
Tom Lane
d849c5d182 Editorial overhaul of plpgsql documentation. Provide detailed documentation
of variable substitution and plan caching behavior in dedicated sections.
(A lot of this material existed already, but was scattered in various places
in the chapter.)  Reorganize material a little bit, mostly to try to avoid
diving into deep details in the first introductory sections.  Document some
fine points that had escaped treatment before, notably the ability to qualify
plpgsql variable names with block labels.  Some minor wordsmithing here and
there.
2007-07-14 23:02:25 +00:00
Tom Lane
bf75e2a3c7 Add note that building from CVS requires bison and flex, whereas
building from a distribution tarball does not.
2007-07-10 23:03:18 +00:00
Tom Lane
ff481ca0d4 Adjust processSQLNamePattern() so that $ within the pattern is always matched
literally, whether quoted or not.  Since we allow $ as a character within
identifiers, this behavior is useful, whereas the previous behavior of
treating it as the regexp ending anchor was nearly useless given that the
pattern is automatically anchored anyway.  This affects the arguments of
psql's \d commands as well as pg_dump's -n and -t switches.  Per discussion.
2007-07-10 00:21:31 +00:00
Tom Lane
9b619679a8 Minor copy-editing. 2007-07-09 01:08:09 +00:00
Tom Lane
5f7b1f8d9d Closer code review for PQconnectionUsedPassword() patch: in particular,
not OK to include postgres_fe.h into libpq-fe.h, hence declare it as
returning int not bool.
2007-07-08 18:28:56 +00:00
Tom Lane
3f33d7bcb6 Fix broken markup. 2007-07-08 17:47:38 +00:00
Joe Conway
51bc3dfe4b Arrange for the authentication request type to be preserved in
PGconn. Invent a new libpq connection-status function,
PQconnectionUsedPassword() that returns true if the server
demanded a password during authentication, false otherwise.
This may be useful to clients in general, but is immediately
useful to help plug a privilege escalation path in dblink.
Per list discussion and design proposed by Tom Lane.
2007-07-08 17:11:51 +00:00
Bruce Momjian
8c69d881ce Remove TODO.detail/win32intr, no longer needed. 2007-07-08 00:42:07 +00:00
Bruce Momjian
5b67de17ee Remove, per Magnus:
< 	o Check WSACancelBlockingCall() for interrupts [win32intr]
2007-07-08 00:41:11 +00:00
Tom Lane
ad9a99c24f Improve description of SPI_scroll_cursor_move's return values, per a
gripe by Pavel Stehule awhile ago.
2007-07-05 19:15:12 +00:00
Neil Conway
a55898131e Add ALTER VIEW ... RENAME TO, and a RENAME TO clause to ALTER SEQUENCE.
Sequences and views could previously be renamed using ALTER TABLE, but
this was a repeated source of confusion for users. Update the docs,
and psql tab completion. Patch from David Fetter; various minor fixes
by myself.
2007-07-03 01:30:37 +00:00
Tom Lane
9fc25c0511 Improve logging of checkpoints. Patch by Greg Smith, worked over
by Heikki and a little bit by me.
2007-06-30 19:12:02 +00:00
Tom Lane
4303c0fdbf Add a note that pg_start_backup will take awhile because of new
distributed checkpoint behavior.  Explain how to work around this
by issuing a manual CHECKPOINT command.  Per discussion with Heikki.
2007-06-29 15:46:21 +00:00
Bruce Momjian
700eabbe69 Done:
> * -Reduce checkpoint performance degredation by forcing data to disk
2007-06-28 21:55:00 +00:00
Neil Conway
7c07b136bc Add the function's volatility to the output of psql's \df+ command.
Update the psql reference page accordingly.
2007-06-28 06:40:16 +00:00
Tom Lane
867e2c91a0 Implement "distributed" checkpoints in which the checkpoint I/O is spread
over a fairly long period of time, rather than being spat out in a burst.
This happens only for background checkpoints carried out by the bgwriter;
other cases, such as a shutdown checkpoint, are still done at full speed.

Remove the "all buffers" scan in the bgwriter, and associated stats
infrastructure, since this seems no longer very useful when the checkpoint
itself is properly throttled.

Original patch by Itagaki Takahiro, reworked by Heikki Linnakangas,
and some minor API editorialization by me.
2007-06-28 00:02:40 +00:00
Tom Lane
b09c248bdd Fix PGXS conventions so that extensions can be built against Postgres
installations whose pg_config program does not appear first in the PATH.
Per gripe from Eddie Stanley and subsequent discussions with Fabien Coelho
and others.
2007-06-26 22:05:04 +00:00
Tom Lane
ec0bb02db8 Add a <tip> that log_line_prefix should usually end with a space to
provide visual separation from the rest of the log line; I've been
noticing lately that quite a few newbies fail to figure this out for
themselves.  Also a little editorial cleanup of the log_line_prefix
description.
2007-06-22 16:15:23 +00:00
Peter Eisentraut
9f6aacd9e6 Update password example. 2007-06-21 12:20:10 +00:00
Peter Eisentraut
8ddb046bc9 Update examples of create/drop scripts. 2007-06-21 10:43:09 +00:00
Tom Lane
4c2d3ccf8a Add a caveat pointing out that constraint exclusion doesn't work with
constraints the planner is unable to disprove, hence simple btree-compatible
conditions should be used.  We've seen people try to get cute with stuff
like date_part(something) = something at least twice now.  Even if we
wanted to try to teach predtest.c about the properties of date_part,
most of the useful variants aren't immutable so nothing could be proved.
2007-06-20 23:11:38 +00:00
Neil Conway
8f3d07764f Remove some empty columns from a few system catalog tables in the
SGML docs.
2007-06-20 19:24:05 +00:00
Tom Lane
6e07228728 Code review for log_lock_waits patch. Don't try to issue log messages from
within a signal handler (this might be safe given the relatively narrow code
range in which the interrupt is enabled, but it seems awfully risky); do issue
more informative log messages that tell what is being waited for and the exact
length of the wait; minor other code cleanup.  Greg Stark and Tom Lane
2007-06-19 20:13:22 +00:00
Tom Lane
23347231a5 Tweak the API for per-datatype typmodin functions so that they are passed
an array of strings rather than an array of integers, and allow any simple
constant or identifier to be used in typmods; for example
	create table foo (f1 widget(42,'23skidoo',point));
Of course the typmodin function has still got to pack this info into a
non-negative int32 for storage, but it's still a useful improvement in
flexibility, especially considering that you can do nearly anything if you
are willing to keep the info in a side table.  We can get away with this
change since we have not yet released a version providing user-definable
typmods.  Per discussion.
2007-06-15 20:56:52 +00:00
Bruce Momjian
7ced811d45 Update item:
< * Allow EXPLAIN output to be more easily processed by scripts
> * Allow EXPLAIN output to be more easily processed by scripts, perhaps XML
2007-06-13 21:38:00 +00:00
Magnus Hagander
1ad08a8e9a Update documentation of resultmap file format. 2007-06-12 17:49:12 +00:00
Tom Lane
a9545b3aef Improve UPDATE/DELETE WHERE CURRENT OF so that they can be used from plpgsql
with a plpgsql-defined cursor.  The underlying mechanism for this is that the
main SQL engine will now take "WHERE CURRENT OF $n" where $n is a refcursor
parameter.  Not sure if we should document that fact or consider it an
implementation detail.  Per discussion with Pavel Stehule.
2007-06-11 22:22:42 +00:00
Tom Lane
bdc71c2cb1 Minor wording improvement. 2007-06-11 15:08:32 +00:00
Bruce Momjian
5f2bda15eb Done:
< 	o Allow UPDATE/DELETE WHERE CURRENT OF cursor
<
< 	  This requires using the row ctid to map cursor rows back to the
< 	  original heap row. This become more complicated if WITH HOLD cursors
< 	  are to be supported because WITH HOLD cursors have a copy of the row
< 	  and no FOR UPDATE lock.
< 	  http://archives.postgresql.org/pgsql-hackers/2007-01/msg01014.php
<
> 	o -Allow UPDATE/DELETE WHERE CURRENT OF cursor
2007-06-11 01:51:50 +00:00
Tom Lane
6808f1b1de Support UPDATE/DELETE WHERE CURRENT OF cursor_name, per SQL standard.
Along the way, allow FOR UPDATE in non-WITH-HOLD cursors; there may once
have been a reason to disallow that, but it seems to work now, and it's
really rather necessary if you want to select a row via a cursor and then
update it in a concurrent-safe fashion.

Original patch by Arul Shaji, rather heavily editorialized by Tom Lane.
2007-06-11 01:16:30 +00:00
Alvaro Herrera
2b438c12cc Avoid passing zero as a value for vacuum_cost_limit, because it's not a valid
value for the vacuum code.  Instead, make zero signify getting the value from a
higher level configuration facility, just like -1 in the original coding.  We
still document that -1 is the value that disables the feature, to avoid
confusing the user unnecessarily.

Reported by Galy Lee in <200705310914.l4V9E6JA094603@wwwmaster.postgresql.org>;
per subsequent discussion.
2007-06-08 21:09:49 +00:00
Tom Lane
4213e5f0db Add note that LIMIT without ORDER BY can produce outright nondeterministic
results.  Necessary due to introduction of syncscan patch.
2007-06-08 20:26:18 +00:00
Bruce Momjian
a3e3389913 Done:
< * Allow sequential scans to take advantage of other concurrent
> * -Allow sequential scans to take advantage of other concurrent
<
<   One possible implementation is to start sequential scans from the lowest
<   numbered buffer in the shared cache, and when reaching the end wrap
<   around to the beginning, rather than always starting sequential scans
<   at the start of the table.
<
<   http://archives.postgresql.org/pgsql-patches/2006-12/msg00076.php
<   http://archives.postgresql.org/pgsql-hackers/2006-12/msg00408.php
<   http://archives.postgresql.org/pgsql-hackers/2006-12/msg00784.php
<   http://archives.postgresql.org/pgsql-hackers/2007-03/msg00415.php
<
2007-06-08 18:45:22 +00:00
Tom Lane
24ee8af573 Rework temp_tablespaces patch so that temp tablespaces are assigned separately
for each temp file, rather than once per sort or hashjoin; this allows
spreading the data of a large sort or join across multiple tablespaces.
(I remain dubious that this will make any difference in practice, but certain
people insisted.)  Arrange to cache the results of parsing the GUC variable
instead of recomputing from scratch on every demand, and push usage of the
cache down to the bottommost fd.c level.
2007-06-07 19:19:57 +00:00
Tom Lane
04d919a11a Fix array_dims() example to be consistent with the data previously shown.
Christian Rossow
2007-06-07 14:49:56 +00:00
Tom Lane
2d4db3675f Fix up text concatenation so that it accepts all the reasonable cases that
were accepted by prior Postgres releases.  This takes care of the loose end
left by the preceding patch to downgrade implicit casts-to-text.  To avoid
breaking desirable behavior for array concatenation, introduce a new
polymorphic pseudo-type "anynonarray" --- the added concatenation operators
are actually text || anynonarray and anynonarray || text.
2007-06-06 23:00:50 +00:00
Tom Lane
31edbadf4a Downgrade implicit casts to text to be assignment-only, except for the ones
from the other string-category types; this eliminates a lot of surprising
interpretations that the parser could formerly make when there was no directly
applicable operator.

Create a general mechanism that supports casts to and from the standard string
types (text,varchar,bpchar) for *every* datatype, by invoking the datatype's
I/O functions.  These new casts are assignment-only in the to-string direction,
explicit-only in the other, and therefore should create no surprising behavior.
Remove a bunch of thereby-obsoleted datatype-specific casting functions.

The "general mechanism" is a new expression node type CoerceViaIO that can
actually convert between *any* two datatypes if their external text
representations are compatible.  This is more general than needed for the
immediate feature, but might be useful in plpgsql or other places in future.

This commit does nothing about the issue that applying the concatenation
operator || to non-text types will now fail, often with strange error messages
due to misinterpreting the operator as array concatenation.  Since it often
(not always) worked before, we should either make it succeed or at least give
a more user-friendly error; but details are still under debate.

Peter Eisentraut and Tom Lane
2007-06-05 21:31:09 +00:00
Peter Eisentraut
9539e64bc0 Remove gratuitous response messages from utility programs.
(Possibly release notes material, lest users be confused.)

The --quiet option is now obsolete and without effect in createdb,
createuser, dropdb, dropuser; kept for compatibility but marked for
removal in 8.4.

Progress messages when acting on all databases now go to stdout instead
of stderr, since they are not in fact errors.

Ordered options in reindexdb reference page alphabetically, like in
other programs' pages.
2007-06-04 10:02:40 +00:00
Bruce Momjian
55477d742e Remove description for:
o -Add a GUC variable to control the tablespace for temporary objects
          and sort files
<
< 	  It could start with a random tablespace from a supplied list and
< 	  cycle through the list.
<
2007-06-03 18:49:28 +00:00
Tom Lane
acfce502ba Create a GUC parameter temp_tablespaces that allows selection of the
tablespace(s) in which to store temp tables and temporary files.  This is a
list to allow spreading the load across multiple tablespaces (a random list
element is chosen each time a temp object is to be created).  Temp files are
not stored in per-database pgsql_tmp/ directories anymore, but per-tablespace
directories.

Jaime Casanova and Albert Cervera, with review by Bernd Helmle and Tom Lane.
2007-06-03 17:08:34 +00:00
Bruce Momjian
4e023373d0 Re-add TODO and clarify it is for the kernel cache:
< * Allow free-behind capability for large sequential scans, perhaps using
<   posix_fadvise()
> * Allow free-behind capability for large sequential scans to avoid
>   kernel cache spoiling
2007-06-02 11:28:01 +00:00
Bruce Momjian
ededa6dfc8 TODO item not needed anymore now that the buffer cache is
scan-resistant:

<
< * Allow free-behind capability for large sequential scans, perhaps using
<   posix_fadvise()
<
<   Posix_fadvise() can control both sequential/random file caching and
<   free-behind behavior, but it is unclear how the setting affects other
<   backends that also have the file open, and the feature is not supported
<   on all operating systems.
2007-06-02 02:46:38 +00:00
Neil Conway
f086be3d39 Allow leading and trailing whitespace in the input to the boolean
type. Also, add explicit casts between boolean and text/varchar. Both
of these changes are for conformance with SQL:2003.

Update the regression tests, bump the catversion.
2007-06-01 23:40:19 +00:00
Bruce Momjian
41ef1c0f32 Add URL for:
o Research self-referential UPDATEs that see inconsistent row versions
          in read-committed mode
<
> 	  http://archives.postgresql.org/pgsql-hackers/2007-06/msg00016.php
2007-06-01 18:41:55 +00:00
Bruce Momjian
4fbdcc174e Update wording:
o Research self-referential UPDATEs that see inconsistent row versions
          in read-committed mode


http://archives.postgresql.org/pgsql-hackers/2007-05/msg00507.php
2007-06-01 18:40:42 +00:00
Bruce Momjian
397d00af8f Wording improvement. 2007-06-01 04:11:43 +00:00
Bruce Momjian
4dc6319331 Update FAQ_DEV URL to output for text format. 2007-06-01 04:05:36 +00:00
Bruce Momjian
95e9f4ede3 Add URL for code comments to developer's FAQ:
http://www.ibm.com/developerworks/linux/library/l-clear-code/?ca=dgr-FClnxw01linuxcodetips
2007-06-01 00:28:35 +00:00
Bruce Momjian
9b89c13ab5 Update:
< * Consider allowing 64-bit integers to be passed by value on 64-bit
<   platforms
> * Consider allowing 64-bit integers and floats to be passed by value on
>   64-bit platforms
>
>   Also change 32-bit floats (float4) to be passed by value at the same
>   time.
>
2007-05-30 20:26:06 +00:00
Bruce Momjian
0a6f2ee84d Fix wording:
< * Consider allowing 64-bit integers to be passed by reference on 64-bit
> * Consider allowing 64-bit integers to be passed by value on 64-bit
2007-05-30 20:02:41 +00:00
Bruce Momjian
8a73ec138e Add:
>
> * Consider allowing 64-bit integers to be passed by reference on 64-bit
>   platforms
2007-05-30 20:00:35 +00:00
Bruce Momjian
9e38d2a4a8 Update documentation mention of VACUUM FULL and CLUSTER where
appropriate.

Guillaume Cottenceau
2007-05-30 19:45:01 +00:00
Bruce Momjian
85df43f341 Add URL for:
* Improve speed with indexes

  For large table adjustments during VACUUM FULL, it is faster to cluster
  or reindex rather than update the index.  Also, index updates can bloat
  the index.
2007-05-30 19:07:20 +00:00
Bruce Momjian
7d3b7011b0 Add documentation reference to statistical functions from func.sgml.
Jim Nasby
2007-05-30 18:13:29 +00:00
Bruce Momjian
44af16f6b7 Update cvsutils documentation description. 2007-05-30 18:00:08 +00:00
Bruce Momjian
ea2ab0bd10 Update cvs instructions to suggest cvsutils.
David Fetter
2007-05-30 17:41:43 +00:00
Neil Conway
6af04882de Fix a bug in input processing for the "interval" type. Previously,
"microsecond" and "millisecond" units were not considered valid input
by themselves, which caused inputs like "1 millisecond" to be rejected
erroneously.

Update the docs, add regression tests, and backport to 8.2 and 8.1
2007-05-29 04:58:43 +00:00
Bruce Momjian
e031844eac Update wording:
< * Fix self-referential UPDATEs seeing inconsistent row versions in
> * Fix self-referential UPDATEs that see inconsistent row versions in
2007-05-28 23:56:29 +00:00
Bruce Momjian
4c75abde53 Add:
>
> * Fix self-referential UPDATEs seeing inconsistent row versions in
>   read-committed mode
>
>   http://archives.postgresql.org/pgsql-hackers/2007-05/msg00507.php
2007-05-28 23:56:00 +00:00