From d265b6ed6f316a16e9c945829a8da1596841f1e2 Mon Sep 17 00:00:00 2001
From: Isaac <isaac@rubenfamily.com>
Date: Fri, 28 Apr 2023 11:57:16 -0700
Subject: [PATCH] add comments in generated files

---
 borgmatic/commands/completion.py | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/borgmatic/commands/completion.py b/borgmatic/commands/completion.py
index 225fffa7..56109f37 100644
--- a/borgmatic/commands/completion.py
+++ b/borgmatic/commands/completion.py
@@ -79,15 +79,21 @@ def fish_completion():
             '    end',
             'end',
             '__borgmatic_check_version &',
+        ) + (
+            '# subparser completions',
         ) + tuple(
             '''complete -c borgmatic -a '%s' -d %s -f -n "not __fish_seen_subcommand_from %s"'''
             % (actionStr, shlex.quote(subparser.description), all_subparsers)
             for actionStr, subparser in subparsers.choices.items()
+        ) + (
+            '# global flags',
         ) + tuple(
             '''complete -c borgmatic -a '%s' -d %s -f'''
             % (option, shlex.quote(action.help))
             for action in top_level_parser._actions
             for option in action.option_strings
+        ) + (
+            '# subparser flags',
         ) + tuple(
             '''complete -c borgmatic -a '%s' -d %s -f -n "__fish_seen_subcommand_from %s"'''
             % (option, shlex.quote(action.help), actionStr)