From 9df6c728e8e43a20e337debbd17c6509f31f570f Mon Sep 17 00:00:00 2001
From: Daniel Shahaf <d.s@daniel.shahaf.name>
Date: Mon, 18 Jan 2016 02:36:39 +0000
Subject: 37664: docs: Document the completion function _command_names.

---
 Completion/Unix/Type/_path_commands | 3 +++
 1 file changed, 3 insertions(+)

(limited to 'Completion/Unix')

diff --git a/Completion/Unix/Type/_path_commands b/Completion/Unix/Type/_path_commands
index 423563c0d..66795ae0f 100644
--- a/Completion/Unix/Type/_path_commands
+++ b/Completion/Unix/Type/_path_commands
@@ -82,6 +82,9 @@ if [[ -n $need_desc ]]; then
 else
   _wanted commands expl 'external command' compadd "$@" -k commands && ret=0
 fi
+# TODO: this is called from '_command_names -e' which is typically used in
+# contexts (such as _env) that don't accept directory names.  Should this
+# 'if' block move up to the "_command_names -" branch of _command_names?
 if [[ -o path_dirs ]]; then
   local -a path_dirs
   path_dirs=(${^path}/*(/N:t))
-- 
cgit 1.4.1