1<book xmlns="http://docbook.org/ns/docbook"
2 xmlns:xlink="http://www.w3.org/1999/xlink"
3 xmlns:xi="http://www.w3.org/2001/XInclude"
4 version="5.0"
5 xml:id="book-nixos-manual">
6
7 <info>
8 <title>NixOS Manual</title>
9 <subtitle>Version <xi:include href="version" parse="text" /></subtitle>
10 </info>
11
12 <preface>
13 <title>Preface</title>
14
15 <para>This manual describes how to install, use and extend NixOS,
16 a Linux distribution based on the purely functional package
17 management system Nix.</para>
18
19 <para>If you encounter problems, please report them on the
20 <literal
21 xlink:href="http://lists.science.uu.nl/mailman/listinfo/nix-dev">nix-dev@lists.science.uu.nl</literal>
22 mailing list or on the <link
23 xlink:href="irc://irc.freenode.net/#nixos">
24 <literal>#nixos</literal> channel on Freenode</link>. Bugs should
25 be reported in <link
26 xlink:href="https://github.com/NixOS/nixpkgs/issues">NixOS’ GitHub
27 issue tracker</link>.</para>
28
29 <note><para>Commands prefixed with <literal>#</literal> have to be run as
30 root, either requiring to login as root user or temporarily switching
31 to it using <literal>sudo</literal> for example.</para></note>
32 </preface>
33
34 <xi:include href="installation/installation.xml" />
35 <xi:include href="configuration/configuration.xml" />
36 <xi:include href="administration/running.xml" />
37 <!-- <xi:include href="userconfiguration.xml" /> -->
38 <xi:include href="development/development.xml" />
39
40 <appendix xml:id="ch-options">
41 <title>Configuration Options</title>
42 <xi:include href="options-db.xml" />
43 </appendix>
44
45 <xi:include href="release-notes/release-notes.xml" />
46
47</book>