Add QUIRKS file

2 files changed, 64 insertions, 1 deletions

diff --git a/QUIRKS.7 b/QUIRKS.7
new file mode 100644
index 0000000..69f9596
--- /dev/null
+++ b/QUIRKS.7
@@ -0,0 +1,56 @@
+.Dd May 25, 2021
+.Dt QUIRKS 7
+.Os "Causal Agency"
+.
+.Sh NAME
+.Nm Quirks
+.Nd IRC networks and clients
+.
+.Sh DESCRIPTION
+This file documents the quirks
+of connecting
+.Xr pounce 1
+with particular IRC networks and clients.
+.
+.Ss Networks
+.Bl -tag -width Ds
+.It EFnet
+EFnet uses port 9999 for TLS
+and uses self-signed certificates.
+.
+.It EsperNet
+EsperNet supports SASL,
+but not SASL EXTERNAL.
+Either the
+.Cm sasl-plain
+option can be used,
+or the
+.Cm client-cert
+option without the
+.Cm sasl-external
+option.
+.
+.It OFTC
+OFTC does not support SASL,
+but does support CertFP.
+The
+.Cm client-cert
+option can be used without the
+.Cm sasl-external
+option.
+.El
+.
+.Ss Clients
+.Bl -tag -width Ds
+.It Palaver (iOS)
+Palaver sets its username
+to the same as its nickname.
+The default nick of
+.Dq Palaver
+therefore works well.
+.
+.It Revolution (Android)
+Revolution won't connect properly
+if the nick it is configured with
+is not the one pounce is currently using.
+.El
diff --git a/README.7 b/README.7
index 13fcd98..0b3e923 100644
--- a/README.7
+++ b/README.7
@@ -1,4 +1,4 @@
-.Dd May  2, 2021
+.Dd May 25, 2021
 .Dt README 7
 .Os "Causal Agency"
 .
@@ -15,6 +15,13 @@ and the IRCv3.2
 .Sy server-time
 extension to communicate with clients.
 .
+.Pp
+See
+.Xr QUIRKS 7
+for notes on connecting
+.Nm
+with particular networks and clients.
+.
 .Sh RATIONALE
 As a former
 .Xr znc 1