From 2e61779082e70848fb34c04f7f5df77e500bd7e0 Mon Sep 17 00:00:00 2001 From: C. McEnroe Date: Thu, 19 Dec 2019 02:13:38 -0500 Subject: Rename catgirl.7 to README.7 --- README.7 | 111 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 111 insertions(+) create mode 100644 README.7 (limited to 'README.7') diff --git a/README.7 b/README.7 new file mode 100644 index 0000000..cae56bb --- /dev/null +++ b/README.7 @@ -0,0 +1,111 @@ +.Dd February 25, 2019 +.Dt CATGIRL 7 +.Os "Causal Agency" +. +.Sh NAME +.Nm catgirl +.Nd IRC client +. +.Sh DESCRIPTION +.Nm +is a curses IRC client +originally intended for +use over anonymous SSH. +. +.Pp +It requires LibreSSL +.Pq Fl ltls +and targets +.Fx , +Darwin, +.Nx +and +GNU/Linux. +. +.Sh INSTALL +On platforms other than +.Fx , +copy the appropriate file to +.Pa config.mk +and modify as needed. +The default install +.Va PREFIX +is +.Pa ~/.local . +. +.Pp +.Bd -literal -offset indent +cp $(uname).mk config.mk +make +make install +.Ed +. +.Ss Darwin +LibreSSL is assumed to be installed with +.Xr brew 1 . +The +.Xr sandman 1 +wrapper is also installed. +. +.Ss NetBSD +LibreSSL is assumed to be installed with +.Xr pkgsrc 7 . +Due to bugs in +.Nx Ap s +.Xr curses 3 +implementation, +some of the UI is currently broken. +. +.Ss GNU/Linux +LibreSSL is assumed to be manually installed in +.Pa /usr/local +and is statically linked. +. +.Sh FILES +.Bl -tag -width sandman.m -compact +.It Pa chat.h +shared state and function prototypes +.It Pa chat.c +command line parsing +.It Pa event.c +event loop and process spawning +.It Pa tag.c +tag (channel, query) ID assignment +.It Pa handle.c +incoming command handling +.It Pa input.c +input command handling +.It Pa irc.c +TLS client connection +.It Pa format.c +IRC formatting +.It Pa color.c +nick and channel coloring +.It Pa ui.c +cursed UI +.It Pa term.c +terminal features unsupported by curses +.It Pa edit.c +line editing +.It Pa tab.c +tab-complete +.It Pa url.c +URL detection +.It Pa pls.c +functions which should not have to be written +.It Pa sandman.m +utility for Darwin to signal sleep +.El +. +.Pp +.Bl -tag -width sshd_config -compact +.It Pa sshd_config +anonymous SSH configuration +.It Pa man.sh +.Xr man 1 +implementation for chroot +.El +. +.Sh SEE ALSO +.Xr catgirl 1 , +.Xr sandman 1 -- cgit 1.4.1-2-gfad0