testing..

functions/git.fish

@@ -1,17 +1,30 @@
 function gsa
+# ─< Prompt the user to enter the repository URL to add as a submodule >────────────────────
   echo "-- enter the repository to add as a submodule --"
-  read repo
-  echo "-- enter the branch to checkout (main/master..) --" 
-  read branch
+  read -l repo
+  
+# ─< Prompt the user to enter the branch to checkout (e.g., main, master) >─────────────────
+  echo "-- enter the branch to checkout (main/master..) --"
+  read -l branch
+  
+# ─< Prompt the user to enter the relative path where the submodule will be cloned >────────
+# ─< Advise not to use the leading / or ./ >────────────────────────────────────────────────
   echo "-- enter the relative path, where the submodule will be cloned to. (don't use fist / or ./) --"
-  read -S path
+  read -l path
+  
+# ─< Ask the user for confirmation if the constructed command looks correct >───────────────
   echo "-- does this command look right to you? [y/n] --"
   echo "git submodule add --branch $branch --name $path $repo"
-read comm
+  read -l comm
+  
+# ─< Switch statement to handle the user's confirmation input >─────────────────────────────
   switch $comm
-  case [Yy]
-    git submodule add --branch $branch --name $path $repo
-  case [Nn]
-    echo "-- all right, just try again :) --"
+# ─< If the user inputs 'y' or 'Y', execute the git submodule add command >─────────────────
+    case 'y' 'Y'
+      git submodule add --branch $branch --name $path $repo
+    
+# ─< If the user inputs 'n' or 'N', notify them to try again >──────────────────────────────
+    case 'n' 'N'
+      echo "-- all right, just try again :) --"
   end
 end