From d8206c1fcfdef1fa234fea1177699e0b09649b27 Mon Sep 17 00:00:00 2001
From: Simon Ruderich <simon@ruderich.org>
Date: Mon, 1 Feb 2010 13:03:20 +0100
Subject: [PATCH] zsh: Documentation updates.

---
 zsh/rc | 16 +++++++++-------
 1 file changed, 9 insertions(+), 7 deletions(-)

diff --git a/zsh/rc b/zsh/rc
index 34dc4ed..49843bc 100644
--- a/zsh/rc
+++ b/zsh/rc
@@ -187,9 +187,10 @@ fi
 # When a program is started preexec() sets the window's name to it; when it
 # stops precmd() resets the window's name to 'zsh'.
 #
-# It works with screen and xterm. If screen is running in X11 (DISPLAY is set)
-# and stumpwm is running then the window title is also set in stumpwm using
-# stumpish.
+# It works with screen, xterm and rxvt. If screen is running in X11 (DISPLAY
+# is set) and stumpwm is running then the window title is also set in stumpwm
+# using stumpish (I don't use stumpwm actually anymore but I left the changes
+# in as a reference).
 #
 # If a command is run with sudo or if the shell is running as root then a ! is
 # added at the beginning of the command to make this clear. If a command is
@@ -214,7 +215,7 @@ if [[ $TERM == screen* || $TERM == xterm* || $TERM == rxvt* ]]; then
         local program_name=$1
 
         # When sudo is used use real program name instead, but with an
-        # exclamation mark at the beginning.
+        # exclamation mark at the beginning (handled below).
         local program_sudo=
         if [[ $program_name == sudo* ]]; then
             program_name=${program_name#sudo }
@@ -316,7 +317,8 @@ fi
 # (coloring, scrollable).
 zmodload zsh/complist
 # Use new completion system, store dumpfile in ~/.zsh/cache to prevent
-# cluttering of ~/.
+# cluttering of ~/. $fpath must be set before calling this. Thanks to Adlai in
+# #zsh on Freenode (2009-08-07 21:05) for reminding me of the $fpath problem.
 autoload -U compinit && compinit -d ~/.zsh/cache/zcompdump
 
 # Use cache to speed up completions.
@@ -385,7 +387,7 @@ exec 2>>(while read line; do
 # Make sure aliases are expanded when using sudo.
 alias sudo='sudo '
 
-# Global aliases for often used commands used in the command line.
+# Global aliases for often used commands in the command line.
 alias -g E='2>&1'
 alias -g L='E | less'
 alias -g D='E | colordiff L'
@@ -500,7 +502,7 @@ fi
 # OS SPECIFIC SETTINGS
 
 if [[ $(uname) == Linux ]]; then
-    # Settings to create Debian packages.
+    # Settings when creating Debian packages.
     DEBEMAIL=simon@ruderich.org
     export DEBEMAIL
     DEBFULLNAME="Simon Ruderich"
-- 
2.44.2