diff --git a/NEWS b/NEWS
deleted file mode 100644
index ae7caa82b4f..00000000000
--- a/NEWS
+++ /dev/null
@@ -1,48 +0,0 @@
-Nix Packages 0.8 (April 11, 2005)
-
-* This release is mostly to remain synchronised with the changed
- hashing scheme in Nix 0.8.
-
-* Notable updates:
-
- - Adobe Reader 7.0
- - Various security updates (zlib 1.2.2, etc.)
-
-
-Nix Packages 0.7 (March 14, 2005)
-
-* The bootstrap process for the standard build environment on Linux
- (stdenv-linux) has been improved. It is no longer dependent in its
- initial bootstrap stages on the system Glibc, GCC, and other tools.
- Rather, Nixpkgs contains a statically linked bash and curl, and uses
- that to download other statically linked tools. These are then used
- to build a Glibc and dynamically linked versions of all other
- tools.
-
- This change also makes the bootstrap process faster. For instance,
- GCC is built only once instead of three times.
-
- (Contributed by Armijn Hemel.)
-
-* Tarballs used by Nixpkgs are now obtained from the same server that
- hosts Nixpkgs (catamaran.labs.cs.uu.nl). This reduces the risk of
- packages being unbuildable due to moved or deleted files on various
- servers.
-
-* There now is a generic mechanism for building Perl modules. See the
- various Perl modules defined in pkgs/system/all-packages-generic.nix.
-
-* Notable new packages:
-
- - Qt 3
- - MySQL
- - MythTV
- - Mono
- - MonoDevelop (alpha)
- - Xine
-
-* Notable updates:
-
- - GCC 3.4.3
- - Glibc 2.3.4
- - GTK 2.6
diff --git a/doc/Makefile b/doc/Makefile
new file mode 100644
index 00000000000..c84facb435b
--- /dev/null
+++ b/doc/Makefile
@@ -0,0 +1,27 @@
+ENV = SGML_CATALOG_FILES=$(docbookcatalog)
+
+XMLLINT = $(ENV) xmllint --catalogs
+XSLTPROC = $(ENV) xsltproc --catalogs \
+ --param section.autolabel 1 \
+ --param section.label.includes.component.label 1 \
+ --param html.stylesheet \'style.css\' \
+ --param xref.with.number.and.title 1 \
+ --param toc.section.depth 3
+
+NEWS_OPTS = \
+ --stringparam generate.toc "article nop" \
+ --stringparam section.autolabel.max.depth 0 \
+ --stringparam header.rule 0
+
+all: NEWS.html NEWS.txt
+
+NEWS.html: release-notes.xml
+ $(XSLTPROC) --nonet --xinclude --output $@ $(NEWS_OPTS) \
+ $(docbookxsl)/html/docbook.xsl release-notes.xml
+
+NEWS.txt: release-notes.xml
+ $(XSLTPROC) --nonet --xinclude quote-literals.xsl release-notes.xml | \
+ $(XSLTPROC) --nonet --output $@.tmp.html $(NEWS_OPTS) \
+ $(docbookxsl)/html/docbook.xsl -
+ LANG=en_US w3m -dump $@.tmp.html > $@
+ rm $@.tmp.html
diff --git a/doc/quote-literals.xsl b/doc/quote-literals.xsl
new file mode 100644
index 00000000000..983f5ac3506
--- /dev/null
+++ b/doc/quote-literals.xsl
@@ -0,0 +1,40 @@
+
+
+
+
+
+
+ `'
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/doc/release-notes.xml b/doc/release-notes.xml
new file mode 100644
index 00000000000..5a413abe6b7
--- /dev/null
+++ b/doc/release-notes.xml
@@ -0,0 +1,124 @@
+
+
+
+Nixpkgs Release Notes
+
+
+Release 0.9 (January 31, 2006)
+
+There have been zillions of changes since the last release of
+Nixpkgs. Among the more notable are:
+
+
+
+ Distribution files have been moved to ).
+
+
+
+
+
+
+Release 0.8 (April 11, 2005)
+
+This release is mostly to remain synchronised with the changed
+hashing scheme in Nix 0.8.
+
+Notable updates:
+
+
+
+ Adobe Reader 7.0
+
+ Various security updates (zlib 1.2.2, etc.)
+
+
+
+
+
+
+
+
+Release 0.7 (March 14, 2005)
+
+
+
+
+
+ The bootstrap process for the standard build
+ environment on Linux (stdenv-linux) has been improved. It is no
+ longer dependent in its initial bootstrap stages on the system
+ Glibc, GCC, and other tools. Rather, Nixpkgs contains a statically
+ linked bash and curl, and uses that to download other statically
+ linked tools. These are then used to build a Glibc and dynamically
+ linked versions of all other tools.
+
+ This change also makes the bootstrap process faster. For
+ instance, GCC is built only once instead of three times.
+
+ (Contributed by Armijn Hemel.)
+
+
+
+
+
+ Tarballs used by Nixpkgs are now obtained from the same server
+ that hosts Nixpkgs ().
+ This reduces the risk of packages being unbuildable due to moved or
+ deleted files on various servers.
+
+
+
+
+
+ There now is a generic mechanism for building Perl modules.
+ See the various Perl modules defined in
+ pkgs/system/all-packages-generic.nix.
+
+
+
+
+
+ Notable new packages:
+
+
+
+ Qt 3
+ MySQL
+ MythTV
+ Mono
+ MonoDevelop (alpha)
+ Xine
+
+
+
+
+
+
+
+
+
+ Notable updates:
+
+
+
+ GCC 3.4.3
+ Glibc 2.3.4
+ GTK 2.6
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/doc/style.css b/doc/style.css
new file mode 100644
index 00000000000..bf6fc3ecf43
--- /dev/null
+++ b/doc/style.css
@@ -0,0 +1,234 @@
+/* Copied from http://bakefile.sourceforge.net/, which appears
+ licensed under the GNU GPL. */
+
+
+/***************************************************************************
+ Basic headers and text:
+ ***************************************************************************/
+
+body
+{
+ font-family: sans-serif;
+ background: white;
+
+ margin: 2em 1em 2em 1em;
+}
+
+h1,h2,h3
+{
+ color: #005aa0;
+ text-align: left;
+}
+
+h1 /* title */
+{
+ font-size: 200%;
+}
+
+h2 /* chapters, appendices, subtitle */
+{
+ font-size: 180%;
+}
+
+/* Extra space between chapters, appendices. */
+div.chapter > div.titlepage h2, div.appendix > div.titlepage h2
+{
+ margin-top: 1.5em;
+/* border-top: solid #005aa0; */
+}
+
+div.sect1 h2 /* sections */
+{
+ font-size: 150%;
+}
+
+div.refnamediv h2, div.refsynopsisdiv h2, div.refsection h2 /* refentry parts */
+{
+ font-size: 125%;
+}
+
+div.refsection h3
+{
+ font-size: 110%;
+}
+
+h3 /* subsections */
+{
+ font-size: 125%;
+}
+
+
+
+/***************************************************************************
+ Program listings:
+ ***************************************************************************/
+
+div.example
+{
+ border: 1px solid #6185a0;
+ padding: 6px 6px;
+ margin-left: 3em;
+ margin-right: 3em;
+ background: #eeeeee;
+}
+
+pre.programlisting
+{
+ color: #600000;
+ font-family: monospace;
+}
+
+
+/***************************************************************************
+ Screen dumps:
+ ***************************************************************************/
+
+pre.screen
+{
+ border: 1px solid #6185a0;
+ padding: 6px 6px;
+ margin-left: 3em;
+ margin-right: 3em;
+ color: #600000;
+ background: #eeeeee;
+ font-family: monospace;
+ /* font-size: 90%; */
+}
+
+
+/***************************************************************************
+ Notes, warnings etc:
+ ***************************************************************************/
+
+.note,.warning
+{
+ margin-top: 1em;
+ margin-bottom: 1em;
+ border: 1px solid #6185a0;
+ padding: 0px 1em;
+ background: #fffff5;
+}
+
+div.note,div.warning
+{
+ font-style: italic;
+}
+
+div.warning h3
+{
+ color: red;
+ font-size: 100%;
+}
+
+div.note h3
+{
+ color: blue;
+ font-size: 100%;
+}
+
+div.navfooter *
+{
+ font-size: 90%;
+}
+
+
+/***************************************************************************
+ Links colors and highlighting:
+ ***************************************************************************/
+
+a:link { color: #0048b3; }
+a:visited { color: #002a6a; }
+a:hover { background: #ffffcd; }
+
+
+/***************************************************************************
+ Table of contents:
+ ***************************************************************************/
+
+.toc
+{
+ font-size: 90%;
+}
+
+
+
+/***************************************************************************
+ Special elements:
+ ***************************************************************************/
+
+tt, code
+{
+ color: #400000;
+}
+
+.term
+{
+ font-weight: bold;
+
+}
+
+div.variablelist dd
+{
+ margin-bottom: 1em;
+}
+
+.default
+{
+ font-style: italic;
+}
+
+.availability
+{
+ font-style: italic;
+}
+
+.varname
+{
+ color: #400000;
+}
+
+
+div.informaltable table
+{
+ border: 1px solid #6185a0;
+ width: 100%;
+}
+
+div.informaltable td
+{
+ border: 0;
+ padding: 5px;
+}
+
+div.informaltable td.default
+{
+ text-align: right;
+}
+
+div.informaltable th
+{
+ text-align: left;
+ color: #005aa0;
+ border: 0;
+ padding: 5px;
+ background: #fffff5;
+ font-weight: normal;
+ font-style: italic;
+}
+
+td.varname, td.tagname, td.paramname
+{
+ font-weight: bold;
+ vertical-align: top;
+}
+
+div.epigraph
+{
+ font-style: italic;
+ text-align: right;
+}
+
+table.productionset table.productionset
+{
+ font-family: monospace;
+}