commit - 8908562dcaa8372dc94104ebc93e39f19c3f57a4
commit + 61c1b3647f0284c38c0d8e25f0661f795b11362d
blob - 0c70d255091e9b4ab2a00bb736d8ea7eb7a82dda
blob + aa645df623d74ff03495d3bc97bbfe82a20815a1
--- gotd/gotd.conf.5
+++ gotd/gotd.conf.5
@@ -304,14 +304,39 @@ Each session corresponds to an invocation of a client-
 .Cm got send
 or
 .Cm git push .
-.It Ic email Ar recipient Oo Ic shortlog Oc Oo Ic with diff Oc
+.It Ic email Oo Ic from Ar sender Oc Ic to Ar recipient Oo Ic shortlog Oc Oo Ic with diff Oc Oo Ic reply to Ar responder Oc 
 Send notifications via email to the specified
-.Ar recipient
-address, which must be a valid email address.
-This directive may be specified multiple times to build a list of
-recipient addresses to send notifications to.
+.Ar recipient .
+This directive may be specified multiple times to build a list of
+recipients to send notifications to.
 .Pp
-The commit or tag message will be sent in the email body.
+The
+.Ar recipient
+must be an email addresses that accepts mail.
+The
+.Ar sender
+will be used as the From address.
+If not specified, the sender defaults to an email address composed of the user
+account running
+.Xr gotd 8
+and the local hostname.
+.Pp
+If a
+.Ar responder
+is specified via the
+.Ic reply to
+directive, the
+.Ar responder
+will be used as the Reply-to address.
+Setting the Reply-to header can be useful if replies should go to a
+mailing list instead of the
+.Ar sender ,
+for example.
+.Pp
+Information about newly created commits or tags will be sent in the email body.
+For commits, this includes the commit's author, committer, date, and the
+log message.
+For tags, this includes the tagger, date, and the tag message.
 If the optional
 .Ic shortlog
 directive is given, only the first line of the commit or tag message
@@ -431,7 +456,7 @@ repository "openbsd/ports" {
 		branch "main"
 		reference namespace "refs/tags/"
 		summarize
-		email openbsd-ports-changes@example.com with diff
+		email to openbsd-ports-changes@example.com with diff
 		url https://example.com/?id=%x&type=%tcommitter=%c&timestamp=%d user "flan_announcer" password "secret"
 	}
 }