aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rwxr-xr-xdoc/cli.sh31
l---------doc/code-box.css1
l---------doc/common.css1
-rw-r--r--doc/intro-epilogue.xhtml4
-rw-r--r--doc/intro-prologue.xhtml38
-rw-r--r--doc/intro.cli24
l---------doc/intro.css1
-rw-r--r--doc/intro.html2ps61
l---------doc/pre-box.css1
m---------doc/style0
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