mark a couple more tools for renaming

home/-shrc

@@ -100,6 +100,7 @@ alias gs='git status' ### @- invoke git's status subcommand.
 alias gd='git diff -U2' ### @- invoke git's diff subcommand with fewer lines of context.
 alias gds='git --no-pager diff --stat' ### @- display difference stats from git.
 alias gl='git log --oneline' ### @- invoke git's log subcommand with a single line per commit.
+### **TODO:** consider renaming because [gl(1)](https://github.com/gitless-vcs/gitless) already exists.
 alias glo='git log --graph --decorate --pretty=oneline --abbrev-commit --all' ### @- navigate git's commit tree succinctly.
 alias g1='git log --pretty=oneline --abbrev-commit --color=always | head -1' ### @- display the most recent git commit.
 alias gr='git remote -v' ### @- display remote git repositories verbosely.

sh/e

@@ -13,6 +13,9 @@ e() { ### @-
     ### $ e /etc/sudoers
     ### [sudo] password for notwa: 
     ### ```
+    ###
+    ### **NOTE:** there also exists an e(1) program provided by
+    ### the *e-wrapper* package that i don't use.
 
     [ -z "$ZSH_OPTIONS" ] || setopt local_options sh_word_split
     local d= f= temp= running= editor= needroot=0

sh/trash

@@ -11,6 +11,8 @@ trash() { ### @-
     ### $ trash 10 | xxp
     ### 3A A5 4F C7 6D 89 E7 D7 F7 0C
     ### ```
+    ###
+    ### **TODO:** consider renaming because trash(1) already exists.
     [ $# -le 1 ] || { printf "%s\n" "$0: too many arguments" >&2; return 1; }
     dd status=none if=/dev/random bs=1 count="${1:?missing count argument}"
 }