add some much-needed comments about .sh

home/bashrc

@@ -36,6 +36,8 @@ alias pl="printf '%s\n'"
 ADDPATH "$HOME/sh"
 
 (
+    # combine everything matching "YES_BASH" in ~/sh/ into ~/.sh-bash.
+    # unlike zsh, we do not check the sha1sum of the output.
     cd ~/sh \
       && printf "%s\n" '#!/usr/bin/env false' '[ -n "$preload" ] || exit 1' '' \
       | cat - $(grep -lF 'YES_BASH' $(find ~/sh -maxdepth 1 -type f)) \

home/zshrc

@@ -49,6 +49,8 @@ zmodload zsh/mathfunc
 function {
     local a b
 
+    # combine everything matching "YES_ZSH" in ~/sh/ into ~/.sh,
+    # but only recompile the output if the sha1sum has changed.
     [ -s ~/.sh.sha1 ] && read -r b _ < ~/.sh.sha1
     ( cd ~/sh \
       && print -l '#!/usr/bin/env false' '[ -n "$preload" ] || exit 1' '' \