treewide: convert all option docs to Markdown
This process was automated by [my fork of `nix-doc-munge`]. All
conversions were automatically checked to produce the same DocBook
result when converted back, modulo minor typographical/formatting
differences on the acceptable-to-desirable spectrum.
To reproduce this commit, run:
$ NIX_PATH=nixpkgs=flake:nixpkgs/e7e69199f0372364a6106a1e735f68604f4c5a25 \
nix shell nixpkgs#coreutils \
-c find . -name '*.nix' \
-exec nix run -- github:emilazy/nix-doc-munge/98dadf1f77351c2ba5dcb709a2a171d655f15099 \
{} +
$ ./format
[my fork of `nix-doc-munge`]: https://github.com/emilazy/nix-doc-munge/tree/home-manager
This commit is contained in:
parent
c1d8d2a3d1
commit
36a53d9f26
355 changed files with 3805 additions and 3886 deletions
|
|
@ -22,8 +22,8 @@ let
|
|||
"";
|
||||
defaultText = literalExpression
|
||||
"if source is defined, the content of source, otherwise empty";
|
||||
description = ''
|
||||
Text of the nushell <filename>${name}</filename> file.
|
||||
description = lib.mdDoc ''
|
||||
Text of the nushell {file}`${name}` file.
|
||||
If unset then the source option will be preferred.
|
||||
'';
|
||||
};
|
||||
|
|
@ -31,8 +31,8 @@ let
|
|||
source = mkOption {
|
||||
type = types.nullOr types.path;
|
||||
default = null;
|
||||
description = ''
|
||||
Path of the nushell <filename>${name}</filename> file to use.
|
||||
description = lib.mdDoc ''
|
||||
Path of the nushell {file}`${name}` file to use.
|
||||
If the text option is set, it will be preferred.
|
||||
'';
|
||||
};
|
||||
|
|
@ -52,13 +52,13 @@ in {
|
|||
];
|
||||
|
||||
options.programs.nushell = {
|
||||
enable = mkEnableOption "nushell";
|
||||
enable = mkEnableOption (lib.mdDoc "nushell");
|
||||
|
||||
package = mkOption {
|
||||
type = types.package;
|
||||
default = pkgs.nushell;
|
||||
defaultText = literalExpression "pkgs.nushell";
|
||||
description = "The package to use for nushell.";
|
||||
description = lib.mdDoc "The package to use for nushell.";
|
||||
};
|
||||
|
||||
configFile = mkOption {
|
||||
|
|
@ -74,11 +74,10 @@ in {
|
|||
''';
|
||||
}
|
||||
'';
|
||||
description = ''
|
||||
description = lib.mdDoc ''
|
||||
The configuration file to be used for nushell.
|
||||
</para>
|
||||
<para>
|
||||
See <link xlink:href="https://www.nushell.sh/book/configuration.html#configuration" /> for more information.
|
||||
|
||||
See <https://www.nushell.sh/book/configuration.html#configuration> for more information.
|
||||
'';
|
||||
};
|
||||
|
||||
|
|
@ -88,11 +87,10 @@ in {
|
|||
example = ''
|
||||
let-env FOO = 'BAR'
|
||||
'';
|
||||
description = ''
|
||||
description = lib.mdDoc ''
|
||||
The environment variables file to be used for nushell.
|
||||
</para>
|
||||
<para>
|
||||
See <link xlink:href="https://www.nushell.sh/book/configuration.html#configuration" /> for more information.
|
||||
|
||||
See <https://www.nushell.sh/book/configuration.html#configuration> for more information.
|
||||
'';
|
||||
};
|
||||
|
||||
|
|
@ -105,18 +103,17 @@ in {
|
|||
echo "Hello, World"
|
||||
}
|
||||
'';
|
||||
description = ''
|
||||
description = lib.mdDoc ''
|
||||
The login file to be used for nushell upon logging in.
|
||||
</para>
|
||||
<para>
|
||||
See <link xlink:href="https://www.nushell.sh/book/configuration.html#configuring-nu-as-a-login-shell" /> for more information.
|
||||
|
||||
See <https://www.nushell.sh/book/configuration.html#configuring-nu-as-a-login-shell> for more information.
|
||||
'';
|
||||
};
|
||||
|
||||
extraConfig = mkOption {
|
||||
type = types.lines;
|
||||
default = "";
|
||||
description = ''
|
||||
description = lib.mdDoc ''
|
||||
Additional configuration to add to the nushell configuration file.
|
||||
'';
|
||||
};
|
||||
|
|
@ -124,7 +121,7 @@ in {
|
|||
extraEnv = mkOption {
|
||||
type = types.lines;
|
||||
default = "";
|
||||
description = ''
|
||||
description = lib.mdDoc ''
|
||||
Additional configuration to add to the nushell environment variables file.
|
||||
'';
|
||||
};
|
||||
|
|
@ -132,7 +129,7 @@ in {
|
|||
extraLogin = mkOption {
|
||||
type = types.lines;
|
||||
default = "";
|
||||
description = ''
|
||||
description = lib.mdDoc ''
|
||||
Additional configuration to add to the nushell login file.
|
||||
'';
|
||||
};
|
||||
|
|
@ -141,7 +138,7 @@ in {
|
|||
type = types.attrsOf types.str;
|
||||
default = { };
|
||||
example = { ll = "ls -l"; };
|
||||
description = ''
|
||||
description = lib.mdDoc ''
|
||||
An attribute set that maps aliases (the top level attribute names in
|
||||
this option) to command strings or directly to build outputs.
|
||||
'';
|
||||
|
|
@ -151,7 +148,7 @@ in {
|
|||
type = types.attrsOf types.str;
|
||||
default = { };
|
||||
example = { FOO = "BAR"; };
|
||||
description = ''
|
||||
description = lib.mdDoc ''
|
||||
An attribute set that maps an environment variable to a shell interpreted string.
|
||||
'';
|
||||
};
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue