aboutsummaryrefslogtreecommitdiffstats
path: root/README
diff options
context:
space:
mode:
authormcpcpc <michaelczigler@icloud.com>2020-08-06 16:08:22 -0400
committermcpcpc <michaelczigler@icloud.com>2020-08-06 16:08:22 -0400
commitc1999123facb3ea39ec943d042f7f8fc331eb442 (patch)
tree9b55950a7fed5bb8111204caa5ec239f6fb79932 /README
downloadkirc-c1999123facb3ea39ec943d042f7f8fc331eb442.tar.gz
kirc-c1999123facb3ea39ec943d042f7f8fc331eb442.tar.bz2
kirc-c1999123facb3ea39ec943d042f7f8fc331eb442.tar.xz
kirc-c1999123facb3ea39ec943d042f7f8fc331eb442.tar.zst
kirc-c1999123facb3ea39ec943d042f7f8fc331eb442.zip
new at 0.0.1
Diffstat (limited to 'README')
-rw-r--r--README44
1 files changed, 44 insertions, 0 deletions
diff --git a/README b/README
new file mode 100644
index 0000000..324a771
--- /dev/null
+++ b/README
@@ -0,0 +1,44 @@
+kirc
+
+KISS for IRC, an IRC client written in POSIX C99.
+
+
+BACKGROUND
+----------
+
+After having tried multiple IRC clients, I decided to develope my own. The
+result is a portable <250 sloc application that has no dependencies other
+than a C99 compiler.
+
+
+FEATURES
+--------
+
+- automatic host PING response.
+- vi-like shortcuts:
+
+ :m <message> send a message to the connected channel
+ :q close the host connection and quit kirc
+
+
+INSTALLATION
+------------
+
+Building and installing from source:
+
+ git clone https://github.com/mcpcpc/kirc.git
+ cd kirc
+ make
+ make install
+
+
+USAGE
+-----
+
+usage: kirc [-s hostname] [-p port] [-c channel] [-n nick] [-v|V]
+-s server address (default: 'irc.freenode.org')
+-p server port (default: '6667')
+-c channel name (default: '#kisslinux')
+-n user nickname
+-v version information
+-V verbose output (e.g. raw stream)