Even though the -C option of "complete" is functionally very
similar to -F, the man page
only provides detailed usage for -F. The -C description doesn't
mention parameter passing.
Repeat-By:
man bash
read the section under BUILT-IN COMMANDS for the -C option of
"complete"
Fix:
Expand the -C option text to be similar to -F, or put a
reference to the -F description
to explain how the parameter passing works.
E.g.
The shell command *command* is executed in a subshell
environment. When it is executed,
$1 is the name of the command whose arguments are being
completed, $2 is the word being completed,
and $3 is the word preceding the word being completed, as
described above (see Programmable
Completion). When it finishes, its output is used as the
possible completions.
Or
command is executed in a subshell environment, and its output
is used as the possible completions.
See -F below for a description of how parameters are passed to
the command.