nix-super/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>
      <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" />

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

			`<book>`
* Better introduction. * Set notes in a different color than warnings. 2004-10-13 18:08:35 +03:00			`<title>Nix User's Guide</title>`
* Start of manual; installation instructions. 2003-08-07 17:17:18 +03:00
* XInclude all the way. 2005-03-15 15:55:41 +02: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 12:45:23 +02:00
* Manual updates. 2003-08-13 18:17:57 +03:00			`<bookinfo>`
			`<author>`
			`<firstname>Eelco</firstname>`
			`<surname>Dolstra</surname>`
			`</author>`
			`<copyright>`
* Nix Quick Start guide. 2004-01-20 17:37:55 +02:00			`<year>2004</year>`
* Manual updates. 2005-03-15 15:21:32 +02:00			`<year>2005</year>`
* Manual updates. 2003-08-13 18:17:57 +03:00			`<holder>Eelco Dolstra</holder>`
			`</copyright>`
			`</bookinfo>`
* XInclude all the way. 2005-03-15 15:55:41 +02: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 18:27:14 +03:00
* Generate man pages from the manual. 2003-08-12 16:54:42 +03:00			`<appendix>`
			`<title>Command Reference</title>`
* Documented common environment variables. 2005-03-16 18:45:29 +02: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 16:00:38 +03:00			`<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="conf-file.xml" />`
* Manual updates. 2005-04-10 23:54:21 +03:00			`<sect1 id="sec-nix-env">`
* Start of nix-env reference. * Some CSS tweaks. 2004-01-08 18:56:40 +02:00			`<title>nix-env</title>`
* XInclude all the way. 2005-03-15 15:55:41 +02: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 18:56:40 +02:00			`</sect1>`
* More manual updates. 2005-04-07 13:47:58 +03: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 23:57:09 +02:00			`<sect1>`
			`<title>nix-store</title>`
* XInclude all the way. 2005-03-15 15:55:41 +02:00			`<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="nix-store.xml" />`
* Man pages in sections. 2003-12-21 23:57:09 +02:00			`</sect1>`
* More manual updates. 2005-04-07 13:47:58 +03:00			`<sect1 id="sec-nix-instantiate">`
* Man pages in sections. 2003-12-21 23:57:09 +02:00			`<title>nix-instantiate</title>`
* XInclude all the way. 2005-03-15 15:55:41 +02:00			`<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="nix-instantiate.xml" />`
* Man pages in sections. 2003-12-21 23:57:09 +02: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 18:14:47 +02:00			`<sect1>`
			`<title>nix-collect-garbage</title>`
* XInclude all the way. 2005-03-15 15:55:41 +02: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 18:14:47 +02:00			`</sect1>`
* Document nix-channel. 2005-04-09 20:16:00 +03: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 18:14:47 +02:00			`<sect1>`
			`<title>nix-push</title>`
* XInclude all the way. 2005-03-15 15:55:41 +02: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 18:14:47 +02:00			`</sect1>`
			`<sect1>`
			`<title>nix-pull</title>`
* XInclude all the way. 2005-03-15 15:55:41 +02: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 18:14:47 +02:00			`</sect1>`
			`<sect1>`
			`<title>nix-prefetch-url</title>`
* XInclude all the way. 2005-03-15 15:55:41 +02: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 18:14:47 +02:00			`</sect1>`
* Generate man pages from the manual. 2003-08-12 16:54:42 +03:00			`</appendix>`

* XInclude all the way. 2005-03-15 15:55:41 +02:00			`<!-- &nix-lang-ref; -->`
* EBNF grammar for the Nix expression language. 2004-04-08 16:31:57 +03:00
* XInclude all the way. 2005-03-15 15:55:41 +02: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 18:34:23 +03:00			`<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="glossary.xml" />`
* Started on the introduction. 2003-08-07 18:27:14 +03:00
* Start of manual; installation instructions. 2003-08-07 17:17:18 +03:00			`</book>`