b12f/nixpkgs
1
0
Fork 0
Code Issues Pull requests Packages Projects Releases Wiki Activity

Reduce verbosity of packageOverrides description.

Browse source
This commit is contained in:
Sebastian Jordan 2015-04-20 22:48:28 +02:00
parent 8a78dcc00f
commit 20dadec264
1 changed files with 7 additions and 28 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

35
doc/packageconfig.xml
View file

@ -4,8 +4,6 @@
<title><filename>~/.nixpkgs/config.nix</filename>: global configuration</title> <title><filename>~/.nixpkgs/config.nix</filename>: global configuration</title>
<section><title>Allow unfree software</title>
<para> <para>
Nix packages can be configured to allow or deny certain options. Nix packages can be configured to allow or deny certain options.
</para> </para>
@ -68,37 +66,18 @@
A complete list of licenses can be found in the file A complete list of licenses can be found in the file
<filename>lib/licenses.nix</filename> of the nix package tree. <filename>lib/licenses.nix</filename> of the nix package tree.
</para> </para>
</section>
<section><title>Overriding existing packages</title> <section><title>Modify packages via<literal>packageOverrides</literal></title>
<para> <para>
<filename>~/.nixpkgs/config.nix</filename> enables the user to <filename>~/.nixpkgs/config.nix</filename> enables the user to
override package names without creating a fork of the Nixpkgs. override package names without creating a fork of Nixpkgs. This is
This is accomplished by defining a function called accomplished by defining a function called
<varname>packageOverrides</varname>. It takes the set of <varname>packageOverrides</varname>. It is expected to take the set
packages, usually called <varname>pkgs</varname>, and returns a of packages, usually called <varname>pkgs</varname>, and returns a
modified set of packages. modified set of packages. It is called when evaluating any nix
expression in the <varname>pkgs</varname> set.
</para> </para>
<para>
Here is an example. Say we want to install
<varname>xbmc</varname> but we want to use another Python
version when running <varname>xbmc</varname>.
<programlisting>
packageOverrides = pkgs: rec {
xbmc = pkgs.xbmc.override {
python = pkgs.python26;
};
};
</programlisting>
Further information is available at the <command
xlink:href="https://nixos.org/wiki/Nix_Modifying_Packages">Nix
wiki</command>
</para>
</section> </section>
</chapter> </chapter>