languages: link to vim.lsp.servers for customization

horriblename · horriblename · commit c9bb5a762115 · 2025-09-10T10:47:51.000+02:00
diff --git a/modules/plugins/languages/asm.nix b/modules/plugins/languages/asm.nix
@@ -36,7 +36,10 @@ in {
       servers = mkOption {
         type = singleOrListOf (enum (attrNames servers));
         default = defaultServers;
-        description = "Assembly LSP server to use";
+        description = ''
+          Assembly LSP server to use. Customization of the servers can be done
+          via [](#opt-vim.lsp.servers).
+        '';
       };
     };
   };
diff --git a/modules/plugins/languages/astro.nix b/modules/plugins/languages/astro.nix
@@ -91,7 +91,10 @@ in {
       servers = mkOption {
         type = singleOrListOf (enum (attrNames servers));
         default = defaultServers;
-        description = "Astro LSP server to use";
+        description = ''
+          Astro LSP server to use. Customization of the servers can be done via
+          [](#opt-vim.lsp.servers).
+        '';
       };
     };
 
diff --git a/modules/plugins/languages/bash.nix b/modules/plugins/languages/bash.nix
@@ -57,7 +57,10 @@ in {
       servers = mkOption {
         type = singleOrListOf (enum (attrNames servers));
         default = defaultServers;
-        description = "Bash LSP server to use";
+        description = ''
+          Bash LSP server to use. Customization of the servers can be done via
+          [](#opt-vim.lsp.servers).
+        '';
       };
     };
 
diff --git a/modules/plugins/languages/clang.nix b/modules/plugins/languages/clang.nix
@@ -197,7 +197,10 @@ in {
       enable = mkEnableOption "clang LSP support" // {default = config.vim.lsp.enable;};
 
       servers = mkOption {
-        description = "The clang LSP server to use";
+        description = ''
+          The clang LSP server to use. Customization of the servers can be done
+          via [](#opt-vim.lsp.servers).
+        '';
         type = singleOrListOf (enum (attrNames servers));
         default = defaultServers;
       };
diff --git a/modules/plugins/languages/clojure.nix b/modules/plugins/languages/clojure.nix
@@ -39,7 +39,10 @@ in {
       servers = mkOption {
         type = listOf (enum (attrNames servers));
         default = defaultServers;
-        description = "Clojure LSP server to use";
+        description = ''
+          Clojure LSP server to use. Customization of the servers can be done
+          via [](#opt-vim.lsp.servers).
+        '';
       };
     };
   };
diff --git a/modules/plugins/languages/csharp.nix b/modules/plugins/languages/csharp.nix
@@ -185,7 +185,10 @@ in {
       lsp = {
         enable = mkEnableOption "C# LSP support" // {default = config.vim.lsp.enable;};
         servers = mkOption {
-          description = "C# LSP server to use";
+          description = ''
+            C# LSP server to use. Customization of the servers can be done via
+            [](#opt-vim.lsp.servers).
+          '';
           type = singleOrListOf (enum (attrNames servers));
           default = defaultServers;
         };
diff --git a/modules/plugins/languages/css.nix b/modules/plugins/languages/css.nix
@@ -76,7 +76,10 @@ in {
       servers = mkOption {
         type = singleOrListOf (enum (attrNames servers));
         default = defaultServer;
-        description = "CSS LSP server to use";
+        description = ''
+          CSS LSP server to use. Customization of the servers can be done via
+          [](#opt-vim.lsp.servers).
+        '';
       };
     };
 
diff --git a/modules/plugins/languages/dart.nix b/modules/plugins/languages/dart.nix
@@ -54,7 +54,10 @@ in {
       servers = mkOption {
         type = singleOrListOf (enum (attrNames servers));
         default = defaultServers;
-        description = "Dart LSP server to use";
+        description = ''
+          Dart LSP server to use. Customization of the servers can be done via
+          [](#opt-vim.lsp.servers).
+        '';
       };
     };
 
diff --git a/modules/plugins/languages/elixir.nix b/modules/plugins/languages/elixir.nix
@@ -65,7 +65,10 @@ in {
       servers = mkOption {
         type = singleOrListOf (enum (attrNames servers));
         default = defaultServers;
-        description = "Elixir LSP server to use";
+        description = ''
+          Elixir LSP server to use. Customization of the servers can be done via
+          [](#opt-vim.lsp.servers).
+        '';
       };
     };
 
diff --git a/modules/plugins/languages/fsharp.nix b/modules/plugins/languages/fsharp.nix
@@ -74,7 +74,10 @@ in {
         servers = mkOption {
           type = singleOrListOf (enum (attrNames servers));
           default = defaultServer;
-          description = "F# LSP server to use";
+          description = ''
+            F# LSP server to use. Customization of the servers can be done via
+            [](#opt-vim.lsp.servers).
+          '';
         };
       };
       format = {
diff --git a/modules/plugins/languages/gleam.nix b/modules/plugins/languages/gleam.nix
@@ -37,7 +37,10 @@ in {
       servers = mkOption {
         type = singleOrListOf (enum (attrNames servers));
         default = defaultServers;
-        description = "Gleam LSP server to use";
+        description = ''
+          Gleam LSP server to use. Customization of the servers can be done via
+          [](#opt-vim.lsp.servers).
+        '';
       };
     };
   };
diff --git a/modules/plugins/languages/go.nix b/modules/plugins/languages/go.nix
@@ -97,7 +97,10 @@ in {
       servers = mkOption {
         type = singleOrListOf (enum (attrNames servers));
         default = defaultServers;
-        description = "Go LSP server to use";
+        description = ''
+          Go LSP server to use. Customization of the servers can be done via
+          [](#opt-vim.lsp.servers).
+        '';
       };
     };
 
diff --git a/modules/plugins/languages/haskell.nix b/modules/plugins/languages/haskell.nix
@@ -79,7 +79,10 @@ in {
       servers = mkOption {
         type = listOf (enum (attrNames servers));
         default = defaultServers;
-        description = "Haskell LSP server to use";
+        description = ''
+          Haskell LSP server to use. Customization of the servers can be done
+          via [](#opt-vim.lsp.servers).
+        '';
       };
     };
 
diff --git a/modules/plugins/languages/hcl.nix b/modules/plugins/languages/hcl.nix
@@ -44,7 +44,10 @@ in {
       servers = mkOption {
         type = listOf (enum (attrNames servers));
         default = defaultServers;
-        description = "HCL LSP server to use";
+        description = ''
+          HCL LSP server to use. Customization of the servers can be done via
+          [](#opt-vim.lsp.servers).
+        '';
       };
     };
 
diff --git a/modules/plugins/languages/helm.nix b/modules/plugins/languages/helm.nix
@@ -51,7 +51,10 @@ in {
       servers = mkOption {
         type = singleOrListOf (enum (attrNames servers));
         default = defaultServers;
-        description = "Helm LSP server to use";
+        description = ''
+          Helm LSP server to use. Customization of the servers can be done via
+          [](#opt-vim.lsp.servers).
+        '';
       };
     };
   };
diff --git a/modules/plugins/languages/html.nix b/modules/plugins/languages/html.nix
@@ -60,7 +60,10 @@ in {
       servers = mkOption {
         type = singleOrListOf (enum (attrNames servers));
         default = defaultServers;
-        description = "HTML LSP server to use";
+        description = ''
+          HTML LSP server to use. Customization of the servers can be done via
+          [](#opt-vim.lsp.servers).
+        '';
       };
     };
 
diff --git a/modules/plugins/languages/java.nix b/modules/plugins/languages/java.nix
@@ -74,7 +74,10 @@ in {
       servers = mkOption {
         type = listOf (enum (attrNames servers));
         default = defaultServers;
-        description = "Java LSP server to use";
+        description = ''
+          Java LSP server to use. Customization of the servers can be done via
+          [](#opt-vim.lsp.servers).
+        '';
       };
     };
   };
diff --git a/modules/plugins/languages/json.nix b/modules/plugins/languages/json.nix
@@ -51,7 +51,10 @@ in {
       servers = mkOption {
         type = singleOrListOf (enum (attrNames servers));
         default = defaultServers;
-        description = "JSON LSP server to use";
+        description = ''
+          JSON LSP server to use. Customization of the servers can be done via
+          [](#opt-vim.lsp.servers).
+        '';
       };
     };
 
diff --git a/modules/plugins/languages/just.nix b/modules/plugins/languages/just.nix
@@ -39,7 +39,10 @@ in {
       servers = mkOption {
         type = listOf (enum (attrNames servers));
         default = defaultServers;
-        description = "Just LSP server to use";
+        description = ''
+          Just LSP server to use. Customization of the servers can be done via
+          [](#opt-vim.lsp.servers).
+        '';
       };
     };
   };
diff --git a/modules/plugins/languages/kotlin.nix b/modules/plugins/languages/kotlin.nix
@@ -65,7 +65,10 @@ in {
       servers = mkOption {
         type = listOf (enum (attrNames servers));
         default = defaultServers;
-        description = "Kotlin LSP server to use";
+        description = ''
+          Kotlin LSP server to use. Customization of the servers can be done via
+          [](#opt-vim.lsp.servers).
+        '';
       };
     };
 
diff --git a/modules/plugins/languages/lua.nix b/modules/plugins/languages/lua.nix
@@ -66,7 +66,10 @@ in {
       servers = mkOption {
         type = listOf (enum (attrNames servers));
         default = defaultServers;
-        description = "Lua LSP server to use";
+        description = ''
+          Lua LSP server to use. Customization of the servers can be done via
+          [](#opt-vim.lsp.servers).
+        '';
       };
 
       lazydev.enable = mkEnableOption "lazydev.nvim integration, useful for neovim plugin developers";
diff --git a/modules/plugins/languages/markdown.nix b/modules/plugins/languages/markdown.nix
@@ -62,7 +62,10 @@ in {
       enable = mkEnableOption "Markdown LSP support" // {default = config.vim.lsp.enable;};
 
       servers = mkOption {
-        description = "Markdown LSP server to use";
+        description = ''
+          Markdown LSP server to use. Customization of the servers can be done
+          via [](#opt-vim.lsp.servers).
+        '';
         type = singleOrListOf (enum (attrNames servers));
         default = defaultServers;
       };
diff --git a/modules/plugins/languages/nim.nix b/modules/plugins/languages/nim.nix
@@ -61,7 +61,10 @@ in {
       servers = mkOption {
         type = singleOrListOf (enum (attrNames servers));
         default = defaultServers;
-        description = "Nim LSP server to use";
+        description = ''
+          Nim LSP server to use. Customization of the servers can be done via
+          [](#opt-vim.lsp.servers).
+        '';
       };
     };
 
diff --git a/modules/plugins/languages/nix.nix b/modules/plugins/languages/nix.nix
@@ -100,7 +100,10 @@ in {
       servers = mkOption {
         type = singleOrListOf (enum (attrNames servers));
         default = defaultServers;
-        description = "Nix LSP server to use";
+        description = ''
+          Nix LSP server to use. Customization of the servers can be done via
+          [](#opt-vim.lsp.servers).
+        '';
       };
     };
 
diff --git a/modules/plugins/languages/nu.nix b/modules/plugins/languages/nu.nix
@@ -48,7 +48,10 @@ in {
       servers = mkOption {
         type = singleOrListOf (enum (attrNames servers));
         default = defaultServers;
-        description = "Nu LSP server to use";
+        description = ''
+          Nu LSP server to use. Customization of the servers can be done via
+          [](#opt-vim.lsp.servers).
+        '';
       };
     };
   };
diff --git a/modules/plugins/languages/ocaml.nix b/modules/plugins/languages/ocaml.nix
@@ -76,7 +76,10 @@ in {
       servers = mkOption {
         type = singleOrListOf (enum (attrNames servers));
         default = defaultServers;
-        description = "OCaml LSP server to use";
+        description = ''
+          OCaml LSP server to use. Customization of the servers can be done via
+          [](#opt-vim.lsp.servers).
+        '';
       };
     };
 
diff --git a/modules/plugins/languages/odin.nix b/modules/plugins/languages/odin.nix
@@ -48,7 +48,10 @@ in {
       servers = mkOption {
         type = singleOrListOf (enum (attrNames servers));
         default = defaultServers;
-        description = "Odin LSP server to use";
+        description = ''
+          Odin LSP server to use. Customization of the servers can be done via
+          [](#opt-vim.lsp.servers).
+        '';
       };
     };
   };
diff --git a/modules/plugins/languages/php.nix b/modules/plugins/languages/php.nix
@@ -79,7 +79,10 @@ in {
       servers = mkOption {
         type = singleOrListOf (enum (attrNames servers));
         default = defaultServers;
-        description = "PHP LSP server to use";
+        description = ''
+          PHP LSP server to use. Customization of the servers can be done via
+          [](#opt-vim.lsp.servers).
+        '';
       };
     };
   };
diff --git a/modules/plugins/languages/python.nix b/modules/plugins/languages/python.nix
@@ -242,7 +242,10 @@ in {
       servers = mkOption {
         type = singleOrListOf (enum (attrNames servers));
         default = defaultServers;
-        description = "Python LSP server to use";
+        description = ''
+          Python LSP server to use. Customization of the servers can be done
+          via [](#opt-vim.lsp.servers).
+        '';
       };
     };
 
diff --git a/modules/plugins/languages/qml.nix b/modules/plugins/languages/qml.nix
@@ -48,7 +48,10 @@ in {
       servers = mkOption {
         type = singleOrListOf (enum (attrNames servers));
         default = defaultServers;
-        description = "QML LSP server to use";
+        description = ''
+          QML LSP server to use. Customization of the servers can be done via
+          [](#opt-vim.lsp.servers).
+        '';
       };
     };
 
diff --git a/modules/plugins/languages/r.nix b/modules/plugins/languages/r.nix
@@ -79,7 +79,10 @@ in {
       servers = mkOption {
         type = singleOrListOf (enum (attrNames servers));
         default = defaultServers;
-        description = "R LSP server to use";
+        description = ''
+          R LSP server to use. Customization of the servers can be done via
+          [](#opt-vim.lsp.servers).
+        '';
       };
     };
 
diff --git a/modules/plugins/languages/ruby.nix b/modules/plugins/languages/ruby.nix
@@ -79,7 +79,10 @@ in {
       servers = mkOption {
         type = singleOrListOf (enum (attrNames servers));
         default = defaultServers;
-        description = "Ruby LSP server to use";
+        description = ''
+          Ruby LSP server to use. Customization of the servers can be done via
+          [](#opt-vim.lsp.servers).
+        '';
       };
     };
 
diff --git a/modules/plugins/languages/sql.nix b/modules/plugins/languages/sql.nix
@@ -80,7 +80,10 @@ in {
       servers = mkOption {
         type = singleOrListOf (enum (attrNames servers));
         default = defaultServers;
-        description = "SQL LSP server to use";
+        description = ''
+          SQL LSP server to use. Customization of the servers can be done via
+          [](#opt-vim.lsp.servers).
+        '';
       };
     };
 
diff --git a/modules/plugins/languages/svelte.nix b/modules/plugins/languages/svelte.nix
diff --git a/modules/plugins/languages/tailwind.nix b/modules/plugins/languages/tailwind.nix
diff --git a/modules/plugins/languages/terraform.nix b/modules/plugins/languages/terraform.nix
diff --git a/modules/plugins/languages/ts.nix b/modules/plugins/languages/ts.nix
diff --git a/modules/plugins/languages/typst.nix b/modules/plugins/languages/typst.nix
diff --git a/modules/plugins/languages/vala.nix b/modules/plugins/languages/vala.nix
diff --git a/modules/plugins/languages/wgsl.nix b/modules/plugins/languages/wgsl.nix
diff --git a/modules/plugins/languages/yaml.nix b/modules/plugins/languages/yaml.nix
diff --git a/modules/plugins/languages/zig.nix b/modules/plugins/languages/zig.nix
