Re: GUC flags

Justin Pryzby <pryzby@telsasoft.com>

From: Justin Pryzby <pryzby@telsasoft.com>
To: Michael Paquier <michael@paquier.xyz>
Cc: pgsql-hackers@lists.postgresql.org
Date: 2021-12-02T03:34:39Z
Lists: pgsql-hackers
> @@ -2142,7 +2142,8 @@ static struct config_int ConfigureNamesInt[] =
>  		{"post_auth_delay", PGC_BACKEND, DEVELOPER_OPTIONS,
> -			gettext_noop("Waits N seconds on connection startup after authentication."),
> +			gettext_noop("Sets the amount of time to wait on connection "
> +						 "startup after authentication."),

> @@ -2762,7 +2763,8 @@ static struct config_int ConfigureNamesInt[] =
>  		{"pre_auth_delay", PGC_SIGHUP, DEVELOPER_OPTIONS,
> -			gettext_noop("Waits N seconds on connection startup before authentication."),
> +			gettext_noop("Sets the amount of time to wait on connection "
> +						 "startup before authentication."),
>  			gettext_noop("This allows attaching a debugger to the process."),

I wonder if these should say "Sets the amount of time to wait [before]
authentication during connection startup"

>  		{"checkpoint_warning", PGC_SIGHUP, WAL_CHECKPOINTS,
> -			gettext_noop("Enables warnings if checkpoint segments are filled more "
> -						 "frequently than this."),
> +			gettext_noop("Sets the maximum time before warning if checkpoints "
> +						 "triggered by WAL volume happen too frequently."),
>  			gettext_noop("Write a message to the server log if checkpoints "
> -						 "caused by the filling of checkpoint segment files happens more "
> +						 "caused by the filling of WAL segment files happen more "
>  						 "frequently than this number of seconds. Zero turns off the warning."),

Should this still say "seconds" ?
Or change it to "this amount of time"?
I'm not sure.

>  		{"log_rotation_age", PGC_SIGHUP, LOGGING_WHERE,
> -			gettext_noop("Automatic log file rotation will occur after N minutes."),
> +			gettext_noop("Sets the amount of time to wait before forcing "
> +						 "log file rotation."),
>  			NULL,
>  			GUC_UNIT_MIN
>  		},
> @@ -3154,7 +3159,8 @@ static struct config_int ConfigureNamesInt[] =
>  
>  	{
>  		{"log_rotation_size", PGC_SIGHUP, LOGGING_WHERE,
> -			gettext_noop("Automatic log file rotation will occur after N kilobytes."),
> +			gettext_noop("Sets the maximum size of log file to reach before "
> +						 "forcing log file rotation."),

Actually, I think that for log_rotation_size, it should not say "forcing".

"Sets the maximum size a log file can reach before being rotated"

BTW the EXPLAIN flag for enable_incremental_sort could be backpatched to v13.

-- 
Justin



Commits

  1. Add TAP test to automate the equivalent of check_guc, take two

  2. Retire src/backend/utils/misc/check_guc

  3. Add TAP test to automate the equivalent of check_guc

  4. Add PostgreSQL::Test::Cluster::config_data()

  5. Introduce pg_settings_get_flags() to find flags associated to a GUC

  6. Revert changes about warnings/errors for placeholders.

  7. Improve the description of various GUCs