Commit Graph

9934 Commits

Author SHA1 Message Date
Alvaro Herrera
2602e63750 Expand warnings on locks acquired by CREATE INDEX CONCURRENTLY
The previous wording wasn't explicit enough, which could misled readers
into thinking that the locks acquired are more restricted in nature than
they really are.  The resulting optimism can be damaging to morale when
confronted with reality, as has been observed in the field.

Greg Smith
2011-06-13 17:21:15 -04:00
Robert Haas
6350d75bf2 Remove parentheses from mention of current_schemas function.
This is more consistent with what we do elsewhere, and hopefully avoids
creating the perception that current_schemas takes no arguments.

As suggested by Brendan Jurd
2011-06-13 13:04:13 -04:00
Robert Haas
c06bdaf92c Add doc cross-reference to search_path discussion of current_schemas().
Brendan Jurd
2011-06-13 12:38:47 -04:00
Magnus Hagander
15fe829b23 Support silent mode for service registrations on win32
Using -s when registering a service will now suppress
the application eventlog entries stating that the service
is starting and started.

MauMau
2011-06-09 18:26:25 +02:00
Peter Eisentraut
ffa653b945 Fix documentation of information_schema.element_types
The documentation of the columns collection_type_identifier and
dtd_identifier was wrong.  This effectively reverts commits
8e1ccad519 and
57352df66d and updates the name
array_type_identifier (the name in SQL:1999) to
collection_type_identifier.

closes bug #5926
2011-06-09 07:27:51 +03:00
Peter Eisentraut
39dbc62ade Fix documentation reference to "above" example
found by Thom Brown
2011-06-04 23:13:28 +03:00
Peter Eisentraut
ec688fd346 More ECPG documentation fixes
Marc Cousin
2011-06-04 22:52:25 +03:00
Peter Eisentraut
843c280626 ECPG documentation fix
Marc Cousin, Satoshi Nagayasu
2011-06-04 22:52:25 +03:00
Tom Lane
b26d8fda65 Protect GIST logic that assumes penalty values can't be negative.
Apparently sane-looking penalty code might return small negative values,
for example because of roundoff error.  This will confuse places like
gistchoose().  Prevent problems by clamping negative penalty values to
zero.  (Just to be really sure, I also made it force NaNs to zero.)
Back-patch to all supported branches.

Alexander Korotkov
2011-05-31 17:53:55 -04:00
Bruce Momjian
f71b5c77fa Update documentation to state there is three-value logic, not
three-value boolean logic.

Backpatch to 9.0.X since we just got another bug report about this
today.
2011-05-09 21:04:22 -04:00
Heikki Linnakangas
c02bc6356f The arguments to pg_ctl kill are not optional - remove brackets in the docs.
Fujii Masao
2011-04-28 12:57:51 +03:00
Tom Lane
db3cf25293 Add comments about the need to avoid uninitialized bits in datatype values.
There was already one recommendation in the documentation about writing
C functions to ensure padding bytes are zeroes, but make it stronger.

Also fix an example that was still using direct assignment to a varlena
length word, which no longer works since the varvarlena changes.
2011-04-27 14:06:29 -04:00
Magnus Hagander
c1d4238063 Note that Bison on GnuWin32 has trouble with paths with spaces
Peter Eisentraut
2011-04-15 15:31:41 +02:00
Magnus Hagander
52a6150445 Specify which versions of the Platform SDK are supported
Anything including Visual Studio 2010 compilers is not yet
supported for building on Windows.
2011-04-15 15:31:33 +02:00
Marc G. Fournier
ffb39e1aed Tag 9.0.4. 2011-04-15 00:15:53 -03:00
Tom Lane
b37834ab69 Update release notes for releases 9.0.4, 8.4.8, 8.3.15, and 8.2.21. 2011-04-14 15:51:41 -04:00
Robert Haas
3a88af0425 Correct "characters" to "bytes" in createdb docs.
Susanne Ebrecht
2011-03-27 21:29:03 -04:00
Tom Lane
03c7733720 Improve user-defined-aggregates documentation.
On closer inspection, that two-element initcond value seems to have been
a little white lie to avoid explaining the full behavior of float8_accum.
But if people are going to expect the examples to be exactly correct,
I suppose we'd better explain.  Per comment from Thom Brown.
2011-03-23 16:57:29 -04:00
Tom Lane
6d0877fc5e Fix ancient typo in user-defined-aggregates documentation.
The description of the initcond value for the built-in avg(float8)
aggregate has been wrong since it was written.  Noted by Disc Magnet.
2011-03-23 12:33:40 -04:00
Tom Lane
a48fb0b598 Correct mistaken claims about EXPLAIN ANALYZE's handling of triggers.
Time spent executing AFTER triggers is not included in the runtime of the
associated ModifyTable node; in my patch of yesterday I confused queuing of
these triggers with their actual execution.  Spotted by Marko Tiikkaja.
2011-03-02 11:17:07 -05:00
Tom Lane
82a0e35222 Update discussion of EXPLAIN to reflect existence of ModifyTable nodes.
Back-patch to 9.0, since this was changed then.
2011-03-01 11:36:09 -05:00
Bruce Momjian
888fda8092 Clarify documentation for libpq's PQescapeBytea to mention the new hex
format.

