+
+<p>
+The <em>grmlzshrc</em> now supplies three prompt themes compatible with zsh's
+<strong>promptinit</strong> system. The three themes are called <strong>grml</strong>, <strong>grml-large</strong> and
+<strong>grml-chroot</strong>.
+</p>
+<p>
+By default, <strong>grml</strong> is used, unless <em>$GRMLPROMPT</em> is set to a value larger
+than zero, in which case <strong>grml-large</strong> is used. Lastly, if <em>$GRML_CHROOT</em> is
+non-empty, <strong>grml-chroot</strong> is used.
+</p>
+<p>
+As usual, with promptinit themes, the user may switch to a different theme using
+the <em>prompt</em> utility:
+\
+</p>
+
+<pre>
+ prompt grml-large
+</pre>
+
+<p>
+That will use the <strong>grml-large</strong> prompt theme.
+</p>
+<p>
+The themes are highly customisable. The main source of documentation about
+customisation is the main <strong>grml</strong> theme's doc-string, that is available via
+the following command:
+\
+</p>
+
+<pre>
+ prompt -h grml
+</pre>
+
+<p>
+The other themes also come with doc-strings, but the main theme's is the
+canonical reference about all of them.
+</p>
+<p>
+This feature requires version <em>4.3.7</em> of the shell. Older versions will use
+the classic grml prompt as a fallback.
+</p>
+<p>
+A note to people who like customisation: If you are <strong>not</strong> using a prompt
+theme for your customisation, but you're either statically setting $PS1 (or
+$PROMPT) or you're constructing one of those variables in zsh's \`precmd()'
+function, make sure you are turning the zsh's prompt theme system <strong>off</strong>
+before doing so. A correct example customisation could look like this:
+\
+</p>
+
+<pre>
+ # Turn the prompt system off:
+ prompt off
+ # Customise the prompt yourself:
+ PS1='%~ %# '
+</pre>
+
+<p>
+You also add your own tokens by using the \`grml_theme_add_token()' function.
+Call the function without arguments for detailed documentation about that
+procedure.
+</p>
+
+</section>
+<section>