fish: plugins uses pluginModule type, add example

1 files changed, 28 insertions, 4 deletions

diff --git a/modules/programs/fish.nix b/modules/programs/fish.nix
index 12f33304b92..ca5f1108d2d 100644
--- a/modules/programs/fish.nix
+++ b/modules/programs/fish.nix
@@ -111,12 +111,36 @@ in
     };
 
     programs.fish.plugins = mkOption {
-      type = types.listOf types.package;
+      type = types.listOf pluginModule;
       default = [];
+      example = literalExample ''
+        [
+          {
+            name = "z";
+            src = pkgs.fetchFromGitHub {
+              owner = "jethrokuan";
+              repo = "z";
+              rev = "ddeb28a7b6a1f0ec6dae40c636e5ca4908ad160a";
+              sha256 = "0c5i7sdrsp0q3vbziqzdyqn4fmp235ax4mn4zslrswvn8g3fvdyh";
+            };
+          }
+
+          # oh-my-fish plugins are stored in their own repositories, which
+          # makes them simple to import into home-manager.
+          {
+            name = "fasd";
+            src = pkgs.fetchFromGitHub {
+              owner = "oh-my-fish";
+              repo = "plugin-fasd";
+              rev = "38a5b6b6011106092009549e52249c6d6f501fba";
+              sha256 = "06v37hqy5yrv5a6ssd1p3cjd9y3hnp19d3ab7dag56fs1qmgyhbs";
+            };
+          }
+        ]
+      '';
       description = ''
-        The plugins to add to fish.
-        Built with <varname>buildFishPlugin</varname>.
-        Overrides manually installed ones.
+        The plugins to source in
+        <filename>conf.d/99plugins.fish</filename>.
       '';
     };