From d17e10406ea58617f7104da041000f9912aca2b0 Mon Sep 17 00:00:00 2001
From: Francis Lavoie <lavofr@gmail.com>
Date: Sat, 15 Jul 2023 20:22:13 -0400
Subject: [PATCH] Header replacement defer

---
 src/docs/markdown/caddyfile/directives/header.md | 15 ++++++++++++---
 1 file changed, 12 insertions(+), 3 deletions(-)

diff --git a/src/docs/markdown/caddyfile/directives/header.md b/src/docs/markdown/caddyfile/directives/header.md
index cf96cad..5f3bc08 100644
--- a/src/docs/markdown/caddyfile/directives/header.md
+++ b/src/docs/markdown/caddyfile/directives/header.md
@@ -13,9 +13,6 @@ By default, header operations are performed immediately unless any of the header
 
 ```caddy-d
 header [<matcher>] [[+|-|?|>]<field> [<value>|<find>] [<replace>]] {
-	# Replace
-	<field> <find> <replace>
-
 	# Add
 	+<field> <value>
 
@@ -28,6 +25,12 @@ header [<matcher>] [[+|-|?|>]<field> [<value>|<find>] [<replace>]] {
 	# Delete
 	-<field>
 
+	# Replace
+	<field> <find> <replace>
+
+	# Replace with defer
+	><field> <find> <replace>
+
 	# Default
 	?<field> <value>
 
@@ -121,3 +124,9 @@ To override the cache expiration that a proxy upstream had set for paths startin
 header /no-cache* >Cache-Control nocache
 reverse_proxy upstream:443
 ```
+
+To perform a deferred update of a `Set-Cookie` header to add `SameSite=None`; a regexp capture is used to grab the existing value, and `$1` re-inserts it at the start with the additional option appended:
+
+```caddy-d
+header >Set-Cookie (.*) "$1; SameSite=None;"
+```