diff --git a/modules/flake-parts/disko-configurations.nix b/modules/flake-parts/disko-configurations.nix index 335e4055..1f35a20b 100644 --- a/modules/flake-parts/disko-configurations.nix +++ b/modules/flake-parts/disko-configurations.nix @@ -9,7 +9,7 @@ description = '' A set of [disko](https://github.com/nix-community/disko) configurations readily available as part of the flake output to be - used by {program}`disko`. Could be useful as backup initialization + used by {command}`disko`. Could be useful as backup initialization scripts for individual storage drives. ''; }; diff --git a/modules/flake-parts/setups/nixvim.nix b/modules/flake-parts/setups/nixvim.nix index 5edf68d0..65fe638f 100644 --- a/modules/flake-parts/setups/nixvim.nix +++ b/modules/flake-parts/setups/nixvim.nix @@ -1,3 +1,6 @@ +# Declarative NixVim configurations because everything under the Nix ecosystem +# must be so declarative so we're setting up declarative ways of declaring +# those accursed setups to be exported in this flake. { inputs , lib , config diff --git a/modules/nixos/_private/state/default.nix b/modules/nixos/_private/state/default.nix index 8cfe414e..b1080dc7 100644 --- a/modules/nixos/_private/state/default.nix +++ b/modules/nixos/_private/state/default.nix @@ -6,6 +6,8 @@ ./ports.nix ]; + # We can basically dump everything that is supposed to hold values for the + # entire system. This entry module should contain NOTHING ELSE! options.state = lib.mkOption { type = lib.types.submodule { freeformType = with lib.types; attrsOf anything; @@ -17,14 +19,16 @@ source of truth for different parts (e.g., services, program) of the system. ''; - example = { - services = { - postgresql.directory = "/var/lib/postgresql"; - backup.ignoreDirectories = [ - "node_modules" - ".direnv" - ]; - }; - }; + example = lib.literalExpression '' + { + services = { + postgresql.directory = "/var/lib/postgresql"; + backup.ignoreDirectories = [ + "node_modules" + ".direnv" + ]; + }; + } + ''; }; } diff --git a/modules/nixos/services/archivebox.nix b/modules/nixos/services/archivebox.nix index c65c50e7..be0b58de 100644 --- a/modules/nixos/services/archivebox.nix +++ b/modules/nixos/services/archivebox.nix @@ -151,6 +151,9 @@ in curl yt-dlp ] ++ lib.optional config.programs.git.enable config.programs.git.package; + defaultText = '' + Chromium, NodeJS, wget, yt-dlp, and git if enabled. + ''; example = lib.literalExpression '' with pkgs; [ curl diff --git a/modules/nixos/xdg/mime-desktop-specific.nix b/modules/nixos/xdg/mime-desktop-specific.nix index 449957af..013a40a8 100644 --- a/modules/nixos/xdg/mime-desktop-specific.nix +++ b/modules/nixos/xdg/mime-desktop-specific.nix @@ -1,4 +1,4 @@ -{ config, lib, options, pkgs, ... }: +{ config, lib, options, ... }: let cfg = config.xdg.mime; diff --git a/modules/wrapper-manager/sandboxing/boxxy.nix b/modules/wrapper-manager/sandboxing/boxxy.nix index 207899ed..baa81c86 100644 --- a/modules/wrapper-manager/sandboxing/boxxy.nix +++ b/modules/wrapper-manager/sandboxing/boxxy.nix @@ -63,7 +63,7 @@ let description = if isGlobal then '' Global list of arguments to be appended to each Boxxy-enabled wrappers. '' else '' - List of arguments to the {program}`boxxy` executable. + List of arguments to the {command}`boxxy` executable. ''; default = [ ]; example = [ "--immutable" "--daemon" ]; diff --git a/modules/wrapper-manager/sandboxing/bubblewrap/dbus-filter.nix b/modules/wrapper-manager/sandboxing/bubblewrap/dbus-filter.nix index d02d582c..393098d7 100644 --- a/modules/wrapper-manager/sandboxing/bubblewrap/dbus-filter.nix +++ b/modules/wrapper-manager/sandboxing/bubblewrap/dbus-filter.nix @@ -65,7 +65,7 @@ in type = with lib.types; attrsOf (submodule dbusFilterType); description = '' A global set of D-Bus addresses with their policies set with - {program}`xdg-dbus-proxy` for each D-Bus address specified on the + {command}`xdg-dbus-proxy` for each D-Bus address specified on the Bubblewrap-enabled wrappers. See {manpage}`xdg-dbus-proxy(1)` for more details. ''; @@ -102,7 +102,7 @@ in type = with lib.types; listOf str; description = '' List of proxy-specific arguments to be passed to - {program}`xdg-dbus-proxy`. + {command}`xdg-dbus-proxy`. ''; default = [ ]; }; @@ -131,7 +131,7 @@ in extraArgs = lib.mkOption { type = with lib.types; listOf str; description = '' - List of arguments to be passed to {program}`xdg-dbus-proxy`. + List of arguments to be passed to {command}`xdg-dbus-proxy`. ''; default = [ ]; }; @@ -140,7 +140,7 @@ in type = with lib.types; attrsOf (submodule addressesModule); description = '' A set of addresses to be applied with the filter through - {program}`xdg-dbus-proxy`. + {command}`xdg-dbus-proxy`. ''; default = { }; example = {