nix-gh/doc/manual/manual.xml

<?xml version="1.0"?>
<!DOCTYPE book
    PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
    "http://www.docbook.org/xml/4.3/docbook-xml-4.3.zip"
[
]>

<book>
  <title>Nix User's Guide</title>

  <subtitle>Draft (Version <xi:include
  xmlns:xi="http://www.w3.org/2001/XInclude"
  href="version.txt" parse="text" />)</subtitle>
  
  <bookinfo>
    <author>
      <firstname>Eelco</firstname>
      <surname>Dolstra</surname>
    </author>
    <copyright>
      <year>2004</year>
      <year>2005</year>
      <year>2006</year>
      <holder>Eelco Dolstra</holder>
    </copyright>
  </bookinfo>
  
  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="introduction.xml" />
  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="quick-start.xml" />
  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="installation.xml" />
  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="package-management.xml" />
  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="writing-nix-expressions.xml" />
  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="build-farm.xml" />

  <appendix>
    <title>Command Reference</title>
    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="opt-common.xml" />
    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="env-common.xml" />
    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="conf-file.xml" />
    <sect1 id="sec-nix-env">
      <title>nix-env</title>
      <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="nix-env.xml" />
    </sect1>
    <sect1 id="sec-nix-build">
      <title>nix-build</title>
      <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="nix-build.xml" />
    </sect1>
    <sect1>
      <title>nix-store</title>
      <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="nix-store.xml" />
    </sect1>
    <sect1 id="sec-nix-instantiate">
      <title>nix-instantiate</title>
      <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="nix-instantiate.xml" />
    </sect1>
    <sect1>
      <title>nix-collect-garbage</title>
      <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="nix-collect-garbage.xml" />
    </sect1>
    <sect1 id="sec-nix-channel">
      <title>nix-channel</title>
      <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="nix-channel.xml" />
    </sect1>
    <sect1>
      <title>nix-push</title>
      <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="nix-push.xml" />
    </sect1>
    <sect1>
      <title>nix-pull</title>
      <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="nix-pull.xml" />
    </sect1>
    <sect1>
      <title>nix-prefetch-url</title>
      <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="nix-prefetch-url.xml" />
    </sect1>
  </appendix>

  <!--  &nix-lang-ref; -->

  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="troubleshooting.xml" />
  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="bugs.xml" />
  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="glossary.xml" />

  <appendix>
    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="release-notes.xml"
                xpointer="xpointer(article/*)" />
  </appendix>
    
</book>
* Start of manual; installation instructions. 2003-08-07 16:17:18 +02:00			`<?xml version="1.0"?>`
* Use xmllint instead of nsgmls to validate the manual. 2003-08-14 20:17:02 +02:00			`<!DOCTYPE book`
* EBNF grammar for the Nix expression language. 2004-04-08 15:31:57 +02:00			`PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"`
* Drop the grammar appendix. 2004-11-07 21:36:10 +01:00			`"http://www.docbook.org/xml/4.3/docbook-xml-4.3.zip"`
			`[`
* Start of manual; installation instructions. 2003-08-07 16:17:18 +02:00			`]>`

			`<book>`
* Better introduction. * Set notes in a different color than warnings. 2004-10-13 17:08:35 +02:00			`<title>Nix User's Guide</title>`
* Start of manual; installation instructions. 2003-08-07 16:17:18 +02:00
* XInclude all the way. 2005-03-15 14:55:41 +01:00			`<subtitle>Draft (Version <xi:include`
			`xmlns:xi="http://www.w3.org/2001/XInclude"`
			`href="version.txt" parse="text" />)</subtitle>`
* Include version number in manual. 2004-01-08 11:45:23 +01:00
* Manual updates. 2003-08-13 17:17:57 +02:00			`<bookinfo>`
			`<author>`
			`<firstname>Eelco</firstname>`
			`<surname>Dolstra</surname>`
			`</author>`
			`<copyright>`
* Nix Quick Start guide. 2004-01-20 16:37:55 +01:00			`<year>2004</year>`
* Manual updates. 2005-03-15 14:21:32 +01:00			`<year>2005</year>`
* Update copyright. 2006-03-15 13:58:22 +01:00			`<year>2006</year>`
* Manual updates. 2003-08-13 17:17:57 +02:00			`<holder>Eelco Dolstra</holder>`
			`</copyright>`
			`</bookinfo>`
* XInclude all the way. 2005-03-15 14:55:41 +01:00
			`<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="introduction.xml" />`
			`<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="quick-start.xml" />`
			`<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="installation.xml" />`
			`<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="package-management.xml" />`
			`<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="writing-nix-expressions.xml" />`
			`<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="build-farm.xml" />`
* Started on the introduction. 2003-08-07 17:27:14 +02:00
* Generate man pages from the manual. 2003-08-12 15:54:42 +02:00			`<appendix>`
			`<title>Command Reference</title>`
* Documented common environment variables. 2005-03-16 17:45:29 +01:00			`<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="opt-common.xml" />`
			`<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="env-common.xml" />`
