refactor: COMP_CONFIGURE_HINTS to `BASH_COMPLETION_CMD_CONFIGURE_HINTS

The old name still serves as the (undocumented) fallback.

Author: scop

completions/configure

@@ -25,9 +25,9 @@ _configure()
         return
     fi
 
-    # if $COMP_CONFIGURE_HINTS is not null, then completions of the form
-    # --option=SETTING will include 'SETTING' as a contextual hint
-    if [[ ${COMP_CONFIGURE_HINTS-} ]]; then
+    # if $BASH_COMPLETION_CMD_CONFIGURE_HINTS is not null, then completions of
+    # the form --option=SETTING will include 'SETTING' as a contextual hint
+    if [[ ${BASH_COMPLETION_CMD_CONFIGURE_HINTS-${COMP_CONFIGURE_HINTS-}} ]]; then
         COMPREPLY=($(compgen -W "$($1 --help 2>&1 |
             awk '/^  --[A-Za-z]/ { print $1; \
             if ($2 ~ /--[A-Za-z]/) print $2 }' | command sed -e 's/[[,].*//g')" \

doc/bash_completion.txt

@@ -22,7 +22,7 @@
     loaded. If unset or null, the default compatibility directory to use is
     `/etc/bash_completion.d`.
 
-*COMP_CONFIGURE_HINTS*::
+*BASH_COMPLETION_CMD_CONFIGURE_HINTS*::
     If set and not null, `configure` completion will return the entire option
     string (e.g.  `--this-option=DESCRIPTION`) so one can see what kind of data
     is required and then simply delete the descriptive text and add one's own

test/config/bashrc

@@ -45,6 +45,7 @@ export XDG_DATA_DIRS=/var/empty
 
 # Make sure default settings are in effect
 unset -v \
+    BASH_COMPLETION_CMD_CONFIGURE_HINTS \
     BASH_COMPLETION_CMD_IWCONFIG_SCAN \
     BASH_COMPLETION_FILEDIR_FALLBACK \
     COMP_CONFIGURE_HINTS \