summary refs log tree commit diff
path: root/doc/overlays.xml
Commit message (Collapse)AuthorAge
* doc: Improve overrides and overlays documentationRobert Hensing2018-10-18
|
* nixpkgs docs: Point to pkgs.extend, pkgs.appendOverlays and improve override ↵Robert Hensing2018-10-18
| | | | section
* nixpkgs docs: format =)Graham Christensen2018-05-01
|
* Overlays: allow overlays to be specified in a fileMichael Peyton Jones2017-08-17
|
* Overlays: fix some documentation nitsMichael Peyton Jones2017-08-13
|
* Nixpkgs manual: expand documentation for overlaysMichael Peyton Jones2017-08-13
|
* doc: Fix some typosJan Tojnar2017-06-11
|
* doc: fix overlays pathsCarles Pagès2017-04-02
| | | | It was not updated with 9d6a55aefd7.
* $NIXPKGS_OVERLAYS -> <nixpkgs-overlays>Eelco Dolstra2017-02-01
| | | | | | The Nix search path is the established mechanism for specifying the location of Nix expressions, so let's use it instead of adding another environment variable.
* Fix nixpkgs manual generation, missing para closing tag.Nicolas B. Pierron2017-01-16
|
* Fix extra nits from aneeshusaNicolas B. Pierron2017-01-16
|
* Update overlay documentation by following nits from aneeshusa.Nicolas B. Pierron2017-01-16
|
* Replace 'phases' by 'layers' in overlays documentation.Nicolas B. Pierron2017-01-16
|
* Throw an error if NIXPKGS_OVERLAYS is invalid and improve documentation.Nicolas B. Pierron2017-01-16
|
* Add overlays mechanism to Nixpkgs.Nicolas B. Pierron2017-01-16
This patch add a new argument to Nixpkgs default expression named "overlays". By default, the value of the argument is either taken from the environment variable `NIXPKGS_OVERLAYS`, or from the directory `~/.nixpkgs/overlays/`. If the environment variable does not name a valid directory then this mechanism would fallback on the home directory. If the home directory does not exists it will fallback on an empty list of overlays. The overlays directory should contain the list of extra Nixpkgs stages which would be used to extend the content of Nixpkgs, with additional set of packages. The overlays, i-e directory, files, symbolic links are used in alphabetical order. The simplest overlay which extends Nixpkgs with nothing looks like: ```nix self: super: { } ``` More refined overlays can use `super` as the basis for building new packages, and `self` as a way to query the final result of the fix-point. An example of overlay which extends Nixpkgs with a small set of packages can be found at: https://github.com/nbp/nixpkgs-mozilla/blob/nixpkgs-overlay/moz-overlay.nix To use this file, checkout the repository and add a symbolic link to the `moz-overlay.nix` file in `~/.nixpkgs/overlays` directory.