From 092777afe993dc1128c82476b35d27cafa92b4fa Mon Sep 17 00:00:00 2001 From: seth Date: Mon, 29 May 2023 22:21:55 -0400 Subject: docs: improve README instructions --- README.md | 27 ++++++++++++++++++++------- 1 file changed, 20 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index b919072..ab42e63 100644 --- a/README.md +++ b/README.md @@ -7,7 +7,8 @@ ### enable cachix i have a binary cache at , make sure to enable it -in your flake or nixos/darwin config. +in your flake or nixos/darwin config or use `nix run nixpkgs#cachix use getchoo` +for cli support. ### library @@ -20,8 +21,7 @@ in your flake or nixos/darwin config. { inputs = { getchoo = { - url = "github:getchoo/overlay"; - inputs.nixpkgs.follows = "nixpkgs"; + url = "github:getchoo/nix-exprs"; }; }; @@ -68,21 +68,34 @@ in { ### cli support -`nixpkgs.overlays` does not configure overlays for tools -such as `nix(-)run`, `nix(-)shell`, etc. +this overlay can also be used in the base nix package manager :) -the best way to make this overlay available to them is to +> **Note** +> for nixos/nix-darwin users, `nixpkgs.overlays` does not configure +> overlays for tools such as `nix(-)run`, `nix(-)shell`, etc. so this +> will also be required for you + +the best way to make this overlay available for you is to add it to your flake registry or `~/.config/nixpkgs/overlays.nix`. #### flake registry +this is the preferred way to use this overlay in the cli, as it allows +for full reproducibility with the flake. + +to use this overlay with commands like `nix build/run/shell`, you can +add it to your flake registry: + ```shell -nix registry add getchoo github:getchoo/overlay +nix registry add getchoo github:getchoo/nix-exprs nix run getchoo#treefetch ``` #### overlays.nix +for those who don't want to use this flake's revision of nixpkgs, +or do not use flakes, you can also add it as an overlay. + [add the channel](#adding-the-channel) to your nix profile, then place this in `~/.config/nixpkgs/overlays.nix` (or a nix file in `~/.config/nixpkgs/overlays/`): -- cgit v1.2.3