Commit Graph

10390 Commits

Author SHA1 Message Date
Magnus Hagander
eb9ca35fbd Fix typo in sslmode documentation
Per bug #6089, noted by Sidney Cadot
2011-07-05 09:46:06 +02:00
Peter Eisentraut
413ed2556f Small documentation tweaks 2011-07-05 00:17:12 +03:00
Heikki Linnakangas
c33acb4f0a Clarify that you need ActiveState perl 5.8 *or later* to build on Windows. 2011-07-04 22:42:25 +03:00
Simon Riggs
1f70560997 Reset ALTER TABLE lock levels to AccessExclusiveLock in all cases.
Locks on inheritance parent remain at lower level, as they were before.
Remove entry from 9.1 release notes.
2011-07-04 09:30:50 +01:00
Tom Lane
3569e02c98 Fix omissions in documentation of the pg_roles view.
Somehow, column rolconfig got removed from the documentation of the
pg_roles view in the 9.0 cycle, although the column is actually still
there.  In 9.1, we'd also forgotten to document the rolreplication column.
Spotted by Sakamoto Masahiko.
2011-07-03 22:12:20 -04:00
Peter Eisentraut
6b23ba1093 Unify spelling of "canceled", "canceling", "cancellation"
We had previously (af26857a27)
established the U.S. spellings as standard.
2011-07-02 23:30:01 +03:00
Bruce Momjian
158d071b28 In pg_upgrade 9.0 and 9.1, document suggestion of using a non-default
port number to avoid unintended client connections.
2011-07-01 23:09:13 -04:00
Robert Haas
379352602c Mention that SSPI authentication can use GSSAPI on non-Windows systems.
As noted by Christian Ullrich.
2011-06-27 10:39:30 -04:00
Robert Haas
ea41b8c822 Documentation improvements for pg_locks with respect to SSI.
Explain that querying pg_locks does not simultaneously lock both the
normal lock manager and the predicate lock manager.

Per discussion with Kevin Grittner.
2011-06-24 16:09:57 -04:00
Bruce Momjian
50016867a3 In pg_upgrade docs, clarify that link mode uses "hard" links.
Backpatch to 9.1 and 9.0.
2011-06-23 19:58:11 -04:00
Robert Haas
66370f5158 Performance tuning advice for SSI.
Kevin Grittner, with additional wordsmithing by me.
2011-06-21 21:55:26 -04:00
Tom Lane
9d6e6feded Fix missed use of "cp -i" in an example, per Fujii Masao.
Also be more careful about markup: use & not just &.
2011-06-20 16:27:36 -04:00
Peter Eisentraut
7ec70f46c6 Produce HISTORY file consistently as ASCII
The release notes may contain non-ASCII characters (for contributor
names), which lynx converts to the encoding determined by the current
locale.  The get output that is deterministic and easily readable by
everyone, we make lynx produce LATIN1 and then convert that to ASCII
with transliteration for the non-ASCII characters.
2011-06-19 23:30:11 +03:00
Peter Eisentraut
365c72f205 Capitalization fixes 2011-06-19 00:39:19 +03:00
Tom Lane
c1c4f93056 Don't use "cp -i" in the example WAL archive_command.
This is a dangerous example to provide because on machines with GNU cp,
it will silently do the wrong thing and risk archive corruption.  Worse,
during the 9.0 cycle somebody "improved" the discussion by removing the
warning that used to be there about that, and instead leaving the
impression that the command would work as desired on most Unixen.
It doesn't.  Try to rectify the damage by providing an example that is safe
most everywhere, and then noting that you can try cp -i if you want but
you'd better test that.

