main/pbx - documentation - enhance 'core show hints' and 'core show hint' help text

Adds descriptive help text to 'core show hints' and 'core show hint'. The text describes the various columns for the sake of clarity.

ASTERISK-23764
Review: https://reviewboard.asterisk.org/r/3610/
........

Merged revisions 415998 from http://svn.asterisk.org/svn/asterisk/branches/1.8

git-svn-id: https://origsvn.digium.com/svn/asterisk/branches/11@415999 65c4cc65-6c06-0410-ace0-fbb531ad65f3

diff --git a/main/pbx.c b/main/pbx.c
index 117e3102f9440fbd1fc0b0dc4fc52cc46f6ade06..347078c506eb6668f4cddbc6386e9a1a57bd5b34 100644 (file)
--- a/main/pbx.c
+++ b/main/pbx.c
@@ -7574,7 +7574,12 @@ static char *handle_show_hints(struct ast_cli_entry *e, int cmd, struct ast_cli_
                e->command = "core show hints";
                e->usage =
                        "Usage: core show hints\n"
-                       "       List registered hints\n";
+                       "       List registered hints.\n"
+                       "       Hint details are shown in four columns. In order from left to right, they are:\n"
+                       "       1. Hint extension URI.\n"
+                       "       2. Mapped device state identifiers.\n"
+                       "       3. Current extension state. The aggregate of mapped device states.\n"
+                       "       4. Watchers - number of subscriptions and other entities watching this hint.\n";
                return NULL;
        case CLI_GENERATE:
                return NULL;
@@ -7660,7 +7665,13 @@ static char *handle_show_hint(struct ast_cli_entry *e, int cmd, struct ast_cli_a
                e->command = "core show hint";
                e->usage =
                        "Usage: core show hint <exten>\n"
-                       "       List registered hint\n";
+                       "       List registered hint.\n"
+                       "       Hint details are shown in four columns. In order from left to right, they are:\n"
+                       "       1. Hint extension URI.\n"
+                       "       2. Mapped device state identifiers.\n"
+                       "       3. Current extension state. The aggregate of mapped device states.\n"
+                       "       4. Watchers - number of subscriptions and other entities watching this hint.\n";
+
                return NULL;
        case CLI_GENERATE:
                return complete_core_show_hint(a->line, a->word, a->pos, a->n);