Modify PQescapeStringConn() docs to be consisent with other escaping
functions.

Add mention problems with pre-9.0 versions of libpq using not understanding
bytea hex format to the 9.0 release notes.

Backpatch to 9.0 docs.
2011-02-13 09:48:19 -05:00
Magnus Hagander
5dfc66b3d0 Fix typo.
Thom Brown
2011-02-03 11:25:34 +01:00
Simon Riggs
d6c1dc176a Create new errcode for recovery conflict caused by db drop on master.
Previously reported as ERRCODE_ADMIN_SHUTDOWN, this case is now
reported as ERRCODE_DATABASE_DROPPED. No message text change.
Unlikely to happen on most servers, so low impact change to allow
session poolers to correctly handle this situation.

Tatsuo Ishii and Simon Riggs
2011-02-01 08:49:58 +00:00
Marc G. Fournier
2fb64d8570 Tag 9.0.3 2011-01-27 22:21:31 -04:00
Tom Lane
aefb8d9198 Update release notes.
Security: CVE-2010-4015
2011-01-27 17:47:15 -05:00
Tom Lane
af9e2ed29b Update release notes for releases 9.0.3, 8.4.7, 8.3.14, and 8.2.20. 2011-01-27 16:09:51 -05:00
Robert Haas
2c3e292998 Correct ALTER TYPE -> SET DATA TYPE in ALTER TABLE documentation.
The latter is the correct name of the operation to change the data type
of a column.

Noah Misch
2011-01-25 18:52:03 -05:00
Robert Haas
ba3afc88d2 Document that WITH queries are also called Common Table Expressions.
Peter Geoghegan, reviewed by Stephen Frost
2011-01-19 21:21:33 -05:00
Magnus Hagander
a1ed4cf6ca Typo fix
Josh Kupershmidt
2011-01-11 10:46:08 +01:00
Robert Haas
e445f9f8b5 Remove bogus claims regarding createuser defaults.
Josh Kupershmidt
2011-01-08 06:13:53 -05:00
Bruce Momjian
8b3790916d Update documentation to say that \lo_import sets :LASTOID, not
lo_insert.
2011-01-05 21:32:13 -05:00
Robert Haas
a45e2e141d Correct spelling: longjump() -> longjmp(). 2010-12-24 22:23:13 -05:00
Peter Eisentraut
3bb1800b55 Fix grammar 2010-12-24 22:08:15 +02:00
Bruce Momjian
c474585295 Backpatch to 9.0 a doc mention that a BBU does not prevent partial page
writes.
2010-12-24 11:32:52 -05:00
Magnus Hagander
8b4d3d44dc Document unavailable parameters in some configurations
Add a note to user-facing parameters that can be removed completely
(and not just empty) by #ifdef's depending on build configuration.
2010-12-18 16:30:00 +01:00
Marc G. Fournier
178ca03f1c Tag 9.0.2. 2010-12-13 22:55:50 -04:00
Tom Lane
7fa690f8b9 Update release notes for releases 9.0.2, 8.4.6, 8.3.13, 8.2.19, and 8.1.23. 2010-12-13 20:23:08 -05:00
Tom Lane
87eadd7e3d Force default wal_sync_method to be fdatasync on Linux.
Recent versions of the Linux system header files cause xlogdefs.h to
believe that open_datasync should be the default sync method, whereas
formerly fdatasync was the default on Linux.  open_datasync is a bad
choice, first because it doesn't actually outperform fdatasync (in fact
the reverse), and second because we try to use O_DIRECT with it, causing
failures on certain filesystems (e.g., ext4 with data=journal option).
This part of the patch is largely per a proposal from Marti Raudsepp.
More extensive changes are likely to follow in HEAD, but this is as much
change as we want to back-patch.

