docs(functions): merge manual-only examples and notes into headers

Folds the examples Section 5 carried but the headers did not into each function's `# EXAMPLE`, and moves the three lines that only looked like examples -- the two typo-abbreviation notes and rm's /usr/bin/rm fallback -- into `# NOTES`, the label already in use. Also corrects gi's synopsis, which omitted -l, and documents yt-dlp's --no-embed-thumbnail in `# ARGUMENTS`.
2026-07-26 03:47:25 -04:00
parent 5f4306b6ca
commit 02c46ebea7
22 changed files with 40 additions and 1 deletions
@@ -17,6 +17,7 @@
 #
 # EXAMPLE
 #   cheat tar
+#   cheat git
 function cheat --wraps='cheat' --description 'alias cheat=cheat -c'
    if type -q cheat
        command cheat -c $argv