aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorBoris Kolpackov <boris@codesynthesis.com>2016-02-11 12:14:44 +0200
committerBoris Kolpackov <boris@codesynthesis.com>2016-02-11 12:14:44 +0200
commit4d606849c74a2effc05a595368d2d0b48acf880e (patch)
tree5a9c09860864f087c83c4d9f704d8a4fe48ec3a4 /doc
parent5739fce028916724e08d62ef7f35f8faed1b94b1 (diff)
Setup manual infra
Diffstat (limited to 'doc')
-rw-r--r--doc/.gitignore3
l---------doc/a4.html2ps1
-rw-r--r--doc/buildfile15
-rwxr-xr-xdoc/cli.sh18
l---------doc/code-box.css1
l---------doc/doc-epilogue.xhtml1
l---------doc/doc-prologue.xhtml1
l---------doc/doc.css1
l---------doc/doc.html2ps1
l---------doc/letter.html2ps1
-rw-r--r--doc/manual.cli25
m---------doc/style0
l---------doc/toc.css1
13 files changed, 67 insertions, 2 deletions
diff --git a/doc/.gitignore b/doc/.gitignore
index ada8beb..7b6d42a 100644
--- a/doc/.gitignore
+++ b/doc/.gitignore
@@ -1,2 +1,5 @@
bpkg*.xhtml
bpkg*.1
+build2-package-manager-manual*.ps
+build2-package-manager-manual*.pdf
+build2-package-manager-manual.xhtml
diff --git a/doc/a4.html2ps b/doc/a4.html2ps
new file mode 120000
index 0000000..4b31c06
--- /dev/null
+++ b/doc/a4.html2ps
@@ -0,0 +1 @@
+style/a4.html2ps \ No newline at end of file
diff --git a/doc/buildfile b/doc/buildfile
index 39678d6..189eb83 100644
--- a/doc/buildfile
+++ b/doc/buildfile
@@ -33,5 +33,16 @@ xhtml{*}: extension = xhtml
./: {man1 xhtml}{bpkg bpkg-common-options $cmds} \
css{common pre-box man} \
file{man-prologue.1 man-epilogue.1 \
- man-prologue.xhtml man-epilogue.xhtml \
- cli.sh}
+ man-prologue.xhtml man-epilogue.xhtml}
+
+./: doc{build2-package-manager-manual.xhtml \
+ build2-package-manager-manual-a4.pdf \
+ build2-package-manager-manual-a4.ps \
+ build2-package-manager-manual-letter.pdf \
+ build2-package-manager-manual-letter.ps} \
+ css{code-box common doc pre-box toc} \
+ file{a4.html2ps letter.html2ps doc.html2ps} \
+ file{doc-prologue.xhtml doc-epilogue.xhtml \
+ manual.cli}
+
+./: file{cli.sh}
diff --git a/doc/cli.sh b/doc/cli.sh
index 25fe084..983f39a 100755
--- a/doc/cli.sh
+++ b/doc/cli.sh
@@ -13,6 +13,9 @@ while [ $# -gt 0 ]; do
case $1 in
--clean)
rm -f bpkg*.xhtml bpkg*.1
+ rm -f build2-package-manager-manual*.ps \
+ build2-package-manager-manual*.pdf \
+ build2-package-manager-manual.xhtml
exit 0
;;
*)
@@ -58,3 +61,18 @@ pkg-test pkg-uninstall pkg-unpack pkg-update pkg-verify rep-create rep-info"
for p in $pages; do
compile $p $o
done
+
+# Manual.
+#
+cli -I .. -v version="$version" -v date="$date" \
+--generate-html --html-suffix .xhtml \
+--html-prologue-file doc-prologue.xhtml \
+--html-epilogue-file doc-epilogue.xhtml \
+--link-regex '%b([-.].+)%../../build2/doc/b$1%' \
+--output-prefix build2-package-manager- manual.cli
+
+html2ps -f doc.html2ps:a4.html2ps -o build2-package-manager-manual-a4.ps build2-package-manager-manual.xhtml
+ps2pdf14 -sPAPERSIZE=a4 -dOptimize=true -dEmbedAllFonts=true build2-package-manager-manual-a4.ps build2-package-manager-manual-a4.pdf
+
+html2ps -f doc.html2ps:letter.html2ps -o build2-package-manager-manual-letter.ps build2-package-manager-manual.xhtml
+ps2pdf14 -sPAPERSIZE=letter -dOptimize=true -dEmbedAllFonts=true build2-package-manager-manual-letter.ps build2-package-manager-manual-letter.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/doc-epilogue.xhtml b/doc/doc-epilogue.xhtml
new file mode 120000
index 0000000..5111ca2
--- /dev/null
+++ b/doc/doc-epilogue.xhtml
@@ -0,0 +1 @@
+style/doc-epilogue.xhtml \ No newline at end of file
diff --git a/doc/doc-prologue.xhtml b/doc/doc-prologue.xhtml
new file mode 120000
index 0000000..e1fd108
--- /dev/null
+++ b/doc/doc-prologue.xhtml
@@ -0,0 +1 @@
+style/doc-prologue.xhtml \ No newline at end of file
diff --git a/doc/doc.css b/doc/doc.css
new file mode 120000
index 0000000..6cb3fd5
--- /dev/null
+++ b/doc/doc.css
@@ -0,0 +1 @@
+style/doc.css \ No newline at end of file
diff --git a/doc/doc.html2ps b/doc/doc.html2ps
new file mode 120000
index 0000000..dc19855
--- /dev/null
+++ b/doc/doc.html2ps
@@ -0,0 +1 @@
+style/doc.html2ps \ No newline at end of file
diff --git a/doc/letter.html2ps b/doc/letter.html2ps
new file mode 120000
index 0000000..607ca58
--- /dev/null
+++ b/doc/letter.html2ps
@@ -0,0 +1 @@
+style/letter.html2ps \ No newline at end of file
diff --git a/doc/manual.cli b/doc/manual.cli
new file mode 100644
index 0000000..8fe03bf
--- /dev/null
+++ b/doc/manual.cli
@@ -0,0 +1,25 @@
+// file : doc/manual.cli
+// copyright : Copyright (c) 2014-2016 Code Synthesis Ltd
+// license : MIT; see accompanying LICENSE file
+
+"\name=build2-package-manager-manual"
+"\subject=package manager"
+"\title=Package Manager"
+
+// NOTES
+//
+// - Maximum <pre> line is 70 characters.
+//
+
+"
+\h0#preface|Preface|
+
+This is the preface.
+"
+
+/*
+"
+\h Installation
+"
+source "../INSTALL.cli";
+*/
diff --git a/doc/style b/doc/style
-Subproject 88bef7fa19d595b64944edc38696bb1ceadba2f
+Subproject e8d8ccfbd637d68f6feceace9dddc5bd5c13d83
diff --git a/doc/toc.css b/doc/toc.css
new file mode 120000
index 0000000..477b331
--- /dev/null
+++ b/doc/toc.css
@@ -0,0 +1 @@
+style/toc.css \ No newline at end of file