summaryrefslogtreecommitdiff
path: root/doc/src
AgeCommit message (Collapse)Author
2016-06-09Eliminate "parallel degree" terminology.Robert Haas
This terminology provoked widespread complaints. So, instead, rename the GUC max_parallel_degree to max_parallel_workers_per_gather (leaving room for a possible future GUC max_parallel_workers that acts as a system-wide limit), and rename the parallel_degree reloption to parallel_workers. Rename structure members to match. These changes create a dump/restore hazard for users of PostgreSQL 9.6beta1 who have set the reloption (or applied the GUC using ALTER USER or ALTER DATABASE).
2016-06-09Polish the documentation concerning phrase text search.Tom Lane
Fix grammar, improve examples, etc. I did not attempt to document the current behavior concerning distance-zero matches, because I think that's broken and needs to change, so I'm not going to use up brain cells figuring out how to explain how it works now. One way or the other, there's still more to write here.
2016-06-08Fix typo.Robert Haas
Amit Langote
2016-06-07Fix thinko in description of table_name parameterAlvaro Herrera
Commit 6820094d1 mixed up types of parent object (table) with type of sub-object being commented on. Noticed while fixing docs for COMMENT ON ACCESS METHOD. Backpatch to 9.5, like that commit.
2016-06-07Fix loose ends for SQL ACCESS METHOD objectsAlvaro Herrera
COMMENT ON ACCESS METHOD was missing; add it, along psql tab-completion support for it. psql was also missing a way to list existing access methods; the new \dA command does that. Also add tab-completion support for DROP ACCESS METHOD. Author: Michael Paquier Discussion: https://www.postgresql.org/message-id/CAB7nPqTzdZdu8J7EF8SXr_R2U5bSUUYNOT3oAWBZdEoggnwhGA@mail.gmail.com
2016-06-07doc: Update wording about direct system catalog manipulationPeter Eisentraut
It was previously suggested that "esoteric" operations such as creating a new access method would require direct manipulation of the system catalogs, but that example has gone away, and I can't think of a new one to replace it, so just put in some weasel wording.
2016-06-07doc: Fix typoPeter Eisentraut
2016-06-07Improve documentation for contrib/bloom.Tom Lane
Michael Paquier, David Johnston, Tom Lane Discussion: <CAB7nPqQB8dcFmY1uodmiJOSZdhBFOx-us-uW6rfYrzhpEiBR2g@mail.gmail.com>
2016-06-07doc: Refer to table by idPeter Eisentraut
2016-06-07Fix simple typo in monitoring docsSimon Riggs
2016-06-03Fix various common mispellings.Greg Stark
Mostly these are just comments but there are a few in documentation and a handful in code and tests. Hopefully this doesn't cause too much unnecessary pain for backpatching. I relented from some of the most common like "thru" for that reason. The rest don't seem numerous enough to cause problems. Thanks to Kevin Lyda's tool https://pypi.python.org/pypi/misspellings
2016-06-03Measure Bloom index signature-length reloption in bits, not words.Tom Lane
Per discussion, this is a more understandable and future-proof way of exposing the setting to users. On-disk, we can still store it in words, so as to not break on-disk compatibility with beta1. Along the way, clean up the code associated with Bloom reloptions. Provide explicit macros for default and maximum lengths rather than having magic numbers buried in multiple places in the code. Drop the adjustBloomOptions() code altogether: it was useless in view of the fact that reloptions.c already performed default-substitution and range checking for the options. Rename a couple of macros and types for more clarity. Discussion: <23767.1464926580@sss.pgh.pa.us>
2016-05-31doc: Update version() and current_date output in tutorialPeter Eisentraut
While the version number is automatically updated in the example output, the other details looked a bit dated. suggested by mike2.schneider@gmail.com
2016-05-31Fix whitespacePeter Eisentraut
2016-05-31Fix typo in CREATE DATABASE syntax synopsis.Tom Lane
Misplaced "]", evidently a thinko in commit 213335c14.
2016-05-27Fix release-note typo.Tom Lane
Léonard Benedetti
2016-05-26Fix typo in 9.5 release nodesAlvaro Herrera
Noted by 星合 拓馬 (HOSHIAI Takuma)
2016-05-25Update doc text to reflect new column in MVCC phenomena table.Kevin Grittner
Scott Wehrenberg
2016-05-24Docs: mention pg_reload_conf() in ALTER SYSTEM reference page.Tom Lane
Takayuki Tsunakawa Discussion: <0A3221C70F24FB45833433255569204D1F578FC3@G01JPEXMBYT05>
2016-05-24In examples of Oracle PL/SQL code, use varchar2 not varchar.Tom Lane
Oracle recommends using VARCHAR2 not VARCHAR, allegedly because they might someday change VARCHAR to be spec-compliant about distinguishing null from empty string. (I'm not holding my breath, though.) Our examples of PL/SQL code were using VARCHAR, which while not wrong is missing the pedagogical opportunity to talk about converting Oracle type names to Postgres. So switch the examples to use VARCHAR2, and add some text about what to do with common Oracle type names like VARCHAR2 and NUMBER. (There is probably more to be said here, but those are the ones I'm sure about offhand.) Per suggestion from rapg12@gmail.com. Discussion: <20160521140046.22591.24672@wrigleys.postgresql.org>
2016-05-24Fix typo in docsTeodor Sigaev
Add missing USING BLOOM in example of contrib/bloom Nikolay Shaplov
2016-05-21Improve docs about contrib/intarray's benchmark suite.Tom Lane
Correct obsolete install instructions, as noted by Daniel Gustafsson. Clarify the test code's prerequisites. Discussion: <88E617F2-7721-4C4E-84F4-886A2041C1D0@yesql.se>
2016-05-21Improve docs about using ORDER BY to control aggregate input order.Tom Lane
David Johnston pointed out that the original text here had been obsoleted by SQL:2008, which allowed ORDER BY in subqueries. We could weaken the text to describe ORDER-BY-in-subqueries as an optional SQL feature that's possibly unportable; but then the exact same statements would apply to the alternative it's being compared to (ORDER-BY-in-aggregate-calls). So really that would be pretty useless; let's just take out the sentence entirely. Instead, point out the hazard that any extra processing in the upper query might cause the subquery output order to be destroyed. Discussion: <CAKFQuwbAX=iO9QbpN7_jr+BnUWm9FYX8WbEPUvG0p+nZhp6TZg@mail.gmail.com>
2016-05-20Further improve documentation about --quote-all-identifiers switch.Tom Lane
Mention it in the Notes section too, per suggestion from David Johnston. Discussion: <20160520165824.22598.31426@wrigleys.postgresql.org>
2016-05-20Improve documentation about pg_dump's --quote-all-identifiers switch.Tom Lane
Per bug #14152 from Alejandro Martínez. Back-patch to all supported branches. Discussion: <20160520165824.22598.31426@wrigleys.postgresql.org>
2016-05-17Fix typoMagnus Hagander
Amit Langote
2016-05-13doc: Fix typoPeter Eisentraut
From: Alexander Law <exclusion@gmail.com>
2016-05-13doc: Update link to external sitePeter Eisentraut
2016-05-12doc: Document default of max_worker_processesPeter Eisentraut
found by David G. Johnston <david.g.johnston@gmail.com>
2016-05-12doc: Small wording change for clarityPeter Eisentraut
From: Martín Marqués <martin@2ndquadrant.com>
2016-05-11Update key words table for 9.6Peter Eisentraut
2016-05-08Improve 9.6 release notes.Tom Lane
Incorporate some suggestions from David Johnston, and update through today.
2016-05-08Docs: create some user-facing documentation about index-only scans.Tom Lane
We didn't have any real user documentation about how index-only scans work or how to design indexes to exploit them. Remedy that. Per gripe from David Johnston.
2016-05-07Release notes for 9.5.3, 9.4.8, 9.3.13, 9.2.17, 9.1.22.Tom Lane
2016-05-07Docs: improve warnings about nextval() not producing gapless sequences.Tom Lane
In the documentation for nextval(), point out explicitly that INSERT ... ON CONFLICT will call nextval() if needed for the insertion case, whether or not it ends up following the ON CONFLICT path. This seems to be a matter of some confusion, cf bug #14126, so let's be clear about it. Also mention the issue in the CREATE SEQUENCE reference page, since that is another place where people might expect such things to be covered. Minor wording improvements nearby, as well. Back-patch to 9.5 where ON CONFLICT was introduced.
2016-05-07Update back-branch release notes for the last few commits.Tom Lane
OpenSSL error queue fix no longer needs to be documented under 9.6.
2016-05-06First-draft release notes for 9.5.3.Tom Lane
As usual, the release notes for other branches will be made by cutting these down, but put them up for community review first.
2016-05-06Docs: fix alphabetization of table entries.Tom Lane
Fabien Coelho
2016-05-06Docs: minor copy-editing for GSSAPI/SSPI authentication docs.Tom Lane
Describe compat_realm = 0 as "disabled" not "enabled", per discussion with Christian Ullrich. I failed to resist the temptation to do some other minor copy-editing in the same area.
2016-05-06More small 9.6 release note improvements.Tom Lane
Corrections per Jeff Janes, Christian Ullrich, and Daniel Vérité.
2016-05-06Docs: fix \crosstabview example.Tom Lane
This example missed being updated when we redefined \crosstabview's argument processing. Daniel Vérité
2016-05-06Fix hash index vs "snapshot too old" problemmsKevin Grittner
Hash indexes are not WAL-logged, and so do not maintain the LSN of index pages. Since the "snapshot too old" feature counts on detecting error conditions using the LSN of a table and all indexes on it, this makes it impossible to safely do early vacuuming on any table with a hash index, so add this to the tests for whether the xid used to vacuum a table can be adjusted based on old_snapshot_threshold. While at it, add a paragraph to the docs for old_snapshot_threshold which specifically mentions this and other aspects of the feature which may otherwise surprise users. Problem reported and patch reviewed by Amit Kapila
2016-05-05Further 9.6 release note improvements.Tom Lane
Call out the major enhancements in this release as identified by pgsql-advocacy discussion, and rearrange some of the entries to make those items more prominent. Other minor improvements per advice from Vitaly Burovoy, Masahiko Sawada, Peter Geoghegan, and Andres Freund.
2016-05-05Rename tsvector delete() to ts_delete(), and filter() to ts_filter().Tom Lane
The similarity of the original names to SQL keywords seems like a bad idea. Rename them before we're stuck with 'em forever. In passing, minor code and docs cleanup. Discussion: <4875.1462210058@sss.pgh.pa.us>
2016-05-05Small 9.6 release note improvements.Tom Lane
Sync release notes through today, and incorporate some suggestions from Robert Haas.
2016-05-05Rename pgbench min/max to least/greatest, and fix handling of double args.Tom Lane
These functions behave like the backend's least/greatest functions, not like min/max, so the originally-chosen names invite confusion. Per discussion, rename to least/greatest. I also took it upon myself to make them return double if any input is double. The previous behavior of silently coercing all inputs to int surely does not meet the principle of least astonishment. Copy-edit some of the other new functions' documentation, too.
2016-05-05First-draft release notes for Postgres 9.6.Tom Lane
These are just of beta quality, but we're only at beta ... the section about parallel query, in particular, could doubtless use more work.
2016-05-05Fix ordering/categorization of some recently-added system views.Tom Lane
Somebody added pg_replication_origin, pg_replication_origin_status and pg_replication_slots to catalogs.sgml without a whole lot of concern for either alphabetical order or the difference between a table and a view. Clean up the mess. Back-patch to 9.5, not so much because this is critical as because if I don't it will result in a cross-branch divergence in release-9.5.sgml, which would be a maintenance hazard.
2016-05-04doc: Fix more typosPeter Eisentraut
From: Alexander Law <exclusion@gmail.com>
2016-05-03doc: Fix typosPeter Eisentraut
From: Alexander Law <exclusion@gmail.com>