nixos/manual: clarify declarative packages section

This commit is contained in:
Aaron Janse 2019-03-13 18:40:00 -07:00
parent 44298e76d5
commit f67eb111ac
No known key found for this signature in database
GPG key ID: 7C5577ABFFEFFE19

View file

@ -14,9 +14,10 @@
<programlisting>
<xref linkend="opt-environment.systemPackages"/> = [ pkgs.thunderbird ];
</programlisting>
The effect of this specification is that the Thunderbird package from Nixpkgs
will be built or downloaded as part of the system when you run
<command>nixos-rebuild switch</command>.
The <literal>pkgs</literal> variable is used to reference packages in your
root channel. The effect of this specification is that the Thunderbird
package from your root Nixpkgs channel will be built or downloaded as part of
the system when you run <command>nixos-rebuild switch</command>.
</para>
<para>
@ -27,8 +28,10 @@ nixos.firefox firefox-23.0 Mozilla Firefox - the browser, reloaded
<replaceable>...</replaceable>
</screen>
The first column in the output is the <emphasis>attribute name</emphasis>,
such as <literal>nixos.thunderbird</literal>. (The <literal>nixos</literal>
prefix allows distinguishing between different channels that you might have.)
such as <literal>nixos.thunderbird</literal>. The <literal>nixos</literal>
prefix tells us that we want to get the package from the `nixos` channel.
Some systems have other channels installed, such as `nixpkgs` or custom
channels for development purposes.
</para>
<para>