summary refs log tree commit diff
diff options
context:
space:
mode:
authorJune McEnroe <june@causal.agency>2019-10-25 23:41:27 -0400
committerJune McEnroe <june@causal.agency>2019-10-25 23:41:27 -0400
commite948a8b5b413486c1070e4684ad6b499564f9373 (patch)
treef1db79656cd3779617e81252a3f1c7e84f1a0876
parentAdd AGPLv3 notice on client registration (diff)
downloadpounce-e948a8b5b413486c1070e4684ad6b499564f9373.tar.gz
pounce-e948a8b5b413486c1070e4684ad6b499564f9373.zip
Expand documentation
Diffstat (limited to '')
-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.
3-05 12:55:46 -0500'>2018-03-05Use stdio in merge and metaJune McEnroe 2018-03-05Clean up spawn constantsJune McEnroe 2018-03-05Rename Tile timestamps {create,modify,access}TimeJune McEnroe 2018-03-05Pack message type enumsJune McEnroe 2018-03-05Undef COLOR_ constants in torus.hJune McEnroe 2018-03-05Generate tagsJune McEnroe 2017-10-03Simplify Makefile with pattern ruleJune McEnroe Insert rant about how GNU make handles the .c rule with extra dependencies. Also I don't care that everything links curses now. 2017-09-27Remove leading blank linesJune McEnroe 2017-09-27Add merge.c to READMEJune McEnroe 2017-09-03Assert client coords are valid after movementJune McEnroe 2017-09-03Relicense AGPLJune McEnroe I know it's already published under a permissive license in what is probably its final form, but I want to license it AGPL anyway on principle following some conversations I had about open source, corporations and copyleft. 2017-09-01Revert "Add client readOnly mode"June McEnroe This reverts commit 34f25ae40a3db9369e9d98b3814f2b93bbc21451. 2017-09-01Remove clientRemove call from clientCastJune McEnroe If an error occurs on a client socket during a broadcast, that client will show up in the kqueue loop with EV_EOF and get removed that way. Tested by sending SIGKILL to a client and watching its cursor disappear. 2017-09-01Add client readOnly modeJune McEnroe 2017-08-31Clean up merge toolJune McEnroe Choose the version with the most recent access if the modify times are the same. 2017-08-31Choose B for tiles with equal modify timesJune McEnroe This way newer access counts and times will be preserved. 2017-08-31Add quick data file merge toolJune McEnroe Hopefully I won't have to use it ever again. 2017-08-30Use only foreground color for selecting spawnJune McEnroe 2017-08-29Add four additional spawnsJune McEnroe 2017-08-28Add respawningJune McEnroe 2017-08-26Move license above includesJune McEnroe Why was it down there? 2017-08-26Snapshot metadataJune McEnroe 2017-08-26Add meta.c to READMEJune McEnroe 2017-08-26Use MakefileJune McEnroe