From 14677b3acfaf1476c491565a79922f0eb70110ad Mon Sep 17 00:00:00 2001
From: Connor Olding <cloningdonor@gmail.com>
Date: Sun, 1 Aug 2021 08:32:45 -0700
Subject: [PATCH] document dbusiest

---
 sh/dbusiest | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/sh/dbusiest b/sh/dbusiest
index 95e50fc..d6b5b15 100755
--- a/sh/dbusiest
+++ b/sh/dbusiest
@@ -4,7 +4,16 @@
 # NO_DASH
 
 dbusiest() { ### @-
-    ### display the directory with the most files in it, counted recursively.
+    ### list directories ordered descending by the number of files in them,
+    ### counted recursively. see also [`cdbusiest`.](#cdbusiest)
+    ###
+    ### ```
+    ### $ cd
+    ### $ dbusiest | head -n3
+    ### 152364 src
+    ### 46518 work
+    ### 20903 play
+    ### ```
     [ $# -le 0 ] || { printf "%s\n" "$0: too many arguments" >&2; return 1; }
     local c d
     for d in *(FDN); do