Also clean up confusing code and incorrect documentation surrounding the
fsync_writethrough option.  Those changes shouldn't result in any actual
behavioral change, but I chose to back-patch them anyway to keep the
branches looking similar in this area.

In 9.0 and HEAD, also do some copy-editing on the WAL Reliability
documentation section.

Back-patch to all supported branches, since any of them might get used
on modern Linux versions.
2010-12-08 20:01:14 -05:00
Peter Eisentraut
bda2856514 docs -> documentation 2010-11-12 21:26:32 +02:00
Bruce Momjian
ad2a292dc3 Mention that pg_upgrade requires compatible 32/64-bit binaries. 2010-11-10 14:33:37 +00:00
Alvaro Herrera
e55e4c9ced plpython has plpy.Error instead of plpy.ERROR
Author: Marti Raudsepp <marti@juffo.org>
2010-11-09 11:05:37 -03:00
Heikki Linnakangas
b887f7b352 Note explicitly that hash indexes are also not replicated because they're not
WAL-logged. Make the notice about the lack of WAL-logging more visible by
making it a <caution>. Also remove the false statement from hot standby
caveats section that hash indexes are not used during hot standby.
2010-10-26 22:53:08 +03:00
Heikki Linnakangas
ae9ac79b39 Add semicolon, missed in previous patch. And update the keyword list in
the docs to reflect that OFF is now unreserved. Spotted by Tom Lane.
2010-10-22 18:39:43 +03:00
Tom Lane
486187ae84 Update storage.sgml to describe the 9.0 tablespace directory layout. 2010-10-19 21:53:08 -04:00
Bruce Momjian
6f609199df Add mention of using tools/fsync to test fsync methods. Restructure
recent wal_sync_method doc paragraph to be clearer.
2010-10-19 14:58:03 +00:00
Bruce Momjian
377e6e97eb Remove tab from SGML. 2010-10-18 18:51:28 +00:00
Bruce Momjian
02b1f04770 Document the tablespace directory "should" be empty, rather than "must"
be empty.  Because of binary migration usage, it might not be empty.
2010-10-18 18:16:45 +00:00
Simon Riggs
4bc8d9dc90 Correct WAL space calculation formula in docs.
Error pointed out by Fujii Masao, though not his patch.
2010-10-15 10:19:10 +01:00
Robert Haas
fb9bb9f4cf Add pg_user_mappings to the table of system views. 2010-10-14 19:12:24 -04:00
Simon Riggs
d609ff3ced Improvements to docs about pg_archive_cleanup and use of archives
Brendan Jurd
2010-10-14 23:23:26 +01:00
Peter Eisentraut
071f810c98 Complete the documentation of the USAGE privilege for foreign servers
The GRANT reference page failed to mention that the USAGE privilege
allows modifying associated user mappings, although this was already
documented on the CREATE/ALTER/DROP USER MAPPING pages.
2010-10-14 23:16:23 +03:00
Peter Eisentraut
ef76230c27 Make title capitalization consistent with surroundings 2010-10-13 20:06:10 +03:00
Robert Haas
ffeca98cec Adjust EXPLAIN documentation, so that it's not unreasonably wide.
The new formatting matches what we do for COPY.

Per a complaint from Bruce Momjian.
2010-10-08 23:00:39 -04:00
Robert Haas
57f475271d Warn that views can be safely used to hide columns, but not rows. 2010-10-08 09:16:08 -04:00
Robert Haas
c1db529642 Improve WAL reliability documentation, and add more cross-references to it.
In particular, we are now more explicit about the fact that you may need
wal_sync_method=fsync_writethrough for crash-safety on some platforms,
including MaxOS X.  There's also now an explicit caution against assuming
that the default setting of wal_sync_method is either crash-safe or best
for performance.
2010-10-07 12:22:04 -04:00
Simon Riggs
7887db612c Correct docs for behaviour of ALTER DATABASE .. RENAME during Hot Standby.
Actual behaviour did not match documented behaviour and we have agreed
that it should be the docs that change.

Spotted by Bernd Helmle
2010-10-06 00:20:54 +01:00
Tom Lane
6f1e6b9ccd Undo some poorly-thought-out "proofreading improvements".
Per Tatsuhito Kasahara.
2010-10-05 18:48:20 -04:00
Tom Lane
a0ccae7ed4 Fix back-branch breakage from ill-advised last-minute commit. 2010-10-01 10:25:44 -04:00
Marc G. Fournier
fd51c16ce9 Tag 9.0.1 2010-10-01 10:28:42 -03:00
Tom Lane
0d1f3d7bb2 Use a separate interpreter for each calling SQL userid in plperl and pltcl.
There are numerous methods by which a Perl or Tcl function can subvert
the behavior of another such function executed later; for example, by
redefining standard functions or operators called by the target function.
If the target function is SECURITY DEFINER, or is called by such a
function, this means that any ordinary SQL user with Perl or Tcl language
usage rights can do essentially anything with the privileges of the target
function's owner.

