BUG #7799: Several configuration options in guc.c miss descriptions

The following bug has been logged on the website:

Bug reference: 7799
Logged by: Tianyin Xu
Email address: tixu(at)cs(dot)ucsd(dot)edu
PostgreSQL version: 9.2.2
Operating system: any
Description:

Hi, I just noticed that several developer options do not have descriptions
(in src/backend/utils/misc/guc.c) with the text "No description available."

I wrote the desc. according to the online doc, see below.

HTH

--- src/backend/utils/misc/guc.c
+++ src/backend/utils/misc/guc.c.
@@ -988,7 +988,7 @@ static struct config_bool ConfigureNamesBool[] =
#ifdef BTREE_BUILD_STATS
{
{"log_btree_build_stats", PGC_SUSET, DEVELOPER_OPTIONS,
- gettext_noop("No description available."),
+ gettext_noop("Logs system resource usage statistics (memory and CPU) on
various B-tree operations."),
NULL,
GUC_NOT_IN_SAMPLE
},
@@ -1062,7 +1062,7 @@ static struct config_bool ConfigureNamesBool[] =
#ifdef LOCK_DEBUG
{
{"trace_locks", PGC_SUSET, DEVELOPER_OPTIONS,
- gettext_noop("No description available."),
+ gettext_noop("Emits information about lock usage."),
NULL,
GUC_NOT_IN_SAMPLE
},
@@ -1072,7 +1072,7 @@ static struct config_bool ConfigureNamesBool[] =
},
{
{"trace_userlocks", PGC_SUSET, DEVELOPER_OPTIONS,
- gettext_noop("No description available."),
+ gettext_noop("Emits information about user lock usage."),
NULL,
GUC_NOT_IN_SAMPLE
},
@@ -1082,7 +1082,7 @@ static struct config_bool ConfigureNamesBool[] =
},
{
{"trace_lwlocks", PGC_SUSET, DEVELOPER_OPTIONS,
- gettext_noop("No description available."),
+ gettext_noop("Emits information about lightweight lock usage."),
NULL,
GUC_NOT_IN_SAMPLE
},
@@ -1092,7 +1092,7 @@ static struct config_bool ConfigureNamesBool[] =
},
{
{"debug_deadlocks", PGC_SUSET, DEVELOPER_OPTIONS,
- gettext_noop("No description available."),
+ gettext_noop("Dumps information about all current locks when a deadlock
timeout occurs."),
NULL,
GUC_NOT_IN_SAMPLE
},
@@ -1828,8 +1828,8 @@ static struct config_int ConfigureNamesInt[] =
#ifdef LOCK_DEBUG
{
{"trace_lock_oidmin", PGC_SUSET, DEVELOPER_OPTIONS,
- gettext_noop("No description available."),
- NULL,
+ gettext_noop("Sets the minimum OID of tables for tracking locks."),
+ gettext_noop("Is used to avoid output on system tables."),
GUC_NOT_IN_SAMPLE
},
&Trace_lock_oidmin,
@@ -1838,7 +1838,7 @@ static struct config_int ConfigureNamesInt[] =
},
{
{"trace_lock_table", PGC_SUSET, DEVELOPER_OPTIONS,
- gettext_noop("No description available."),
+ gettext_noop("Sets the OID of the table with unconditionally lock
tracing."),
NULL,
GUC_NOT_IN_SAMPLE
},