update

listen/http.conf

@@ -1,2 +1,5 @@
+# Minimal dual-stack HTTP listener. Keep default_server and proxy_protocol out
+# of the shared baseline so projects do not inherit mutually incompatible
+# listener behavior by accident.
 listen 80;
 listen [::]:80;

listen/http2.conf

@@ -1 +1,3 @@
+# Keep HTTP/2 separate from https.conf so older nginx 1.24.x systems can keep
+# using the compatibility snippet instead of failing on "http2 on;".
 http2 on;

listen/https-http2.conf

@@ -1,2 +1,4 @@
+# Compatibility listener for nginx 1.24.x and distro packages that still
+# expect HTTP/2 on the listen directive instead of a standalone "http2 on;".
 listen 443 ssl http2;
 listen [::]:443 ssl http2;

listen/https.conf

@@ -1,2 +1,4 @@
+# HTTPS listener without HTTP/2. Use this together with http2.conf on nginx
+# 1.25.1+ so newer installs avoid the "listen ... http2" deprecation warning.
 listen 443 ssl;
 listen [::]:443 ssl;