nixpkgs/nixos/doc/manual/manual.xml

<book xmlns="http://docbook.org/ns/docbook"
      xmlns:xlink="http://www.w3.org/1999/xlink"
      xmlns:xi="http://www.w3.org/2001/XInclude">

  <info>

    <title>NixOS Manual</title>
    <subtitle>Version <xi:include href="version" parse="text" /></subtitle>

    <author>
      <personname>
        <firstname>Eelco</firstname>
        <surname>Dolstra</surname>
      </personname>
    </author>

    <author>
      <personname>
        <firstname>Nicolas</firstname>
        <surname>Pierron</surname>
      </personname>
    </author>

    <copyright>
      <year>2007-2013</year>
      <holder>Eelco Dolstra</holder>
    </copyright>

  </info>


  <preface>
    <title>Preface</title>

    <para>This manual describes how to install, use and extend NixOS,
    a Linux distribution based on the purely functional package
    management system Nix.</para>

    <para>If you encounter problems, please report them on the
    <literal
    xlink:href="http://lists.science.uu.nl/mailman/listinfo/nix-dev">nix-dev@lists.science.uu.nl</literal>
    mailing list or on the <link
    xlink:href="irc://irc.freenode.net/#nixos">
    <literal>#nixos</literal> channel on Freenode</link>.  Bugs should
    be reported in <link
    xlink:href="https://github.com/NixOS/nixpkgs/issues">NixOS’ GitHub
    issue tracker</link>.</para>

  </preface>


  <xi:include href="installation.xml" />
  <xi:include href="configuration.xml" />
  <xi:include href="running.xml" />
  <!-- <xi:include href="userconfiguration.xml" /> -->
  <xi:include href="troubleshooting.xml" />
  <xi:include href="containers.xml" />
  <xi:include href="development.xml" />

  <xi:include href="release-notes.xml" />

  <appendix xml:id="ch-options">
    <title>Configuration options</title>
    <xi:include href="options-db.xml" />
  </appendix>

</book>
-												* Add a top-level book.
* Copy the stylesheet from the Nix manual.  We should really put this
  somewhere central.

svn path=/nixos/trunk/; revision=7766

											
										
										
											2007-01-23 12:11:58 +01:00
+								<book xmlns="http://docbook.org/ns/docbook"
-												* Manual.

svn path=/nixos/trunk/; revision=7868

											
										
										
											2007-02-06 22:14:02 +01:00
+								      xmlns:xlink="http://www.w3.org/1999/xlink"
-												* Add a top-level book.
* Copy the stylesheet from the Nix manual.  We should really put this
  somewhere central.

svn path=/nixos/trunk/; revision=7766

											
										
										
											2007-01-23 12:11:58 +01:00
+								      xmlns:xi="http://www.w3.org/2001/XInclude">
 								  <info>
 								    <title>NixOS Manual</title>
-												Include the NixOS version in the manual

In particular, this will make it clear what version of the manual is
shown at http://nixos.org/nixos/manual/.

											
										
										
											2013-11-01 16:44:03 +01:00
+								    <subtitle>Version <xi:include href="version" parse="text" /></subtitle>
-												* Add a top-level book.
* Copy the stylesheet from the Nix manual.  We should really put this
  somewhere central.

svn path=/nixos/trunk/; revision=7766

											
										
										
											2007-01-23 12:11:58 +01:00
 								    <author>
 								      <personname>
 								        <firstname>Eelco</firstname>
 								        <surname>Dolstra</surname>
 								      </personname>
 								    </author>
-												* Obsoleted boot.initrd.extraKernelModules (use
  boot.initrd.kernelModules instead).

svn path=/nixos/trunk/; revision=18969

											
										
										
											2009-12-15 15:05:01 +01:00
+								    <author>
 								      <personname>
 								        <firstname>Nicolas</firstname>
 								        <surname>Pierron</surname>
 								      </personname>
 								    </author>
-												* Add a top-level book.
* Copy the stylesheet from the Nix manual.  We should really put this
  somewhere central.

svn path=/nixos/trunk/; revision=7766

											
										
										
											2007-01-23 12:11:58 +01:00
+								    <copyright>
-												Manual: Remove "bleeding edge" remark

											
										
										
											2013-08-20 13:28:33 +02:00
+								      <year>2007-2013</year>
-												* Add a top-level book.
* Copy the stylesheet from the Nix manual.  We should really put this
  somewhere central.

svn path=/nixos/trunk/; revision=7766

											
										
										
											2007-01-23 12:11:58 +01:00
+								      <holder>Eelco Dolstra</holder>
 								    </copyright>
-												Add section on network configuration topics

											
										
										
											2013-01-08 00:35:27 +01:00
-												* Add a top-level book.
* Copy the stylesheet from the Nix manual.  We should really put this
  somewhere central.

svn path=/nixos/trunk/; revision=7766

											
										
										
											2007-01-23 12:11:58 +01:00
