From 74867e72f29f8850892bd30b9c5aa5272bc49d75 Mon Sep 17 00:00:00 2001
From: Eelco Dolstra <e.dolstra@tudelft.nl>
Date: Thu, 7 Aug 2003 14:17:18 +0000
Subject: [PATCH] * Start of manual; installation instructions.

---
 doc/manual/Makefile |   9 ++--
 doc/manual/book.xml | 102 ++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 107 insertions(+), 4 deletions(-)
 create mode 100644 doc/manual/book.xml

diff --git a/doc/manual/Makefile b/doc/manual/Makefile
index 95b472eee..52f17c65a 100644
--- a/doc/manual/Makefile
+++ b/doc/manual/Makefile
@@ -1,10 +1,11 @@
 DOCBOOK_DTD = /nix/current/xml/dtd/docbook
-DOCBOOK_XSL  =/nix/current/xml/xsl/docbook/
+DOCBOOK_XSL = /nix/current/xml/xsl/docbook
+
+all: check html
 
 check:
 	SP_CHARSET_FIXED=YES SP_ENCODING=XML \
-	nsgmls -wxml -c /usr/share/sgml/opensp/xml.soc -c $(DOCBOOK_DTD)/docbook.cat -ges book.xml
+	nsgmls -wxml -c /usr/share/doc/packages/sp/html-xml/xml.soc -c $(DOCBOOK_DTD)/docbook.cat -ges book.xml
 
 html:
-	mkdir -p out
-	xsltproc --output out/book.html $(DOCBOOK_XSL)/html/docbook.xsl book.xml
+	xsltproc --output book.html $(DOCBOOK_XSL)/html/docbook.xsl book.xml
diff --git a/doc/manual/book.xml b/doc/manual/book.xml
new file mode 100644
index 000000000..51fddadf1
--- /dev/null
+++ b/doc/manual/book.xml
@@ -0,0 +1,102 @@
+<?xml version="1.0"?>
+<!DOCTYPE book SYSTEM "/nix/current/xml/dtd/docbook/docbookx.dtd"
+[
+]>
+
+<book>
+  <title>Nix: The Manual</title>
+
+
+  <!--======================================================================-->
+
+  <chapter>
+    <title>Introduction</title>
+
+    <para>
+      Nix is a system for the automatic creation and distribution of data, such
+      as computer programs and other software artifacts.
+    </para>
+
+  </chapter>
+
+
+  <!--======================================================================-->
+
+  <chapter>
+    <title>Installation</title>
+
+    <sect1>
+      <title>Prerequisites</title>
+
+      <para>
+	Nix uses Sleepycat's Berkeley DB and CWI's ATerm library.  However,
+	these are fetched automatically as part of the build process.
+      </para>
+
+      <para>
+	Other than that, you need a good C++ compiler.  GCC 2.95 does not
+	appear to work; please use GCC 3.x.
+      </para>
+    </sect1>
+
+    <sect1>
+      <title>Obtaining Nix</title>
+
+      <para>
+	Nix can be obtained from its <ulink
+	  url='http://losser.st-lab.cs.uu.nl:12080/repos/trace/nix/trunk'>Subversion 
+	  repository</ulink>.  For example, the following command will check
+	out the latest revision into a directory called
+	<filename>nix</filename>:
+      </para>
+
+      <screen>
+$ svn checkout http://losser.st-lab.cs.uu.nl:12080/repos/trace/nix/trunk nix</screen>
+
+      <para>
+	Likewise, specific releases can be obtained from the <ulink
+	  url='http://losser.st-lab.cs.uu.nl:12080/repos/trace/nix/tags'>tags
+	  directory</ulink> of the repository.  If you don't have Subversion,
+	you can download a <ulink
+	  url='http://losser.st-lab.cs.uu.nl:12080/dist/trace/'>compressed
+	  tar-file</ulink> of the latest revision of the repository.
+      </para>
+
+    </sect1>
+
+    <sect1>
+      <title>Building Nix</title>
+
+      <para>
+	To build Nix, do the following:
+      </para>
+
+      <screen>
+$ autoreconf -i
+$ ./configure <replaceable>options...</replaceable>
+$ make
+$ make install</screen>
+
+      <para>
+	Currently, the only useful switch for <command>configure</command> is
+	<option>--prefix=<replaceable>prefix</replaceable></option> to specify
+	where Nix is to be installed.  The default installation directory is
+	<filename>/nix</filename>.  You can change this to any location you
+	like.  You should ensure that you have write permission to the
+	installation prefix. 
+      </para>
+
+      <warning>
+	<para>
+	  It is advisable <emphasis>not</emphasis> to change the installation
+	  prefix, since doing so will in all likelihood make it impossible to
+	  use derivates built on other systems.
+	</para>
+      </warning>
+
+    </sect1>
+
+  </chapter>
+
+
+</book>