about summary refs log tree commit diff
diff options
context:
space:
mode:
authorJune McEnroe <june@causal.agency>2021-09-06 17:35:34 -0400
committerJune McEnroe <june@causal.agency>2021-09-06 17:35:34 -0400
commit22b58b9749be60a90e3b51284d01698976d0cfaf (patch)
tree1afab47bb610918848ddbe7fd022b18a973da2d9
parentDocument DIAGNOSTICS (diff)
downloadpounce-22b58b9749be60a90e3b51284d01698976d0cfaf.tar.gz
pounce-22b58b9749be60a90e3b51284d01698976d0cfaf.zip
Explain what pounce does and some of how it works in README 2.5
That opening paragraph was severely lacking for a README.
Diffstat (limited to '')
-rw-r--r--README.732
1 files changed, 26 insertions, 6 deletions
diff --git a/README.7 b/README.7
index 7997a49..2ad9f67 100644
--- a/README.7
+++ b/README.7
@@ -1,4 +1,4 @@
-.Dd May 27, 2021
+.Dd September  6, 2021
 .Dt README 7
 .Os "Causal Agency"
 .
@@ -9,13 +9,33 @@
 .Sh DESCRIPTION
 .Xr pounce 1
 is a multi-client, TLS-only IRC bouncer.
-It takes a simple approach,
-using a multiple-consumer ring buffer
-and the IRCv3
-.Sy server-time
-extension to communicate with clients.
+It maintains a persistent connection
+to an IRC server,
+acting as a proxy and buffer
+for a number of clients.
+When a client connects,
+any messages received
+since it last disconnected
+will be relayed to it.
+Unlike some other bouncers,
+.Nm
+uses a single buffer
+for all IRC messages,
+which acts as a queue
+from which each client
+reads messages independently.
 .
 .Pp
+.Nm
+speaks regular modern IRC
+to both servers and clients,
+using the
+.Sy server-time
+extension to indicate
+when messages originally occurred.
+Clients identify themselves to
+.Nm
+by their IRC usernames.
 See
 .Xr QUIRKS 7
 for notes on connecting