1BitchX 1.2.1 README
2===================
3
4BitchX is a free software text-based IRC (Internet Relay Chat) client for
5UNIX-like systems, originally based on ircII and heavily influenced by
6EPIC. This is the release notes for the 1.2.1 release.
7
8I'd like to send out a special thanks to all those who've contributed in
9a large or small way to the BitchX 1.2.1 release, whether through bug reports,
10patches, testing, coding, packaging, updating documentation, maintaining
11IRC channels or websites, promotion or just keeping the faith:
12
13flashback, Xavier, panasync, dialtone, sideshow, hop, Ancient, fudd, tau,
14dan408, cpet, jeezy, zimzum, t3gah, darkfires, gauze, madsage, snadge,
15packet, nyet, brabes, nenolod, jdhore, riderplus, DJ, oxy, ncopa.
16
17This release has primarily focussed on fixing a lage number of bugs and
18updating the code to suit a modern environment - the full list of changes is
19in the Changelog. Notable changes in the 1.2.1 release that are particularly
20user-visible or of interest to scripters are explained below.
21
22Instructions on building and installing the client are in the INSTALL file,
23and licensing info is found in the COPYRIGHT file.
24
25The BitchX 1.2 series is dedicated to void. We'll miss you, man.
26
27 - caf
28
29/NAMES and /SCAN
30----------------
31
32The formatting of /NAMES and /SCAN output has been substantially reworked.
33The old /FSETs NAMES_BOTCOLOR, NAMES_FRIENDCOLOR, NAMES_NICKCOLOR,
34NAMES_OPCOLOR, NAMES_SHITCOLOR and NAMES_VOICECOLOR have been replaced
35with these new /FSETs:
36
37....................NAMES_NICK %B$[10]0
38................NAMES_NICK_BOT %G$[10]0
39.............NAMES_NICK_FRIEND %Y$[10]0
40.................NAMES_NICK_ME %W$[10]0
41...............NAMES_NICK_SHIT %R$[10]0
42....................NAMES_USER %K[ %n$1-%K]
43.............NAMES_USER_CHANOP %K[%C$0%n$1-%K]
44..............NAMES_USER_IRCOP %K[%R$0%n$1-%K]
45..............NAMES_USER_VOICE %K[%M$0%n$1-%K]
46
47The NAMES_NICK formats control how the nick itself is displayed, depending
48on the status of the nick as recognised by BitchX (the priority order is
49NAMES_NICK_ME > NAMES_NICK_BOT > NAMES_NICK_FRIEND > NAMES_NICK_SHIT >
50NAMES_NICK). The NAMES_USER formats control how the overall entry appears in
51the /NAMES or /SCAN line, depending on the channel status of the nick (the
52priority order is NAMES_USER_CHANOP > NAMES_USER_VOICE > NAMES_USER_IRCOP >
53NAMES_USER).
54
55You'll need to update any scripts or custom formats that altered the old
56formats. If you just use the defaults, the main difference you'll see is
57that your own nick is now shown in white, and voiced users are shown with
58the '+' sent by the server instead of the 'v'. You can go back to the old
59look by setting these formats:
60
61/FSET NAMES_NICK_ME %B$[10]0
62/FSET NAMES_USER_VOICE %K[%Mv%n$1-%K]
63
64Also, the NAMES header and NAMES_FOOTER formats are now called with $3 set
65to the total number of nicks in the channel, and $4 to the mask given to
66/SCAN (if any).
67
68/SCAN now supports a new sort flag "-stat", which sorts the output by
69channel status (chanops, then halfops, then voices, then the riff-raff).
70This functionality was previously provided by the "scan" plugin, so this
71plugin has been removed. If you want this to be the default, just set this
72alias (the double-slash is necessary):
73
74/ALIAS SCAN { //SCAN -STAT }
75
76NEW FORMATS
77-----------
78
79In addition to the new NAMES_* formats mentioned above, these new /FSET
80formats have been added:
81
82CHANNEL_URL
83USERMODE_OTHER
84WHOIS_CALLERID
85WHOIS_SECURE
86WHOIS_LOGGEDIN
87
88HALF-OP SUPPORT
89---------------
90
91New commands /HOP and /DEHOP have been added, to give and remove halfop
92status (on servers that support it).
93
94The scripting function $ishalfop(<nick> <channel) has been added (compatible
95with EPIC), and support for halfops has been added to $channel().
96
97The default status bar now shows your halfop status against your nick.
98
99TCL
100---
101
102panasync OK'd releasing the tcl.c source, so this is now part of the main
103client distribution. If you want TCL support, just pass --with-tcl to
104./configure.
105
106MULTISERVER
107-----------
108
109The "last nick sent to" and "last nick received from" are now tracked
110per-server, so $. $, $B and the "." and "," message targets are all
111per-server.
112