database/postgres
1
0
Fork 0
mirror of https://github.com/postgres/postgres.git synced 2025-12-21 05:21:08 +03:00
Code Activity
Files
0b06459f3c0a515c922f2a22974acea9db38c024
postgres/doc/src/sgml/ref
History
David Rowley 0b06459f3c Doc: reword text explaining the --maintenance-db option 
The previous text was a little clumsy.  Here we improve that.

Author: David Rowley <dgrowleyml@gmail.com>
Reported-by: Noboru Saito <noborusai@gmail.com>
Reviewed-by: David G. Johnston <david.g.johnston@gmail.com>
Discussion: https://postgr.es/m/CAAM3qnJtv5YbjpwDfVOYN2gZ9zGSLFM1UGJgptSXmwfifOZJFQ@mail.gmail.com
Backpatch-through: 13
2025-04-22 14:54:22 +12:00
..
abort.sgml
Improve <xref> vs. <command> formatting in the documentation
2020-10-03 16:40:02 +02:00
allfiles.sgml
pg_createsubscriber: creates a new logical replica from a standby server
2024-03-25 12:42:47 +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
Fix typo in docs.
2025-04-08 22:02:45 +12:00
alter_default_privileges.sgml
Extend ALTER DEFAULT PRIVILEGES to define default privileges for large objects.
2025-04-04 19:02:17 +09:00
alter_domain.sgml
doc: fix ALTER DOMAIN domain_constraint to spell out options
2024-11-01 13:54:28 -04:00
alter_event_trigger.sgml
doc: remove incorrect grammar for ALTER EVENT TRIGGER
2024-02-01 10:45:37 +01:00
alter_extension.sgml
Reconsider the handling of procedure OUT parameters.
2021-06-10 17:11:36 -04:00
alter_foreign_data_wrapper.sgml
doc: Fix syntax in ALTER FOREIGN DATA WRAPPER example
2023-12-19 14:13:50 +01:00
alter_foreign_table.sgml
Add pg_constraint rows for not-null constraints
2024-11-08 13:28:48 +01: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
Note that index_name in ALTER INDEX ATTACH PARTITION can be schema-qualified
2024-10-20 15:36:20 +02: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
doc: Fix column_name parameter in ALTER MATERIALIZED VIEW
2024-05-23 13:02:57 +09:00
alter_opclass.sgml
More documentation update for GRANT ... WITH SET OPTION.
2023-01-16 10:35:29 -05:00
alter_operator.sgml
Extend ALTER OPERATOR to allow setting more optimization attributes.
2023-10-20 12:28:46 -04:00
alter_opfamily.sgml
Remove obsolete RECHECK keyword completely
2024-08-09 07:18:51 +02: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
Doc: Add a caution in alter publication.
2024-10-25 14:19:05 +05:30
alter_role.sgml
Improve some documentation about the bootstrap superuser.
2024-01-18 21:39:51 -06: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
doc: improve create/alter sequence CYCLE syntax
2024-08-19 20:18:03 -04:00
alter_server.sgml
More documentation update for GRANT ... WITH SET OPTION.
2023-01-16 10:35:29 -05:00
alter_statistics.sgml
Make stxstattarget nullable
2024-03-17 12:26:26 +01:00
alter_subscription.sgml
Doc: Fix the mistakes in the subscription's failover option.
2024-07-24 14:24:45 +05:30
alter_system.sgml
Add allow_alter_system GUC.
2024-03-29 08:45:11 -04:00
alter_table.sgml
Allow NOT NULL constraints to be added as NOT VALID
2025-04-07 19:19:50 +02:00
alter_tablespace.sgml
Enable IO concurrency on all systems
2025-03-30 19:16:47 -04: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
Revert "Add USER SET parameter values for pg_db_role_setting"
2023-05-17 20:28:57 +03:00
alter_view.sgml
More documentation update for GRANT ... WITH SET OPTION.
2023-01-16 10:35:29 -05:00
analyze.sgml
doc: Clarify log level for VERBOSE messages in maintenance commands.
2025-01-06 17:24:10 +09: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
Revamp documentation for predefined roles.
2024-07-10 16:35:25 -05:00
close.sgml
Improve <xref> vs. <command> formatting in the documentation
2020-10-03 16:40:02 +02:00
cluster.sgml
doc: Clarify log level for VERBOSE messages in maintenance commands.
2025-01-06 17:24:10 +09:00
clusterdb.sgml
Doc: reword text explaining the --maintenance-db option
2025-04-22 14:54:22 +12: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: use "an SQL" consistently rather than "a SQL"
2025-04-14 11:55:18 +12: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
Support PG_UNICODE_FAST locale in the builtin collation provider.
2025-01-17 15:56:30 -08:00
create_conversion.sgml
Add 'noError' argument to encoding conversion functions.
2021-04-01 11:45:22 +03:00
create_database.sgml
Introduce file_copy_method setting.
2025-04-08 21:35:38 +12:00
create_domain.sgml
Fix PG 17 [NOT] NULL optimization bug for domains
2025-04-07 21:33:42 -04:00
create_event_trigger.sgml
Add GUC for temporarily disabling event triggers
2023-09-25 12:41:49 +02:00
create_extension.sgml
extension_control_path
2025-03-19 07:03:20 +01:00
create_foreign_data_wrapper.sgml
…
create_foreign_table.sgml
Add support for LIKE in CREATE FOREIGN TABLE
2025-02-19 15:50:37 +09:00
create_function.sgml
Allow "internal" subtransactions in parallel mode.
2024-03-28 12:43:10 -04: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: do a little copy-editing on Index Storage Parameters list.
2025-04-12 13:42:31 -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: Note that CREATE MATERIALIZED VIEW restricts search_path.
2024-09-27 16:21:21 -05:00
create_opclass.sgml
Remove obsolete RECHECK keyword completely
2024-08-09 07:18:51 +02:00
create_operator.sgml
Doc: update CREATE OPERATOR's statement about => as an operator.
2023-10-20 13:01:02 -04: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: Generated column replication.
2025-01-30 11:09:18 +05:30
create_role.sgml
Deprecate MD5 passwords.
2024-12-02 13:30:07 -06:00
create_rule.sgml
Doc: update CREATE RULE ref page's hoary discussion of views.
2023-11-03 11:48:23 -04:00
create_schema.sgml
Fix various typos in code and tests
2023-02-09 14:43:53 +09:00
create_sequence.sgml
doc: improve create/alter sequence CYCLE syntax
2024-08-19 20:18:03 -04:00
create_server.sgml
doc: foreign servers with pushdown need matching collation
2023-10-10 16:04:56 -04:00
create_statistics.sgml
Doc: mention that extended stats aren't used for joins
2023-06-22 12:45:50 +12:00
create_subscription.sgml
Fix a WARNING for data origin discrepancies.
2025-02-21 14:34:40 +05:30
create_table_as.sgml
doc: clarify CREATE TABLE AS ... IF NOT EXISTS
2022-08-12 10:59:00 -04:00
create_table.sgml
Add support for NOT ENFORCED in foreign key constraints
2025-04-02 13:36:44 +02:00
create_tablespace.sgml
Enable IO concurrency on all systems
2025-03-30 19:16:47 -04: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
Support MERGE into updatable views.
2024-02-29 15:56:59 +00:00
createdb.sgml
createdb: Correct parameter name in SGML docs
2024-04-20 18:54:09 +02:00
createuser.sgml
Document deprecated createuser option.
2023-05-23 19:35:05 -07: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
Add OLD/NEW support to RETURNING in DML queries.
2025-01-16 14:57:35 +00: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
Fix documentation about DROP DATABASE FORCE process termination rights.
2024-05-16 14:11:00 -07:00
drop_domain.sgml
…
drop_event_trigger.sgml
…
drop_extension.sgml
Doc: replace unnecessary non-breaking space with ordinal space.
2024-10-01 11:34:34 +09: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
Avoid race condition between "GRANT role" and "DROP ROLE".
2025-02-21 17:07:01 -05: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
Doc: Add more links in logical replication pages.
2023-10-13 12:13:46 +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 assorted bugs in ecpg's macro mechanism.
2024-04-16 12:31:42 -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
Show index search count in EXPLAIN ANALYZE, take 2.
2025-03-11 09:20:50 -04:00
fetch.sgml
doc: Fix XML formatting that psql cannot handle
2023-02-03 09:04:35 +01:00
grant.sgml
Correct "improve role option documentation".
2024-04-13 07:56:14 -07:00
import_foreign_schema.sgml
…
initdb.sgml
doc: Fix typos in documentation
2025-04-15 21:32:18 +02:00
insert.sgml
Add OLD/NEW support to RETURNING in DML queries.
2025-01-16 14:57:35 +00:00
listen.sgml
Use larger segment file names for pg_notify
2023-11-29 01:41:48 +02:00
load.sgml
doc: make ref/*.sgml file header comment layout consistent
2020-05-15 08:52:24 -04:00
lock.sgml
Reintroduce MAINTAIN privilege and pg_maintain predefined role.
2024-03-13 14:49:26 -05:00
merge.sgml
Add OLD/NEW support to RETURNING in DML queries.
2025-01-16 14:57:35 +00:00
move.sgml
doc: Fix XML formatting that psql cannot handle
2023-02-03 09:04:35 +01:00
notify.sgml
Use larger segment file names for pg_notify
2023-11-29 01:41:48 +02:00
pg_amcheck.sgml
pg_amcheck: Put new options in consistent order in --help and man page
2024-05-16 11:29:41 +02:00
pg_basebackup.sgml
doc: Expand version compatibility for pg_basebackup features
2025-03-04 12:08:27 +01:00
pg_checksums.sgml
Adjust documentation for syncfs().
2024-03-27 10:23:13 -05:00
pg_combinebackup.sgml
pg_combinebackup: Add -k, --link option.
2025-03-17 14:03:14 -04: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_createsubscriber.sgml
Cosmetic fixes for pg_createsubscriber's -all option.
2025-04-10 10:30:05 +05:30
pg_ctl-ref.sgml
doc: Remove claims that initdb and pg_ctl use libpq environment variables
2024-05-15 13:06:12 +02:00
pg_dump.sgml
Fix typos and grammar in the code
2025-04-19 19:17:42 +09:00
pg_dumpall.sgml
Non text modes for pg_dumpall, correspondingly change pg_restore
2025-04-04 16:01:22 -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
pg_basebackup, pg_receivewal: fix failure to find password in ~/.pgpass.
2024-11-04 14:36:11 -05:00
pg_recvlogical.sgml
doc: Fix a typo in pg_recvlogical documentation.
2025-04-07 12:13:08 -07:00
pg_resetwal.sgml
pg_resetwal: Add --char-signedness option to change the default char signedness.
2025-02-21 10:14:36 -08:00
pg_restore.sgml
doc: Fix missing whitespace in pg_restore documentation.
2025-04-15 23:15:06 +09:00
pg_rewind.sgml
pg_rewind: Add dbname to primary_conninfo when using --write-recovery-conf.
2025-03-12 16:56:04 -07:00
pg_verifybackup.sgml
pg_verifybackup: Verify tar-format backups.
2024-09-27 08:40:24 -04:00
pg_waldump.sgml
doc: Clarify name of files generated by pg_waldump --save-fullpage
2024-10-02 11:12:40 +09:00
pg_walsummary.sgml
pg_walsummary: Document --version option
2024-04-24 08:56:21 +02:00
pgarchivecleanup.sgml
pg_archivecleanup: Add --clean-backup-history
2023-07-19 13:41:22 +09:00
pgbench.sgml
Doc: Fix punctuation errors
2025-02-12 13:18:14 +07: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
doc: Adjust some notes about pg_upgrade's file transfer modes.
2025-04-01 14:37:47 -05: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: Miscellaneous doc updates for MERGE.
2023-02-26 09:06:04 +00:00
psql-ref.sgml
psql: Make default \watch interval configurable
2025-03-25 17:53:33 +01:00
reassign_owned.sgml
Improve <xref> vs. <command> formatting in the documentation
2020-10-03 16:40:02 +02:00
refresh_materialized_view.sgml
Reintroduce MAINTAIN privilege and pg_maintain predefined role.
2024-03-13 14:49:26 -05:00
reindex.sgml
doc: Clarify log level for VERBOSE messages in maintenance commands.
2025-01-06 17:24:10 +09:00
reindexdb.sgml
Doc: reword text explaining the --maintenance-db option
2025-04-22 14:54:22 +12:00
release_savepoint.sgml
doc: Fix up spacing around verbatim DocBook elements
2024-04-24 12:26:19 +02:00
reset.sgml
…
revoke.sgml
Reintroduce MAINTAIN privilege and pg_maintain predefined role.
2024-03-13 14:49:26 -05: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: fix typo in SECURITY LABEL synopsis.
2024-02-19 14:17:11 -05:00
select_into.sgml
Doc: fix misleading syntax synopses for targetlists.
2024-07-25 19:52:08 -04:00
select.sgml
Doc: fix misleading syntax synopses for targetlists.
2024-07-25 19:52:08 -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
doc: Note exceptions for SET ROLE's effect on privilege checks.
2024-04-15 14:03:24 -05:00
set_session_auth.sgml
Fix privilege check for SET SESSION AUTHORIZATION.
2023-07-13 21:13:45 -07:00
set_transaction.sgml
Doc: Miscellaneous doc updates for MERGE.
2023-02-26 09:06:04 +00:00
set.sgml
doc: Quote value in SET NAMES documentation
2024-10-07 11:50:39 +02:00
show.sgml
doc: remove LC_COLLATE and LC_CTYPE from SHOW command
2024-12-07 12:55:55 +01: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
Add OLD/NEW support to RETURNING in DML queries.
2025-01-16 14:57:35 +00:00
vacuum.sgml
Add vacuum_truncate configuration parameter.
2025-03-20 10:16:50 -05:00
vacuumdb.sgml
Doc: reword text explaining the --maintenance-db option
2025-04-22 14:54:22 +12:00
values.sgml
doc: Properly punctuate "etc."
2022-05-19 09:42:17 +02:00