Update clap_complete/src/env/shells.rs

Co-authored-by: Ed Page <eopage@gmail.com>

Author: douzebis

clap_complete/src/env/shells.rs

@@ -39,13 +39,11 @@ _clap_complete_NAME() {
     fi
     local words=("${COMP_WORDS[@]}")
     if [[ "${BASH_VERSINFO[0]}" -ge 4 ]]; then
-        # bash splits on COMP_WORDBREAKS characters (e.g. '=', ':') so
-        # '--option=value' becomes ["--option", "=", "value"] in COMP_WORDS,
-        # and $2 (the word-to-complete) only contains the fragment after the
-        # last break character.  We can't use $2 directly; instead we reassemble
-        # the word list by dropping single-character COMP_WORDBREAKS tokens and
-        # adjusting the index.  Approach adapted from _comp__reassemble_words in
-        # https://github.com/scop/bash-completion.
+        # Reassemble the argument list from the word list by dropping single-character `COMP_WORDBREAKS` tokens and adjusting the index.
+        # This is in place of using `$2` (the word-to-complete) because bash splits the arguments into words using `COMP_WORDBREAKS` characters (e.g. '=', ':') so
+        # `--option=value` becomes `["--option", "=", "value"]` in `COMP_WORDS`.
+        #
+        # Approach adapted from `_comp__reassemble_words` in https://github.com/scop/bash-completion.
         local _i _cword=$COMP_CWORD
         words=()
         for (( _i = 0; _i < ${#COMP_WORDS[@]}; _i++ )); do