lix/doc/manual
Rebecca Turner 727b43478c Add repl-overlays
Adds a `repl-overlays` option, which specifies files that can overlay
and modify the top-level bindings in `nix repl`. For example, with the
following contents in `~/.config/nix/repl.nix`:

    info: final: prev: let
      optionalAttrs = predicate: attrs:
        if predicate
        then attrs
        else {};
    in
      optionalAttrs (prev ? legacyPackages && prev.legacyPackages ? ${info.currentSystem})
      {
        pkgs = prev.legacyPackages.${info.currentSystem};
      }

We can run `nix repl` and use `pkgs` to refer to `legacyPackages.${currentSystem}`:

    $ nix repl --repl-overlays ~/.config/nix/repl.nix nixpkgs
    Lix 2.90.0
    Type :? for help.
    Loading installable 'flake:nixpkgs#'...
    Added 5 variables.
    Loading 'repl-overlays'...
    Added 6 variables.
    nix-repl> pkgs.bash
    «derivation /nix/store/g08b5vkwwh0j8ic9rkmd8mpj878rk62z-bash-5.2p26.drv»

Change-Id: Ic12e0f2f210b2f46e920c33088dfe1083f42391a
2024-04-08 17:11:47 -07:00
..
rl-next Add repl-overlays 2024-04-08 17:11:47 -07:00
rl-next-dev
src
theme
anchors.jq
book.toml
custom.css
docroot.py
generate-builtin-constants.nix
generate-builtins.nix
generate-manpage.nix
generate-manpage.py meson: fix warm nix3 CLI manual generation 2024-04-06 14:43:14 -06:00
generate-xp-features-shortlist.nix
generate-xp-features.nix
local.mk
meson.build meson: fix warm nix3 CLI manual generation 2024-04-06 14:43:14 -06:00
process-includes.sh
quote-literals.xsl
redirects.js
render-manpage.sh
utils.nix