database/postgres
1
0
Fork 0
mirror of https://github.com/postgres/postgres.git synced 2025-07-18 17:42:25 +03:00
Code Activity
Files
38cc08546459a9052b6ed43cdb28973288db38c6
postgres/doc/src/sgml/ref
History
Tom Lane 856ca51a23 Doc: clarify use of NULL to drop comments and security labels. 
This was only mentioned in the description of the text/label, which
are marked as being in quotes in the synopsis, which can cause
confusion (as witnessed on IRC).

Also separate the literal and NULL cases in the parameter list, per
suggestion from Tom Lane.

Also add an example of dropping a security label.

Dagfinn Ilmari Mannsåker, with some tweaks by me

Discussion: https://postgr.es/m/87sffqk4zp.fsf@wibble.ilmari.org
2023-01-31 14:32:24 -05:00
..
abort.sgml
Improve <xref> vs. <command> formatting in the documentation
2020-10-03 16:40:02 +02:00
allfiles.sgml
Don't install postmaster symlink anymore
2023-01-26 11:33:01 +01:00
alter_aggregate.sgml
More documentation update for GRANT ... WITH SET OPTION.
2023-01-16 10:35:29 -05:00
alter_collation.sgml
More documentation update for GRANT ... WITH SET OPTION.
2023-01-16 10:35:29 -05:00
alter_conversion.sgml
More documentation update for GRANT ... WITH SET OPTION.
2023-01-16 10:35:29 -05:00
alter_database.sgml
More documentation update for GRANT ... WITH SET OPTION.
2023-01-16 10:35:29 -05:00
alter_default_privileges.sgml
Add grantable MAINTAIN privilege and pg_maintain role.
2022-12-13 17:33:28 -08:00
alter_domain.sgml
More documentation update for GRANT ... WITH SET OPTION.
2023-01-16 10:35:29 -05:00
alter_event_trigger.sgml
Allow CURRENT_ROLE where CURRENT_USER is accepted
2020-09-17 11:40:08 +02:00
alter_extension.sgml
Reconsider the handling of procedure OUT parameters.
2021-06-10 17:11:36 -04:00
alter_foreign_data_wrapper.sgml
Allow CURRENT_ROLE where CURRENT_USER is accepted
2020-09-17 11:40:08 +02:00
alter_foreign_table.sgml
More documentation update for GRANT ... WITH SET OPTION.
2023-01-16 10:35:29 -05:00
alter_function.sgml
More documentation update for GRANT ... WITH SET OPTION.
2023-01-16 10:35:29 -05:00
alter_group.sgml
Make role grant system more consistent with other privileges.
2022-08-22 11:35:17 -04:00
alter_index.sgml
Revert per-index collation version tracking feature.
2021-05-07 21:10:11 +12:00
alter_language.sgml
Allow CURRENT_ROLE where CURRENT_USER is accepted
2020-09-17 11:40:08 +02:00
alter_large_object.sgml
More documentation update for GRANT ... WITH SET OPTION.
2023-01-16 10:35:29 -05:00
alter_materialized_view.sgml
More documentation update for GRANT ... WITH SET OPTION.
2023-01-16 10:35:29 -05:00
alter_opclass.sgml
More documentation update for GRANT ... WITH SET OPTION.
2023-01-16 10:35:29 -05:00
alter_operator.sgml
More documentation update for GRANT ... WITH SET OPTION.
2023-01-16 10:35:29 -05:00
alter_opfamily.sgml
Use the correct article for abbreviations
2021-06-11 13:38:04 +12:00
alter_policy.sgml
doc: Improve hyphenation consistency
2021-04-21 08:14:43 +02:00
alter_procedure.sgml
More documentation update for GRANT ... WITH SET OPTION.
2023-01-16 10:35:29 -05:00
alter_publication.sgml
More documentation update for GRANT ... WITH SET OPTION.
2023-01-16 10:35:29 -05:00
alter_role.sgml
Adjust interaction of CREATEROLE with role properties.
2023-01-24 10:57:09 -05:00
alter_routine.sgml
Doc: fix confusion about LEAKPROOF in syntax summaries.
2021-06-23 14:27:13 -04:00
alter_rule.sgml
…
alter_schema.sgml
More documentation update for GRANT ... WITH SET OPTION.
2023-01-16 10:35:29 -05:00
alter_sequence.sgml
More documentation update for GRANT ... WITH SET OPTION.
2023-01-16 10:35:29 -05:00
alter_server.sgml
More documentation update for GRANT ... WITH SET OPTION.
2023-01-16 10:35:29 -05:00
alter_statistics.sgml
More documentation update for GRANT ... WITH SET OPTION.
2023-01-16 10:35:29 -05:00
alter_subscription.sgml
Doc: clarify behavior of boolean options in replication commands.
2023-01-30 11:59:37 -05:00
alter_system.sgml
Allow granting SET and ALTER SYSTEM privileges on GUC parameters.
2022-04-06 13:24:33 -04:00
alter_table.sgml
More documentation update for GRANT ... WITH SET OPTION.
2023-01-16 10:35:29 -05:00
alter_tablespace.sgml
More documentation update for GRANT ... WITH SET OPTION.
2023-01-16 10:35:29 -05:00
alter_trigger.sgml
Make ALTER TRIGGER RENAME consistent for partitioned tables
2021-07-22 18:33:47 -04:00
alter_tsconfig.sgml
Allow CURRENT_ROLE where CURRENT_USER is accepted
2020-09-17 11:40:08 +02:00
alter_tsdictionary.sgml
Allow CURRENT_ROLE where CURRENT_USER is accepted
2020-09-17 11:40:08 +02:00
alter_tsparser.sgml
…
alter_tstemplate.sgml
…
alter_type.sgml
More documentation update for GRANT ... WITH SET OPTION.
2023-01-16 10:35:29 -05:00
alter_user_mapping.sgml
Allow CURRENT_ROLE where CURRENT_USER is accepted
2020-09-17 11:40:08 +02:00
alter_user.sgml
Add USER SET parameter values for pg_db_role_setting
2022-12-09 13:12:20 +03:00
alter_view.sgml
More documentation update for GRANT ... WITH SET OPTION.
2023-01-16 10:35:29 -05:00
analyze.sgml
Fix MAINTAIN privileges for toast tables and partitions.
2023-01-14 00:16:23 -08:00
begin.sgml
Improve <xref> vs. <command> formatting in the documentation
2020-10-03 16:40:02 +02:00
call.sgml
Reconsider the handling of procedure OUT parameters.
2021-06-10 17:11:36 -04:00
checkpoint.sgml
Rename pg_checkpointer predefined role to pg_checkpoint.
2022-07-05 13:31:42 -04:00
close.sgml
Improve <xref> vs. <command> formatting in the documentation
2020-10-03 16:40:02 +02:00
cluster.sgml
Clarify documentation for CLUSTER on partitioned tables.
2023-01-25 20:23:32 -08:00
clusterdb.sgml
Fix connection string handling in src/bin/scripts/ programs.
2020-10-19 19:03:46 -04:00
comment.sgml
Doc: clarify use of NULL to drop comments and security labels.
2023-01-31 14:32:24 -05:00
commit_prepared.sgml
doc: Remove unused title ids
2020-03-13 15:45:37 +01:00
commit.sgml
Doc: add XML ID attributes to <sectN> and <varlistentry> tags.
2023-01-09 15:08:24 -05:00
copy.sgml
doc: Minor wordsmithing to COPY docs
2022-08-22 15:08:45 +02:00
create_access_method.sgml
…
create_aggregate.sgml
Improve <xref> vs. <command> formatting in the documentation
2020-10-03 16:40:02 +02:00
create_cast.sgml
Improve <xref> vs. <command> formatting in the documentation
2020-10-03 16:40:02 +02:00
create_collation.sgml
Revert per-index collation version tracking feature.
2021-05-07 21:10:11 +12:00
create_conversion.sgml
Add 'noError' argument to encoding conversion functions.
2021-04-01 11:45:22 +03:00
create_database.sgml
More documentation update for GRANT ... WITH SET OPTION.
2023-01-16 10:35:29 -05:00
create_domain.sgml
Convert domain_in to report errors softly.
2022-12-11 12:56:54 -05:00
create_event_trigger.sgml
doc: Add missing markup in CREATE EVENT TRIGGER page
2021-09-25 14:48:03 +09:00
create_extension.sgml
doc: Fix man page whitespace issues
2021-04-09 23:36:46 +02:00
create_foreign_data_wrapper.sgml
…
create_foreign_table.sgml
Doc: Further fix CREATE FOREIGN TABLE synopsis.
2022-06-02 18:00:00 +09:00
create_function.sgml
Assorted improvements to SECURITY DEFINER functions documentation.
2023-01-16 10:49:59 -05:00
create_group.sgml
Doc: sync CREATE GROUP syntax synopsis with CREATE ROLE.
2020-04-10 10:44:09 -04:00
create_index.sgml
doc: mention "bloom" as a possible index access method
2022-08-31 22:35:09 -04:00
create_language.sgml
Improve <xref> vs. <command> formatting in the documentation
2020-10-03 16:40:02 +02:00
create_materialized_view.sgml
Doc: be more precise about conflicts between relation names.
2021-11-02 12:12:02 -04:00
create_opclass.sgml
Use the correct article for abbreviations
2021-06-11 13:38:04 +12:00
create_operator.sgml
Improve <xref> vs. <command> formatting in the documentation
2020-10-03 16:40:02 +02:00
create_opfamily.sgml
…
create_policy.sgml
Add support for MERGE SQL command
2022-03-28 16:47:48 +02:00
create_procedure.sgml
doc: Fix man page whitespace issues
2021-04-09 23:36:46 +02:00
create_publication.sgml
Doc: clarify behavior of boolean options in replication commands.
2023-01-30 11:59:37 -05:00
create_role.sgml
Adjust interaction of CREATEROLE with role properties.
2023-01-24 10:57:09 -05:00
create_rule.sgml
…
create_schema.sgml
More documentation update for GRANT ... WITH SET OPTION.
2023-01-16 10:35:29 -05:00
create_sequence.sgml
doc: fix wrong tag used in create sequence manual.
2022-08-16 09:20:14 +09:00
create_server.sgml
…
create_statistics.sgml
doc: in create statistics docs, mention analyze for parent info
2022-08-31 23:11:46 -04:00
create_subscription.sgml
Doc: clarify behavior of boolean options in replication commands.
2023-01-30 11:59:37 -05:00
create_table_as.sgml
doc: clarify CREATE TABLE AS ... IF NOT EXISTS
2022-08-12 10:59:00 -04:00
create_table.sgml
Revert "Add eager and lazy freezing strategies to VACUUM."
2023-01-25 22:22:27 -08:00
create_tablespace.sgml
Remove configure probes for symlink/readlink, and dead code.
2022-08-05 09:22:56 +12:00
create_transform.sgml
plpython: Adjust docs after removal of Python 2 support.
2022-03-07 18:30:57 -08:00
create_trigger.sgml
Support TRUNCATE triggers on foreign tables.
2022-07-12 09:18:02 +09:00
create_tsconfig.sgml
…
create_tsdictionary.sgml
…
create_tsparser.sgml
…
create_tstemplate.sgml
…
create_type.sgml
Create infrastructure for "soft" error reporting.
2022-12-09 09:58:38 -05:00
create_user_mapping.sgml
Allow CURRENT_ROLE where CURRENT_USER is accepted
2020-09-17 11:40:08 +02:00
create_user.sgml
Improve <xref> vs. <command> formatting in the documentation
2020-10-03 16:40:02 +02:00
create_view.sgml
Add support for security invoker views.
2022-03-22 10:28:10 +00:00
createdb.sgml
Add new block-by-block strategy for CREATE DATABASE.
2022-03-29 11:48:36 -04:00
createuser.sgml
Add new GUC createrole_self_grant.
2023-01-10 12:44:49 -05:00
deallocate.sgml
…
declare.sgml
In plpgsql, don't preassign portal names to bound cursor variables.
2023-01-01 13:22:34 -05:00
delete.sgml
Improve <xref> vs. <command> formatting in the documentation
2020-10-03 16:40:02 +02:00
discard.sgml
…
do.sgml
doc: Remove unused title ids
2020-03-13 15:45:37 +01:00
drop_access_method.sgml
…
drop_aggregate.sgml
…
drop_cast.sgml
doc: make ref/*.sgml file header comment layout consistent
2020-05-15 08:52:24 -04:00
drop_collation.sgml
doc: make ref/*.sgml file header comment layout consistent
2020-05-15 08:52:24 -04:00
drop_conversion.sgml
doc: make ref/*.sgml file header comment layout consistent
2020-05-15 08:52:24 -04:00
drop_database.sgml
doc: Trim trailing whitespace
2020-06-07 13:24:40 +02:00
drop_domain.sgml
…
drop_event_trigger.sgml
…
drop_extension.sgml
doc: clarify DROP EXTENSION dependent members text
2022-08-12 09:07:11 -04:00
drop_foreign_data_wrapper.sgml
…
drop_foreign_table.sgml
doc: make ref/*.sgml file header comment layout consistent
2020-05-15 08:52:24 -04:00
drop_function.sgml
doc: Fix man page whitespace issues
2020-06-07 14:54:28 +02:00
drop_group.sgml
Improve <xref> vs. <command> formatting in the documentation
2020-10-03 16:40:02 +02:00
drop_index.sgml
doc: Clarify use of ACCESS EXCLUSIVE lock in various sections
2021-04-01 15:28:37 +09:00
drop_language.sgml
Improve <xref> vs. <command> formatting in the documentation
2020-10-03 16:40:02 +02:00
drop_materialized_view.sgml
…
drop_opclass.sgml
…
drop_operator.sgml
Remove support for postfix (right-unary) operators.
2020-09-17 19:38:05 -04:00
drop_opfamily.sgml
…
drop_owned.sgml
Allow granting SET and ALTER SYSTEM privileges on GUC parameters.
2022-04-06 13:24:33 -04:00
drop_policy.sgml
doc: Improve hyphenation consistency
2021-04-21 08:14:43 +02:00
drop_procedure.sgml
doc: Fix man page whitespace issues
2022-04-07 18:25:12 +02:00
drop_publication.sgml
…
drop_role.sgml
Restrict the privileges of CREATEROLE users.
2023-01-10 12:44:30 -05:00
drop_routine.sgml
Reconsider the handling of procedure OUT parameters.
2021-06-10 17:11:36 -04:00
drop_rule.sgml
…
drop_schema.sgml
…
drop_sequence.sgml
…
drop_server.sgml
…
drop_statistics.sgml
doc: Mention CASCADE/RESTRICT for DROP STATISTICS
2021-07-19 12:39:38 +09:00
drop_subscription.sgml
Allow multiple xacts during table sync in logical replication.
2021-02-12 07:41:51 +05:30
drop_table.sgml
Improve <xref> vs. <command> formatting in the documentation
2020-10-03 16:40:02 +02:00
drop_tablespace.sgml
…
drop_transform.sgml
plpython: Adjust docs after removal of Python 2 support.
2022-03-07 18:30:57 -08:00
drop_trigger.sgml
…
drop_tsconfig.sgml
…
drop_tsdictionary.sgml
…
drop_tsparser.sgml
…
drop_tstemplate.sgml
…
drop_type.sgml
…
drop_user_mapping.sgml
Allow CURRENT_ROLE where CURRENT_USER is accepted
2020-09-17 11:40:08 +02:00
drop_user.sgml
Improve <xref> vs. <command> formatting in the documentation
2020-10-03 16:40:02 +02:00
drop_view.sgml
…
dropdb.sgml
Fix connection string handling in src/bin/scripts/ programs.
2020-10-19 19:03:46 -04:00
dropuser.sgml
Restrict the privileges of CREATEROLE users.
2023-01-10 12:44:30 -05:00
ecpg-ref.sgml
Fix our getopt_long's behavior for a command line argument of just "-".
2020-03-23 11:58:00 -04:00
end.sgml
Improve <xref> vs. <command> formatting in the documentation
2020-10-03 16:40:02 +02:00
execute.sgml
Doc: fix "Unresolved ID reference" warnings, clean up man page cross-refs.
2020-05-11 14:15:55 -04:00
explain.sgml
Remove trailing whitespace from *.sgml files.
2022-04-20 11:04:49 -04:00
fetch.sgml
doc: show direction is optional in FETCH/MOVE's FROM/IN syntax
2022-08-31 19:29:06 -04:00
grant.sgml
More documentation update for GRANT ... WITH SET OPTION.
2023-01-16 10:35:29 -05:00
import_foreign_schema.sgml
…
initdb.sgml
Doc: add XML ID attributes to <sectN> and <varlistentry> tags.
2023-01-09 15:08:24 -05:00
insert.sgml
doc: clarify that "excluded" ON CONFLICT is a single row
2022-07-14 15:33:28 -04:00
listen.sgml
Doc: improve discussion of race conditions involved in LISTEN.
2019-11-24 18:03:39 -05:00
load.sgml
doc: make ref/*.sgml file header comment layout consistent
2020-05-15 08:52:24 -04:00
lock.sgml
Fix MAINTAIN privileges for toast tables and partitions.
2023-01-14 00:16:23 -08:00
merge.sgml
Update MERGE docs to mention that ONLY is supported.
2022-12-09 10:00:01 +00:00
move.sgml
doc: show direction is optional in FETCH/MOVE's FROM/IN syntax
2022-08-31 19:29:06 -04:00
notify.sgml
Use a hash table to de-duplicate NOTIFY events faster.
2019-08-15 12:22:12 -04:00
pg_amcheck.sgml
pg_amcheck: avoid unhelpful verification attempts.
2021-10-13 14:08:12 -07:00
pg_basebackup.sgml
Refactor code parsing compression option values (-Z/--compress)
2022-11-30 09:34:32 +09:00
pg_checksums.sgml
Doc: fix a few oddly-spelled SGML ID attributes.
2023-01-17 17:13:20 -05:00
pg_config-ref.sgml
Add missing <application> tags in application doc <refentrytitle>s
2020-07-10 16:51:29 +02:00
pg_controldata.sgml
doc: remove unnecessary blank before command option text
2020-12-03 11:33:24 -05:00
pg_ctl-ref.sgml
Remove exclusive backup mode
2022-04-06 14:41:03 -04:00
pg_dump.sgml
pg_dump: Remove "blob" terminology
2022-12-05 08:52:55 +01:00
pg_dumpall.sgml
Doc: adjust misleading phrasing of a few cross-references.
2022-09-22 22:05:09 -04:00
pg_isready.sgml
doc: libpq connection options can override command-line flags
2020-10-02 22:19:31 -04:00
pg_receivewal.sgml
Restore archive_command documentation
2022-09-22 07:35:00 -04:00
pg_recvlogical.sgml
Improve terminology
2022-09-23 21:18:17 -04:00
pg_resetwal.sgml
doc: use wording "restore" instead of "reload" of dumps
2022-07-21 14:55:23 -04:00
pg_restore.sgml
doc: use wording "restore" instead of "reload" of dumps
2022-07-21 14:55:23 -04:00
pg_rewind.sgml
Rework <warning> box about column list combining in logical replication
2022-12-23 17:49:51 +01:00
pg_verifybackup.sgml
Fix typos and grammar in docs and comments
2020-12-24 17:05:49 +09:00
pg_waldump.sgml
pg_waldump: Add --save-fullpage=PATH to save full page images from WAL records
2022-12-27 08:27:53 +09:00
pgarchivecleanup.sgml
Remove trailing whitespace from *.sgml files.
2022-04-20 11:04:49 -04:00
pgbench.sgml
Doc: add XML ID attributes to <sectN> and <varlistentry> tags.
2023-01-09 15:08:24 -05:00
pgtestfsync.sgml
Remove trailing whitespace from *.sgml files.
2022-04-20 11:04:49 -04:00
pgtesttiming.sgml
doc: make ref/*.sgml file header comment layout consistent
2020-05-15 08:52:24 -04:00
pgupgrade.sgml
pg_upgrade: Add --copy option
2022-12-16 18:32:02 +01:00
postgres-ref.sgml
Provide options for postmaster to kill child processes with SIGABRT.
2022-11-21 11:59:29 -05:00
prepare_transaction.sgml
Improve <xref> vs. <command> formatting in the documentation
2020-10-03 16:40:02 +02:00
prepare.sgml
Doc: fix a few oddly-spelled SGML ID attributes.
2023-01-17 17:13:20 -05:00
psql-ref.sgml
Fix typos in code and comments
2023-01-11 15:16:38 +09:00
reassign_owned.sgml
Improve <xref> vs. <command> formatting in the documentation
2020-10-03 16:40:02 +02:00
refresh_materialized_view.sgml
Add grantable MAINTAIN privilege and pg_maintain role.
2022-12-13 17:33:28 -08:00
reindex.sgml
Fix MAINTAIN privileges for toast tables and partitions.
2023-01-14 00:16:23 -08:00
reindexdb.sgml
Clarify that --system reindexes system catalogs *only*
2021-10-27 16:28:11 +02:00
release_savepoint.sgml
doc: add transaction processing chapter with internals info
2022-11-29 20:49:52 -05:00
reset.sgml
…
revoke.sgml
Add grantable MAINTAIN privilege and pg_maintain role.
2022-12-13 17:33:28 -08:00
rollback_prepared.sgml
doc: Remove unused title ids
2020-03-13 15:45:37 +01:00
rollback_to.sgml
doc: add transaction processing chapter with internals info
2022-11-29 20:49:52 -05:00
rollback.sgml
Doc: add XML ID attributes to <sectN> and <varlistentry> tags.
2023-01-09 15:08:24 -05:00
savepoint.sgml
doc: clarify the behavior of identically-named savepoints
2022-07-14 15:44:22 -04:00
security_label.sgml
Doc: clarify use of NULL to drop comments and security labels.
2023-01-31 14:32:24 -05:00
select_into.sgml
Fix various typos, grammar and code style in comments and docs
2022-01-25 09:40:04 +09:00
select.sgml
doc: split out the NATURAL/CROSS JOIN in SELECT syntax
2022-08-31 21:46:14 -04:00
set_constraints.sgml
doc: make ref/*.sgml file header comment layout consistent
2020-05-15 08:52:24 -04:00
set_role.sgml
Add a SET option to the GRANT command.
2022-11-18 12:32:56 -05:00
set_session_auth.sgml
Remove trailing whitespace from *.sgml files.
2022-04-20 11:04:49 -04:00
set_transaction.sgml
docs: Fix snapshot name in SET TRANSACTION docs.
2022-09-22 12:54:26 +09:00
set.sgml
doc: mention that SET TIME ZONE often needs to be quoted
2022-08-31 20:27:27 -04:00
show.sgml
Remove trailing whitespace from *.sgml files.
2022-04-20 11:04:49 -04:00
start_transaction.sgml
Improve <xref> vs. <command> formatting in the documentation
2020-10-03 16:40:02 +02:00
truncate.sgml
doc: Review for "Allow TRUNCATE command to truncate foreign tables".
2021-04-27 18:39:30 +09:00
unlisten.sgml
…
update.sgml
doc: Make UPDATE FROM examples consistent
2022-03-29 14:53:20 +02:00
vacuum.sgml
Fix MAINTAIN privileges for toast tables and partitions.
2023-01-14 00:16:23 -08:00
vacuumdb.sgml
Add --schema and --exclude-schema options to vacuumdb.
2022-07-31 16:46:13 -04:00
values.sgml
doc: Properly punctuate "etc."
2022-05-19 09:42:17 +02:00