diff --git a/mode-icons.el b/mode-icons.el
index 7c8a8c6..3b4f704 100644
--- a/mode-icons.el
+++ b/mode-icons.el
@@ -22,7 +22,33 @@
 
 ;;; Commentary:
 
+;; This package provides a globalized minor mode that replaces the
+;; major mode name in your mode-line and places like Ibuffer with an
+;; icon.  Currently the following programming modes are supported,
+;; along with some other modes:
 ;;
+;; - CSS
+;; - Coffee
+;; - Emacs-Lisp
+;; - HTML
+;; - Haml
+;; - JavaScript
+;; - Lisp
+;; - nXML
+;; - PHP
+;; - Python
+;; - Ruby
+;; - Sass/Scss
+;; - Scheme
+;; - Shell-script
+;; - Slim
+;; - Snippet
+;; - Web
+;; - Yaml
+;;
+;; To enable this minor mode add the following line to your init file:
+;;
+;;     (mode-icons-mode)
 
 ;;; Code: