README.md: clarify overlays better

This commit is contained in:
Timothy DeHerrera 2020-01-06 00:16:21 -07:00
parent 395be3f74c
commit 32381093ad
No known key found for this signature in database
GPG key ID: 8985725DB5B0C122

View file

@ -151,20 +151,21 @@ only be imported from the `users` or [`hosts`](hosts) directory.
## Modules, Packages and Overlays ## Modules, Packages and Overlays
All expressions in both [modules/defualt.nix](modules/default.nix) and All expressions in both [modules/defualt.nix](modules/default.nix) and
[pkgs/default.nix](pkgs/default.nix) are available globally, anywhere else in the [pkgs/default.nix](pkgs/default.nix) are available globally, anywhere else in the
repo. They are additionally included in the `nixosModules` or `overlays` flake repo. They are additionally included in the `nixosModules` and `overlay` flake
outputs. Packages can manually be added to [flake.nix](flake.nix) for inclusion outputs, respectively. Packages can manually be added to [flake.nix](flake.nix)
in the `packages` output as well. for inclusion in the `packages` output as well.
All overlays should be defined in the [overlays](overlays) directory. They will
be automatically pulled in for use by all configurations. Nix command line tools
will be able to read overlays from here as well since it is set as
`nixpkgs-overlays` in `NIX_PATH`.
The directory structure is identical to nixpkgs to provide a kind of staging area The directory structure is identical to nixpkgs to provide a kind of staging area
for any modules or packages we might be wanting to merge there later. If your not for any modules or packages we might be wanting to merge there later. If your not
familiar or can't be bothered, simply dropping a valid nix file and pointing the familiar or can't be bothered, simply dropping a valid nix file and pointing the
`default.nix` to it, is all that's really required. `default.nix` to it, is all that's really required.
As for overlays, they should be defined in the [overlays](overlays) directory.
They will be automatically pulled in for use by all configurations. Nix command
line tools will be able to read overlays from here as well since it is set as
`nixpkgs-overlays` in `NIX_PATH`. And of course they will be exported via the
flake output `overlays` as well.
# License # License
This software is licensed under the [MIT License](COPYING). This software is licensed under the [MIT License](COPYING).