Merge master into staging-next

  To avoid updating this field when dependencies change, run `go mod vendor` in your source repo and set `vendorHash = null;`

  To obtain the actual hash, set `vendorHash = lib.fakeSha256;` and run the build ([more details here](#sec-source-hashes)).

- `proxyVendor`: Fetches (go mod download) and proxies the vendor directory. This is useful if your code depends on c code and go mod tidy does not include the needed sources to build or if any dependency has case-insensitive conflicts which will produce platform dependant `vendorHash` checksums.

- `proxyVendor`: Fetches (go mod download) and proxies the vendor directory. This is useful if your code depends on c code and go mod tidy does not include the needed sources to build or if any dependency has case-insensitive conflicts which will produce platform-dependent `vendorHash` checksums.

- `modPostBuild`: Shell commands to run after the build of the go-modules executes `go mod vendor`, and before calculating fixed output derivation's `vendorHash` (or `vendorSha256`). Note that if you change this attribute, you need to update `vendorHash` (or `vendorSha256`) attribute.

```nix

    githubId = 1009523;

    name = "Ashijit Pramanik";

  };

  name-snrl = {

    github = "name-snrl";

    githubId = 72071763;

    name = "Yusup Urazaev";

  };

  namore = {

    email = "namor@hemio.de";

    github = "namore";

<!-- To avoid merge conflicts, consider adding your item at an arbitrary place in the list instead. -->

- [river](https://github.com/riverwm/river), A dynamic tiling wayland compositor. Available as [programs.river](#opt-programs.river.enable).

## Backward Incompatibilities {#sec-release-23.11-incompatibilities}

- The latest version of `clonehero` now stores custom content in `~/.clonehero`. See the [migration instructions](https://clonehero.net/2022/11/29/v23-to-v1-migration-instructions.html). Typically, these content files would exist along side the binary, but the previous build used a wrapper script that would store them in `~/.config/unity3d/srylain Inc_/Clone Hero`.

- `etcd` has been updated to 3.5, you will want to read the [3.3 to 3.4](https://etcd.io/docs/v3.5/upgrades/upgrade_3_4/) and [3.4 to 3.5](https://etcd.io/docs/v3.5/upgrades/upgrade_3_5/) upgrade guides

## Other Notable Changes {#sec-release-23.11-notable-changes}

- A new option was added to the virtualisation module that enables specifying explicitly named network interfaces in QEMU VMs. The existing `virtualisation.vlans` is still supported for cases where the name of the network interface is irrelevant.

  ./programs/starship.nix

  ./programs/steam.nix

  ./programs/streamdeck-ui.nix

  ./programs/sway.nix

  ./programs/sysdig.nix

  ./programs/system-config-printer.nix

  ./programs/systemtap.nix

  ./programs/usbtop.nix

  ./programs/vim.nix

  ./programs/wavemon.nix

  ./programs/waybar.nix

  ./programs/wayland/river.nix

  ./programs/wayland/sway.nix

  ./programs/wayland/waybar.nix

  ./programs/weylus.nix

  ./programs/wireshark.nix

  ./programs/xastir.nix

  ./services/x11/window-managers/default.nix

  ./services/x11/window-managers/fluxbox.nix

  ./services/x11/window-managers/icewm.nix

  ./services/x11/window-managers/bspwm.nix

  ./services/x11/window-managers/katriawm.nix

  ./services/x11/window-managers/metacity.nix

  ./services/x11/window-managers/nimdow.nix

{

  config,

  pkgs,

  lib,

  ...

}:

with lib; let

  cfg = config.programs.river;

in {

  options.programs.river = {

    enable = mkEnableOption (lib.mdDoc "river, a dynamic tiling Wayland compositor");

    package = mkOption {

      type = with types; nullOr package;

      default = pkgs.river;

      defaultText = literalExpression "pkgs.river";

      description = lib.mdDoc ''

        River package to use.

        Set to `null` to not add any River package to your path.

        This should be done if you want to use the Home Manager River module to install River.

      '';

    };

    extraPackages = mkOption {

      type = with types; listOf package;

      default = with pkgs; [

        swaylock

        foot

        dmenu

      ];

      defaultText = literalExpression ''

        with pkgs; [ swaylock foot dmenu ];

      '';

      example = literalExpression ''

        with pkgs; [

          termite rofi light

        ]

      '';

      description = lib.mdDoc ''

        Extra packages to be installed system wide. See

        [Common X11 apps used on i3 with Wayland alternatives](https://github.com/swaywm/sway/wiki/i3-Migration-Guide#common-x11-apps-used-on-i3-with-wayland-alternatives)

        for a list of useful software.

      '';

    };

  };

  config =

    mkIf cfg.enable (mkMerge [

      {

        environment.systemPackages = optional (cfg.package != null) cfg.package ++ cfg.extraPackages;

        # To make a river session available if a display manager like SDDM is enabled:

        programs.xwayland.enable = mkDefault true;

      }

      (import ./wayland-session.nix { inherit lib pkgs; })

    ]);

  meta.maintainers = with lib.maintainers; [ GaetanLepage ];

}