Document git-dirs

README.md

@@ -35,3 +35,8 @@ the remote branch deleted. See `git close-current-branch --help` for details.
 Closes all local branches that have been merged into HEAD (or a specified
 branch). This command is upstream-aware, and can be instructed to close remote
 branches as well. See `git close-merged --help` for details.
+
+## `git-dirs`
+
+Prints a list of the most recently checked-out branches. See `git dirs --help`
+for details.

git-dirs

@@ -6,11 +6,17 @@ source "${BASH_SOURCE[0]%/*}"/utils.bash
 # So we need to repeatedly invoke it for each branch.
 
 usage() {
-    echo "git dirs [(-l|--limit) N]"
-    echo ""
-    echo "  --limit|-l N"
-    echo "      Limits the branch history to N previous branches"
-    echo "      (default 10)"
+    echo "Usage: git dirs [(--limit N)]"
+    echo
+    echo "Options:"
+    echo "  -h --help        Displays this help."
+    echo "  -l N, --limit N  Limits the branch history to N previous branches."
+    echo "                   [default: 10]"
+    [[ -z $1 ]] && return
+    echo
+    echo "Description:"
+    echo "  Prints the N most recently checked-out branches."
+    echo "  Branches that have been deleted are displayed as '(deleted branch)'."
 }
 
 limit=10
@@ -25,7 +31,7 @@ while (( $# > 0 )); do
             shift
             ;;
         --help|-h)
-            usage
+            usage full
             exit 0
             ;;
         --)