From 82d771f6e66e3f8a7101574d9c606553b490fe71 Mon Sep 17 00:00:00 2001 From: Eelco Dolstra Date: Sun, 10 Apr 2005 20:54:21 +0000 Subject: * Manual updates. --- doc/manual/glossary.xml | 23 + doc/manual/manual.xml | 2 +- doc/manual/nix-build.xml | 2 + doc/manual/nix-env.xml | 1510 ++++++++++++++++---------------- doc/manual/nix-store.xml | 9 +- doc/manual/opt-common.xml | 15 +- doc/manual/package-management.xml | 32 +- doc/manual/style.css | 2 + doc/manual/writing-nix-expressions.xml | 2 +- 9 files changed, 811 insertions(+), 786 deletions(-) (limited to 'doc/manual') diff --git a/doc/manual/glossary.xml b/doc/manual/glossary.xml index cee6dac254d6..a659e7e4a90b 100644 --- a/doc/manual/glossary.xml +++ b/doc/manual/glossary.xml @@ -134,6 +134,29 @@ +user environment + + An automatically generated store object that + consists of a set of symlinks to “active” applications, i.e., other + store paths. These are generated automatically by nix-env. See . + + + + + + +profile + + A symlink to the current user environment of a user, e.g., + /nix/var/nix/profiles/default. + + + + + diff --git a/doc/manual/manual.xml b/doc/manual/manual.xml index a9e4473e020a..d6dd437edda4 100644 --- a/doc/manual/manual.xml +++ b/doc/manual/manual.xml @@ -36,7 +36,7 @@ - + nix-env diff --git a/doc/manual/nix-build.xml b/doc/manual/nix-build.xml index 2a5af6adb3d7..447ef126bfed 100644 --- a/doc/manual/nix-build.xml +++ b/doc/manual/nix-build.xml @@ -8,6 +8,8 @@ nix-build + + paths diff --git a/doc/manual/nix-env.xml b/doc/manual/nix-env.xml index 6d145a2129ff..8111775cedb8 100644 --- a/doc/manual/nix-env.xml +++ b/doc/manual/nix-env.xml @@ -1,387 +1,417 @@ - - nix-env - manipulate or query Nix user environments - - - - - nix-env - - - - - - - path - - - - - - - path - - - - - system - - - operation - options - arguments - - - - - Description - - - The command nix-env is used to manipulate Nix - user environments. User environments are sets of software - components available to a user at some point in time. In other - words, they are a synthesised view of the programs available in - the Nix store. There may be many user environments: different - users can have different environments, and individual users can - switch between different environments. - - - - - - nix-env takes exactly one - operation flag which indicates the - subcommand to be performed. These are documented below. - + + + nix-env + manipulate or query Nix user environments + + + + + nix-env + + + + + + + path + + + + + + + path + + + + + system + + + + + path + operation + options + arguments + + + + +Description + +The command nix-env is used to manipulate Nix +user environments. User environments are sets of software components +available to a user at some point in time. In other words, they are a +synthesised view of the programs available in the Nix store. There +may be many user environments: different users can have different +environments, and individual users can switch between different +environments. + +nix-env takes exactly one +operation flag which indicates the subcommand to +be performed. These are documented below. - + - + - - Common options +Common options - - This section lists the options that are common to all - operations. These options are allowed for every subcommand, - though they may not always have an effect. See also . - +This section lists the options that are common to all +operations. These options are allowed for every subcommand, though +they may not always have an effect. See also . - + - - / - - - Specifies the Nix expression (designated below as the - active Nix expression) used by the - , , - and operations to - obtain derivations. The default is - ~/.nix-defexpr. - - - - - - / - - - Specifies the profile to be used by those operations that - operate on a profile (designated below as the - active profile). A profile is - sequence of user environments called - generations, one of which is the - current generation. The default - profile is the target of the symbolic link - ~/.nix-profile (see below). - - - + + + + Specifies the Nix expression (designated below as + the active Nix expression) used by the + , , and + operations to obtain + derivations. The default is + ~/.nix-defexpr. + + - - - - - For the , - , , - and - operations, this flag will - cause nix-env to print what - would be done if this flag had not - been specified, without actually doing it. - - - + + + + Specifies the profile to be used by those + operations that operate on a profile (designated below as the + active profile). A profile is sequence of + user environments called generations, one of + which is the current generation. The default + profile is the target of the symbolic link + ~/.nix-profile (see below). + + - - - - - By default, when you install a derivation with the - operation, it will replace - previously installed versions with the same derivation - name (regardless of the version number). This option - causes those previously installed versions to be kept in - the new generation of the profile. Note that this will - generally cause conflicts in the creation of the user - environment (since multiple versions of a package - typically contain the same programs). - - - + + + For the , + , , + and + operations, this flag will cause + nix-env to print what + would be done if this flag had not been + specified, without actually doing it. + + - - system - - - By default, operations such as only include derivations matching the - current platform. This option allows you to use - derivations for the specified platform - system. The special value - * causes derivations for any platform - to be included. - - - + + + By default, when you install a derivation with the + operation, it will replace previously + installed versions with the same derivation name (regardless of + the version number). This option causes those previously + installed versions to be kept in the new generation of the + profile. Note that this will generally cause conflicts in the + creation of the user environment (since multiple versions of a + package typically contain the same programs). + + - - - - - - - - - - Files - - - - - ~/.nix-defexpr - - - The default Nix expression used by the - , , - and operations to - obtain derivations. It is generally a symbolic link to - some other location set using the - operation. The - option may be used to override - this default. - - - - - - ~/.nix-profile - - - A symbolic link to the user's current profile. By - default, this symlink points to - prefix/var/nix/profiles/default. - The PATH environment variable should - include ~/.nix-profile/bin for the - user environment to be visible to the user. - - - - - + system + + By default, operations such as only include derivations matching the current + platform. This option allows you to use derivations for the + specified platform system. The special + value * causes derivations for any platform to + be included. + + + + + + + + + + + +Files + + + + ~/.nix-defexpr + + The default Nix expression used by the + , , and + operations to obtain + derivations. It is generally a symbolic link to some other + location set using the operation. The + option may be used to override this + default. + + + + ~/.nix-profile + + A symbolic link to the user's current profile. By + default, this symlink points to + prefix/var/nix/profiles/default. + The PATH environment variable should include + ~/.nix-profile/bin for the user environment + to be visible to the user. + + + + - + - + + +Operation <option>--install</option> + +Synopsis - - Operation <option>--install</option> + + nix-env + + + + + + + + + args + - - Synopsis - - nix-env - - - - - - - - - drvnames - - + - - Description + +Description - - The install operation creates a new user environment, based on - the current generation of the active profile, to which the - derivations designated by drvnames - in the active Nix expression are added. - - - - Currently installed derivations with a name equal to the name - of a derivation being added are removed unless the option - is specified. - - - - - - Flags - - - - - / - - - Do not remove derivations with a name matching one of - the derivations being installed. Usually, trying to - have two versions of the same package installed in the - same generation of a profile will lead to an error in - building the generation, due to file name clashes - between the two versions. However, this is not the case - for all packages. - - - - - - +The install operation creates a new user environment, based on +the current generation of the active profile, to which a set of store +paths described by args is added. The +arguments args map to store paths in a +number of possible ways: + + + + By default, args is a set + of derivation names denoting derivations in the active Nix + expression. These are realised, and the resulting output paths are + installed. Currently installed derivations with a name equal to the + name of a derivation being added are removed unless the option + is + specified. + + If + path is given, + args is a set of names denoting installed + store paths in the profile path. This is + an easy way to copy user environment elements from one profile to + another. + + If is given, + args are Nix functions that are called with the + active Nix expression as their single argument. The derivations + returned by those function calls are installed. This allows + derivations to be specified in a unambiguous way, which is necessary + if there are multiple derivations with the same + name. + + If args are store + derivations, then these are realised, and the resulting + output paths are installed. + + If args are store paths + that are not store derivations, then these are realised and + installed. + + + + + + + + +Flags + + + + + + + Do not remove derivations with a name matching one + of the derivations being installed. Usually, trying to have two + versions of the same package installed in the same generation of a + profile will lead to an error in building the generation, due to + file name clashes between the two versions. However, this is not + the case for all packages. + + + + + + - - Examples - -$ nix-env --install gcc-3.3.2 (install specific version) +Examples + +To install a specific version of gcc from the +active Nix expression: + + +$ nix-env --install gcc-3.3.2 installing `gcc-3.3.2' -uninstalling `gcc-3.1' (previously installed version is removed) +uninstalling `gcc-3.1' + +Note the the previously installed version is removed, since + was not specified. + +To install an arbitrary version: + + +$ nix-env --install gcc +installing `gcc-3.3.2' + + + +To install all derivations in the Nix expression foo.nix: + + +$ nix-env -f ~/foo.nix -i '*' + + + +To copy the store path with symbolic name gcc +from another profile: + + +$ nix-env -i --from-profile /nix/var/nix/profiles/foo -i gcc + + + +To install a specific store derivation (typically created by +nix-instantiate): + + +$ nix-env -i /nix/store/fibjb1bfbpm5mrsxc4mh2d8n37sxh91i-gcc-3.4.3.drv + + + +To install a specific output path: + + +$ nix-env -i /nix/store/x3cgx0xj1p4iv9x0pnnmdhr8iyg741vk-gcc-3.4.3 + + + +To install from a Nix expression specified on the command-line: -$ nix-env --install gcc (just pick any version) + +$ nix-env -f ./foo.nix -i -E \ + 'f: (f {system = "i686-linux";}).subversionWithJava' -$ nix-env -f ~/foo.nix -i '*' (install everything in foo.nix) +I.e., this evaluates to (f: (f {system = +"i686-linux";}).subversionWithJava) (import ./foo.nix), thus +selecting the subversionWithJava attribute from the +attribute set returned by calling the function defined in +./foo.nix. - + - - - - - - - - Operation <option>--upgrade</option> - - - Synopsis - - nix-env - - - - - - - - - - drvnames - - - - - Description + + + + + + +Operation <option>--upgrade</option> + +Synopsis + + + nix-env + + + + + + + + + + args + + + + +Description - - The upgrade operation creates a new user environment, based on - the current generation of the active profile, in which all - derivations designated by drvnames - for which there are newer versions in the active Nix - expression are replaced by those newer versions. Matching - derivations for which there are no newer versions are left - untouched; this is not an error. It is also not an error if - an element of drvnames matches no - installed derivations. - - - - If multiple derivations in the active Nix expression match an - installed derivation, the one with the highest version is - selected. - - - +The upgrade operation creates a new user environment, based on +the current generation of the active profile, in which all store paths +are replaced for which there are newer versions in the set of paths +described by args. Paths for which there +are no newer versions are left untouched; this is not an error. It is +also not an error if an element of args +matches no installed derivations. + +For a description of how args is +mapped to a set of store paths, see . If +args describes multiple store paths with +the same symbolic name, only the one with the highest version is +installed. + + - - Flags - - - - - - - - Only upgrade a derivation to newer versions. This is - the default. - - - - - - - - - In addition to upgrading to newer versions, also - upgrade to derivations that have the same - version. Version are not a unique identification of a - derivation, so there may be many derivations that have - the same version. This flag may be useful to force - synchronisation between the installed and - available derivations. - - - - - - - - - In addition to upgrading to newer versions, also - upgrade to derivations that have the same - or a lower version. I.e., derivations may actually be - downgraded depending on what is available in the active - Nix expression. - - - - - - - - - - Examples - - +Flags + + + + + + Only upgrade a derivation to newer versions. This + is the default. + + + + + + In addition to upgrading to newer versions, also + “upgrade” to derivations that have the same version. Version are + not a unique identification of a derivation, so there may be many + derivations that have the same version. This flag may be useful + to force “synchronisation” between the installed and available + derivations. + + + + + + In addition to upgrading to newer versions, also + “upgrade” to derivations that have the same or a lower version. + I.e., derivations may actually be downgraded depending on what is + available in the active Nix expression. + + + + + + + +Examples + + $ nix-env --upgrade gcc upgrading `gcc-3.3.1' to `gcc-3.4' @@ -395,48 +425,39 @@ $ nix-env -u '*' (try to upgrade everything) upgrading `hello-2.1.2' to `hello-2.1.3' upgrading `mozilla-1.2' to `mozilla-1.4' - + - - Versions - - - The upgrade operation determines whether a derivation - y is an upgrade of a derivation - x by looking at their respective - name attributes. The names (e.g., - gcc-3.3.1 are split into two parts: the - package name (gcc), and the version - (3.3.1). The version part starts after the - first dash not following by a letter. x is - considered an upgrade of y if their package - names match, and the version of y is higher - that that of x. - - - - The versions are compared by splitting them into contiguous - components of numbers and letters. E.g., - 3.3.1pre5 is split into [3, 3, 1, - "pre", 5]. These lists are then compared - lexicographically (from left to right). Corresponding - components a and b are - compared as follows. If they are both numbers, integer - comparison is used. If a is an empty - string and b is a number, - a is considered less than - b. The special string component - pre (for pre-release) - is considered to be less than other components. String - components are considered less than number components. - Otherwise, they are compared lexicographically (i.e., using - case-sensitive string comparison). - - - - This is illustrated by the following examples: - - +Versions + +The upgrade operation determines whether a derivation +y is an upgrade of a derivation +x by looking at their respective +name attributes. The names (e.g., +gcc-3.3.1 are split into two parts: the package +name (gcc), and the version +(3.3.1). The version part starts after the first +dash not following by a letter. x is considered an +upgrade of y if their package names match, and the +version of y is higher that that of +x. + +The versions are compared by splitting them into contiguous +components of numbers and letters. E.g., 3.3.1pre5 +is split into [3, 3, 1, "pre", 5]. These lists are +then compared lexicographically (from left to right). Corresponding +components a and b are compared +as follows. If they are both numbers, integer comparison is used. If +a is an empty string and b is a +number, a is considered less than +b. The special string component +pre (for pre-release) is +considered to be less than other components. String components are +considered less than number components. Otherwise, they are compared +lexicographically (i.e., using case-sensitive string comparison). + +This is illustrated by the following examples: + + 1.0 < 2.3 2.1 < 2.3 2.3 = 2.3 @@ -450,199 +471,189 @@ upgrading `mozilla-1.2' to `mozilla-1.4' 2.3pre1 < 2.3c 2.3pre1 < 2.3q - + - + - + - + + +Operation <option>--uninstall</option> - - Operation <option>--uninstall</option> +Synopsis - - Synopsis - - nix-env - - - - - drvnames - - + + nix-env + + + + + drvnames + + - - Description +Description - - The uninstall operation creates a new user environment, based - on the current generation of the active profile, from which the - derivations designated by drvnames - are removed. - - - +The uninstall operation creates a new user environment, based on +the current generation of the active profile, from which the store +paths designated by the symbolic names +names are removed. + + - - Examples +Examples - + $ nix-env --uninstall gcc $ nix-env -e '*' (remove everything) - + - - - - - - - - Operation <option>--query</option> - - - Synopsis - - nix-env - - - - - - - - - - - - - - - - - - - - Description + + + + + + +Operation <option>--query</option> + +Synopsis + + + nix-env + + + + + + + + + + + + + + + + + + + + +Description - - The query operation displays information about either the - derivations that are installed in the current generation of - the active profile (), or the - derivations that are available for installation in the active - Nix expression (). - - - - The derivations are sorted by their name - attributes. - - - - - - Source selection - - - The following flags specify the set of derivations on which - the query operates. - - - - - - - - - The query operates on the derivations that are installed - in the current generation of the active profile. This - is the default - - - - - - / - - - The query operates on the derivations that are available - in the active Nix expression. - - - - - +The query operation displays information about either the store +paths that are installed in the current generation of the active +profile (), or the derivations that are +available for installation in the active Nix expression +(). + +The derivations are sorted by their name +attributes. + + + + +Source selection + +The following flags specify the set of things on which the query +operates. + + + + + + The query operates on the store paths that are + installed in the current generation of the active profile. This + is the default. + + + + + + + The query operates on the derivations that are + available in the active Nix expression. + + + + - - - - Queries - - - The following flags specify what information to display about - the selected derivations. Only one type of query may be - specified. - - - - - - - - - Prints the name attribute of each - derivation. This is the default. - - - - - - - - - Prints the store expression in the Nix store that - described the derivation. - - - - - - / - - - Prints the status of each - derivation, followed by its name - attribute. The status consists of three characters. - The first is I or - -, indicating whether the derivation - is currently installed in the current generation of the - active profile. This is by definition the case for - , but not for - . The second is - P or -, indicating - whether the derivation is present on the system. This - indicates whether installation of an available - derivation will require the derivation to be built. The - third is S or -, - indicating whether a substitute is available for the - derivation. - - - - - - - - - - Examples - - + + + +Queries + +The following flags specify what information to display about +the selected derivations. Multiple flags may be specified, in which +case the information is shown in the order given here. Note that the +name of the derivation is shown unless is +specified. + + + + + + + + + Print the status of the + derivation. The status consists of three characters. The first + is I or -, indicating + whether the derivation is currently installed in the current + generation of the active profile. This is by definition the case + for , but not for + . The second is P + or -, indicating whether the derivation is + present on the system. This indicates whether installation of an + available derivation will require the derivation to be built. The + third is S or -, indicating + whether a substitute is available for the + derivation. + + + + + + Suppress printing of the name + attribute of each derivation. + + + + + + Print the system attribute of + the derivation. + + + + + + Print the path of the store + derivation. + + + + + + Print the output path of the + derivation. + + + + + + + + +Examples + + $ nix-env -q (show installed derivations) MozillaFirebird-0.7 bison-1.875c @@ -666,270 +677,251 @@ IP- bison-1.875c (installed and by definition present)(show available derivations in the Nix expression foo.nix) foo-1.2.3 - - - + + + - - - - Operation <option>--switch-profile</option> - - - Synopsis - - nix-env - - - - - path - - - - - Description + + +Operation <option>--switch-profile</option> + +Synopsis + + + nix-env + + + + + path + + + + + +Description - - This operation makes path the - current profile for the user. That is, the symlink - ~/.nix-profile is made to point to - path. - - - +This operation makes path the current +profile for the user. That is, the symlink +~/.nix-profile is made to point to +path. + + - - Examples +Examples - + $ nix-env -S ~/my-profile - + - + - + - - Operation <option>--list-generations</option> +Operation <option>--list-generations</option> - - Synopsis - - nix-env - - - +Synopsis - - Description - - - This operation print a list of all the currently existing - generations for the active profile. These may be switched to - using the operation. It - also prints the creation date of the generation, and indicates - the current generation. - - - + + nix-env + + + + + + +Description - - Examples +This operation print a list of all the currently existing +generations for the active profile. These may be switched to using +the operation. It also prints +the creation date of the generation, and indicates the current +generation. + + + - +Examples + + $ nix-env --list-generations 95 2004-02-06 11:48:24 96 2004-02-06 11:49:01 97 2004-02-06 16:22:45 98 2004-02-06 16:24:33 (current) - + - + - + + +Operation <option>--delete-generations</option> + +Synopsis - - Operation <option>--delete-generations</option> + + nix-env + + generations + - - Synopsis - - nix-env - - generations - - + - - Description + +Description - - This operation deletes the specified generations of the - current profile. The generations can be a list of generation - numbers, or the special value old to delete - all non-current generations. Periodically deleting old - generations is important to make garbage collection effective. - - - +This operation deletes the specified generations of the current +profile. The generations can be a list of generation numbers, or the +special value old to delete all non-current +generations. Periodically deleting old generations is important to +make garbage collection effective. + + - - Examples +Examples - + $ nix-env --delete-generations 3 4 8 $ nix-env -p other_profile --delete-generations old - + - + - + - - Operation <option>--switch-generation</option> +Operation <option>--switch-generation</option> - - Synopsis - - nix-env - - - - - generation - - +Synopsis - - Description - - - This operation makes generation number - generation the current generation - of the active profile. That is, if the - profile is the - path to the active profile, then the symlink - profile is - made to point to - profile-generation-link, - which is in turn a symlink to the actual user environment in - the Nix store. - - - - Switching will fail if the specified generation does not - exist. - - - + + nix-env + + + + + generation + + + + + +Description - - Examples +This operation makes generation number +generation the current generation of the +active profile. That is, if the +profile is the path to +the active profile, then the symlink +profile is made to +point to +profile-generation-link, +which is in turn a symlink to the actual user environment in the Nix +store. + +Switching will fail if the specified generation does not exist. + + - + +Examples + + $ nix-env -G 42 switching from generation 50 to 42 - + - + - + - - Operation <option>--rollback</option> +Operation <option>--rollback</option> - - Synopsis - - nix-env - - - +Synopsis - - Description - - - This operation switches to the previous - generation of the active profile, that is, the highest - numbered generation lower than the current generation, if it - exists. It is just a convenience wrapper around - and - . - - - + + nix-env + + + + + +Description - - Examples +This operation switches to the “previous” generation of the +active profile, that is, the highest numbered generation lower than +the current generation, if it exists. It is just a convenience +wrapper around and +. - + + + +Examples + + $ nix-env --rollback switching from generation 92 to 91 $ nix-env --rolback error: no generation older than the current (91) exists - + - + - + - - Operation <option>--import</option> +Operation <option>--import</option> - - Synopsis - - nix-env - - - - - path - - +Synopsis - - Description - - - This operation makes path the - default active Nix expression for the user. That is, the - symlink ~/.nix-userenv is made to point - to path. - - - + + nix-env + + + + + path + + + + + +Description - - Examples +This operation makes path the default +active Nix expression for the user. That is, the symlink +~/.nix-userenv is made to point to +path. + + + + +Examples - + $ nix-env -I ~/nixpkgs-0.5/ - + - + diff --git a/doc/manual/nix-store.xml b/doc/manual/nix-store.xml index eead48397262..2913f1899307 100644 --- a/doc/manual/nix-store.xml +++ b/doc/manual/nix-store.xml @@ -330,7 +330,8 @@ query is applied to the target of the symlink. - / + + For each argument to the query that is a store derivation, apply the query to the output path of the derivation @@ -338,7 +339,8 @@ query is applied to the target of the symlink. - / + + Realise each argument to the query first (see nix-store @@ -365,7 +367,8 @@ query is applied to the target of the symlink. - / + + Prints out the closure of the store path diff --git a/doc/manual/opt-common.xml b/doc/manual/opt-common.xml index 467959f19628..052ae4cf983f 100644 --- a/doc/manual/opt-common.xml +++ b/doc/manual/opt-common.xml @@ -19,7 +19,8 @@ - / + + @@ -72,7 +73,8 @@ - / + + By default, output written by builders to standard output and standard error is echoed to the Nix command's standard @@ -84,7 +86,8 @@ - / + + Sets the maximum number of build jobs that Nix will perform in parallel to the specified number. The default is 1. A @@ -93,7 +96,8 @@ - / + + Keep going in case of failed builds, to the greatest extent possible. That is, if building an input of some @@ -105,7 +109,8 @@ - / + + Specifies that in case of a build failure, the temporary directory (usually in /tmp) in which diff --git a/doc/manual/package-management.xml b/doc/manual/package-management.xml index 450353337e5a..7620531c0ead 100644 --- a/doc/manual/package-management.xml +++ b/doc/manual/package-management.xml @@ -2,23 +2,23 @@ This chapter discusses how to do package management with Nix, i.e., how to obtain, install, upgrade, and erase components. This is -the user’s perspective of the Nix system — people +the “user’s” perspective of the Nix system — people who want to create components should consult . Basic package management -The main command for package management is -nix-env. You can use it to install, upgrade, and -erase components, and to query what components are installed or are -available for installation. +The main command for package management is nix-env. You can use +it to install, upgrade, and erase components, and to query what +components are installed or are available for installation. -In Nix, different users can have different views +In Nix, different users can have different “views” on the set of installed applications. That is, there might be lots of applications present on the system (possibly in many different versions), but users can have a specific selection of those active — -where active just means that it appears in a directory +where “active” just means that it appears in a directory in the user’s PATH. Such a view on the set of installed applications is called a user environment, which is just a directory tree consisting of @@ -31,11 +31,9 @@ Nix expressions called the Nix Package collection that contains components ranging from basic development stuff such as GCC and Glibc, to end-user applications like Mozilla Firefox. (Nix is however not tied to the Nix Package collection; you could write your own Nix -expression based on it, or completely new ones.) You can download the -latest version from . You probably want -the latest unstable release; currently the stable releases tend to lag -behind quite a bit. +expressions based on it, or completely new ones.) You can download +the latest version from . Assuming that you have downloaded and unpacked a release of Nix Packages, you can view the set of available components in the release: @@ -127,7 +125,7 @@ release of Nix Packages, you can do: $ nix-env -f nixpkgs-version -u subversion This will only upgrade Subversion if there is a -newer version in the new set of Nix expressions, as +“newer” version in the new set of Nix expressions, as defined by some pretty arbitrary rules regarding ordering of version numbers (which generally do what you’d expect of them). To just unconditionally replace Subversion with whatever version is in the Nix @@ -175,7 +173,7 @@ set. -Profiles +Profiles Profiles and user environments are Nix’s mechanism for implementing the ability to allow differens users to have different @@ -336,7 +334,7 @@ This will not change the () and uninstall () never actually delete components from the system. All they do (as shown above) is to create a new user environment that no longer contains -symlinks to the deleted components. +symlinks to the “deleted” components. Of course, since disk space is not infinite, unused components should be removed at some point. You can do this by running the Nix @@ -423,7 +421,7 @@ linkend="sec-nix-channel">nix-channel you can automatically stay up to date with whatever is available at that URL. -You can subscribe to a channel using +You can “subscribe” to a channel using nix-channel --add, e.g., @@ -436,7 +434,7 @@ of the Nix Packages collection. (Instead of stability, but right now is just outdated.) Subscribing really just means that the URL is added to the file ~/.nix-channels. Right now there is no command -to unsubscribe; you should just edit that file manually +to “unsubscribe”; you should just edit that file manually and delete the offending URL. To obtain the latest Nix expressions available in a channel, do diff --git a/doc/manual/style.css b/doc/manual/style.css index 533104229953..bf6fc3ecf43e 100644 --- a/doc/manual/style.css +++ b/doc/manual/style.css @@ -102,6 +102,8 @@ pre.screen .note,.warning { + margin-top: 1em; + margin-bottom: 1em; border: 1px solid #6185a0; padding: 0px 1em; background: #fffff5; diff --git a/doc/manual/writing-nix-expressions.xml b/doc/manual/writing-nix-expressions.xml index a664f1e3256e..d9c78dbecb9d 100644 --- a/doc/manual/writing-nix-expressions.xml +++ b/doc/manual/writing-nix-expressions.xml @@ -818,7 +818,7 @@ set. -Functions +Functions Functions have the following form: -- cgit 1.4.1