From 867531d31b848478d6b87b576a3d7f285f30d57b Mon Sep 17 00:00:00 2001
From: Jeremy Baxter <jeremy@baxters.nz>
Date: Thu, 28 Jul 2022 18:28:52 +1200
Subject: [PATCH] Added matrix-send.conf(5) manpage

---
 matrix-send.conf.5 | 59 ++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 59 insertions(+)
 create mode 100644 matrix-send.conf.5

diff --git a/matrix-send.conf.5 b/matrix-send.conf.5
new file mode 100644
index 0000000..6ab963d
--- /dev/null
+++ b/matrix-send.conf.5
@@ -0,0 +1,59 @@
+.Dd $Mdocdate: July 28 2022 $
+.Dt MATRIX-SEND.CONF 5
+.Os
+.Sh NAME
+.Nm matrix-send.conf
+.Nd configuration file for
+.Xr matrix-send 1
+.Sh DESCRIPTION
+.Pp
+.Xr matrix-send 1
+sends messages to Matrix rooms. In order to send a message however, it needs
+credentials for the account sending the message. These credentials are provided
+in the
+.Nm
+configuration file, as well as other options if you need them.
+.Pp
+The following directives are available:
+.Bl -bullet
+.It
+Server
+.Ar server
+        The Client-Server API URL for your Matrix server.
+.It
+Username
+.Ar username
+        Your Matrix username.
+.It
+Password
+.Ar password
+        The password to your Matrix account.
+.It
+AccessToken
+.Ar token
+        Instead of using a username and password to obtain an access token, just use
+.Ar token .
+.It
+CacheLocation
+.Ar location
+        Instead of caching access tokens to ~/.cache, cache them to
+.Ar location .
+.El
+.Pp
+The following statements are available:
+.Bl -bullet
+.It
+NoCache
+        Don't cache access tokens.
+.El
+.Sh FILES
+.Bl -tag -width ~/.config/matrix-send.conf
+.It Pa ~/.config/matrix-send.conf
+configuration file for
+.Nm
+.It Pa ~/.cache/matrix-send/access-token
+default access token cache file
+.El
+
+.Sh SEE ALSO
+.Xr matrix-send 1