134 lines
4.0 KiB
Plaintext
134 lines
4.0 KiB
Plaintext
|
What is this repo?
|
||
|
|
~~~~~~~~~~~~~~~~~~
|
||
|
|
This is Xchat 2.8.8, with all the Debian Jessie patches applied, as well
|
||
|
|
as some fixes manually pulled from hexchat for building against OpenSSL
|
||
|
|
1.1.0. The goal of my version of XChat is to keep it buildable on newer
|
||
|
|
Linux/Unix/Cygwin systems than the last release of XChat is compatible
|
||
|
|
with.
|
||
|
|
|
||
|
|
I do not just use Hexchat because I don't like some of the UI changes
|
||
|
|
that it introduced.
|
||
|
|
|
||
|
|
As of the last update to this readme (21 January 2017), the final link
|
||
|
|
of the xchat binary fails due to it needing '-lgmodule-2.0' added to its
|
||
|
|
linking flags. Until this gets fixed in source (I'll need to learn about
|
||
|
|
autoconf for that to happen, I think), it can be done manually by adding
|
||
|
|
that flag to the Makefile or running the configure script with
|
||
|
|
`LDFLAGS=-lgmodule-2.0` set as an environment variable.
|
||
|
|
|
||
|
|
With that caveat, it currently builds and runs in Debian Sid as of
|
||
|
|
21 January 2017.
|
||
|
|
|
||
|
|
As of 26 May 2019, it still builds in FreeBSD stable with:
|
||
|
|
|
||
|
|
MAKE="gmake" LDFLAGS='-L/usr/local/lib -lgmodule-2.0' ./configure \
|
||
|
|
--prefix=/usr/local --disable-dbus
|
||
|
|
|
||
|
|
...so we may still have some time ahead of us.
|
||
|
|
|
||
|
|
Original README contents are below.
|
||
|
|
|
||
|
|
X-Chat README
|
||
|
|
~~~~~~~~~~~~~
|
||
|
|
X-Chat ("xchat") Copyright (c) 1998-2010 By Peter Zelezny.
|
||
|
|
|
||
|
|
This program is released under the GPL v2 with the additional exemption
|
||
|
|
that compiling, linking, and/or using OpenSSL is allowed. You may
|
||
|
|
provide binary packages linked to the OpenSSL libraries, provided that
|
||
|
|
all other requirements of the GPL are met.
|
||
|
|
See file COPYING for details.
|
||
|
|
|
||
|
|
|
||
|
|
What is it?
|
||
|
|
~~~~~~~~~~~
|
||
|
|
X-Chat is an IRC client for UNIX operating systems. I.R.C. is Internet
|
||
|
|
Relay Chat, see http://irchelp.org for more information about IRC in
|
||
|
|
general. Xchat runs on most BSD and POSIX compliant operating systems.
|
||
|
|
|
||
|
|
|
||
|
|
Requirements:
|
||
|
|
~~~~~~~~~~~~~
|
||
|
|
* GTK+ 2.10 (this is available at http://www.gtk.org).
|
||
|
|
|
||
|
|
X-Chat is known to work on, at least:
|
||
|
|
|
||
|
|
* Linux
|
||
|
|
* FreeBSD
|
||
|
|
* OpenBSD
|
||
|
|
* NetBSD
|
||
|
|
* Solaris
|
||
|
|
* AIX
|
||
|
|
* IRIX
|
||
|
|
* DEC/Compaq Tru64 UNIX
|
||
|
|
* HP-UX 10.20 and 11
|
||
|
|
* MacOS X
|
||
|
|
* Windows XP/2000/Vista/7
|
||
|
|
|
||
|
|
|
||
|
|
Notes for packagers:
|
||
|
|
~~~~~~~~~~~~~~~~~~~~
|
||
|
|
|
||
|
|
If you need your packages to work on i386, you don't need to compile with
|
||
|
|
--disable-mmx, because it's also checked at run-time.
|
||
|
|
|
||
|
|
|
||
|
|
Python Scripts:
|
||
|
|
~~~~~~~~~~~~~~~
|
||
|
|
Scripts for 1.8.x are not compatible, and a brand new interface has be
|
||
|
|
written. Documentation can be found here: http://xchat.org/docs/.
|
||
|
|
Consider using the Python interface for your scripts, it's a very nice
|
||
|
|
API, allows for loading/unloading individual scripts, and gives you
|
||
|
|
almost all the features of the C-Plugin API.
|
||
|
|
|
||
|
|
|
||
|
|
Perl Scripts:
|
||
|
|
~~~~~~~~~~~~~
|
||
|
|
Scripts for 1.8.x are compatible with the following exceptions:
|
||
|
|
|
||
|
|
* IRC::command will not interpret %C, %B, %U etc.
|
||
|
|
|
||
|
|
* user_list and user_list_short:
|
||
|
|
If a user has both op and voice, only the op flag will be 1.
|
||
|
|
|
||
|
|
* add_user_list/sub_user_list/clear_user_list
|
||
|
|
These functions do nothing.
|
||
|
|
|
||
|
|
* notify_list
|
||
|
|
Not implemented. Always returns an empty list.
|
||
|
|
|
||
|
|
* server_list
|
||
|
|
Lists servers that are not connected aswell.
|
||
|
|
|
||
|
|
* Some print events may have new names and some were added.
|
||
|
|
|
||
|
|
* Text printed by scripts must now be UTF8.
|
||
|
|
|
||
|
|
* Text passed to scripts (via add_message_handler) will be encoded in UTF8.
|
||
|
|
|
||
|
|
|
||
|
|
Autoloading Perl Scripts and Plugins
|
||
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||
|
|
* X-Chat automatically loads, at startup:
|
||
|
|
~/.xchat2/*.pl Perl scripts
|
||
|
|
~/.xchat2/*.py Python scripts
|
||
|
|
~/.xchat2/*.so Plugins
|
||
|
|
$(libdir)/xchat/plugins/*.so plugins
|
||
|
|
(this usually translates to /usr/lib/xchat/plugins/*.so)
|
||
|
|
|
||
|
|
|
||
|
|
Control Codes:
|
||
|
|
~~~~~~~~~~~~~~
|
||
|
|
%% - A single percentage sign
|
||
|
|
%C - Control-C (mIRC color code)
|
||
|
|
%B - Bold Text
|
||
|
|
%U - Underline Text
|
||
|
|
%R - Reverse Text
|
||
|
|
%O - Reset all Text attributes
|
||
|
|
%XXX - ASCII XXX (where XXX is a decimal 3 digit number)
|
||
|
|
(Eg: %007 sends a BEEP)
|
||
|
|
|
||
|
|
%Cforeground,background will produce a color code, eg: %C03,10
|
||
|
|
|
||
|
|
These are now disabled by default (see Settings > Prefs > Input Box).
|
||
|
|
Instead you can insert the real codes via ctrl-k, ctrl-b and ctrl-o.
|