More debugging, add weird networking info to README

CHANGELOG

@@ -8,6 +8,7 @@ vNEXT (in development)
     * Added status field to ServerState
     * ServerConnected event is emitted as soon as the socket is connected
     * ServerReady event is emitted after logging in, negotiating, etc
+  * Added extra debugging to show what type of events are being dispatched
   * (Internal) Event handlers can now return more events to emit
 
 v0.2.1

README.md

@@ -41,6 +41,23 @@ with(IrcClientImpl(Server("my.server.com", 6667), Profile("nick", "realName", "u
 }
 ```
 
+## Known issues / FAQ
+
+### `java.lang.IllegalStateException: Check failed` when connecting to some servers
+
+This happens when the IRC server requests an optional client certificate (for use
+in SASL auth, usually). At present there is no support for client certificates in
+the networking library used by KtIrc. This is tracked upstream in
+[ktor#641](https://github.com/ktorio/ktor/issues/641). There is no workaround
+other than using an insecure connection.
+
+### KtIrc connects over IPv4 even when host has IPv6
+
+This is an issue with the Java standard library. You can change its behaviour by
+defining the system property `java.net.preferIPv6Addresses` to `true`, e.g. by
+running Java with `-Djava.net.preferIPv6Addresses=true` or calling
+`System.setProperty("java.net.preferIPv6Addresses","true");` in code. 
+
 ## Contributing
 
 Contributing is welcomed and encouraged! Please try to add unit tests for new features,

src/main/kotlin/com/dmdirc/ktirc/io/MessageHandler.kt

@@ -19,6 +19,7 @@ internal class MessageHandler(private val processors: List<MessageProcessor>, va
     }
 
     fun emitEvent(ircClient: IrcClient, ircEvent: IrcEvent) {
+        log.fine { "Dispatching event of type ${ircEvent::class}" }
         handlers.forEach { handler ->
             handler.processEvent(ircClient, ircEvent).forEach {
                 emitEvent(ircClient, it)