summaryrefslogtreecommitdiff
path: root/doc/src/sgml/ref
AgeCommit message (Collapse)Author
2011-10-12Improve documentation of psql's \q command.Tom Lane
The documentation neglected to explain its behavior in a script file (it only ends execution of the script, not psql as a whole), and failed to mention the long form \quit either.
2011-07-27Fix typo.Robert Haas
Noted by Josh Kupershmidt.
2011-07-26Clarify which relkinds accept column comments.Robert Haas
Per discussion with Josh Kupershmidt.
2011-06-13Expand warnings on locks acquired by CREATE INDEX CONCURRENTLYAlvaro Herrera
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-09Support silent mode for service registrations on win32Magnus Hagander
Using -s when registering a service will now suppress the application eventlog entries stating that the service is starting and started. MauMau
2011-04-28The arguments to pg_ctl kill are not optional - remove brackets in the docs.Heikki Linnakangas
Fujii Masao
2011-02-03Fix typo.Magnus Hagander
Thom Brown
2011-01-25Correct ALTER TYPE -> SET DATA TYPE in ALTER TABLE documentation.Robert Haas
The latter is the correct name of the operation to change the data type of a column. Noah Misch
2011-01-11Typo fixMagnus Hagander
Josh Kupershmidt
2011-01-08Remove bogus claims regarding createuser defaults.Robert Haas
Josh Kupershmidt
2011-01-05Update documentation to say that \lo_import sets :LASTOID, notBruce Momjian
lo_insert.
2010-10-18Document the tablespace directory "should" be empty, rather than "must"Bruce Momjian
be empty. Because of binary migration usage, it might not be empty.
2010-10-14Complete the documentation of the USAGE privilege for foreign serversPeter Eisentraut
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-08Adjust EXPLAIN documentation, so that it's not unreasonably wide.Robert Haas
The new formatting matches what we do for COPY. Per a complaint from Bruce Momjian.
2010-10-08Warn that views can be safely used to hide columns, but not rows.Robert Haas
2010-09-25Fix man page markup for <cmdsynopsis> with multiple variantsPeter Eisentraut
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-16Stamp 9.0 release notes with expected release date; also some last-minuteTom Lane
copy-editing.
2010-08-31Add missing markup for translatabilityAlvaro Herrera
2010-08-17Spell and markup checkingPeter Eisentraut
2010-08-09Add EXPLAIN documentation example.Bruce Momjian
gabrielle <gorthx@gmail.com> Backpatch to 9.0.X.
2010-07-29Fix indentation of verbatim block elementsPeter Eisentraut
Block elements with verbatim formatting (literallayout, programlisting, screen, synopsis) should be aligned at column 0 independent of the surrounding SGML, because whitespace is significant, and indenting them creates erratic whitespace in the output. The CSS stylesheets already take care of indenting the output. Assorted markup improvements to go along with it.
2010-07-10Clarify that "psql -c" ignores psqlrc files.Robert Haas
Tim Landscheidt
2010-07-08Add a cross-reference to precedence information to CREATE OPERATOR'sTom Lane
documentation. Per suggestion from Marc Cousin.
2010-07-05Split the LDFLAGS make variable into two parts: LDFLAGS is now used forTom Lane
linking both executables and shared libraries, and we add on LDFLAGS_EX when linking executables or LDFLAGS_SL when linking shared libraries. This provides a significantly cleaner way of dealing with link-time switches than the former behavior. Also, make sure that the various platform-specific %.so: %.o rules incorporate LDFLAGS and LDFLAGS_SL; most of them missed that before. (I did not add these variables for the platforms that invoke $(LD) directly, however. It's not clear if we can do that safely, since for the most part we assume these variables use CC command-line syntax.) Per gripe from Aaron Swenson and subsequent investigation.
2010-06-24Mention that when alter rewrites a table, indexes are also rebuilt.Bruce Momjian
2010-06-22Update pg_ctl docs to explain server output behavior differences onBruce Momjian
win32 and non-win32 platforms.
2010-06-22Deprecate the use of => as an operator name.Robert Haas
In HEAD, emit a warning when an operator named => is defined. In both HEAD and the backbranches (except in 8.2, where contrib modules do not have documentation), document that hstore's text => text operator may be removed in a future release, and encourage the use of the hstore(text, text) function instead. This function only exists in HEAD (previously, it was called tconvert), so backpatch it back to 8.2, when hstore was added. Per discussion.
2010-06-17Add missing close brackets in old-style COPY syntax diagram.Tom Lane
Spotted by Evan Carroll.
2010-06-16Add notes that CREATE/DROP CONVERSION is similar to CREATE/DROPPeter Eisentraut
TRANSLATION in the SQL standard.
2010-06-15Clarify SELECT FOR UPDATE behavior in docs.Bruce Momjian
2010-06-15Document new 9.0 behavior of ANALYZE on inheritance hierarchies.Robert Haas
In particular, note that autovacuum does not yet understand that it might need to vacuum inheritance parents as a result of changes to the child tables.
2010-06-09Update ALTER TABLE docs to account for exclusion and deferrable uniquenessAlvaro Herrera
constraints Dean Rasheed
2010-06-07Ensure default-only storage parameters for TOAST relationsItagaki Takahiro
to be initialized with proper values. Affected parameters are fillfactor, analyze_threshold, and analyze_scale_factor. Especially uninitialized fillfactor caused inefficient page usage because we built a StdRdOptions struct in which fillfactor is zero if any reloption is set for the toast table. In addition, we disallow toast.autovacuum_analyze_threshold and toast.autovacuum_analyze_scale_factor because we didn't actually support them; they are always ignored. Report by Rumko on pgsql-bugs on 12 May 2010. Analysis by Tom Lane and Alvaro Herrera. Patch by me. Backpatch to 8.4.
2010-05-31Add note about database ownership to REASSIGN OWNED command documentation,Alvaro Herrera
per Josh Berkus. Add ALTER DATABASE to the "see also" section, too.
2010-05-30Clarify the meaning of "trusted language" in the documentation.Bruce Momjian
2010-05-29Document that NOT NULL domain constraints are not always honored.Bruce Momjian
2010-05-27Make it more clear that you need to release savepoint withHeikki Linnakangas
RELEASE SAVEPOINT to make an older savepoint with the same name accessible. It's also possible to implicitly release the savepoint by rolling back to an earlier savepoint, but mentioning that too would make the note just more verbose and confusing.
2010-05-18Move pg_notify() details to a subsection within the NOTIFY reference page.Robert Haas
This allows the index to reference the pg_notify() subsection specifically, rather than Notes section of the NOTIFY reference page more generally. Fujii Masao
2010-05-17Make table in example less wide.Alvaro Herrera
2010-05-15Improve documentation of pg_restore's -l and -L switches to point out theirTom Lane
interactions with filtering switches, such as -n and -t. Per a complaint from Russell Smith.
2010-05-13Use "TOAST table" in place of the vague, not-used-elsewhere phraseTom Lane
"supplementary storage table".
2010-05-11Mention related ALTER TABLE variants in documentation for CLUSTER.Robert Haas
As suggested by Andy Lester.
2010-04-30Improve COPY documentation to clarify that it doesn't copy data to or fromTom Lane
child tables. Per gripe from Jaime Casanova.
2010-04-23Fix various instances of "the the".Robert Haas
Two of these were pointed out by Erik Rijkers; the rest I found.
2010-04-21Enforce superuser permissions checks during ALTER ROLE/DATABASE SET, ratherTom Lane
than during define_custom_variable(). This entails rejecting an ALTER command if the target variable doesn't have a known (non-placeholder) definition, unless the calling user is superuser. When the variable *is* known, we can correctly apply the rule that only superusers can issue ALTER for SUSET parameters. This allows define_custom_variable to apply ALTER's values for SUSET parameters at module load time, secure in the knowledge that only a superuser could have set the ALTER value. This change fixes a longstanding gotcha in the usage of SUSET-level custom parameters; which is a good thing to fix now that plpgsql defines such a parameter.
2010-04-16Document that autovacuum cannot vacuum or analyze temporary tables.Bruce Momjian
2010-04-08Make smart shutdown work in combination with Hot Standby/Streaming Replication.Robert Haas
At present, killing the startup process does not release any locks it holds, so we must wait to stop the startup and walreceiver processes until all read-only backends have exited. Without this patch, the startup and walreceiver processes never exit, so the server gets permanently stuck in a half-shutdown state. Fujii Masao, with review, docs, and comment adjustments by me.
2010-04-05Arrange to remove pg_default_acl entries completely if their ACL settingTom Lane
is changed to match the hard-wired default. This avoids accumulating useless catalog entries, and also provides a path for dropping the owning role without using DROP OWNED BY. Per yesterday's complaint from Jaime Casanova, the need to use DROP OWNED BY for that is less than obvious, so providing this alternative method might save some user frustration.
2010-04-03Minor wording improvement.Tom Lane
2010-04-03Remove unnecessary xref endterm attributes and title idsPeter Eisentraut
The endterm attribute is mainly useful when the toolchain does not support automatic link target text generation for a particular situation. In the past, this was required by the man page tools for all reference page links, but that is no longer the case, and it now actually gets in the way of proper automatic link text generation. The only remaining use cases are currently xrefs to refsects.