From 495bde2404974fcfcad95342c5f84ff781caef5c Mon Sep 17 00:00:00 2001
From: Matt Hamilton <m@tthamilton.com>
Date: Tue, 15 Dec 2015 18:49:15 -0500
Subject: [PATCH] add utility documentation

---
 modules/utility/README.md | 23 +++++++++++++++++++++++
 modules/utility/init.zsh  | 16 +++++++++++-----
 2 files changed, 34 insertions(+), 5 deletions(-)
 create mode 100644 modules/utility/README.md

diff --git a/modules/utility/README.md b/modules/utility/README.md
new file mode 100644
index 0000000..65d77ec
--- /dev/null
+++ b/modules/utility/README.md
@@ -0,0 +1,23 @@
+Utility
+=======
+
+Adds utility aliases and functions.
+
+Aliases
+-------
+
+### General
+
+  | alias | command |
+  | ----- | ------- |
+  | `chmod` | `chmod --preserve-root -v` |
+  | `chown` | `chown --preserve-root -v` |
+  | `df` | `df -kh` |
+  | `du` | `du -kh` |
+
+### ls
+
+  | alias | command |
+  | ----- | ------- |
+  | `ls` | `ls --group-directories-first --color=auto` |
+  | `l` | `ls -lAh` |
diff --git a/modules/utility/init.zsh b/modules/utility/init.zsh
index 6974923..142a123 100644
--- a/modules/utility/init.zsh
+++ b/modules/utility/init.zsh
@@ -2,11 +2,21 @@
 # utility functions and options
 #
 
+
+#
 # general aliases
+#
+
 alias chmod='chmod --preserve-root -v'
 alias chown='chown --preserve-root -v'
+alias df='df -kh'
+alias du='du -kh'
+
+
+#
+# ls
+#
 
-# ls colors
 if [[ dircolors ]]; then
   if [[ -s ${HOME}/.dir_colors ]]; then
     eval "$(dircolors --sh ${HOME}/.dir_colors)"
@@ -24,7 +34,3 @@ else
 fi
 
 alias l='ls -lAh'        # one column, all files, human-readable sizes
-
-# resource usage
-alias df='df -kh'
-alias du='du -kh'