summaryrefslogtreecommitdiff
path: root/doc/src
AgeCommit message (Collapse)Author
2014-05-10Rename min_recovery_apply_delay to recovery_min_apply_delay.Tom Lane
Per discussion, this seems like a more consistent choice of name. Fabrízio de Royes Mello, after a suggestion by Peter Eisentraut; some additional documentation wordsmithing by me
2014-05-10More work on the JSON/JSONB user documentation.Tom Lane
Document existence operator adequately; fix obsolete claim that no Unicode-escape semantic checks happen on input (it's still true for json, but not for jsonb); improve examples; assorted wordsmithing.
2014-05-09Fix bogus documentation of json_object_agg().Tom Lane
It takes two arguments, not one.
2014-05-09Improve user-facing JSON documentation.Tom Lane
I started out with the intention of just fixing the info about the jsonb operator classes, but soon found myself copy-editing most of the JSON material. Hopefully it's more readable now.
2014-05-08Document permissions needed for pg_database_size and pg_tablespace_size.Tom Lane
Back in 8.3, we installed permissions checks in these functions (see commits 8bc225e7990a and cc26599b7206). But we forgot to document that anywhere in the user-facing docs; it did get mentioned in the 8.3 release notes, but nobody's looking at that any more. Per gripe from Suya Huang.
2014-05-08Increase the default value of effective_cache_size to 4GB.Tom Lane
Per discussion, the old value of 128MB is ridiculously small on modern machines; in fact, it's not even any larger than the default value of shared_buffers, which it certainly should be. Increase to 4GB, which is unlikely to be any worse than the old default for anyone, and should be noticeably better for most. Eventually we might have an autotuning scheme for this setting, but the recent attempt crashed and burned, so for now just do this.
2014-05-08Revert "Auto-tune effective_cache size to be 4x shared buffers"Tom Lane
This reverts commit ee1e5662d8d8330726eaef7d3110cb7add24d058, as well as a remarkably large number of followup commits, which were mostly concerned with the fact that the implementation didn't work terribly well. It still doesn't: we probably need some rather basic work in the GUC infrastructure if we want to fully support GUCs whose default varies depending on the value of another GUC. Meanwhile, it also emerged that there wasn't really consensus in favor of the definition the patch tried to implement (ie, effective_cache_size should default to 4 times shared_buffers). So whack it all back to where it was. In a followup commit, I'll do what was recently agreed to, which is to simply change the default to a higher value.
2014-05-07When a background worker exists with code 0, unregister it.Robert Haas
The previous behavior was to restart immediately, which was generally viewed as less useful. Petr Jelinek, with some adjustments by me.
2014-05-06doc: Fix DocBook XML validityPeter Eisentraut
The main problem is that DocBook SGML allows indexterm elements just about everywhere, but DocBook XML is stricter. For example, this common pattern <varlistentry> <indexterm>...</indexterm> <term>...</term> ... </varlistentry> needs to be changed to something like <varlistentry> <term>...<indexterm>...</indexterm></term> ... </varlistentry> See also bb4eefe7bf518e42c73797ea37b033a5d8a8e70a. There is currently nothing in the build system that enforces that things stay valid, because that requires additional tools and will receive separate consideration.
2014-05-06More rewording of pg_stat_statements for 9.4 release notesBruce Momjian
Report by Amit Langote
2014-05-05Update 9.4 release notes for queryid controlBruce Momjian
2014-05-05Move pg_stat_statements into its on 9.4 release note sectionBruce Momjian
2014-05-05In 9.4 release notes, add detail to pg_stat_statements itemsBruce Momjian
2014-05-05Improve JSONB 9.4 release textBruce Momjian
2014-05-05Add doc links to 9.4 release notes, and add major features listBruce Momjian
2014-05-05Add SGML markup tags to 9.4 release notesBruce Momjian
2014-05-05Update "huge pages" description in the 9.4 release notesBruce Momjian
2014-05-05Update 9.4 release notes with feedback from the hackers listBruce Momjian
2014-05-05doc: In FDW handler docs, mark up scan_clauses with <literal>.Robert Haas
Etsuro Fujita
2014-05-04Add missing 9.4 release file.Bruce Momjian
2014-05-03Initial version of Postgres 9.4 release notesBruce Momjian
2014-05-01doc: Update pg_basebackup version compatibility claim for 9.4Peter Eisentraut
2014-04-30Documentation corrections for pg_replication_slots.Robert Haas
Thomas Reiss, with changes to the catalog_xmin language by me.
2014-04-30Rationalize common/relpath.[hc].Tom Lane
Commit a73018392636ce832b09b5c31f6ad1f18a4643ea created rather a mess by putting dependencies on backend-only include files into include/common. We really shouldn't do that. To clean it up: * Move TABLESPACE_VERSION_DIRECTORY back to its longtime home in catalog/catalog.h. We won't consider this symbol part of the FE/BE API. * Push enum ForkNumber from relfilenode.h into relpath.h. We'll consider relpath.h as the source of truth for fork numbers, since relpath.c was already partially serving that function, and anyway relfilenode.h was kind of a random place for that enum. * So, relfilenode.h now includes relpath.h rather than vice-versa. This direction of dependency is fine. (That allows most, but not quite all, of the existing explicit #includes of relpath.h to go away again.) * Push forkname_to_number from catalog.c to relpath.c, just to centralize fork number stuff a bit better. * Push GetDatabasePath from catalog.c to relpath.c; it was rather odd that the previous commit didn't keep this together with relpath(). * To avoid needing relfilenode.h in common/, redefine the underlying function (now called GetRelationPath) as taking separate OID arguments, and make the APIs using RelFileNode or RelFileNodeBackend into macro wrappers. (The macros have a potential multiple-eval risk, but none of the existing call sites have an issue with that; one of them had such a risk already anyway.) * Fix failure to follow the directions when "init" fork type was added; specifically, the errhint in forkname_to_number wasn't updated, and neither was the SGML documentation for pg_relation_size(). * Fix tablespace-path-too-long check in CreateTableSpace() to account for fork-name component of maximum-length pathnames. This requires putting FORKNAMECHARS into a header file, but it was rather useless (and actually unreferenced) where it was. The last couple of items are potentially back-patchable bug fixes, if anyone is sufficiently excited about them; but personally I'm not. Per a gripe from Christoph Berg about how include/common wasn't self-contained.
2014-04-28Minor fixes for ALTER TABLE documentation.Robert Haas
Etsuro Fujita
2014-04-23Allow polymorphic aggregates to have non-polymorphic state data types.Tom Lane
Before 9.4, such an aggregate couldn't be declared, because its final function would have to have polymorphic result type but no polymorphic argument, which CREATE FUNCTION would quite properly reject. The ordered-set-aggregate patch found a workaround: allow the final function to be declared as accepting additional dummy arguments that have types matching the aggregate's regular input arguments. However, we failed to notice that this problem applies just as much to regular aggregates, despite the fact that we had a built-in regular aggregate array_agg() that was known to be undeclarable in SQL because its final function had an illegal signature. So what we should have done, and what this patch does, is to decouple the extra-dummy-arguments behavior from ordered-set aggregates and make it generally available for all aggregate declarations. We have to put this into 9.4 rather than waiting till later because it slightly alters the rules for declaring ordered-set aggregates. The patch turned out a bit bigger than I'd hoped because it proved necessary to record the extra-arguments option in a new pg_aggregate column. I'd thought we could just look at the final function's pronargs at runtime, but that didn't work well for variadic final functions. It's probably just as well though, because it simplifies life for pg_dump to record the option explicitly. While at it, fix array_agg() to have a valid final-function signature, and add an opr_sanity test to notice future deviations from polymorphic consistency. I also marked the percentile_cont() aggregates as not needing extra arguments, since they don't.
2014-04-23doc: Fix DocBook table column count declarationPeter Eisentraut
This was broken in 26cd1d7d9513b2b490efc746551ec5a786b56212.
2014-04-23Fix typo, trance -> tranche, in docs.Heikki Linnakangas
Amit Langote
2014-04-22doc: adjust 9970443640b4569cf72b3c8e84abe80bdf533c7f for "null string"Bruce Momjian
Report by Andrew Dunstan
2014-04-22doc: improve wording of COPY commit 7ec73783d88a743799b0c262f1235f772497fb1dBruce Momjian
2014-04-22doc: mention CREATE MATERIALIZED VIEW AS can be EXPLAINedBruce Momjian
Patch by Amit Langote Report by Backpatch through
2014-04-22docs: add results for JSON operator examplesBruce Momjian
Patch by Sehrope Sarkuni
2014-04-22docs: clearify use of pg_database.datistemplateBruce Momjian
Patch by Rajeev rastogi
2014-04-22doc: improve CREATE RULE event listBruce Momjian
Patch by Fujii Masao Report by Emanuel Calvo
2014-04-22copy: update docs for FORCE_NULL and FORCE_NOT_NULL combinationBruce Momjian
Also update regression tests Patch by Michael Paquier
2014-04-22doc: Improve "replication slot" index entriesPeter Eisentraut
Now that we have accumulated two different "replication slot" concepts, make the index entries consistent.
2014-04-19doc: CREATE DATABASE doesn't copy template database-level config paramsBruce Momjian
Report by Alexey Bashtanov
2014-04-19doc: mention archive_command and recovery_command are exec'ed locallyBruce Momjian
Report by Craig Ringer
2014-04-19docs: tablespaces cannot be accessed independentlyBruce Momjian
Mention impossibility of moving tablespaces, backing them up independently, or the inadvisability of placing them on temporary file systems. Patch by Craig Ringer, adjustments by Ian Lawrence Warwick and me
2014-04-19libpq: have PQconnectdbParams() and PQpingParams accept "" as defaultBruce Momjian
Previously, these functions treated "" optin values as defaults in some ways, but not in others, like when comparing to .pgpass. Also, add documentation to clarify that now "" and NULL use defaults, like PQsetdbLogin() has always done. BACKWARD INCOMPATIBILITY Patch by Adrian Vondendriesch, docs by me Report by Jeff Janes
2014-04-17docs: adjustments for streaming standbys that disconnect frequentlyBruce Momjian
Document problems when disconnection causes loss of hot_standby_feedback and suggest adjusting max_standby_archive_delay and max_standby_streaming_delay. Initial patch by Marko Tiikkaja, adjustments by me
2014-04-16Rename EXPLAIN ANALYZE's "total runtime" output to "execution time".Tom Lane
Now that EXPLAIN also outputs a "planning time" measurement, the use of "total" here seems rather confusing: it sounds like it might include the planning time which of course it doesn't. Majority opinion was that "execution time" is a better label, so we'll call it that. This should be noted as a backwards incompatibility for tools that examine EXPLAIN ANALYZE output. In passing, I failed to resist the temptation to do a little editing on the materialized-view example affected by this change.
2014-04-16docs: properly document psql auto encoding modeBruce Momjian
In psql, both stdin and stdout must be terminals to get a client encoding of 'auto'. Patch by Albe Laurenz Backpatch to 9.3.
2014-04-16doc: move min_recovery_apply_delay into the right sectionBruce Momjian
Patch by Fujii Masao
2014-04-16docs: make max_wal_senders higher to handle disconnectsBruce Momjian
Document abrupt streaming client disconnection might leave slots in use, so max_wal_senders should be slightly higher than needed to allow for immediate reconnection. Per mention by Magnus
2014-04-16Add to_regprocedure() and to_regoperator().Robert Haas
These are natural complements to the functions added by commit 0886fc6a5c75b294544263ea979b9cf6195407d9, but they weren't included in the original patch for some reason. Add them. Patch by me, per a complaint by Tom Lane. Review by Tatsuo Ishii.
2014-04-16doc: fix json_extract_path_text() typo by adding jsonbBruce Momjian
Report from rudolf <stu3.1@eq.cz>
2014-04-15psql: conditionally display oids and replication identityBruce Momjian
In psql \d+, display oids only when they exist, and display replication identity only when it is non-default. Also document the defaults for replication identity for system and non-system tables. Update regression output.
2014-04-15vacuumdb: Add option --analyze-in-stagesPeter Eisentraut
Add vacuumdb option --analyze-in-stages which runs ANALYZE three times with different configuration settings, adopting the logic from the analyze_new_cluster.sh script that pg_upgrade generates. That way, users of pg_dump/pg_restore can also use that functionality. Change pg_upgrade to create the script so that it calls vacuumdb instead of implementing the logic itself.
2014-04-14Add TAP tests for client programsPeter Eisentraut
Reviewed-by: Pavel Stěhule <pavel.stehule@gmail.com> Reviewed-by: Erik Rijkers <er@xs4all.nl>