10 files changed, 160 insertions, 2 deletions
diff --git a/doc/cli.sh b/doc/cli.sh
new file mode 100755
index 0000000..c315efa
--- /dev/null
+++ b/doc/cli.sh
@@ -0,0 +1,31 @@
+#! /usr/bin/env bash
+
+version="0.2" # 0.2.0
+date="January 2016"
+
+trap 'exit 1' ERR
+set -o errtrace # Trap in functions.
+
+function info () { echo "$*" 1>&2; }
+function error () { info "$*"; exit 1; }
+
+while [ $# -gt 0 ]; do
+  case $1 in
+    --clean)
+      rm -f build2-toolchain-intro.xhtml build2-toolchain-intro.ps \
+build2-toolchain-intro.pdf
+      exit 0
+      ;;
+    *)
+      error "unexpected $1"
+      ;;
+  esac
+done
+
+cli -I .. -v version="$version" -v date="$date" --generate-html \
+--html-prologue-file intro-prologue.xhtml \
+--html-epilogue-file intro-epilogue.xhtml \
+--html-suffix .xhtml --output-prefix build2-toolchain- intro.cli
+
+#html2ps -f intro.html2ps -o build2-toolchain-intro.ps build2-toolchain-intro.xhtml
+#ps2pdf14 build2-toolchain-intro.ps build2-toolchain-intro.pdf
diff --git a/doc/code-box.css b/doc/code-box.css
new file mode 120000
index 0000000..e442993
--- /dev/null
+++ b/doc/code-box.css
@@ -0,0 +1 @@
+style/code-box.css
+\ No newline at end of file
diff --git a/doc/common.css b/doc/common.css
new file mode 120000
index 0000000..3ddf6fc
--- /dev/null
+++ b/doc/common.css
@@ -0,0 +1 @@
+style/common.css
+\ No newline at end of file
diff --git a/doc/intro-epilogue.xhtml b/doc/intro-epilogue.xhtml
new file mode 100644
index 0000000..aa5a7c3
--- /dev/null
+++ b/doc/intro-epilogue.xhtml
@@ -0,0 +1,4 @@
+</div>
+
+</body>
+</html>
diff --git a/doc/intro-prologue.xhtml b/doc/intro-prologue.xhtml
new file mode 100644
index 0000000..a6362cf
--- /dev/null
+++ b/doc/intro-prologue.xhtml
@@ -0,0 +1,38 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml">
+<head>
+  <meta charset="UTF-8"/>
+  <meta name="viewport" content="width=device-width, initial-scale=1"/>
+  <meta name="version" content="$version$"/>
+
+  <title>The build2 Toolchain Introduction</title>
+
+  <style type="text/css">
+$./common.css$
+$./pre-box.css$
+$./code-box.css$
+$./intro.css$
+  </style>
+
+</head>
+<body>
+<div id="content">
+
+  <div class="noprint"> <!-- Exclude from html2ps. -->
+
+  <div id="titlepage">
+    <div class="title">The <code>build2</code> Toolchain Introduction</div>
+
+    <p>Copyright &#169; 2014-2016 <a href="http://codesynthesis.com">Code
+    Synthesis Ltd</a><br/>
+    Permission is granted to copy, distribute and/or modify this document
+    under the terms of the MIT License.</p>
+
+    <p id="revision">Revision <code>$version$</code>, $date$<br/>
+    This revision of the document describes the <code>build2</code>
+    toolchain <code>$version$.x</code> series and is available in the following
+    formats: <a href="$name$.xhtml">XHTML</a>, <a href="$name$.pdf">PDF</a>,
+    and <a href="$name$.ps">PostScript</a>.</p>
+  </div>
+
+  </div> <!-- noprint -->
diff --git a/doc/intro.cli b/doc/intro.cli
index dce9fc4..6e27b72 100644
--- a/doc/intro.cli
+++ b/doc/intro.cli
@@ -14,8 +14,6 @@
 //
 // STYLE
 //
-// @@ letter spacing
-// @@ links in <code> have underline in spaces.
 // @@ section boundary page breaks (<hr class="page-break"/>)
 // @@ when printed, code background is gone, but spaces still there
 
@@ -24,6 +22,28 @@
 // - Maximum <pre> line is 70 characters.
 //
 
+/*
+
+$ mkdir hello-mingw32
+$ cd hello-mingw32
+$ bpkg create cxx config.cxx=i686-w64-mingw32-g++ config.bin.ar=i686-w64-mingw32-ar config.bin.lib=static config.cxx.loptions=-static
+bpkg create -d . --wipe cxx config.cxx=x86_64-w64-mingw32-g++ config.bin.ar=x86_64-w64-mingw32-ar config.bin.lib=static config.cxx.loptions=-static
+created new configuration in /tmp/hello-mingw32/
+
+$ bpkg add https://build2.org/pkg/1/hello/stable
+added repository build2.org/hello/stable
+
+$ bpkg fetch
+fetching build2.org/hello/stable
+2 package(s) in 1 repository(s)
+
+$ bpkg build -y hello
+
+$ wine hello-1.0.0/hello.exe Windows
+Hello, Windows!
+
+*/
+
 "
 \h|TL;DR|
 
diff --git a/doc/intro.css b/doc/intro.css
new file mode 120000
index 0000000..71895c7
--- /dev/null
+++ b/doc/intro.css
@@ -0,0 +1 @@
+style/intro.css
+\ No newline at end of file
diff --git a/doc/intro.html2ps b/doc/intro.html2ps
new file mode 100644
index 0000000..051e384
--- /dev/null
+++ b/doc/intro.html2ps
@@ -0,0 +1,61 @@
+@html2ps {
+  option {
+    toc: hb;
+    colour: 1;
+    hyphenate: 1;
+    titlepage: 1;
+  }
+
+  datefmt: "%B %Y";
+
+  titlepage {
+    content: "
+<div align=center>
+  <h1><big>The <code>build2</code> Toolchain Introduction</big></h1>
+  <h1>&nbsp;</h1>
+  <h1>&nbsp;</h1>
+  <h1>&nbsp;</h1>
+  <h1>&nbsp;</h1>
+  <h1>&nbsp;</h1>
+  <h1>&nbsp;</h1>
+  <h1>&nbsp;</h1>
+  <h1>&nbsp;</h1>
+  <h1>&nbsp;</h1>
+</div>
+  <p>Copyright &copy; 2014-2016 Code Synthesis Ltd<br/>
+  Permission is granted to copy, distribute and/or modify this document under
+  the terms of the MIT License.</p>
+
+  <p>Revision $[version], $D<br/>
+  This revision of the document describes the <code>build2</code> toolchain
+  <code>$[version].x</code> series.</p>";
+  }
+
+  toc {
+    indent: 2em;
+  }
+
+  header {
+    odd-right: $H;
+    even-left: $H;
+  }
+
+  footer {
+    odd-left: Revision $[version], $D;
+    odd-center: $T;
+    odd-right: $N;
+
+    even-left: $N;
+    even-center: $T;
+    even-right: Revision $[version], $D;
+  }
+}
+
+body {
+  font-size: 12pt;
+  text-align: justify;
+}
+
+pre {
+  font-size: 10pt;
+}
diff --git a/doc/pre-box.css b/doc/pre-box.css
new file mode 120000
index 0000000..b9ec76c
--- /dev/null
+++ b/doc/pre-box.css
@@ -0,0 +1 @@
+style/pre-box.css
+\ No newline at end of file
diff --git a/doc/style b/doc/style
-Subproject 9510963c900770f86f80b98f07deb8242448b11
+Subproject fe9e7121d07c5a134559f02d5dc46cceb3f276c