* Lots of manual updates, in particular the new `nix-store --query' options were documented, as well as the Nix configuration file. 2005-04-08 15:00:38 +02:00			`<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="conf-file.xml" />`
* Manual updates. 2005-04-10 22:54:21 +02:00			`<sect1 id="sec-nix-env">`
* Start of nix-env reference. * Some CSS tweaks. 2004-01-08 17:56:40 +01:00			`<title>nix-env</title>`
* XInclude all the way. 2005-03-15 14:55:41 +01:00			`<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="nix-env.xml" />`
* Start of nix-env reference. * Some CSS tweaks. 2004-01-08 17:56:40 +01:00			`</sect1>`
* More manual updates. 2005-04-07 12:47:58 +02:00			`<sect1 id="sec-nix-build">`
			`<title>nix-build</title>`
			`<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="nix-build.xml" />`
			`</sect1>`
* Man pages in sections. 2003-12-21 22:57:09 +01:00			`<sect1>`
			`<title>nix-store</title>`
* XInclude all the way. 2005-03-15 14:55:41 +01:00			`<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="nix-store.xml" />`
* Man pages in sections. 2003-12-21 22:57:09 +01:00			`</sect1>`
* More manual updates. 2005-04-07 12:47:58 +02:00			`<sect1 id="sec-nix-instantiate">`
* Man pages in sections. 2003-12-21 22:57:09 +01:00			`<title>nix-instantiate</title>`
* XInclude all the way. 2005-03-15 14:55:41 +01:00			`<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="nix-instantiate.xml" />`
* Man pages in sections. 2003-12-21 22:57:09 +01:00			`</sect1>`
* Lots of manual stuff. Reference pages for most Nix commands. * nix-pull now requires the full url to the manifest, i.e., `/MANIFEST/' is no longer automatically appended. * nix-prefetch-url works again. 2004-02-10 17:14:47 +01:00			`<sect1>`
			`<title>nix-collect-garbage</title>`
* XInclude all the way. 2005-03-15 14:55:41 +01:00			`<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="nix-collect-garbage.xml" />`
* Lots of manual stuff. Reference pages for most Nix commands. * nix-pull now requires the full url to the manifest, i.e., `/MANIFEST/' is no longer automatically appended. * nix-prefetch-url works again. 2004-02-10 17:14:47 +01:00			`</sect1>`
* Document nix-channel. 2005-04-09 19:16:00 +02:00			`<sect1 id="sec-nix-channel">`
			`<title>nix-channel</title>`
			`<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="nix-channel.xml" />`
			`</sect1>`
* Lots of manual stuff. Reference pages for most Nix commands. * nix-pull now requires the full url to the manifest, i.e., `/MANIFEST/' is no longer automatically appended. * nix-prefetch-url works again. 2004-02-10 17:14:47 +01:00			`<sect1>`
			`<title>nix-push</title>`
* XInclude all the way. 2005-03-15 14:55:41 +01:00			`<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="nix-push.xml" />`
* Lots of manual stuff. Reference pages for most Nix commands. * nix-pull now requires the full url to the manifest, i.e., `/MANIFEST/' is no longer automatically appended. * nix-prefetch-url works again. 2004-02-10 17:14:47 +01:00			`</sect1>`
			`<sect1>`
			`<title>nix-pull</title>`
* XInclude all the way. 2005-03-15 14:55:41 +01:00			`<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="nix-pull.xml" />`
* Lots of manual stuff. Reference pages for most Nix commands. * nix-pull now requires the full url to the manifest, i.e., `/MANIFEST/' is no longer automatically appended. * nix-prefetch-url works again. 2004-02-10 17:14:47 +01:00			`</sect1>`
			`<sect1>`
			`<title>nix-prefetch-url</title>`
* XInclude all the way. 2005-03-15 14:55:41 +01:00			`<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="nix-prefetch-url.xml" />`
* Lots of manual stuff. Reference pages for most Nix commands. * nix-pull now requires the full url to the manifest, i.e., `/MANIFEST/' is no longer automatically appended. * nix-prefetch-url works again. 2004-02-10 17:14:47 +01:00			`</sect1>`
* Generate man pages from the manual. 2003-08-12 15:54:42 +02:00			`</appendix>`

* XInclude all the way. 2005-03-15 14:55:41 +01:00			`<!-- &nix-lang-ref; -->`
* EBNF grammar for the Nix expression language. 2004-04-08 15:31:57 +02:00
* XInclude all the way. 2005-03-15 14:55:41 +01:00			`<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="troubleshooting.xml" />`
			`<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="bugs.xml" />`
* Added a glossary to the manual. 2005-04-01 17:34:23 +02:00			`<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="glossary.xml" />`
* Started on the introduction. 2003-08-07 17:27:14 +02:00
* Include the release notes in the manual. 2005-09-16 10:47:34 +02:00			`<appendix>`
			`<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="release-notes.xml"`
			`xpointer="xpointer(article/*)" />`
			`</appendix>`

* Start of manual; installation instructions. 2003-08-07 16:17:18 +02:00			`</book>`