misc: dfm tweaks, documentation, code style

config/functions

@@ -66,17 +66,23 @@ function silent
   "$@" >&/dev/null
 }
 
+# Remove directory from the PATH variable
+# usage: path_remove ~/.local/bin
 function path_remove
 {
   PATH=$(echo -n "$PATH" | awk -v RS=: -v ORS=: "\$0 != \"$1\"" | sed 's/:$//')
 }
 
+# Append directory to the PATH
+# usage: path_append ~/.local/bin
 function path_append
 {
   path_remove "$1"
   PATH="${PATH:+"$PATH:"}$1"
 }
 
+# Prepend directory to the PATH
+# usage: path_prepend ~/.local/bin
 function path_prepend
 {
   path_remove "$1"
@@ -108,4 +114,3 @@ function x-default-antigen-bundles
   hash python 2> /dev/null && antigen bundle MichaelAquilina/zsh-autoswitch-virtualenv
   hash rvm 2> /dev/null && antigen bundle unixorn/rvm-plugin
 }
-