summaryrefslogtreecommitdiff
path: root/doc/src/sgml/ref
AgeCommit message (Collapse)Author
2011-05-30Add pg_basebackup -z option for compression with default levelPeter Eisentraut
2011-05-29Allow pg_basebackup compressed tar output to stdoutPeter Eisentraut
2011-05-25Put options in some sensible orderPeter Eisentraut
For the --help output and reference pages of pg_dump, pg_dumpall, pg_restore, put the options in some consistent, mostly alphabetical, and consistent order, rather than newest option last or something like that.
2011-05-22Put documentation of backslash commands back in alphabetical orderPeter Eisentraut
2011-05-19Rename pg_dump --no-security-label to --no-security-labelsPeter Eisentraut
Other similar options also use the plural form.
2011-05-19Spell checking and markup refinementPeter Eisentraut
2011-05-13More cleanup of FOREIGN TABLE permissions handling.Robert Haas
This commit fixes psql, pg_dump, and the information schema to be consistent with the backend changes which I made as part of commit be90032e0d1cf473bdd99aee94218218f59f29f1, and also includes a related documentation tweak. Shigeru Hanada, with slight adjustment.
2011-05-10Add some punctuationPeter Eisentraut
2011-05-10Put options in more alphabetical orderPeter Eisentraut
2011-05-06Fix typos in SECURITY LABEL documentation.Robert Haas
KaiGai Kohei
2011-05-02Small cleanup of spacing in verbatim DocBook elementsPeter Eisentraut
2011-04-28The arguments to pg_ctl kill are not optional - remove brackets in the docs.Heikki Linnakangas
Fujii Masao
2011-04-25Remove partial and undocumented GRANT .. FOREIGN TABLE support.Robert Haas
Instead, foreign tables are treated just like views: permissions can be granted using GRANT privilege ON [TABLE] foreign_table_name TO role, and revoked similarly. GRANT/REVOKE .. FOREIGN TABLE is no longer supported, just as we don't support GRANT/REVOKE .. VIEW. The set of accepted permissions for foreign tables is now identical to the set for regular tables, and views. Per report from Thom Brown, and subsequent discussion.
2011-04-22Make a code-cleanup pass over the collations patch.Tom Lane
This patch is almost entirely cosmetic --- mostly cleaning up a lot of neglected comments, and fixing code layout problems in places where the patch made lines too long and then pgindent did weird things with that. I did find a bug-of-omission in equalTupleDescs().
2011-04-21Improve doc wording for SQL syntax of LIMIT/OFFSET.Bruce Momjian
2011-04-20Allow ALTER TYPE .. ADD ATTRIBUTE .. CASCADE to recurse to descendants.Robert Haas
Without this, adding an attribute to a typed table with an inheritance child fails, which is surprising. Noah Misch, with minor changes by me.
2011-04-20Allow ALTER TABLE name {OF type | NOT OF}.Robert Haas
This syntax allows a standalone table to be made into a typed table, or a typed table to be made standalone. This is possibly a mildly useful feature in its own right, but the real motivation for this change is that we need it to make pg_upgrade work with typed tables. This doesn't actually fix that problem, but it's necessary infrastructure. Noah Misch
2011-04-17Document COLLATE option in CREATE TYPE reference page.Tom Lane
Curiously, it was already documented in ALTER TYPE ADD ATTRIBUTE, but not here.
2011-04-13Add some useful cross-references to the CREATE EXTENSION reference page.Tom Lane
Per a suggestion from Josh Kupershmidt, though I modified his patch quite a lot.
2011-04-09Don't show unusable collations in psql's \dO command.Tom Lane
"Unusable" collations are those not matching the current database's encoding. The former behavior inconsistently showed such collations some of the time, depending on the details of the pattern argument.
2011-04-08Add an example of WITH (UPDATE RETURNING) INSERT to the INSERT ref page.Tom Lane
Per a discussion with Gavin Flower. This barely scratches the surface of potential WITH (something RETURNING) use cases, of course, but it's one of the simplest compelling examples I can think of.
2011-04-04Uppercase <!ENTITY> and <!DOCTYPE> tags in SGML sourceAlvaro Herrera
This improves compatibility with external toolchains, such as those used by some documentation translation tools. Gabriele Bartolini
2011-04-04Duplicate expansion of "direction" from FETCH's synopsis into MOVEAlvaro Herrera
2011-04-02Escape greater than and less than characters in docs.Heikki Linnakangas
Susanne Ebrecht and me
2011-04-01Support comments on FOREIGN DATA WRAPPER and SERVER objects.Robert Haas
This mostly involves making it work with the objectaddress.c framework, which does most of the heavy lifting. In that vein, change GetForeignDataWrapperOidByName to get_foreign_data_wrapper_oid and GetForeignServerOidByName to get_foreign_server_oid, to match the pattern we use for other object types. Robert Haas and Shigeru Hanada
2011-03-25Fix broken markup, and remove tabsAlvaro Herrera
2011-03-25Documented some ecpg command line options that were missing:Michael Meskes
-r no_indicator -r prepare -r questionsmarks
2011-03-16Corrections to CREATE FOREIGN TABLE documentation.Robert Haas
Omit incorrect = sign, and properly document server_name parameter. Shigeru Hanada
2011-03-15Adjust doc wording about the casting exceptions for composite types.Bruce Momjian
2011-03-12Use "backend process" rather than "backend server", where appropriate.Bruce Momjian
2011-03-11Fix "unparenthesized" mention in vacuum docs.Bruce Momjian
2011-03-11Document that pg_dump --clean might generate some harmless errors on restore.Bruce Momjian
2011-03-11Document that the parenthesized VACUUM syntax is deprecated, not theBruce Momjian
FREEZE functionality.
2011-03-10Reference doc "examples" section for pg_dump options that often needBruce Momjian
complex quoting, e.g. -t and -n.
2011-03-10Use '=' when documenting long options.Bruce Momjian
2011-03-09Remove collation information from TypeName, where it does not belong.Tom Lane
The initial collations patch treated a COLLATE spec as part of a TypeName, following what can only be described as brain fade on the part of the SQL committee. It's a lot more reasonable to treat COLLATE as a syntactically separate object, so that it can be added in only the productions where it actually belongs, rather than needing to reject it in a boatload of places where it doesn't belong (something the original patch mostly failed to do). In addition this change lets us meet the spec's requirement to allow COLLATE anywhere in the clauses of a ColumnDef, and it avoids unfriendly behavior for constructs such as "foo::type COLLATE collation". To do this, pull collation information out of TypeName and put it in ColumnDef instead, thus reverting most of the collation-related changes in parse_type.c's API. I made one additional structural change, which was to use a ColumnDef as an intermediate node in AT_AlterColumnType AlterTableCmd nodes. This provides enough room to get rid of the "transform" wart in AlterTableCmd too, since the ColumnDef can carry the USING expression easily enough. Also fix some other minor bugs that have crept in in the same areas, like failure to copy recently-added fields of ColumnDef in copyfuncs.c. While at it, document the formerly secret ability to specify a collation in ALTER TABLE ALTER COLUMN TYPE, ALTER TYPE ADD ATTRIBUTE, and ALTER TYPE ALTER ATTRIBUTE TYPE; and correct some misstatements about what the default collation selection will be when COLLATE is omitted. BTW, the three-parameter form of format_type() should go away too, since it just contributes to the confusion in this area; but I'll do that in a separate patch.
2011-03-09Document that server single-user mode does not do checkpoints or otherBruce Momjian
background processing.
2011-03-09Adjust the permissions required for COMMENT ON ROLE.Tom Lane
Formerly, any member of a role could change the role's comment, as of course could superusers; but holders of CREATEROLE privilege could not, unless they were also members. This led to the odd situation that a CREATEROLE holder could create a role but then could not comment on it. It also seems a bit dubious to let an unprivileged user change his own comment, let alone those of group roles he belongs to. So, change the rule to be "you must be superuser to comment on a superuser role, or hold CREATEROLE to comment on non-superuser roles". This is the same as the privilege check for creating/dropping roles, and thus fits much better with the rule for other object types, namely that only the owner of an object can comment on it. In passing, clean up the documentation for COMMENT a little bit. Per complaint from Owen Jacobson and subsequent discussion.
2011-03-09Remove '=' from initdb switch syntax.Bruce Momjian
2011-03-09Improve wording of initdb and pg_controldata manual pages.REL9_1_ALPHA4Bruce Momjian
gabrielle <gorthx@gmail.com>
2011-03-08Assorted editing for collation documentation.Tom Lane
I made a pass over this to familiarize myself with the feature, and found some things that could be improved.
2011-03-07Minor copy-editing in CREATE TRIGGER reference page.Tom Lane
Per suggestions from Thom Brown and Robert Haas.
2011-03-07Document the DEFERRABLE option in SET TRANSACTION command.Heikki Linnakangas
Kevin Grittner
2011-03-05Convert createlang/droplang to use CREATE/DROP EXTENSION.Tom Lane
In createlang this is a one-line change. In droplang there's a whole lot of cruft that can be discarded since the extension mechanism now manages removal of the language's support functions. Also, add deprecation notices to these two programs' reference pages, since per discussion we may toss them overboard altogether in a release or two.
2011-03-05Update documentation to reflect that standard PLs are now extensions.Tom Lane
Recommend use of CREATE EXTENSION rather than plain CREATE LANGUAGE where relevant. Encourage PL authors to provide extension wrappers for their PLs.
2011-03-04Allow non-superusers to create (some) extensions.Tom Lane
Remove the unconditional superuser permissions check in CREATE EXTENSION, and instead define a "superuser" extension property, which when false (not the default) skips the superuser permissions check. In this case the calling user only needs enough permissions to execute the commands in the extension's installation script. The superuser property is also enforced in the same way for ALTER EXTENSION UPDATE cases. In other ALTER EXTENSION cases and DROP EXTENSION, test ownership of the extension rather than superuserness. ALTER EXTENSION ADD/DROP needs to insist on ownership of the target object as well; to do that without duplicating code, refactor comment.c's big switch for permissions checks into a separate function in objectaddress.c. I also removed the superuserness checks in pg_available_extensions and related functions; there's no strong reason why everybody shouldn't be able to see that info. Also invent an IF NOT EXISTS variant of CREATE EXTENSION, and use that in pg_dump, so that dumps won't fail for installed-by-default extensions. We don't have any of those yet, but we will soon. This is all per discussion of wrapping the standard procedural languages into extensions. I'll make those changes in a separate commit; this is just putting the core infrastructure in place.
2011-03-02Add 'collatable' to the Parameters section of CREATE TYPE.Tom Lane
2011-03-02Fix erroneous documentation of the syntax of CREATE CONSTRAINT TRIGGER.Tom Lane
The grammar requires a specific ordering of the clauses, but the documentation showed a different order. This error was introduced in commit b47953f9c69d48a9261bd643e3170017b93f6337, which merged the CREATE CONSTRAINT TRIGGER documentation into the CREATE TRIGGER page. There is no code bug AFAICS.
2011-02-28Add documentation for data-modifying statements in WITH clauses.Tom Lane
Marko Tiikkaja, somewhat reworked by Tom
2011-02-22Fix a couple of unlogged tables goofs.Robert Haas
"SELECT ... INTO UNLOGGED tabname" works, but wasn't documented; CREATE UNLOGGED SEQUENCE and CREATE UNLOGGED VIEW failed an assertion, instead of throwing a sensible error. Latter issue reported by Itagaki Takahiro; patch review by Tom Lane.