aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
authorNatanael Copa <ncopa@alpinelinux.org>2015-06-19 11:49:48 +0200
committerNatanael Copa <ncopa@alpinelinux.org>2015-06-19 11:49:48 +0200
commit88ce331194155bddbdf9a59e9f97473b8e2597b2 (patch)
treecb71ac6244d66304375c7c41919cbc80635550d5 /README.md
parenta1ca72940008a4d47361c897a226eb873b117d7d (diff)
downloadsircbot-88ce331194155bddbdf9a59e9f97473b8e2597b2.tar.bz2
sircbot-88ce331194155bddbdf9a59e9f97473b8e2597b2.tar.xz
readme: add info on how to build
Diffstat (limited to 'README.md')
-rw-r--r--README.md28
1 files changed, 26 insertions, 2 deletions
diff --git a/README.md b/README.md
index cebf749..75be8ca 100644
--- a/README.md
+++ b/README.md
@@ -4,17 +4,41 @@ sircbot
a small IRC bot for use with git hooks, cronjobs, scripts etc
+Compile
+-------
+
+To build sircbot you need a C compiler and GNU make. To build the lua
+module you need Lua 5.1, 5.2 or 5.3.
+
+To compile sircbot run:
+
+ make
+
+
+You can set various compile options in config.mk:
+
+ CFLAGS=-Os
+ LUA_VERSION=5.2
+
+
+Running the server
+------------------
start the server with:
- sircbot -s SERVER -n NICK '#channel1' '#channel2'
+
+ sircbot -s SERVER -n NICK '#channel1' '#channel2'
It connects to server and joins given channels. When a channel is joined
it creates a unix socket /var/run/sircbot/<#channel> which can connected to
with sircbot-send.
+
+Sending messages
+----------------
+
To send to a connected channel use:
- echo "$message" | sircbot-send '#channel1'
+ echo "$message" | sircbot-send '#channel1'
sircbot-send will send everything from stdin to given channel.