File	Date	Author	Commit
debian	2014-09-06	Eduardo M KALINOWSKI	[d589ef] Acknowledge NMU.
doc	2014-07-16	Eduardo M KALINOWSKI	[e09434] Documented used of GTK+ 3
po	2014-08-17	Eduardo M KALINOWSKI	[6bd700] Corrected translation error.
share	2014-07-16	Eduardo M KALINOWSKI	[9056de] Converted chat plugin to Gtk3.
src	2014-08-23	Eduardo M KALINOWSKI	[19a5ee] Fixed segmentation fault right after connection.
win32	2014-08-21	Eduardo M KALINOWSKI	[d1a921] Added dll's necessary for spell checking to the...
.gitignore	2014-07-09	Eduardo M KALINOWSKI	[2115aa] .ui files are used directly, instead of being c...
AUTHORS	2010-07-01	Eduardo M KALINOWSKI	[c0ada2] Added the channels plugin by Jack Mudge (jakyko...
COPYING	2012-02-12	Eduardo M KALINOWSKI	[32db9f] Added COPYING file to source control.
Makefile.am	2014-08-24	Eduardo M KALINOWSKI	[633c7a] Removed script for correcting Perl flags for Wi...
NEWS	2014-08-18	Eduardo M KALINOWSKI	[17944b] Fixed crash when importing triggers from the Wo...
README	2014-07-16	Eduardo M KALINOWSKI	[e09434] Documented used of GTK+ 3
acinclude.m4	2004-09-01	Eduardo M KALINOWSKI	[60ea49] Rudimentary support for Perl scripting has been...
autogen.sh	2012-02-12	Eduardo M KALINOWSKI	[6b4bd3] Remvoed ChangeLog.
configure.ac	2014-08-24	Eduardo M KALINOWSKI	[633c7a] Removed script for correcting Perl flags for Wi...
kildclient.desktop	2014-06-30	Eduardo M KALINOWSKI	[40b323] Added keywords to .desktop file.
kildclient.spec	2014-07-08	Eduardo M KALINOWSKI	[a3e1b5] Removed usage of stock buttons.

Read Me

KildClient 3.0.0
----------------

KildClient is a MUD client using the GTK+ toolkit. Its main feature is
the support for Perl scripting, which allows you to do basically
whatever you want. Other standard features of mud clients (triggers,
gags, macros, etc.) are also supported. See the features page for a
more detailed list of features.

Installation follows the standard procedure:

./configure
make
make install

After that, run with the `kildclient' command.

Several libraries are required in order to use KildClient. Here is a
list:
- gtk+ >= 3.10.0
- glib >= 2.32.0
- libperl

Note that some of those have further dependencies, which need to be
installed also. If you need to compile the client, you'll need the
development files in addition to the runtime files (if your
distribution uses packages, look for packages ending in -dev).

You might want the gtkspell library also. It is not necessary, but if
found you can have spell checking in the client.

You also need the Locale::Gettext and JSON Perl modules.

For documentation, see the KildClient manual, which should be
installed in {prefix}/share/doc/kildclient. {prefix} if by default
/usr/local, but it can be changed via configure.


SSL Support
-----------

KildClient has the hability to connect to muds securily via SSL (for
servers that support it, naturally). To build a SSL-enabled
KildClient, you need the gnutls library, version 2.10.0 or greater.

The configure script will search for it. If the library is found,
SSL support will be enabled. If it is not found, the built KildClient
will not have that feature.

You can always disable that feature by passing the --without-libgnutls
option to the configure script.


KildClient and gtk3-perl
------------------------

If you have the gtk3-perl bindings, you can use plugins that make use
of the GTK+ library.

It is not necessary to have gtk2-perl installed, but if you have,
you'll be able to use a greater range of plugins. Some standard
plugins distributed with KildClient (such as the notes plugin) use it,
and so may some third-party ones.


Building from git
-----------------

If you have a copy of KildClient that comes from the git repository
(and not a tarball that you downloaded), the building process is more
complicated. You must first run the autogen.sh script, and then
proceed with the configure script.

However, you will need some extra tools: automake, autoconf,
glib-gettextize (part of glib, which is in turn used by gtk) and
intltool. You will also need the development files of the libraries
used by KildClient.


Copyright
---------
KildClient is Copyright 2004-2014 by Eduardo Kalinowski
(eduardo@kalinowski.com.br).

KildClient is free software; you can distribute this software and/or
modify it under the terms of the GNU General Public License as
published by the Free Software Foundation; either version 2 of the
License, or (at your option) any later version.