From 1e3e30d56649dd3a910da3dc4bc3091f0af68c4d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E0=B9=82=E0=B8=97=E0=B8=AA=E0=B8=BA=E0=B8=95=E0=B8=B1?=
 =?UTF-8?q?=E0=B8=A5?= <toastal@posteo.net>
Date: Sun, 2 Mar 2025 18:05:30 +0700
Subject: [PATCH] nixos/h2o: clarify/format some docs to point to upstream
 config

---
 .../web-servers/h2o/vhost-options.nix         | 24 +++++++++++++------
 1 file changed, 17 insertions(+), 7 deletions(-)

diff --git a/nixos/modules/services/web-servers/h2o/vhost-options.nix b/nixos/modules/services/web-servers/h2o/vhost-options.nix
index 4bbca40974bf..9c8a74a62bb1 100644
--- a/nixos/modules/services/web-servers/h2o/vhost-options.nix
+++ b/nixos/modules/services/web-servers/h2o/vhost-options.nix
@@ -33,7 +33,8 @@ in
         "example.org"
       ];
       description = ''
-        Additional names of virtual hosts served by this virtual host configuration.
+        Additional names of virtual hosts served by this virtual host
+        configuration.
       '';
     };
 
@@ -42,7 +43,8 @@ in
       default = null;
       example = "127.0.0.1";
       description = ''
-        Set the host address for this virtual host.
+        Set the host address for this virtual host. If unset, the default is to
+        listen on all network interfaces.
       '';
     };
 
@@ -79,7 +81,7 @@ in
                 config.services.h2o.defaultTLSListenPort
               '';
               description = ''
-                Override the default TLS port for this virtual host.";
+                Override the default TLS port for this virtual host.
               '';
               example = 8443;
             };
@@ -114,11 +116,17 @@ in
                   options = {
                     key-file = mkOption {
                       type = types.path;
-                      description = "Path to key file";
+                      description = ''
+                        Path to key file. See
+                        <https://h2o.examp1e.net/configure/base_directives.html#key-file>.
+                      '';
                     };
                     certificate-file = mkOption {
                       type = types.path;
-                      description = "Path to certificate file";
+                      description = ''
+                        Path to certificate file. See
+                        <https://h2o.examp1e.net/configure/base_directives.html#certificate-file>.
+                      '';
                     };
                   };
                 }
@@ -148,7 +156,8 @@ in
               type = types.attrs;
               default = { };
               description = ''
-                Additional TLS/SSL-related configuration options.
+                Additional TLS/SSL-related configuration options. See
+                <https://h2o.examp1e.net/configure/base_directives.html#listen-ssl>.
               '';
               example =
                 literalExpression
@@ -214,7 +223,8 @@ in
       default = { };
       description = ''
         Attrset to be transformed into YAML for host config. Note that the HTTP
-        / TLS configurations will override these config values.
+        / TLS configurations will override these config values. See
+        <https://h2o.examp1e.net/configure/base_directives.html#hosts>.
       '';
     };
   };