In back-patching this to all supported branches, I also added an example
command for Windows, which wasn't provided before 9.0.
2011-06-17 19:13:08 -04:00
Robert Haas
a3903f1bf8 Fix typo.
Per Josh Kupershmidt and Tom Lane.
2011-06-17 00:54:36 -04:00
Tom Lane
d988d92bf0 Rework parsing of ConstraintAttributeSpec to improve NOT VALID handling.
The initial commit of the ALTER TABLE ADD FOREIGN KEY NOT VALID feature
failed to support labeling such constraints as deferrable.  The best fix
for this seems to be to fold NOT VALID into ConstraintAttributeSpec.
That's a bit more general than the documented syntax, but it allows
better-targeted syntax error messages.

In addition, do some mostly-but-not-entirely-cosmetic code review for
the whole NOT VALID patch.
2011-06-15 19:06:36 -04:00
Peter Eisentraut
b48f888b64 Document that psql's \d also works with composite types
This has always been true, it was just never documented.
2011-06-14 23:51:11 +03:00
Bruce Momjian
6e66d2e424 In pg_upgrade, document that link mode has to have data directories on
the same file system, and that authentication should lock out normal
users.

Per suggestsion from #postgresql irc channel.

Backpatch to 9.1.
2011-06-14 16:48:29 -04:00
Alvaro Herrera
808aa18b3c Fix grammatical mistake introduced by previous commit
Per note from Tom
2011-06-14 13:48:23 -04:00
Alvaro Herrera
d60ce59963 Mention DROP TABLE as well as ALTER TABLE NO INHERIT
... when talking about how good they are in replacement of bulk DELETE
in partitioned setups.

The original wording was a bit confusing.

Per an observation from David Wheeler.
2011-06-14 12:42:02 -04:00
Robert Haas
6fdd897503 Improve accuracy of ON_ERROR_STOP documentation.
Per a gripe from Tom Lane.
2011-06-14 11:07:17 -04:00
Bruce Momjian
8d49524a6a Document that bits to the right of the CIDR mask "should" be zero, not
"must".
2011-06-13 20:57:37 -04:00
Alvaro Herrera
9adda3e125 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:12:26 -04:00
Robert Haas
20c73f3a32 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:07 -04:00
Robert Haas
26e7eec5f0 Clarify that NATURAL without matching columns is like CROSS JOIN.
As suggested by Grzegorz Szpetkowski.
2011-06-13 13:00:09 -04:00
Robert Haas
f2328b0713 Add doc cross-reference to search_path discussion of current_schemas().
Brendan Jurd
2011-06-13 12:38:32 -04:00
Robert Haas
3390fceb69 Document GUC context for synchronous_standby_names/hot_standby_feedback.
Fujii Masao
2011-06-13 12:25:41 -04:00
Robert Haas
a886c94e5e In ALTER EXTENSION docs, document left_type/right_type.
Noted by Daniele Varrazzo.
2011-06-13 10:23:14 -04:00
Robert Haas
5267e5ea5e Markup fix.
Fujii Masao
2011-06-13 10:14:16 -04:00
Robert Haas
16d64a8773 More foreign table documentation improvements.
Shigeru Hanada, with some additional wordsmithing by me
2011-06-13 08:29:38 -04:00
Robert Haas
25271323d4 Corrections to ALTER FOREIGN TABLE documentation.
Shigeru Hanada, with a minor grammar correction.
2011-06-12 00:19:14 -04:00
Tom Lane
829ae4bf83 Tag 9.1beta2. 2011-06-09 19:40:42 -04:00
Bruce Momjian
43958a0280 Ecpg doc cleanups, as reported by Marc Cousin. 2011-06-09 18:48:16 -04:00
Tom Lane
e9c9a92068 Update 9.1 release notes to reflect commits through today.
Also do some desultory copy-editing on the notes.
2011-06-09 18:44:46 -04:00
Magnus Hagander
7e6ec04d96 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:24:59 +02:00
Peter Eisentraut
7d43ae6713 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:24:14 +03:00
Tom Lane
3ebc061c18 Make citext's equality and hashing functions collation-insensitive.
This is an ugly hack to get around the fact that significant parts of the
core backend assume they don't need to worry about passing collation to
equality and hashing functions.  That's true for the core string datatypes,
but citext should ideally have equality behavior that depends on the
specified collation's LC_CTYPE.  However, there's no chance of fixing the
core before 9.2, so we'll have to live with this compromise arrangement for
now.  Per bug #6053 from Regina Obe.

