Explanation comments

Author: MilesCranmer

vims

@@ -4,6 +4,7 @@ PRINT_ALL=1
 DISABLE_VIMRC=0
 MODE=none
 
+# This creates an array to store vim commands to run:
 set -- "$@" '---vims-end---'
 while :; do
     case "$1" in
@@ -17,6 +18,10 @@ while :; do
         -t|--turn-off-mode)    MODE=none;;
         *)
             case "$MODE" in
+                # Each of these store a single command. For example,
+                # -l makes MODE=line-exe, which then stores the command:
+                # `-c :"%g/.*/exe "norm {CMD}"`, where {CMD} is the string
+                # the user passes after `-l`.
                 none)        set -- "$@" -c "$1";;
                 simple)      set -- "$@" -c ":exe \"norm gg""$1""\"";;
                 line-exe)    set -- "$@" -c ":%g/.*/exe \"norm ""$1""\"";;
@@ -38,4 +43,5 @@ if [ "$DISABLE_VIMRC" -eq "1" ]; then
     set -- -u NONE "$@"
 fi
 
+# Finally, we execute the stored array of vim commands:
 vim - -nes "$@" -c ':q!' | tail -n +2