Merge remote-tracking branch 'origin/master' into fonts

1 files changed, 8 insertions, 3 deletions

diff --git a/modules/fonts/default.nix b/modules/fonts/default.nix
index 9b33db0..b39df76 100644
--- a/modules/fonts/default.nix
+++ b/modules/fonts/default.nix
@@ -14,9 +14,9 @@ in
   options = {
     fonts.fontDir.enable = mkOption {
       default = false;
-      description = ''
+      description = lib.mdDoc ''
         Whether to enable font management and install configured fonts to
-        <filename>/Library/Fonts</filename>.
+        {file}`/Library/Fonts`.
 
         NOTE: removes any manually-added fonts.
       '';
@@ -26,7 +26,12 @@ in
       type = types.listOf types.path;
       default = [ ];
       example = literalExpression "[ pkgs.dejavu_fonts ]";
-      description = "List of fonts to install.";
+      description = lib.mdDoc ''
+        List of fonts to install.
+
+        Fonts present in later entries override those with the same filenames
+        in previous ones.
+      '';
     };
   };