summary refs log tree commit diff
path: root/nixos/doc/manual/manual.xml
blob: a5efde32885cf4c7ba9b30fc20cec6eb23c4b406 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
<book xmlns="http://docbook.org/ns/docbook"
      xmlns:xlink="http://www.w3.org/1999/xlink"
      xmlns:xi="http://www.w3.org/2001/XInclude"
      version="5.0"
      xml:id="book-nixos-manual">
 <info>
  <title>NixOS Manual</title>
  <subtitle>Version <xi:include href="./generated/version" parse="text" />
  </subtitle>
 </info>
 <preface xml:id="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="https://discourse.nixos.org">Discourse</literal>
   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>
  <note>
   <para>
    Commands prefixed with <literal>#</literal> have to be run as root, either
    requiring to login as root user or temporarily switching to it using
    <literal>sudo</literal> for example.
   </para>
  </note>
 </preface>
 <xi:include href="installation/installation.xml" />
 <xi:include href="configuration/configuration.xml" />
 <xi:include href="administration/running.xml" />
<!-- <xi:include href="userconfiguration.xml" /> -->
 <xi:include href="development/development.xml" />
 <appendix xml:id="ch-options">
  <title>Configuration Options</title>
  <xi:include href="./generated/options-db.xml"
                xpointer="configuration-variable-list" />
 </appendix>
 <xi:include href="release-notes/release-notes.xml" />
</book>