From: Nathan Bossart Date: Wed, 30 Apr 2025 18:07:51 +0000 (-0500) Subject: doc: Alphabetize long options for pg_dump[all]. X-Git-Url: http://git.postgresql.org/gitweb/?a=commitdiff_plain;h=f60420cff66a9089a9b431f9c07f4a29aae4990a;p=postgresql.git doc: Alphabetize long options for pg_dump[all]. The current ordering strategy for these pages is to list the short options in alphabetical order followed by the long options in alphabetical order. If an option has both a short variant and a long variant, the short variant takes precedence. This commit moves a few recently added options to match this style. We should probably adjust all pages and --help output to list the long and short options in one combined alphabetical list (with the long variants taking precedence), but that is a much larger change, so it is left as a future exercise. Oversights in commits a5cf808be5, 1fd1bd8710, and bde2fb797a. Reviewed-by: Álvaro Herrera Reviewed-by: Peter Eisentraut Discussion: https://postgr.es/m/aBFBtsltgu3-IU1d%40nathan --- diff --git a/doc/src/sgml/ref/pg_dump.sgml b/doc/src/sgml/ref/pg_dump.sgml index b757d27ebd0..c10bca63e55 100644 --- a/doc/src/sgml/ref/pg_dump.sgml +++ b/doc/src/sgml/ref/pg_dump.sgml @@ -655,17 +655,6 @@ PostgreSQL documentation - - - - - Dump only the statistics, not the schema (data definitions) or data. - Statistics for tables, materialized views, and indexes are dumped. - - - - - [:detail] @@ -1124,19 +1113,19 @@ PostgreSQL documentation - + - Do not dump security labels. + Do not dump schema (data definitions). - + - Do not dump schema (data definitions). + Do not dump security labels. @@ -1232,33 +1221,6 @@ PostgreSQL documentation - - - - - Dump data. This is the default. - - - - - - - - - Dump schema (data definitions). This is the default. - - - - - - - - - Dump statistics. This is the default. - - - - @@ -1392,6 +1354,16 @@ PostgreSQL documentation + + + + + Dump only the statistics, not the schema (data definitions) or data. + Statistics for tables, materialized views, and indexes are dumped. + + + + @@ -1467,6 +1439,33 @@ PostgreSQL documentation + + + + + Dump data. This is the default. + + + + + + + + + Dump schema (data definitions). This is the default. + + + + + + + + + Dump statistics. This is the default. + + + + diff --git a/doc/src/sgml/ref/pg_dumpall.sgml b/doc/src/sgml/ref/pg_dumpall.sgml index 43fdab2d77e..5df4b04287b 100644 --- a/doc/src/sgml/ref/pg_dumpall.sgml +++ b/doc/src/sgml/ref/pg_dumpall.sgml @@ -205,37 +205,6 @@ PostgreSQL documentation - - - - - Specify a filename from which to read patterns for databases excluded - from the dump. The patterns are interpreted according to the same rules - as . - To read from STDIN, use - as the - filename. The option can be specified in - conjunction with for excluding - databases, and can also be specified more than once for multiple filter - files. - - - - The file lists one database pattern per row, with the following format: - -exclude database PATTERN - - - - - Lines starting with # are considered comments and - ignored. Comments can be placed after an object pattern row as well. - Blank lines are also ignored. See - for how to perform quoting in patterns. - - - - - @@ -345,16 +314,6 @@ exclude database PATTERN - - - - - Dump only the statistics, not the schema (data definitions) or data. - Statistics for tables, materialized views, and indexes are dumped. - - - - @@ -444,6 +403,37 @@ exclude database PATTERN + + + + + Specify a filename from which to read patterns for databases excluded + from the dump. The patterns are interpreted according to the same rules + as . + To read from STDIN, use - as the + filename. The option can be specified in + conjunction with for excluding + databases, and can also be specified more than once for multiple filter + files. + + + + The file lists one database pattern per row, with the following format: + +exclude database PATTERN + + + + + Lines starting with # are considered comments and + ignored. Comments can be placed after an object pattern row as well. + Blank lines are also ignored. See + for how to perform quoting in patterns. + + + + + @@ -640,33 +630,6 @@ exclude database PATTERN - - - - - Dump data. This is the default. - - - - - - - - - Dump schema (data definitions). This is the default. - - - - - - - - - Dump statistics. This is the default. - - - - @@ -722,6 +685,16 @@ exclude database PATTERN + + + + + Dump only the statistics, not the schema (data definitions) or data. + Statistics for tables, materialized views, and indexes are dumped. + + + + @@ -735,6 +708,33 @@ exclude database PATTERN + + + + + Dump data. This is the default. + + + + + + + + + Dump schema (data definitions). This is the default. + + + + + + + + + Dump statistics. This is the default. + + + +