The code changes in this commit should be reverted in full once the core
code is up to speed, but be careful about reverting the docs changes:
I fixed a number of obsolete statements while at it.
2011-06-08 15:25:02 -04:00
Peter Eisentraut
1bcdd66315 Reorder pg_ctl promote after pg_ctl status
Since start/stop/restart/reload/status is a kind of standard command
set, it seems odd to insert the special-purpose "promote" in between
the closely related "restart" and "reload".  So put it after "status"
in code and documentation.

Put the documentation of the -U option in some sensible place.

Rewrite the synopsis sentence in help and documentation to make it
less of a growing mouthful.
2011-06-08 20:51:25 +03:00
Peter Eisentraut
36a1ba9d5e Fix documentation reference to "above" example
found by Thom Brown
2011-06-04 23:12:27 +03:00
Peter Eisentraut
4dd4bd4d8e More ECPG documentation fixes
Marc Cousin
2011-06-04 22:52:01 +03:00
Peter Eisentraut
b51d05b511 ECPG documentation fix
Marc Cousin, Satoshi Nagayasu
2011-06-04 22:52:01 +03:00
Peter Eisentraut
3ece3913d0 Truncate id to <=44 characters
This is the original DocBook SGML limit, but apparently most
installations have changed it or ignore it, which is why few people
have run into this problem.

pointed out by Brendan Jurd
2011-06-03 22:25:26 +03:00
Bruce Momjian
a20bc9c866 Use proper SGML doc entities rather than angle-brackets.
Marco Nenciarini
2011-06-02 19:33:16 -04:00
Peter Eisentraut
c82d415acc Sort COMMENT synopsis and add more examples
Josh Kupershmidt
2011-06-03 00:17:45 +03:00
Peter Eisentraut
596b0c213f Some copy editing of the release notes 2011-06-01 22:22:18 +03:00
Tom Lane
6923d699bc 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:45 -04:00
Peter Eisentraut
85ffed431a Use entities to encode non-ASCII characters in SGML documentation
This has already been the case for the most part; just some cases had
slipped through.
2011-05-31 23:11:46 +03:00
Tom Lane
be4585b1c2 Replace use of credential control messages with getsockopt(LOCAL_PEERCRED).
It turns out the reason we hadn't found out about the portability issues
with our credential-control-message code is that almost no modern platforms
use that code at all; the ones that used to need it now offer getpeereid(),
which we choose first.  The last holdout was NetBSD, and they added
getpeereid() as of 5.0.  So far as I can tell, the only live platform on
which that code was being exercised was Debian/kFreeBSD, ie, FreeBSD kernel
with Linux userland --- since glibc doesn't provide getpeereid(), we fell
back to the control message code.  However, the FreeBSD kernel provides a
LOCAL_PEERCRED socket parameter that's functionally equivalent to Linux's
SO_PEERCRED.  That is both much simpler to use than control messages, and
superior because it doesn't require receiving a message from the other end
at just the right time.

Therefore, add code to use LOCAL_PEERCRED when necessary, and rip out all
the credential-control-message code in the backend.  (libpq still has such
code so that it can still talk to pre-9.1 servers ... but eventually we can
get rid of it there too.)  Clean up related autoconf probes, too.

This means that libpq's requirepeer parameter now works on exactly the same
platforms where the backend supports peer authentication, so adjust the
documentation accordingly.
2011-05-31 16:10:46 -04:00
Magnus Hagander
2367da886d Don't recommend upgrading to latest available Windows SDK
We only support up to version 7.0, so don't recommend
upgrading past it. The rest of the documentation around this
was already updated, but one spot was missed.
2011-05-30 20:46:14 +02:00