commands: Comment/doc for config_command.

1 files changed, 7 insertions, 0 deletions

diff --git a/sway/commands.c b/sway/commands.c
index 7f24f5ab..6e9137c0 100644
--- a/sway/commands.c
+++ b/sway/commands.c
@@ -1471,6 +1471,13 @@ struct cmd_results *handle_command(char *_exec) {
         return results;
 }
 
+// this is like handle_command above, except:
+// 1) it ignores empty commands (empty lines)
+// 2) it does variable substitution
+// 3) it doesn't split commands (because the multiple commands are supposed to
+//        be chained together)
+// 4) handle_command handles all state internally while config_command has some
+//        state handled outside (notably the block mode, in read_config)
 struct cmd_results *config_command(char *exec) {
         struct cmd_results *results = NULL;
         int argc;