summary refs log tree commit diff
diff options
context:
space:
mode:
-rw-r--r--README.712
-rw-r--r--pounce.127
2 files changed, 37 insertions, 2 deletions
diff --git a/README.7 b/README.7
index 6223c4f..7bc7f5f 100644
--- a/README.7
+++ b/README.7
@@ -4,10 +4,18 @@
 .
 .Sh NAME
 .Nm pounce
-.Nd IRC bouncer
+.Nd IRC pouncer :3
 .
 .Sh DESCRIPTION
 .Nm
+is a multi-client, TLS-only IRC bouncer.
+It takes a simple approach,
+using a multiple-consumer ring buffer
+and the IRCv3.2 server-time extension
+to communicate with clients.
+.
+.Pp
+.Nm
 requires LibreSSL
 .Pq Fl ltls
 and targets
@@ -16,7 +24,7 @@ and targets
 .Sh FILES
 .Bl -tag -width "bounce.h" -compact
 .It Pa bounce.h
-function prototypes and default paths
+common declarations and default paths
 .It Pa bounce.c
 command line parsing and event loop
 .It Pa listen.c
diff --git a/pounce.1 b/pounce.1
index 08a5a85..156a511 100644
--- a/pounce.1
+++ b/pounce.1
@@ -119,6 +119,24 @@ Log in with the password
 .Ar pass .
 .El
 .
+.Pp
+When using
+.Xr certbot 8
+to obtain TLS certificates,
+is it sufficient to specify the domain with
+.Fl H .
+.
+.Sh ENVIRONMENT
+.Bl -tag -width Ds
+.It Ev USER
+The default nickname.
+.El
+.
+.Sh EXAMPLES
+.Bd -literal -offset indent
+.Nm Fl H Li pounce.example.org Fl h Li chat.freenode.net Fl j Li '#ascii.town'
+.Ed
+.
 .Sh STANDARDS
 The
 .Nm
@@ -199,3 +217,12 @@ daemon implements the following:
 .%U https://tools.ietf.org/html/rfc4648
 .Re
 .El
+.
+.Sh AUTHORS
+.An June Bug Aq Mt june@causal.agency
+.
+.Sh CAVEATS
+One instance of
+.Nm ,
+and therefore one local port,
+is required for each server connection.
lief after 3 unbearably straight and awful books in a row. A wonderful mess. 2022-09-02Update "Care" with initial electrolysis reportJune McEnroe 2022-08-17Add The Book of Form and EmptinessJune McEnroe There are some nice things in here that I would really like in any other book, but not this one. 2022-08-15Load dates from ~/.config/when/datesJune McEnroe 2022-08-15Allow names with prefixes of months and daysJune McEnroe 2022-08-15Add named dates to whenJune McEnroe 2022-08-14Remove tweets text fileJune McEnroe Such link rot. 2022-08-04Add Conversations With FriendsJune McEnroe The better of the two, but largely the same. I feel like these books are a bit too autobiographical, but I don't know if I'm allowed to accuse an author of that. My real problem is that I read these books as largely uncritical of their characters. They behave in nonsense ways, are mostly uncritical of their own behaviour, and don't really have arcs of growth or change. I suppose this book had a bit of one, but only in the last two chapters. 2022-07-30Add Normal PeopleJune McEnroe Unbearably straight. Eyerolls and sighs per page off the charts. Shout out to Joanna, I guess. I kinda like the lack of quotation marks though to be honest. After half of the Ruth Ozeki novel and now this, I need to get back to some genre fiction. 2022-07-26Rewrite glitch from new pngoJune McEnroe 2022-07-26Update Care with time-to-ID and piercingsJune McEnroe 2022-07-26Add -w to upJune McEnroe 2022-07-13Set push.autoSetupRemoteJune McEnroe 2022-07-08Remove TOURJune McEnroe There is not that much distinct stuff here anymore. 2022-07-03Add The Bone Shard EmperorJune McEnroe Suffers a little bit from middle book but I really enjoyed it. Read it faster than the first one too, despite its length. 2022-06-25Bump xterm font size to 12June McEnroe 2022-06-10Handle subshells (and functions) inside substitutionsJune McEnroe 2022-06-10Switch to jorts Install scriptJune McEnroe 2022-06-08Indicate if still reading or no resultsJune McEnroe 2022-06-08Add Maiden, Mother, CroneJune McEnroe Mixed bag like most collections of short stories. Some of them are pretty good. The author of the worst written story also has the worst written bio. 2022-06-05FIRST SHOW IN 2.5 YEARS BABEY!!!June McEnroe 2022-06-03Set line number on File linesJune McEnroe 2022-06-03Stop polling stdin after EOFJune McEnroe 2022-06-02Set TABSIZE=4June McEnroe Absolutely indiscriminately. 2022-06-02Do basic match highlightingJune McEnroe 2022-06-02Clean up parsing a littleJune McEnroe 2022-06-02Don't duplicate path stringJune McEnroe 2022-06-02Use stderr instead of /dev/tty, realloc buffer if lines too longJune McEnroe For some reason I haven't been able to figure out, trying to poll /dev/tty returns POLLNVAL (and this was using 100% CPU looping), but using stderr instead works fine. 2022-06-02Add initial working version of qfJune McEnroe 2022-05-29Set prompt for okshJune McEnroe