diff options
-rwxr-xr-x | doc/cli.sh | 31 | ||||
l--------- | doc/code-box.css | 1 | ||||
l--------- | doc/common.css | 1 | ||||
-rw-r--r-- | doc/intro-epilogue.xhtml | 4 | ||||
-rw-r--r-- | doc/intro-prologue.xhtml | 38 | ||||
-rw-r--r-- | doc/intro.cli | 24 | ||||
l--------- | doc/intro.css | 1 | ||||
-rw-r--r-- | doc/intro.html2ps | 61 | ||||
l--------- | doc/pre-box.css | 1 | ||||
m--------- | doc/style | 0 |
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 © 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> </h1> + <h1> </h1> + <h1> </h1> + <h1> </h1> + <h1> </h1> + <h1> </h1> + <h1> </h1> + <h1> </h1> + <h1> </h1> +</div> + <p>Copyright © 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 |