From bdfea70f305cae0cee71d79f097aff93a69bccf7 Mon Sep 17 00:00:00 2001
From: Omar Polo <op@omarpolo.com>
Date: Fri, 28 Jun 2024 18:55:12 +0000
Subject: [PATCH] document proxy-v1

---
 gmid.conf.5 | 16 ++++++++++++++--
 1 file changed, 14 insertions(+), 2 deletions(-)

diff --git a/gmid.conf.5 b/gmid.conf.5
index 743a8e9..40b2800 100644
--- a/gmid.conf.5
+++ b/gmid.conf.5
@@ -11,7 +11,7 @@
 .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
-.Dd June 11, 2024
+.Dd June 28, 2024
 .Dt GMID.CONF 5
 .Os
 .Sh NAME
@@ -425,7 +425,7 @@ Specify the language tag for the text/gemini content served.
 If not specified, no
 .Dq lang
 parameter will be added in the response.
-.It Ic listen on Ar address Op Ic port Ar number
+.It Ic listen on Ar address Oo Ic port Ar number Oc Op Ic proxy-v1
 Set the listen
 .Ar address
 and
@@ -444,6 +444,18 @@ will listen on all IPv4 and IPv6 addresses.
 can be used to listen on all IPv4 addresses and
 .Ar ::
 on all IPv6 addresses.
+If
+.Ic proxy-v1
+is specified, then connections speaking the proxy protocol v1 are
+expected on this listener.
+If multiple
+.Ic listen
+directive share the same
+.Ar address
+and
+.Ar port ,
+then all of them must have or lack
+.Ic proxy-v1 .
 .It Ic location Ar path Brq ...
 Specify server configuration rules for a specific location.
 .Ar path