Optionally include kdebuild-1 documentation.

kdebuild-1 is a new EAPI requested by the Gentoo KDE project for use in their
overlay. Having documentation of this format is useful for package manager
writers and kdebuild-1 ebuild authors, but we may or may not want to include it
in the PMS copy we'll submit to the Council. So we have options in pms.tex to
enable or disable inclusion -- edit the value of the ENABLE-KDEBUILD boolean as
appropriate (for now it's on by default). We also have an option to show what
PMS looks like both with and without ENABLE-KDEBUILD, by showing both sides of
conditionals in different colours. This is the ENABLE-ALL-OPTIONS boolean,
which is also enabled by default.

Squashed commit of the following:

commit 137e55e3a2712e5b1f9cbb5d168634ca68b2dbe9
Author: Ciaran McCreesh <ciaran.mccreesh@googlemail.com>
Date:   Tue Mar 18 07:24:14 2008 +0000

    Wording tweak

commit dcd912651f6d0bda15631ec3f16a306740decebc
Author: Ciaran McCreesh <ciaran.mccreesh@googlemail.com>
Date:   Tue Mar 18 06:56:25 2008 +0000

    Rewrite the "no magic mkdir" rules.

    The ban on magic mkdir voodoo gets really messy definition-wise if it's put on
    'into', since we don't want it to apply where the package manager is explicit.
    Reword it so that it just bans on explicit utilities.

commit e39c9d23614a37c3cd6f7e336598f27712cd4b0a
Author: Ciaran McCreesh <ciaran.mccreesh@googlemail.com>
Date:   Tue Mar 18 06:22:12 2008 +0000

    Optionally include kdebuild-1 documentation.

1 files changed, 26 insertions, 0 deletions

diff --git a/pms.tex b/pms.tex
index 9edbb56..c4e415c 100644
--- a/pms.tex
+++ b/pms.tex
@@ -36,6 +36,32 @@
 \newcommand{\TODOBUG}[2]{\fixme[inline]{(discussion on bug \##1) #2}}
 \newcommand{\TODO}[1]{\fixme[inline]{#1}}
 
+\usepackage{ifthen}
+\newboolean{ENABLE-ALL-OPTIONS}
+\newboolean{ENABLE-KDEBUILD}
+
+%%% Enable the below option if you'd like to see both sides of KDEBUILD conditionals shown in
+%%% different colours. Disable it to either fully enable or fully disable KDEBUILD.
+\setboolean{ENABLE-ALL-OPTIONS}{true}
+
+%%% Enable the below if you'd like to see KDEBUILD things.
+\setboolean{ENABLE-KDEBUILD}{true}
+
+\usepackage{color}
+\ifthenelse{\boolean{ENABLE-ALL-OPTIONS}}
+{
+    \definecolor{deepblue}{rgb}{0.0, 0.2, 0.7}
+    \definecolor{deeppurple}{rgb}{0.7, 0.0, 0.8}
+    \newcommand{\IFKDEBUILDELSE}[2]{{\color{deepblue} #1}{\color{deeppurple} #2}}
+}{
+    \ifthenelse{\boolean{ENABLE-KDEBUILD}}
+    {
+        \newcommand{\IFKDEBUILDELSE}[2]{ #1 }
+    }{
+        \newcommand{\IFKDEBUILDELSE}[2]{ #2 }
+    }
+}
+
 \hypersetup{%
   urlcolor=black,
   colorlinks=true,