better phrasing/documentation

themes/dieter.zsh-theme

@@ -1,20 +1,22 @@
-# the idea of this theme is to contain a lot of info in a small string, by compressing some parts,
+# the idea of this theme is to contain a lot of info in a small string, by
-# and colorcoding, which bring useful visual cues.  While limiting the amount of colors and such to keep
+# compressing some parts and colorcoding, which bring useful visual cues,
-# it easy on the eyes
+# while limiting the amount of colors and such to keep it easy on the eyes.
-# exact return code (when >0) is on the right, so it stays out of the way
+# When a command exited >0, the timestamp will be in red and the exit code
-# The visual cues for >0 exit codes will only display once
+# will be on the right edge.
+# The exit code visual cues will only display once.
 # (i.e. they will be reset, even if you hit enter a few times on empty command prompts)
 
 typeset -A host_repr
-host_repr=('dieter-ws-a7n8x-arch' "%{$fg_bold[green]%}ws" 'dieter-p4sci-arch' "%{$fg_bold[blue]%}p4")
 
+# translate hostnames into shortened, colorcoded strings
+host_repr=('dieter-ws-a7n8x-arch' "%{$fg_bold[green]%}ws" 'dieter-p4sci-arch' "%{$fg_bold[blue]%}p4")
 
-# local time, color coded after last return code
+# local time, color coded by last return code
 time_enabled="%(?.%{$fg[green]%}.%{$fg[red]%})%*%{$reset_color%}"
 time_disabled="%{$fg[green]%}%*%{$reset_color%}"
 time=$time_enabled
 
-# user part, color coded after privileges
+# user part, color coded by privileges
 local user="%(!.%{$fg[blue]%}.%{$fg[blue]%})%n%{$reset_color%}"
 
 # Hostname part.  compressed and colorcoded per host_repr array
@@ -26,7 +28,8 @@ local pwd="%{$fg[blue]%}%c%{$reset_color%}"
 
 PROMPT='${time} ${user}${host} ${pwd} $(git_prompt_info)'
 
-# i would prefer 1 icon that shows the "most drastic" deviation from head, but lets see how this works out
+# i would prefer 1 icon that shows the "most drastic" deviation from HEAD,
+# but lets see how this works out
 ZSH_THEME_GIT_PROMPT_PREFIX="%{$fg[yellow]%}"
 ZSH_THEME_GIT_PROMPT_SUFFIX="%{$reset_color%} "
 ZSH_THEME_GIT_PROMPT_DIRTY="%{$fg[green]%} %{$fg[yellow]%}?%{$fg[green]%}%{$reset_color%}"