From a5b72b25a298040798636455d29a7413636368f2 Mon Sep 17 00:00:00 2001
From: Runxi Yu <me@runxiyu.org>
Date: Tue, 01 Apr 2025 13:51:25 +0800
Subject: [PATCH] Add forge-mail(5) and update forge(5) for LMTP

---
 Makefile         |  2 +-
 man/forge-mail.5 | 31 +++++++++++++++++++++++++++++++
 man/forge.5      | 14 ++++++++++++++

diff --git a/Makefile b/Makefile
index a5c947768873c6f60290bf61cb946e12924ab032..7d91c6046355b686944f4869d9b383d74eb17de1 100644
--- a/Makefile
+++ b/Makefile
@@ -4,7 +4,7 @@
 .PHONY: clean version.go man source.tar.gz
 
 CFLAGS = -Wall -Wextra -Werror -pedantic -std=c99 -D_GNU_SOURCE
-MAN_PAGES = forge.5 hookc.1 forge.1
+MAN_PAGES = forge.5 hookc.1 forge.1 forge-mail.5
 
 forge: source.tar.gz version.go hookc/*.c hookc/hookc man # TODO
 	go build .
diff --git a/man/forge-mail.5 b/man/forge-mail.5
new file mode 100644
index 0000000000000000000000000000000000000000..58e35807b06fd97818d44ad8f5d2e95486d8b8af
--- /dev/null
+++ b/man/forge-mail.5
@@ -0,0 +1,31 @@
+.\" SPDX-License-Identifier: AGPL-3.0-only
+.\" SPDX-FileCopyrightText: Copyright (c) 2025 Runxi Yu <https://runxiyu.org>
+.Dd March 30, 2025
+.Dt FORGE-MAIL 5
+.Os Lindenii Forge
+.Sh NAME
+.Nm forge-mail
+.Nd configuring Lindenii Forge email integration
+.Sh DESCRIPTION
+.Nm
+is a guide to configuring Lindenii Forge for email integration.
+.Pp
+This is currently a stub. Here is a working configuration that works
+for the Lindenii Project itself, though.
+.Sh /etc/smtpd/smtpd.conf
+.Bd -literal
+table forge file:/etc/smtpd/forge
+action "FORGE" lmtp "/srv/forge/lmtp.sock" rcpt-to virtual <forge>
+match from any for domain "forge.lindenii.runxiyu.org" action "FORGE"
+.Ed
+.Sh /etc/smtpd/forge
+.Bd -literal
+@ forge
+.Ed
+.Sh SEE ALSO
+.Xr forge 1 ,
+.Xr forge 5 ,
+.Xr smtpd.conf 5
+.Sh AUTHORS
+.An Runxi Yu Aq Mt https://runxiyu.org
+.An Test_User Aq Mt hax@runxiyu.org
diff --git a/man/forge.5 b/man/forge.5
index c8eed431b93890b936a15506fccd78a0fe5a67a9..177c7f4d84c8dd81fa2e23277f077cbb0be4b67c 100644
--- a/man/forge.5
+++ b/man/forge.5
@@ -104,6 +104,20 @@ Maximum send queue size.
 .It Ic nick , user , gecos
 Identity fields for the IRC connection.
 .El
+.It Ic lmtp
+Configuration for the LMTP/MX component. You may wish to refer to
+.Xr forge-mail 5
+for information on configuring your SMTP server.
+.Bl -tag -width Ds
+.It Ic socket
+The path to the UNIX domain socket to listen on.
+.It Ic max_size
+The maximum acceptable ingress message size.
+.It Ic domain
+The domain-part of our LMTP server.
+.It Ic read_timeout , write_timeout
+General timeouts for LMTP connections.
+.El
 .El
 .Sh FILES
 .Bl -tag -width Ds

-- 
2.48.1