+								  </info>
-												Add section on network configuration topics

											
										
										
											2013-01-08 00:35:27 +01:00
-												* Manual.

svn path=/nixos/trunk/; revision=7868

											
										
										
											2007-02-06 22:14:02 +01:00
+								  <preface>
 								    <title>Preface</title>
-												Manual: Remove "bleeding edge" remark

											
										
										
											2013-08-20 13:28:33 +02:00
+								    <para>This manual describes how to install, use and extend NixOS,
 								    a Linux distribution based on the purely functional package
 								    management system Nix.</para>
-												Add section on network configuration topics

											
										
										
											2013-01-08 00:35:27 +01:00
-												Manual: Remove "bleeding edge" remark

											
										
										
											2013-08-20 13:28:33 +02:00
+								    <para>If you encounter problems, please report them on the
-												* Fix some links.

svn path=/nixos/trunk/; revision=33910

											
										
										
											2012-04-24 17:19:24 +02:00
+								    <literal
 								    xlink:href="http://lists.science.uu.nl/mailman/listinfo/nix-dev">nix-dev@lists.science.uu.nl</literal>
-												Manual: Remove "bleeding edge" remark

											
										
										
											2013-08-20 13:28:33 +02:00
+								    mailing list or on the <link
 								    xlink:href="irc://irc.freenode.net/#nixos">
 								    <literal>#nixos</literal> channel on Freenode</link>.  Bugs should
 								    be reported in <link
-												Manual: Update installation section

											
										
										
											2013-10-21 10:46:24 +02:00
+								    xlink:href="https://github.com/NixOS/nixpkgs/issues">NixOS’ GitHub
-												Manual: Remove "bleeding edge" remark

											
										
										
											2013-08-20 13:28:33 +02:00
+								    issue tracker</link>.</para>
-												Add section on network configuration topics

											
										
										
											2013-01-08 00:35:27 +01:00
-												* Manual.

svn path=/nixos/trunk/; revision=7868

											
										
										
											2007-02-06 22:14:02 +01:00
+								  </preface>
-												Add section on network configuration topics

											
										
										
											2013-01-08 00:35:27 +01:00
-												* Manual.

svn path=/nixos/trunk/; revision=7868

											
										
										
											2007-02-06 22:14:02 +01:00
-												* Doh!  Make sure that we put *only* splash_helper in the initrd and
  not all of splashutils, otherwise we get Glibc in the initrd.

svn path=/nixos/trunk/; revision=7771

											
										
										
											2007-01-23 14:44:41 +01:00
+								  <xi:include href="installation.xml" />
-												Add section on network configuration topics

											
										
										
											2013-01-08 00:35:27 +01:00
+								  <xi:include href="configuration.xml" />
-												Add an overview of systemctl/loginctl/journalctl

											
										
										
											2013-01-08 02:02:15 +01:00
+								  <xi:include href="running.xml" />
-												* Comment out the "Configuration in home directory" chapter.
  Everything described in that chapter is a bug (e.g. needing to
  manually create symlinks) that properly belongs in the issue tracker
  or wiki, not in the manual.

svn path=/nixos/trunk/; revision=34085

											
										
										
											2012-05-14 06:01:47 +02:00
+								  <!-- <xi:include href="userconfiguration.xml" /> -->
-												* Readme is obsolete now.

svn path=/nixos/trunk/; revision=7870

											
										
										
											2007-02-06 22:38:59 +01:00
+								  <xi:include href="troubleshooting.xml" />
-												Document NixOS containers

											
										
										
											2014-04-10 14:57:40 +02:00
+								  <xi:include href="containers.xml" />
-												* More manual.

svn path=/nixos/trunk/; revision=7869

											
										
										
											2007-02-06 22:25:36 +01:00
+								  <xi:include href="development.xml" />
-												Start of 14.02 release notes

											
										
										
											2014-02-18 17:05:34 +01:00
 								  <xi:include href="release-notes.xml" />
 								  <appendix xml:id="ch-options">
-												Update section on writing tests

											
										
										
											2014-04-14 19:07:35 +02:00
+								    <title>Configuration options</title>
-												* Generate a manual page for configuration.nix containing all the
  options.

svn path=/nixos/branches/modular-nixos/; revision=16358

											
										
										
											2009-07-14 17:47:03 +02:00
+								    <xi:include href="options-db.xml" />
-												Start of 14.02 release notes

											
										
										
											2014-02-18 17:05:34 +01:00
+								  </appendix>
-												* Add a top-level book.
* Copy the stylesheet from the Nix manual.  We should really put this
  somewhere central.

svn path=/nixos/trunk/; revision=7766

											
										
										
											2007-01-23 12:11:58 +01:00
-												Added user configuration chapter - currently about Compiz.

svn path=/nixos/trunk/; revision=9589

											
										
										
											2007-11-05 22:17:16 +01:00
+								</book>