To close this security hole, create a separate Perl or Tcl interpreter for
each SQL userid under which plperl or pltcl functions are executed within
a session.  However, all plperlu or pltclu functions run within a session
still share a single interpreter, since they all execute at the trust
level of a database superuser anyway.

Note: this change results in a functionality loss when libperl has been
built without the "multiplicity" option: it's no longer possible to call
plperl functions under different userids in one session, since such a
libperl can't support multiple interpreters in one process.  However, such
a libperl already failed to support concurrent use of plperl and plperlu,
so it's likely that few people use such versions with Postgres.

Security: CVE-2010-3433
2010-09-30 17:19:44 -04:00
Robert Haas
f5f945f9f1 Adjust pg_archivecleanup docs to match message changes made 2010-06-17.
Erik Rijkers
2010-09-30 17:11:11 -04:00
Tom Lane
9caf5a841b Update release notes for releases 9.0.1, 8.4.5, 8.3.12, 8.2.18, 8.1.22,
8.0.26, and 7.4.30.
2010-09-30 14:27:28 -04:00
Bruce Momjian
798cbc015b Mention that pg_upgrade requires write permission in the current
directory.

Per report from Harald Armin Massa.
2010-09-28 18:43:01 +00:00
Bruce Momjian
946de44b3d Mention in pg_upgrade docs that the proper Win32 service name should be used.
Per report from Harald Armin Massa
2010-09-28 18:32:07 +00:00
Bruce Momjian
cd1454cdc3 Add mention of installing pg_upgrade_support in pg_upgrade doc section
title, per suggestion from Ian Barwick.
2010-09-28 17:25:21 +00:00
Peter Eisentraut
f27860dba3 Fix man page markup for <cmdsynopsis> with multiple variants
Command synopses using <cmdsynopsis> with multiple variants previously used
<sbr> to break lines between variants.  The new man page toolchain introduced
in 9.0 makes a mess out of that, and that markup was probably wrong all along,
because <sbr> is supposed to break lines within a synopsis, not between them.
So fix that by using multiple <cmdsynopsis> elements inside <refsynopsisdiv>.

backpatched to 9.0
2010-09-25 16:47:58 +03:00
Tom Lane
535c611f76 Do some copy-editing on the Git usage docs. 2010-09-22 20:22:35 -04:00
Tom Lane
5074f68848 Fix remaining stray references to CVS.
These are just cosmetic and don't seem worth back-patching far.
I put them into 9.0 just because it was trivial to do so.
2010-09-22 19:51:46 -04:00
Tom Lane
f3a838bb76 Add assorted other documentation build targets to documentation gitignore. 2010-09-22 18:08:53 -04:00
Magnus Hagander
bbf84ac000 Remove anonymous cvs instructions, and replace them with instructions
for git. Change other references from cvs to git as well.
2010-09-22 20:10:29 +02:00
Magnus Hagander
a692359411 Convert cvsignore to gitignore, and add .gitignore for build targets. 2010-09-22 12:57:06 +02:00
Tom Lane
dcd9dcdeeb Fix a missed explanation of auto-analyze threshold, per Joe Miller. 2010-09-21 16:40:50 -04:00
Robert Haas
c6f6db5fdf Move pg_db_role_setting docs to correct place in alphabetical order. 2010-09-17 18:50:22 +00:00
Marc G. Fournier
861861edcc tag v9.0.0 ... the big day approaches 2010-09-17 01:18:41 +00:00
Tom Lane
57d115c449 Stamp 9.0 release notes with expected release date; also some last-minute
copy-editing.
2010-09-16 18:15:28 +00:00
Tom Lane
a59eaf28cc Fix bad grammar. 2010-09-16 14:31:26 +00:00
Tom Lane
e3171be674 Add a compatibility note about plpgsql's treatment of SELECT INTO rec.fld
when fld is of composite type.  Per discussion of bug #5644 from Valentine
Gogichashvili.
2010-09-15 17:46:02 +00:00
Robert Haas
3b08e09fe7 Elaborate on what gets stored in pg_authid.rolpasswd.
Also, add cross-reference from pg_shadow.passwd to pg_authid.rolpasswd and
fix a bit of markup I muffed in my previous commit.

