summaryrefslogtreecommitdiff
path: root/doc/src
AgeCommit message (Collapse)Author
2016-08-02doc: Remove slightly confusing xreflabelsPeter Eisentraut
It seems clearer to refer to these tables in the normal way.
2016-08-02Small wording tweaksPeter Eisentraut
Dmitry Igrishin
2016-08-02doc: OS collation changes can break indexesBruce Momjian
Discussion: 20160702155517.GD18610@momjian.us Reviewed-by: Christoph Berg Backpatch-through: 9.1
2016-08-02doc: Whitespace fixes in man pagesPeter Eisentraut
2016-08-01pg_rewind docs: clarify handling of remote serversBruce Momjian
2016-08-01Fix pg_basebackup so that it accepts 0 as a valid compression level.Fujii Masao
The help message for pg_basebackup specifies that the numbers 0 through 9 are accepted as valid values of -Z option. But, previously -Z 0 was rejected as an invalid compression level. Per discussion, it's better to make pg_basebackup treat 0 as valid compression level meaning no compression, like pg_dump. Back-patch to all supported versions. Reported-By: Jeff Janes Reviewed-By: Amit Kapila Discussion: CAMkU=1x+GwjSayc57v6w87ij6iRGFWt=hVfM0B64b1_bPVKRqg@mail.gmail.com
2016-07-31Doc: remove claim that hash index creation depends on effective_cache_size.Tom Lane
This text was added by commit ff213239c, and not long thereafter obsoleted by commit 4adc2f72a (which made the test depend on NBuffers instead); but nobody noticed the need for an update. Commit 9563d5b5e adds some further dependency on maintenance_work_mem, but the existing verbiage seems to cover that with about as much precision as we really want here. Let's just take it all out rather than leaving ourselves open to more errors of omission in future. (That solution makes this change back-patchable, too.) Noted by Peter Geoghegan. Discussion: <CAM3SWZRVANbj9GA9j40fAwheQCZQtSwqTN1GBTVwRrRbmSf7cg@mail.gmail.com>
2016-07-30doc: improve wording of Error Message Style GuideBruce Momjian
Reported-by: Daniel Gustafsson Discussion: 48DB4EDA-96F8-4B2F-99C4-110900FC7540@yesql.se Author: Daniel Gustafsson
2016-07-30pgbench docs: fix incorrect "last two" fields textBruce Momjian
Reported-by: Alexander Law Discussion: 5786638C.8080508@gmail.com Backpatch-through: 9.4
2016-07-30docs: properly capitalize and space kB, MB, GB, TBBruce Momjian
2016-07-28Documentation spell checking and markup improvementsPeter Eisentraut
2016-07-28Improve documentation about CREATE TABLE ... LIKE.Tom Lane
The docs failed to explain that LIKE INCLUDING INDEXES would not preserve the names of indexes and associated constraints. Also, it wasn't mentioned that EXCLUDE constraints would be copied by this option. The latter oversight seems enough of a documentation bug to justify back-patching. In passing, do some minor copy-editing in the same area, and add an entry for LIKE under "Compatibility", since it's not exactly a faithful implementation of the standard's feature. Discussion: <20160728151154.AABE64016B@smtp.hushmail.com>
2016-07-28Fix incorrect description of udt_privileges view in documentation.Fujii Masao
The description of udt_privileges view contained an incorrect copy-pasted word. Back-patch to 9.2 where udt_privileges view was added. Author: Alexander Law
2016-07-26Fix constant-folding of ROW(...) IS [NOT] NULL with composite fields.Tom Lane
The SQL standard appears to specify that IS [NOT] NULL's tests of field nullness are non-recursive, ie, we shouldn't consider that a composite field with value ROW(NULL,NULL) is null for this purpose. ExecEvalNullTest got this right, but eval_const_expressions did not, leading to weird inconsistencies depending on whether the expression was such that the planner could apply constant folding. Also, adjust the docs to mention that IS [NOT] DISTINCT FROM NULL can be used as a substitute test if a simple null check is wanted for a rowtype argument. That motivated reordering things so that IS [NOT] DISTINCT FROM is described before IS [NOT] NULL. In HEAD, I went a bit further and added a table showing all the comparison-related predicates. Per bug #14235. Back-patch to all supported branches, since it's certainly undesirable that constant-folding should change the semantics. Report and patch by Andrew Gierth; assorted wordsmithing and revised regression test cases by me. Report: <20160708024746.1410.57282@wrigleys.postgresql.org>
2016-07-22Remove GetUserMappingId() and GetUserMappingById().Tom Lane
These functions were added in commits fbe5a3fb7 and a104a017f, but commit 45639a052 removed their only callers. Put the related code in foreign.c back to the way it was in 9.5, to avoid pointless cross-version diffs. Etsuro Fujita Patch: <d674a3f1-6b63-519c-ef3f-f3188ed6a178@lab.ntt.co.jp>
2016-07-20Fix typosMagnus Hagander
Alexander Law
2016-07-19Add comment & docs about no vacuum truncation with sto.Kevin Grittner
Omission noted by Andres Freund.
2016-07-18Doc: improve discussion of plpgsql's GET DIAGNOSTICS, other minor fixes.Tom Lane
9.4 added a second description of GET DIAGNOSTICS that was totally independent of the existing one, resulting in each description lying to the extent that it claimed the set of status items it described was complete. Fix that, and do some minor markup improvement. Also some other small fixes per bug #14258 from Dilian Palauzov. Discussion: <20160718181437.1414.40802@wrigleys.postgresql.org>
2016-07-18Doc: fix table of BRIN operator strategy numbers.Tom Lane
brin-extensibility-inclusion-table was confused in places about the difference between strategy 4 (RTOverRight) and strategy 5 (RTRight). Alexander Law
2016-07-17Establish conventions about global object names used in regression tests.Tom Lane
To ensure that "make installcheck" can be used safely against an existing installation, we need to be careful about what global object names (database, role, and tablespace names) we use; otherwise we might accidentally clobber important objects. There's been a weak consensus that test databases should have names including "regression", and that test role names should start with "regress_", but we didn't have any particular rule about tablespace names; and neither of the other rules was followed with any consistency either. This commit moves us a long way towards having a hard-and-fast rule that regression test databases must have names including "regression", and that test role and tablespace names must start with "regress_". It's not completely there because I did not touch some test cases in rolenames.sql that test creation of special role names like "session_user". That will require some rethinking of exactly what we want to test, whereas the intent of this patch is just to hit all the cases in which the needed renamings are cosmetic. There is no enforcement mechanism in this patch either, but if we don't add one we can expect that the tests will soon be violating the convention again. Again, that's not such a cosmetic change and it will require discussion. (But I did use a quick-hack enforcement patch to find these cases.) Discussion: <16638.1468620817@sss.pgh.pa.us>
2016-07-17doc: Supply XSLT template for superscript element in man pagesPeter Eisentraut
The default is no decoration, which looks confusing, for example on the CREATE SEQUENCE man page.
2016-07-16Update 9.6 release notes through today.Tom Lane
2016-07-16Clarify usage of clientcert authentication option.Tom Lane
For some reason this option wasn't discussed at all in client-auth.sgml. Document it there, and be more explicit about its relationship to the "cert" authentication method. Per gripe from Srikanth Venkatesh. I failed to resist the temptation to do some minor wordsmithing in the same area, too. Discussion: <20160713110357.1410.30407@wrigleys.postgresql.org>
2016-07-15Improve documentation about search_path for SECURITY DEFINER functions.Tom Lane
Clarify that the reason for recommending that pg_temp be put last is to prevent temporary tables from capturing unqualified table names. Per discussion with Albe Laurenz. Discussion: <A737B7A37273E048B164557ADEF4A58B5386C6E1@ntex2010i.host.magwien.gv.at>
2016-07-14doc: Fix typosPeter Eisentraut
From: Alexander Law <exclusion@gmail.com>
2016-07-13Fix obsolete header-file reference in pg_buffercache docs.Tom Lane
Commit 2d0019049 moved enum ForkNumber from relfilenode.h into relpath.h, but missed updating this documentation reference. Alexander Law
2016-07-13Add missing hyphenStephen Frost
Pointed out by Alexander Law
2016-07-12Put some things in a better order in psql helpPeter Eisentraut
2016-07-12doc: Fix typoPeter Eisentraut
From: Alexander Law <exclusion@gmail.com>
2016-07-11Improve output of psql's \df+ command.Tom Lane
Add display of proparallel (parallel-safety) when the server is >= 9.6, and display of proacl (access privileges) for all server versions. Minor tweak of column ordering to keep related columns together. Michael Paquier Discussion: <CAB7nPqTR3Vu3xKOZOYqSm-+bSZV0kqgeGAXD6w5GLbkbfd5Q6w@mail.gmail.com>
2016-07-11doc: Update URL for PL/PHPPeter Eisentraut
2016-07-08Docs: minor improvements for documentation about plpgsql triggers.Tom Lane
Fabien Coelho, some further wordsmithing by me
2016-07-08Docs: improve examples about not repeating table name in UPDATE ... SET.Tom Lane
Alexander Law
2016-07-08Docs: typo fix.Tom Lane
Etsuro Fujita
2016-07-08Typo fix, buils -> buildsStephen Frost
Pointed out by Alexander Law.
2016-07-08Fix missing parenthesis in docsMagnus Hagander
Author: Alexander Law
2016-07-07Clarify resource utilization of parallel query.Robert Haas
temp_file_limit is a per-process limit, not a per-session limit across all cooperating parallel processes; change wording accordingly, per a suggestion from Tom Lane. Also, document under max_parallel_workers_per_gather the fact that each process involved in a parallel query may use as many resources as a separate session. Caveat emptor. Per a complaint from Peter Geoghegan.
2016-07-07Rename pg_stat_wal_receiver.conn_info to conninfo.Fujii Masao
Per discussion on pgsql-hackers, conninfo is better as the column name because it's more commonly used in PostgreSQL. Catalog version bumped due to the change of pg_proc. Author: Michael Paquier
2016-07-06doc: Fix option order in man pages and fix typosPeter Eisentraut
2016-07-02doc: mention dependency on collation librariesBruce Momjian
Document that index storage is dependent on the operating system's collation library ordering, and any change in that ordering can create invalid indexes. Discussion: 20160617154311.GB19359@momjian.us Backpatch-through: 9.1
2016-07-01Rethink the GetForeignUpperPaths API (again).Tom Lane
In the previous design, the GetForeignUpperPaths FDW callback hook was called before we got around to labeling upper relations with the proper consider_parallel flag; this meant that any upper paths created by an FDW would be marked not-parallel-safe. While that's probably just as well right now, we aren't going to want it to be true forever. Hence, abandon the idea that FDWs should be allowed to inject upper paths before the core code has gotten around to creating the relevant upper relation. (Well, actually they still can, but it's on their own heads how well it works.) Instead, adopt the same API already designed for create_upper_paths_hook: we call GetForeignUpperPaths after each upperrel has been created and populated with the paths the core planner knows how to make.
2016-06-29Add conninfo to pg_stat_wal_receiverAlvaro Herrera
Commit b1a9bad9e744 introduced a stats view to provide insight into the running WAL receiver, but neglected to include the connection string in it, as reported by Michaël Paquier. This commit fixes that omission. (Any security-sensitive information is not disclosed). While at it, close the mild security hole that we were exposing the password in the connection string in shared memory. This isn't user-accessible, but it still looks like a good idea to avoid having the cleartext password in memory. Author: Michaël Paquier, Álvaro Herrera Review by: Vik Fearing Discussion: https://www.postgresql.org/message-id/CAB7nPqStg4M561obo7ryZ5G+fUydG4v1Ajs1xZT1ujtu+woRag@mail.gmail.com
2016-06-29Adjust text search documentation for recent commits.Tom Lane
Fix some now-obsolete statements that were overlooked in commits 6734a1cac, 3dbbd0f02, 028350f61. Document the behavior of <0>. Also do a little bit of rearranging and copy-editing for clarity.
2016-06-29Document precedence of FTS operators in tsqueryTeodor Sigaev
Oleg Bartunov
2016-06-28doc: add link for list-of-scalars mentionBruce Momjian
Reported-by: Manlio Perillo Bug: 14016 Discussion: 20160311163928.6674.94707@wrigleys.postgresql.org Reviewed-by: David G. Johnston
2016-06-28doc: update effective_io_concurrency for SSDsBruce Momjian
SSDs are no longer exotic, so recommend a default in the hundreds for them.
2016-06-28doc: remove GIN vs. GiST performance mentionBruce Momjian
This is a followup to commit 6d8b2aa83af70e20323caf23961667dc4c149276.
2016-06-28doc: in binary mode mention, say "encoding conversion"Bruce Momjian
Used to say "character set conversion" Reported-by: Tatsuo Ishii Discussion: 20160618.210417.343199294611427151.t-ishii@sraoss.co.jp
2016-06-28doc: remove mention of UT1 in representing timeBruce Momjian
UT1 was incorrectly specified as our time representation. (UT1 is astronomical time.) We are not actually UTC either because we ignore leap seconds. Reported-by: Thomas Munro Discussion: CAEepm=3-TW9PLwGZhqjSSiEQ9UzJEKE-HELQDzRE0QUSCp8dgw@mail.gmail.com
2016-06-27Fix mistakes in pg_visibility documentation.Robert Haas
Michael Paquier