From b239ab242c0bc7ce7418d72148c4d36dffd59ffb Mon Sep 17 00:00:00 2001
From: "C. McEnroe" <june@causal.agency>
Date: Sun, 5 Sep 2021 17:51:55 -0400
Subject: Document DIAGNOSTICS

---
 pounce.1 | 33 +++++++++++++++++++++++++++++++++
 1 file changed, 33 insertions(+)

diff --git a/pounce.1 b/pounce.1
index 4642d4b..0a6cf03 100644
--- a/pounce.1
+++ b/pounce.1
@@ -666,6 +666,39 @@ host = irc.tilde.chat
 join = #ascii.town
 .Ed
 .
+.Sh DIAGNOSTICS
+Upon receiving the
+.Dv SIGINFO
+signal,
+.Nm
+prints the current producer position
+and the positions of each consumer
+identified by username.
+Following each consumer position
+is the number by which it trails the producer.
+On systems lacking
+.Dv SIGINFO ,
+.Dv SIGUSR2
+is used.
+.
+.Pp
+If a client reconnects
+after having missed more messages
+than the size of the buffer,
+.Nm
+will print a warning:
+.Bd -ragged -offset indent
+consumer
+.Em name
+dropped
+.Em n
+messages
+.Ed
+.Pp
+The size of the buffer
+can be adjusted with
+.Fl s .
+.
 .Sh SEE ALSO
 .Xr calico 1
 .
-- 
cgit 1.4.1