Per discussion with Josh Kupershmidt.
2010-09-13 17:03:23 +00:00
Bruce Momjian
6bb4a7b305 Don't try aligning comments for new archive_command Win32 doc example;
it doesn't work.

Backpatch to 9.0.X.
2010-09-13 01:35:54 +00:00
Robert Haas
1cdf188aa6 Link from pg_shadow docs to pg_authid docs.
Per discussion with Josh Kupershmidt.
2010-09-13 01:25:12 +00:00
Bruce Momjian
f499c211d8 Re-add documentation for Win32 copy syntax for archive_command.
Backpatch to 9.0.X.
2010-09-12 13:47:19 +00:00
Tom Lane
e266be9110 Remove obsolete claim that gzip is needed while installing PG's documentation.
It isn't, now that we ship the docs as loose files rather than a sub-tarball.

Also adjust the wording in a couple of places to make the lists of required
software read more consistently.
2010-09-09 17:19:46 +00:00
Bruce Momjian
a8745a9afd Doc fixes:
- remove excessive table cells
- moving function parameters into function tags rather than having
  them being considered separate
- add return type column on XML2 contrib module functions list and
  removing return types from function
- add table header to XML2 contrib parameter table

Thom Brown

Backpatch to 9.0.X.
2010-09-09 00:48:29 +00:00
Peter Eisentraut
83756a241a Add tip about building plpython 2 and 3. Fix link to Python docs. 2010-09-08 20:35:53 +00:00
Peter Eisentraut
f48fb5d823 Clarify that surrogate pairs are not encoded in UTF-8 directly 2010-09-07 18:54:08 +00:00
Tom Lane
a2145a5b43 Clean up description of ecpg's dtcvfmtasc function.
Per KOIZUMI Satoru.
2010-09-02 14:57:09 +00:00
Tom Lane
ec3747f77e Clean up some bad grammar and punctuation in description of ecpg's decimal
type.  Per KOIZUMI Satoru.
2010-09-02 14:46:51 +00:00
Tom Lane
43e48de4a5 Clarify documentation of handling of null arguments for aggregates.
Per discussion.
2010-09-01 18:22:35 +00:00
Tom Lane
41c8287de0 Improve release notes' description of Teodor's fixes for polygon overlaps
and contains operators.
2010-09-01 15:14:48 +00:00
Alvaro Herrera
9602630f40 Add missing markup for translatability 2010-08-31 05:57:56 +00:00
Tom Lane
0808cb109b Remove obsolete remark that PQprepare() is more flexible than PREPARE.
Spotted by Dmitriy Igrishin.  Back-patch to 8.2, which is when the PREPARE
statement was improved to allow parameter types to be omitted.
2010-08-29 15:19:12 +00:00
Marc G. Fournier
ee48d27e34 tag rc1 ... final stretch ... 2010-08-27 03:04:41 +00:00
Tom Lane
d7a1feba67 Document the existence of the socket lock file under unix_socket_directory,
which is perhaps not a terribly good spot for it but there doesn't seem to be
a better place.  Also add a source-code comment pointing out a couple reasons
for having a separate lock file.  Per suggestion from Greg Smith.
2010-08-26 22:00:32 +00:00
Tom Lane
cf95e921ff Explain automatic creation (or lack of it) of indexes for the various types
of constraints.

Kevin Grittner
2010-08-26 21:08:43 +00:00
Bruce Momjian
2d685d4ec0 Remove docs for "Incrementally Updated Backups" because it was of
questionable reliability;  information moved to a wiki:

	http://wiki.postgresql.org/wiki/Incrementally_Updated_Backups

Backpatch to 9.0.
2010-08-25 23:56:03 +00:00
Tom Lane
6a167730e3 Document filtering dictionaries in textsearch.sgml.
While at it, copy-edit the description of prefix-match marker support in
synonym dictionaries, and clarify the description of the default unaccent
dictionary a bit more.
2010-08-25 21:43:01 +00:00
Bruce Momjian
167557b476 Update release notes, per comments from Simon Riggs. 2010-08-25 19:41:51 +00:00
Peter Eisentraut
a60d200092 Add missing description of reloftype field 2010-08-25 18:18:38 +00:00
Tom Lane
0d495e3412 Docs review for unaccent: fix grammar, markup, etc. 2010-08-25 02:12:11 +00:00