files: minor documentation improvements

This commit is contained in:
Robert Helgesson 2020-07-31 00:54:23 +02:00
parent bb6eb9b13e
commit 79a2320fd0
No known key found for this signature in database
GPG key ID: 36BDAA14C2797E89

View file

@ -21,6 +21,7 @@ with lib;
absPath = if hasPrefix "/" p then p else "${basePath}/${p}"; absPath = if hasPrefix "/" p then p else "${basePath}/${p}";
in in
removePrefix (homeDirectory + "/") absPath; removePrefix (homeDirectory + "/") absPath;
defaultText = literalExample "<name>";
description = '' description = ''
Path to target file relative to ${basePathDesc}. Path to target file relative to ${basePathDesc}.
''; '';
@ -29,17 +30,20 @@ with lib;
text = mkOption { text = mkOption {
default = null; default = null;
type = types.nullOr types.lines; type = types.nullOr types.lines;
description = "Text of the file."; description = ''
Text of the file. If this option is null then
<link linkend="opt-home.file._name__.source">home.file.&lt;name?&gt;.source</link>
must be set.
'';
}; };
source = mkOption { source = mkOption {
type = types.path; type = types.path;
description = '' description = ''
Path of the source file. The file name must not start Path of the source file or directory. If
with a period since Nix will not allow such names in <link linkend="opt-home.file._name__.text">home.file.&lt;name?&gt;.text</link>
the Nix store. is non-null then this option will automatically point to a file
</para><para> containing that text.
This may refer to a directory.
''; '';
}; };