]> jfr.im git - solanum.git/blobdiff - README.md
Update NEWS.
[solanum.git] / README.md
index ba39f6c0ba1b476db92646facc64d8888d7e1a04..d138e832eb7d21f5c76f8ceecbc1342d460ecbbc 100644 (file)
--- a/README.md
+++ b/README.md
@@ -1,7 +1,8 @@
-# charybdis
+# charybdis [![POSIX Build Status](https://travis-ci.org/charybdis-ircd/charybdis.svg?branch=master)](https://travis-ci.org/charybdis-ircd/charybdis) [![Windows Build Status](https://ci.appveyor.com/api/projects/status/is0obsml8xyq2qk7/branch/master?svg=true)](https://ci.appveyor.com/project/kaniini/charybdis/branch/master)
 
-Charybdis is a reference implementation of the IRCv3.1 server component.  It is meant to be
-used with an IRCv3-capable services implementation such as [Atheme][atheme] or [Anope][anope].
+Charybdis is an IRCv3 server designed to be highly scalable.  It implements IRCv3.1 and some parts of IRCv3.2.
+
+It is meant to be used with an IRCv3-capable services implementation such as [Atheme][atheme] or [Anope][anope].
 
    [atheme]: http://www.atheme.net/
    [anope]: http://www.anope.org/
@@ -12,11 +13,23 @@ used with an IRCv3-capable services implementation such as [Atheme][atheme] or [
  * A working dynamic load library.
  * A working lex.  Solaris /usr/ccs/bin/lex appears to be broken, on this system flex should be used.
 
+# building from git
+
+We no longer supply a prebuilt configure script in git, due to use of automake and libtool causing problems.
+You will need to run `autogen.sh` to build the autotools files prior to building charybdis.
+
 # feature specific requirements
 
- * For SSL Clients, SSL Challenge controlled OPER feature, and encrypted server links,
-   a working OpenSSL library or GnuTLS library.  CHALLENGE is not supported on GnuTLS
-   yet.
+ * For SSL/TLS client and server connections, one of:
+
+   * OpenSSL 1.0 or newer
+   * LibreSSL
+   * mbedTLS
+   * GnuTLS
+
+ * For certificate-based oper CHALLENGE, OpenSSL 1.0 or newer.
+   (Using CHALLENGE is not recommended for new deployments, so if you want to use a different TLS library,
+    feel free.)
 
  * For ECDHE, OpenSSL 1.0.0 or newer is required. RHEL/Fedora and derivatives like CentOS
    will need to compile OpenSSL from source, as ECC/ECDHE-functionality is removed from
@@ -24,7 +37,7 @@ used with an IRCv3-capable services implementation such as [Atheme][atheme] or [
 
 # tips
 
- * To report bugs in charybdis, visit us at irc.atheme.org #charybdis
+ * To report bugs in charybdis, visit us at irc.freenode.net #charybdis
 
  * Please read doc/index.txt to get an overview of the current documentation.
 
@@ -37,7 +50,7 @@ used with an IRCv3-capable services implementation such as [Atheme][atheme] or [
    problems with ipv4 due to the way the socket code is written.  To
    fix this you must: "sysctl net.inet6.ip6.v6only=0"
 
- * SOLARIS USERS: this code appears to tickle a bug in older gcc and 
+ * SOLARIS USERS: this code appears to tickle a bug in older gcc and
    egcs ONLY on 64-bit Solaris7.  gcc-2.95 and SunPro C on 64bit should
    work fine, and any gcc or SunPro compiled on 32bit.
 
@@ -50,9 +63,8 @@ used with an IRCv3-capable services implementation such as [Atheme][atheme] or [
    * OpenSuSE 11/12
    * OpenSolaris 2008.x?
    * Solaris 10 sparc.
-  
-  Please let us know if you find otherwise.  
-  It probably does not compile on AIX, IRIX or libc5 Linux.
+
+  Please let us know if you find otherwise. It may work on other platforms, but this is not guaranteed.
 
  * Please read NEWS for information about what is in this release.