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 Enable clang build timing analysis 2024-03-27 03:52:57 +00:00
src Revert "meson: move nix3 manpage generation into command-ref/" 2024-04-04 11:59:08 -06:00
theme Add pre-commit checks 2024-03-29 22:57:40 -07:00
anchors.jq Add pre-commit checks 2024-03-29 22:57:40 -07:00
book.toml docs: replace sed invocation with an mdbook preprocessor for @docroot@ 2024-04-04 21:43:19 +00:00
custom.css disallow selecting shell prompt in code samples 2022-12-05 11:01:46 +01:00
docroot.py docs: replace sed invocation with an mdbook preprocessor for @docroot@ 2024-04-04 21:43:19 +00:00
generate-builtin-constants.nix revert anchor prefix for builtin constants 2023-07-20 10:27:38 +02:00
generate-builtins.nix Automatically document builtin constants 2023-06-27 09:37:54 -04:00
generate-manpage.nix Merge pull request #8931 from fricklerhandwerk/nix3-config-options 2024-03-04 04:35:54 +01:00
generate-manpage.py meson: fix warm nix3 CLI manual generation 2024-04-06 14:43:14 -06:00
generate-xp-features-shortlist.nix Single page for experimental feature descriptions 2023-04-09 11:01:23 -04:00
generate-xp-features.nix Single page for experimental feature descriptions 2023-04-09 11:01:23 -04:00
local.mk docs: replace sed invocation with an mdbook preprocessor for @docroot@ 2024-04-04 21:43:19 +00:00
meson.build meson: fix warm nix3 CLI manual generation 2024-04-06 14:43:14 -06:00
process-includes.sh meson: add manpages for old cli and config files 2024-03-30 14:26:47 +00:00
quote-literals.xsl Generate release notes again 2014-03-12 14:24:29 +01:00
redirects.js fix an old lost direct (#9717) 2024-01-08 20:57:39 +01:00
render-manpage.sh doc: remove the -- unescaping hack 2024-04-01 20:15:28 +00:00
utils.nix backport fix for the --help output 2023-11-10 19:22:42 +01:00