about summary refs log tree commit diff
path: root/doc/introduction.xml
diff options
context:
space:
mode:
Diffstat (limited to 'doc/introduction.xml')
-rw-r--r--doc/introduction.xml16
1 files changed, 14 insertions, 2 deletions
diff --git a/doc/introduction.xml b/doc/introduction.xml
index f1f15995909d..bdc035bbaf75 100644
--- a/doc/introduction.xml
+++ b/doc/introduction.xml
@@ -4,6 +4,18 @@
 
 <title>Introduction</title>
 
-<para>Bla</para>
+<para>This manual tells you how to write packages for the Nix Packages
+collection (Nixpkgs).  Thus it’s for packagers and developers who want
+to add packages to Nixpkgs.  End users are kindly referred to the
+<link xlink:href="http://nixos.org/releases/nix/unstable/manual/">Nix
+manual</link>.</para>
 
-</chapter>
\ No newline at end of file
+<para>This manual does not describe the syntax and semantics of the
+Nix expression language, which are given in the Nix manual in the
+<link
+xlink:href="http://nixos.org/releases/nix/unstable/manual/#chap-writing-nix-expressions">chapter
+on writing Nix expressions</link>.  It only describes the facilities
+provided by Nixpkgs to make writing packages easier, such as the
+standard build environment (<literal>stdenv</literal>).</para>
+
+</chapter>