+
+</section>
+<section>
+<h1>GRML-ZSHRC SPECIFIC STYLES</h1>
+
+<p>
+Styles are a context sensitive configuration mechanism included with zsh. The
+shell uses it extensively in sub-systems like the completion and the VCS info
+system. It lives outside of the classic shell variable namespace, so it avoids
+polluting it. New functionality in grml's zshrc will likely use styles instead
+of variables. Some features of the setup (like the directory stack handling)
+already use styles. Those styles are documented with the specific features.
+This section documents more general styles.
+</p>
+
+<section>
+<h2>Context: :grml:completion:compinit</h2>
+
+<p>
+This context revolves around the zshrc's <em>compinit</em> function call, that
+initialises zsh's function based completion system.
+</p>
+
+<dl>
+<dt><strong>arguments</strong></dt><dd>
+This style allows the injection of arguments to the command line that is used
+to run compinit. It is a list style and its default is the empty list. Using
+this style, it's possible to add <strong>-i</strong> to <em>compinit</em> in order to disable
+<em>compaudit</em>.
+\
+
+<pre>
+zstyle ':grml:completion:compinit' arguments -i
+</pre>
+
+\
+Only do this, if you know what sort of security checks are disabled if
+<em>compaudit</em> is not active and if that's acceptable with your specific setup.
+\
+This style has to be set at the point that Grml's zshrc runs <em>compinit</em>. A
+possible way to achieve this is to set it in <em>~/.zshrc.pre</em> (see AUXILIARY
+FILES below for details).
+</dd>
+</dl>
+
+</section>
+</section>
+<section>