Little fixes to the README
Finally learned how to use this asciidoc{,tor} thing.
This commit is contained in:
parent
e75e840346
commit
99ac971b66
50
README.adoc
50
README.adoc
@ -1,4 +1,6 @@
|
||||
= uirc3
|
||||
uirc3
|
||||
=====
|
||||
:compact-option:
|
||||
|
||||
The unethical IRC trinity. This project consists of an experimental IRC client,
|
||||
daemon, and bot. It's all you're ever going to need for chatting.
|
||||
@ -11,8 +13,8 @@ All of them have these potentially interesting properties:
|
||||
- very compact and easy to hack on
|
||||
- permissive license
|
||||
|
||||
== degesch
|
||||
|
||||
degesch
|
||||
-------
|
||||
The IRC client. It is largely defined by being built on top of GNU Readline.
|
||||
Its interface should however feel familiar for weechat or irssi users.
|
||||
|
||||
@ -22,8 +24,8 @@ servers, powerful configuration system, integrated help, mIRC text formatting,
|
||||
CTCP queries, automatic splitting of overlong messages, autocomplete, logging
|
||||
to file, and command aliases.
|
||||
|
||||
== kike
|
||||
|
||||
kike
|
||||
----
|
||||
The IRC daemon. It is designed to be used as a regular user application rather
|
||||
than a system-wide daemon. If all you want is a decent, minimal IRCd for
|
||||
a small network of respectful users (or bots), or testing, this one will do it.
|
||||
@ -42,8 +44,8 @@ Not supported:
|
||||
- online changes to configuration; the config system from degesch could be used
|
||||
- limits of almost any kind, just connections and mode `+l`
|
||||
|
||||
== ZyklonB
|
||||
|
||||
ZyklonB
|
||||
-------
|
||||
The IRC bot. It builds upon the concept of my other VitaminA IRC bot. The main
|
||||
characteristic of these two bots is that they run plugins as coprocesses, which
|
||||
allows for enhanced reliability and programming language freedom.
|
||||
@ -58,8 +60,8 @@ Notable features:
|
||||
- resilient against crashes, server disconnects and timeouts
|
||||
- SOCKS support (even though socksify can add that easily to any program)
|
||||
|
||||
== Building
|
||||
|
||||
Building
|
||||
--------
|
||||
Build dependencies: CMake, pkg-config, help2man, awk, sh, liberty (included) +
|
||||
Runtime dependencies: openssl, curses (degesch),
|
||||
readline or libedit >= 2013-07-12 (degesch)
|
||||
@ -83,9 +85,9 @@ Or you can try telling CMake to make a package for you. For Debian it is:
|
||||
Note that for versions of CMake before 2.8.9, you need to prefix `cpack` with
|
||||
`fakeroot` or file ownership will end up wrong.
|
||||
|
||||
== Running
|
||||
|
||||
_degesch_ has in-program configuration. Just run it and read the instructions.
|
||||
Running
|
||||
-------
|
||||
'degesch' has in-program configuration. Just run it and read the instructions.
|
||||
|
||||
For the rest you might want to generate a configuration file:
|
||||
|
||||
@ -98,34 +100,34 @@ doing that), simply run the appropriate program with no arguments:
|
||||
$ zyklonb
|
||||
$ kike
|
||||
|
||||
_ZyklonB_ stays running in the foreground, therefore I recommend launching it
|
||||
'ZyklonB' stays running in the foreground, therefore I recommend launching it
|
||||
inside a Screen or tmux session.
|
||||
|
||||
_kike_, on the other hand, immediately forks into the background. Use the PID
|
||||
'kike', on the other hand, immediately forks into the background. Use the PID
|
||||
file or something like `killall` if you want to terminate it. You can run it
|
||||
as a `forking` type systemd user service.
|
||||
|
||||
== Client Certificates
|
||||
|
||||
_kike_ uses SHA1 fingerprints of TLS client certificates to authenticate users.
|
||||
Client Certificates
|
||||
-------------------
|
||||
'kike' uses SHA1 fingerprints of TLS client certificates to authenticate users.
|
||||
To get the fingerprint from a certificate file in the required form, use:
|
||||
|
||||
$ openssl x509 -in public.pem -outform DER | sha1sum
|
||||
|
||||
== Contributing and Support
|
||||
|
||||
Contributing and Support
|
||||
------------------------
|
||||
Use this project's GitHub to report any bugs, request features, or submit pull
|
||||
requests. If you want to discuss this project, or maybe just hang out with
|
||||
the developer, feel free to join me at irc://anathema.irc.so, channel #anathema.
|
||||
|
||||
== Disclaimer
|
||||
|
||||
Disclaimer
|
||||
----------
|
||||
I am not an antisemitist, I'm just being an offensive asshole with the naming.
|
||||
And no, I'm not going to change the names.
|
||||
|
||||
== License
|
||||
|
||||
`uirc3' is written by Přemysl Janouch <p.janouch@gmail.com>.
|
||||
License
|
||||
-------
|
||||
'uirc3' is written by Přemysl Janouch <p.janouch@gmail.com>.
|
||||
|
||||
You may use the software under the terms of the ISC license, the text of which
|
||||
is included within the package, or, at your option, you may relicense the work
|
||||
|
Loading…
Reference in New Issue
Block a user