diff --git a/lib/bash/git/lib_git.sh b/lib/bash/git/lib_git.sh
index 46dcb2b..d28b445 100644
--- a/lib/bash/git/lib_git.sh
+++ b/lib/bash/git/lib_git.sh
@@ -141,6 +141,9 @@ _git_pull_with_retry() {
 # @param $2 allowed_dirty_path Optional repo-relative path that may be dirty.
 # @param $3 expected_branch    Optional branch name to require instead of auto-detecting.
 #
+# Environment:
+#   BASE_GIT_PULL_MAX_ATTEMPTS Positive integer retry count for `git pull --ff-only`; defaults to 2.
+#
 git_update_repo() {
     local git_repo="$1"
     local allowed_dirty_path="${2:-}"
diff --git a/lib/bash/list/lib_list.sh b/lib/bash/list/lib_list.sh
index 75f72ab..63a960f 100644
--- a/lib/bash/list/lib_list.sh
+++ b/lib/bash/list/lib_list.sh
@@ -41,6 +41,9 @@ list_prepend() {
     eval "$__list_array_name=(\"\${__list_values[@]}\" \"\${__list_current[@]}\")"
 }
 
+#
+# Removes every exact match from a caller-owned indexed array in place.
+#
 list_remove() {
     local __list_array_name="${1-}" __list_needle="${2-}" __list_item
     local -a __list_current=() __list_filtered=()