git.iko.soy/typeable/nixpkgs
on master help sign in
nixpkgs manual: various improvements in introduction

- rename to preface to be inline with NixOS manual - refer to other manuals - use https - change example channel to 19.09

commit8ee774042711dcb499881f5597ee627cd7c39ff7 authorFrederik Rietdijk <fridh@fridh.nl> dateMon 28 Oct 2019, 11:40 (7 years ago) parentf76c836
2 files changed+13−12
doc/manual.xml+1−1 doc/introduction.chapter.md → doc/preface.chapter.md+12−11
doc/manual.xml+1−1
@@ -5,7 +5,7 @@
55 <subtitle>Version <xi:include href=".version" parse="text" />
66 </subtitle>
77 </info>
8− <xi:include href="introduction.chapter.xml" />
8+ <xi:include href="preface.chapter.xml" />
99 <part>
1010 <title>Using Nixpkgs</title>
1111 <xi:include href="configuration.xml" />
doc/introduction.chapter.md → doc/preface.chapter.mdrenamed+12−11
@@ -1,44 +1,45 @@
11---
2−title: Introduction
2+title: Preface
33author: Frederik Rietdijk
44date: 2015-11-25
55---
66
7−# Introduction
7+# Preface
88
99The Nix Packages collection (Nixpkgs) is a set of thousands of packages for the
10−[Nix package manager](http://nixos.org/nix/), released under a
10+[Nix package manager](https://nixos.org/nix/), released under a
1111[permissive MIT/X11 license](https://github.com/NixOS/nixpkgs/blob/master/COPYING).
1212Packages are available for several platforms, and can be used with the Nix
13−package manager on most GNU/Linux distributions as well as NixOS.
13+package manager on most GNU/Linux distributions as well as [NixOS](https://nixos.org/nixos).
1414
1515This manual primarily describes how to write packages for the Nix Packages collection
1616(Nixpkgs). Thus it’s mainly for packagers and developers who want to add packages to
1717Nixpkgs. If you like to learn more about the Nix package manager and the Nix
18−expression language, then you are kindly referred to the [Nix manual](http://nixos.org/nix/manual/).
18+expression language, then you are kindly referred to the [Nix manual](https://nixos.org/nix/manual/).
19+The NixOS distribution is documented in the [NixOS manual](https://nixos.org/nixos/manual/).
1920
2021## Overview of Nixpkgs
2122
2223Nix expressions describe how to build packages from source and are collected in
2324the [nixpkgs repository](https://github.com/NixOS/nixpkgs). Also included in the
2425collection are Nix expressions for
25−[NixOS modules](http://nixos.org/nixos/manual/index.html#sec-writing-modules).
26+[NixOS modules](https://nixos.org/nixos/manual/index.html#sec-writing-modules).
2627With these expressions the Nix package manager can build binary packages.
2728
2829Packages, including the Nix packages collection, are distributed through
29−[channels](http://nixos.org/nix/manual/#sec-channels). The collection is
30+[channels](https://nixos.org/nix/manual/#sec-channels). The collection is
3031distributed for users of Nix on non-NixOS distributions through the channel
3132`nixpkgs`. Users of NixOS generally use one of the `nixos-*` channels, e.g.
32−`nixos-16.03`, which includes all packages and modules for the stable NixOS
33−16.03. Stable NixOS releases are generally only given
33+`nixos-19.09`, which includes all packages and modules for the stable NixOS
34+19.09. Stable NixOS releases are generally only given
3435security updates. More up to date packages and modules are available via the
3536`nixos-unstable` channel.
3637
3738Both `nixos-unstable` and `nixpkgs` follow the `master` branch of the Nixpkgs
3839repository, although both do lag the `master` branch by generally
39−[a couple of days](http://howoldis.herokuapp.com/). Updates to a channel are
40+[a couple of days](https://howoldis.herokuapp.com/). Updates to a channel are
4041distributed as soon as all tests for that channel pass, e.g.
41−[this table](http://hydra.nixos.org/job/nixpkgs/trunk/unstable#tabs-constituents)
42+[this table](https://hydra.nixos.org/job/nixpkgs/trunk/unstable#tabs-constituents)
4243shows the status of tests for the `nixpkgs` channel.
4344
4445The tests are conducted by a cluster called [Hydra](http://nixos.org/hydra/),