commit 84a2cae442d6c7544bc5e515da4e4465f69ec128
from: Omar Polo <op@omarpolo.com>
via: Thomas Adam <thomas@xteddy.org>
date: Sat Dec 30 18:51:43 2023 UTC

gotwebd.8: improve EXAMPLES sections

tweaks and ok stsp

commit - c6c5c5fd9c8ee7a991803e2a8221453bd04f6153
commit + 84a2cae442d6c7544bc5e515da4e4465f69ec128
blob - 933316538bcea15e930372de12d02f34f95eb043
blob + 86dabae4e0bdace2e3e4d7bb41d6f497664ef0fd
--- gotwebd/gotwebd.8
+++ gotwebd/gotwebd.8
@@ -139,37 +139,43 @@ Directory for temporary files created by
 Example configuration for
 .Xr httpd.conf 5 :
 .Bd -literal -offset indent
-  types { include "/usr/share/misc/mime.types" }
+types { include "/usr/share/misc/mime.types" }
 
-  # one gotwebd reachable at http://gotweb1.example.com/
-  server "gotweb1.example.com" {
-        listen on * port 80
-        root "/htdocs/gotwebd"
-        location "/" {
-              fastcgi socket "/run/gotweb.sock"
-        }
-  }
+server "example.com" {
+	listen on * port 80
+	root "/htdocs/gotwebd"
+	location "/" {
+		fastcgi socket "/run/gotweb.sock"
+	}
+}
+.Ed
+.Pp
+Hosting multiple
+.Nm gotwebd
+instances on the same HTTP server under different path prefixes, with
+the first reached via the default
+.Ux Ns -domain socket, the second configured to listen on localhost
+port 9000:
+.Bd -literal -offset indent
+server "example.com" {
+	listen on * port 80
 
-  # hosting multiple gotwebd instances on the same HTTP server:
-  # http://gotweb2.example.com/gotwebd-unix/
-  # http://gotweb2.example.com/gotwebd-tcp/
-  server "gotweb2.example.com" {
-        listen on * port 80
-        location "/gotwebd-unix/" {
-              fastcgi socket "/run/gotweb.sock"
-        }
-        location "/gotwebd-unix/*" {
-               root "/htdocs/gotwebd"
-               request strip 1
-        }
-        location "/gotwebd-tcp/" {
-              fastcgi socket tcp 127.0.0.1 9000
-        }
-        location "/gotwebd-tcp/*" {
-               root "/htdocs/gotwebd"
-               request strip 1
-        }
-  }
+	location "/gotwebd-unix/" {
+		fastcgi socket "/run/gotweb.sock"
+	}
+	location "/gotwebd-unix/*" {
+		root "/htdocs/gotwebd"
+		request strip 1
+	}
+
+	location "/gotwebd-tcp/" {
+		fastcgi socket tcp localhost 9000
+	}
+	location "/gotwebd-tcp/*" {
+		root "/htdocs/gotwebd"
+		request strip 1
+	}
+}
 .Ed
 .Sh SEE ALSO
 .Xr got 1 ,