0
0
Fork 0
mirror of https://github.com/NixOS/nixpkgs.git synced 2025-07-13 13:40:28 +03:00

nixos: remove all uses of lib.mdDoc

these changes were generated with nixq 0.0.2, by running

  nixq ">> lib.mdDoc[remove] Argument[keep]" --batchmode nixos/**.nix
  nixq ">> mdDoc[remove] Argument[keep]" --batchmode nixos/**.nix
  nixq ">> Inherit >> mdDoc[remove]" --batchmode nixos/**.nix

two mentions of the mdDoc function remain in nixos/, both of which
are inside of comments.

Since lib.mdDoc is already defined as just id, this commit is a no-op as
far as Nix (and the built manual) is concerned.
This commit is contained in:
stuebinm 2024-04-13 14:54:15 +02:00 committed by Jonathan Ringer
parent 1dd996e59a
commit 6afb255d97
1701 changed files with 13694 additions and 13865 deletions

View file

@ -19,12 +19,12 @@ in
# One could also do regular btrfs balances, but that shouldn't be necessary
# during normal usage and as long as the filesystems aren't filled near capacity
services.btrfs.autoScrub = {
enable = mkEnableOption (lib.mdDoc "regular btrfs scrub");
enable = mkEnableOption "regular btrfs scrub";
fileSystems = mkOption {
type = types.listOf types.path;
example = [ "/" ];
description = lib.mdDoc ''
description = ''
List of paths to btrfs filesystems to regularly call {command}`btrfs scrub` on.
Defaults to all mount points with btrfs filesystems.
If you mount a filesystem multiple times or additionally mount subvolumes,
@ -36,7 +36,7 @@ in
default = "monthly";
type = types.str;
example = "weekly";
description = lib.mdDoc ''
description = ''
Systemd calendar expression for when to scrub btrfs filesystems.
The recommended period is a month but could be less
({manpage}`btrfs-scrub(8)`).

View file

@ -28,8 +28,8 @@ let
in {
options = {
services.envfs = {
enable = lib.mkEnableOption (lib.mdDoc "Envfs filesystem") // {
description = lib.mdDoc ''
enable = lib.mkEnableOption "Envfs filesystem" // {
description = ''
Fuse filesystem that returns symlinks to executables based on the PATH
of the requesting process. This is useful to execute shebangs on NixOS
that assume hard coded locations in locations like /bin or /usr/bin
@ -41,14 +41,14 @@ in {
type = lib.types.package;
default = pkgs.envfs;
defaultText = lib.literalExpression "pkgs.envfs";
description = lib.mdDoc "Which package to use for the envfs.";
description = "Which package to use for the envfs.";
};
extraFallbackPathCommands = lib.mkOption {
type = lib.types.lines;
default = "";
example = "ln -s $''{pkgs.bash}/bin/bash $out/bash";
description = lib.mdDoc "Extra commands to run in the package that contains fallback executables in case not other executable is found";
description = "Extra commands to run in the package that contains fallback executables in case not other executable is found";
};
};
};

View file

@ -69,7 +69,7 @@ in
idmapd.settings = mkOption {
type = format.type;
default = {};
description = lib.mdDoc ''
description = ''
libnfsidmap configuration. Refer to
<https://linux.die.net/man/5/idmapd.conf>
for details.
@ -88,7 +88,7 @@ in
settings = mkOption {
type = format.type;
default = {};
description = lib.mdDoc ''
description = ''
General configuration for NFS daemons and tools.
See nfs.conf(5) and related man pages for details.
'';
@ -101,7 +101,7 @@ in
extraConfig = mkOption {
type = types.lines;
default = "";
description = lib.mdDoc ''
description = ''
Extra nfs-utils configuration.
'';
};

View file

@ -44,7 +44,7 @@ let
lowerdir = lib.mkOption {
type = with lib.types; nullOr (nonEmptyListOf (either str pathInStore));
default = null;
description = lib.mdDoc ''
description = ''
The list of path(s) to the lowerdir(s).
To create a writable overlay, you MUST provide an upperdir and a
@ -58,7 +58,7 @@ let
upperdir = lib.mkOption {
type = lib.types.nullOr lib.types.str;
default = null;
description = lib.mdDoc ''
description = ''
The path to the upperdir.
If this is null, a read-only overlay is created using the lowerdir.
@ -70,7 +70,7 @@ let
workdir = lib.mkOption {
type = lib.types.nullOr lib.types.str;
default = null;
description = lib.mdDoc ''
description = ''
The path to the workdir.
This MUST be set if you set `upperdir`.

View file

@ -222,14 +222,14 @@ in
type = types.package;
default = pkgs.zfs;
defaultText = literalExpression "pkgs.zfs";
description = lib.mdDoc "Configured ZFS userland tools package, use `pkgs.zfs_unstable` if you want to track the latest staging ZFS branch.";
description = "Configured ZFS userland tools package, use `pkgs.zfs_unstable` if you want to track the latest staging ZFS branch.";
};
modulePackage = mkOption {
internal = true; # It is supposed to be selected automatically, but can be overridden by expert users.
default = selectModulePackage cfgZfs.package;
type = types.package;
description = lib.mdDoc "Configured ZFS kernel module package.";
description = "Configured ZFS kernel module package.";
};
enabled = mkOption {
@ -237,13 +237,13 @@ in
type = types.bool;
default = inInitrd || inSystem;
defaultText = literalMD "`true` if ZFS filesystem support is enabled";
description = lib.mdDoc "True if ZFS filesystem support is enabled";
description = "True if ZFS filesystem support is enabled";
};
allowHibernation = mkOption {
type = types.bool;
default = false;
description = lib.mdDoc ''
description = ''
Allow hibernation support, this may be a unsafe option depending on your
setup. Make sure to NOT use Swap on ZFS.
'';
@ -253,7 +253,7 @@ in
type = types.listOf types.str;
default = [];
example = [ "tank" "data" ];
description = lib.mdDoc ''
description = ''
Name or GUID of extra ZFS pools that you wish to import during boot.
Usually this is not necessary. Instead, you should set the mountpoint property
@ -271,7 +271,7 @@ in
devNodes = mkOption {
type = types.path;
default = "/dev/disk/by-id";
description = lib.mdDoc ''
description = ''
Name of directory from which to import ZFS devices.
This should be a path under /dev containing stable names for all devices needed, as
@ -282,7 +282,7 @@ in
forceImportRoot = mkOption {
type = types.bool;
default = true;
description = lib.mdDoc ''
description = ''
Forcibly import the ZFS root pool(s) during early boot.
This is enabled by default for backwards compatibility purposes, but it is highly
@ -300,7 +300,7 @@ in
forceImportAll = mkOption {
type = types.bool;
default = false;
description = lib.mdDoc ''
description = ''
Forcibly import all ZFS pool(s).
If you set this option to `false` and NixOS subsequently fails to
@ -314,7 +314,7 @@ in
type = types.either types.bool (types.listOf types.str);
default = true;
example = [ "tank" "data" ];
description = lib.mdDoc ''
description = ''
If true on import encryption keys or passwords for all encrypted datasets
are requested. To only decrypt selected datasets supply a list of dataset
names instead. For root pools the encryption key can be supplied via both
@ -325,7 +325,7 @@ in
passwordTimeout = mkOption {
type = types.int;
default = 0;
description = lib.mdDoc ''
description = ''
Timeout in seconds to wait for password entry for decrypt at boot.
Defaults to 0, which waits forever.
@ -349,7 +349,7 @@ in
enable = mkOption {
default = false;
type = types.bool;
description = lib.mdDoc ''
description = ''
Enable the (OpenSolaris-compatible) ZFS auto-snapshotting service.
Note that you must set the `com.sun:auto-snapshot`
property to `true` on all datasets which you wish
@ -365,7 +365,7 @@ in
default = "-k -p";
example = "-k -p --utc";
type = types.str;
description = lib.mdDoc ''
description = ''
Flags to pass to the zfs-auto-snapshot command.
Run `zfs-auto-snapshot` (without any arguments) to
@ -383,7 +383,7 @@ in
frequent = mkOption {
default = 4;
type = types.int;
description = lib.mdDoc ''
description = ''
Number of frequent (15-minute) auto-snapshots that you wish to keep.
'';
};
@ -391,7 +391,7 @@ in
hourly = mkOption {
default = 24;
type = types.int;
description = lib.mdDoc ''
description = ''
Number of hourly auto-snapshots that you wish to keep.
'';
};
@ -399,7 +399,7 @@ in
daily = mkOption {
default = 7;
type = types.int;
description = lib.mdDoc ''
description = ''
Number of daily auto-snapshots that you wish to keep.
'';
};
@ -407,7 +407,7 @@ in
weekly = mkOption {
default = 4;
type = types.int;
description = lib.mdDoc ''
description = ''
Number of weekly auto-snapshots that you wish to keep.
'';
};
@ -415,7 +415,7 @@ in
monthly = mkOption {
default = 12;
type = types.int;
description = lib.mdDoc ''
description = ''
Number of monthly auto-snapshots that you wish to keep.
'';
};
@ -423,7 +423,7 @@ in
services.zfs.trim = {
enable = mkOption {
description = lib.mdDoc "Whether to enable periodic TRIM on all ZFS pools.";
description = "Whether to enable periodic TRIM on all ZFS pools.";
default = true;
example = false;
type = types.bool;
@ -433,7 +433,7 @@ in
default = "weekly";
type = types.str;
example = "daily";
description = lib.mdDoc ''
description = ''
How often we run trim. For most desktop and server systems
a sufficient trimming frequency is once a week.
@ -444,13 +444,13 @@ in
};
services.zfs.autoScrub = {
enable = mkEnableOption (lib.mdDoc "periodic scrubbing of ZFS pools");
enable = mkEnableOption "periodic scrubbing of ZFS pools";
interval = mkOption {
default = "Sun, 02:00";
type = types.str;
example = "daily";
description = lib.mdDoc ''
description = ''
Systemd calendar expression when to scrub ZFS pools. See
{manpage}`systemd.time(7)`.
'';
@ -460,7 +460,7 @@ in
default = [];
type = types.listOf types.str;
example = [ "tank" ];
description = lib.mdDoc ''
description = ''
List of ZFS pools to periodically scrub. If empty, all pools
will be scrubbed.
'';
@ -471,7 +471,7 @@ in
type = types.either (types.enum [ "disabled" "all" ]) (types.listOf types.str);
default = "disabled";
example = [ "tank" "dozer" ];
description = lib.mdDoc ''
description = ''
After importing, expand each device in the specified pools.
Set the value to the plain string "all" to expand all pools on boot:
@ -491,7 +491,7 @@ in
defaultText = literalExpression ''
config.services.mail.sendmailSetuidWrapper != null
'';
description = mdDoc ''
description = ''
Whether to enable ZED's ability to send emails.
'';
};
@ -513,7 +513,7 @@ in
ZED_SCRUB_AFTER_RESILVER = false;
}
'';
description = lib.mdDoc ''
description = ''
ZFS Event Daemon /etc/zfs/zed.d/zed.rc content
See