From 039e50fbf2410ab7181a94c6a7c530ca37db493f Mon Sep 17 00:00:00 2001
From: Ramesh Padmanabhaiah <codeforester@gmail.com>
Date: Fri, 3 Jul 2026 15:15:53 -0700
Subject: [PATCH] Document list and git helper call-site behavior

---
 lib/bash/git/lib_git.sh   | 3 +++
 lib/bash/list/lib_list.sh | 3 +++
 2 files changed, 6 insertions(+)

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=()