From 69e34a630aa835783412477ebd41fed289361a71 Mon Sep 17 00:00:00 2001
From: Omar Polo <op@omarpolo.com>
Date: Sat, 3 Aug 2024 10:49:39 +0000
Subject: [PATCH] gmid.conf.5: some love for the EXAMPLES section

Few grammar and style fixes, plus add an example about logging on
a file.

Prodded by https://github.com/omar-polo/gmid/issues/34
---
 gmid.conf.5 | 25 ++++++++++++++++++++-----
 1 file changed, 20 insertions(+), 5 deletions(-)

diff --git a/gmid.conf.5 b/gmid.conf.5
index f509c5a..66e4299 100644
--- a/gmid.conf.5
+++ b/gmid.conf.5
@@ -631,7 +631,7 @@ if no mapping was found.
 The following is an example of a possible configuration for a site
 that enables only TLSv1.3, adds the MIME types mapping from
 .Pa /usr/share/misc/mime.types
-and defines two virtual host:
+and defines two virtual hosts:
 .Bd -literal -offset indent
 protocols "tlsv1.3"
 
@@ -657,9 +657,9 @@ server "example.it" {
 }
 .Ed
 .Pp
-Yet another example, showing how to enable a
+This example shows how to enable the
 .Ic chroot
-and use
+and use a
 .Ic location
 rule
 .Bd -literal -offset indent
@@ -686,13 +686,28 @@ server "example.com" {
 }
 .Ed
 .Pp
-This shows how to set up a reverse proxy: all request for
+This example shows how to log requests to
+.Pa /var/gemini/logs/access.log
+when running in the
+.Pa /var/gemini
+chroot.
+The file will be created if not exists.
+.Bd -literal -offset indent
+chroot "/var/gemini"
+user "_gmid"
+
+log {
+	access "/logs/access.log"  # relative to the chroot
+}
+.Ed
+.Pp
+This example shows how to set up a reverse proxy: all request for
 .Sq example.com
 will be forwarded to 10.0.0.6 transparently.
 Proxying establish a new TLS connection, so any client-certificates used
 to connect to
 .Xr gmid 8
-cannot be provided to the proxied server as well.
+cannot be provided to the proxied server.
 .Bd -literal -offset indent
 server "example.com" {
 	listen on * port 1965