README
1Last Updated: Tue Apr 8 16:16:03 EDT 2003
2
3This directory contains documentation about BitchX and its features.
4
5Documentation for an IRC Client like BitchX is never complete, if you
6have any files you would like included here, please send them to powuh
7in #BitchX on EFnet.
8
9
10
README.GTK
1GTKBitchX is no longer supported. It is bloated and eats a lot of CPU.
2
3If you have problems with the GTK client do not ask us for help. The GTK
4client has not been updated or supported and we will no longer support it
5in BitchX2
6
7
8Minimum requirements for gtkBitchX:
9
10GTK and GLIB 1.2.0
11<http://www.gtk.org/>
12
13imlib 1.9.4
14<http://www.labs.redhat.com/imlib/>
15
16pthreads
17
18zvt from gnome-libs 1.0 (1.2 fixes the scrolling bug)
19<http://www.gnome.org/>
20
21esound (ESD) 0.2.5 and audiofile 0.1.5 for sound support
22<http://www.tux.org/~ricdude/EsounD.html>
23<http://www.68k.org/~michael/audiofile/>
24
25Building GTK:
26
27./configure --with-gtk
28
29For ESD sound support:
30./configure --with-gtk --enable-sound
31
32Known bugs:
33
34Paste doesn't work in MDI mode.
35When the menu is added during window creation it screws up the size of
36 the window. I need to find a way to delay adding of the menu
37 until the window size has been solidified.
38
39Changes:
40
41Closed stdin/stdout/stderr to prevent problems with the
42 starting terminal on gtkBitchX exit.
43Fixed background operation on Linux (and possibly others).
44 SIGTTOU would be called repeatedly on Linux, on
45 FreeBSD using nothing() would stop it's occurance.
46 It now uses SIG_IGN instead of nothing().
47Fixed a sizing bug with the nicklist enabled.
48Added tab highlighting in MDI mode thanks to DavidW2.
49Added a graphical about box and window icons courtesy of DavidW2.
50Added MDI code using the GTK notebook widget. This is not quite
51 what I had originally envisioned but it will work for the
52 time being.
53Determined that the size bug is caused by creating the menu at
54 the same time as the window. The window is too small by the
55 height of the menu. Workaround in the works.
56Fixed a bug with ESD not finding the sound files.
57Code merged back into the main source.
58Added ESD sound support to allow $mciapi(playfile filename) to function
59 as it does in PMBitchX.
60Fixed a bug where the font sizes were not saved when gtkbx falls back
61 to the default fonts. Pointed out by sideshow and MNC.
62Fixed the window #1 corruption problem. It turned out to be in my
63 failsafe code which was to make sure there was a screen to send
64 the text to.
65Reimplemented shared menu code. It now works as designed however when
66 changing a shared menu it recreates the menus which results in
67 excessive drawing. I am looking for a way to prevent the
68 redrawing (or at least reduce it). Also looking for a way to
69 improve the look of the checks... currently "X".
70Added shared menu code from the PM version and then removed it because
71 GTK does not allow internal sharing of widgets. I guess I'll have
72 to code a database of menus and widgets which are theoretically
73 the same. (that won't work either because once it's attached it
74 can't be changed).
75Bits are now used to store menu types to facilitate having more than
76 one type for a menu item.
77Merged with the new BitchX 1.0 beta source.
78Rewrote the tputs code so it's definition won't conflict on some systems.
79Fixed a bug which was coring on first window creation in very rare
80 conditions.
81Readded the flash code to attempt to solve a weird charset problem.
82Reentrancy is impossible until gtk becomes thread safe so I added two,
83 functions gui_mutex_lock() and gui_mutex_unlock() to allow
84 plugins to call gtk functions safely.
85Removed SIGUSR1 signal trapping on glibc 2.0 systems, because SIGUSR1
86 and SIGUSR2 are used by threads.
87Removed bxzvt.h and added a fix for the zvtterm.h header. Zed (zvt
88 author) will be adding this fix to the current codebase but
89 the fix is still required for previous installations.
90Changes to configure to allow clean compiling on *BSD, and remove
91 temporary files.
92Zed also has proportional fonts working, so proportional fonts will
93 be supported by gtkBitchX if using a version of zvt which
94 supports proportional fonts. I'll note which versions do when
95 they are available.
96Implemented /exec -start for unix.
97Implemented /window font <fontname> to allow the font to be set via
98 a script, and to maintain OpenChat compatibility.
99Tried to fix the window clear bug... mostly got it working... seems to
100 clear the first line of window #1.
101
102If you notice any other bugs, or have any questions email me at
103dbsoft@technologist.com or visit #BitchX on EFNet.
104
105Thanks!
106
107Brian Smith
108
README.OS2
1The OS/2 portion of the BitchX client is no longer supported and will not
2be maintained in BitchX2. If you have troubles with this software you can
3attempt to contact the former maintainer but be aware that he may no longer
4have any interest in updating or fixing problems with the OS/2 portion of
5the client.
6
7sin@bitchx.org/EFnet@#BitchX
8
9------
10
11
12This is a port of the latest BitchX to OS/2 Presentation Manager. (3-25-02)
13
14Several environment variables should be set before running PMBitchX.
15
16As of this version you can let the installation program set these,
17or you can do it yourself.
18
19HOME = your home directory, where you will place scripts and other things.
20
21USER = your username
22
23IRCNAME = PMBX User's name
24
25IRCNICK = PMBXUser
26
27HOSTNAME = mycomputer
28
29Scripts are located at scripts.bitchx.com. To install untar them into the
30HOME directory and /load them. Also try /load menu.bx for pull down
31menus. If it is a clean installation and you don't have the HOME environment
32variable set... it should load automatically.
33
34What's new in 1.0c19:
35
36Fixed multiserver issues resulting from script calls from the
37GUI thread with from_server set incorrectly.
38
39Updated to the latest version of Dynamic Windows.
40
41Memory leaks and buffer under/overrun fixes, should be very
42stable now.
43
44Probably alot more but I've been distracted with other projects
45and this code has been developing for over a year.
46
47What's new in 1.0c17:
48
49Lots of bug fixes to the main BitchX source.
50
51Fixed another multiserver bug. from_server was pointing
52to the wrong server when the EVKEY message made it back to
53the main thread. This affected any GUI BitchX's.
54
55What's new in 1.0c16 release 4:
56
57Fixed saving of the MDI variable. (as well as a few others)
58
59Fixed a bug in /window delete.
60
61Added double click keybindings.
62
63Updated script to use these keybindings to open query windows.
64
65Added Saving of the nick@network time date in the "Comments"
66Extended Attribute. So you can tell when and where a file
67came from.
68
69Fixed some major multiserver issues. Some issues still exist.
70
71Updated to the latest version of dynamic windows.
72
73Fixed a bug where the window size was set to 0 when a window was minimized.
74
75Fixed size bug of the minimized icons in MDI mode.
76
77Added virtual host support.
78
79Fixed a couple timer bugs.
80
81Fixed a crash when trying to detach shared menus from a menu that
82didn't exist.
83
84PM About box.
85
86What's new in 1.0c16 release 3:
87
88MDI fixes, resizing flips the y component.
89
90Enhanced codepage support with tips from mikh.
91
92Fixed a bug where BitchX was attempting to operate on dead screens.
93
94What's new in 1.0c16 release 2:
95
96Once again updated the installer. Fixed a bug in release 1 installer
97which caused crashes when updating CONFIG.SYS.
98
99Fixed a bug which *VERY* intermittently caused crashes when updating
100the cursor (blink).
101
102Fixed crashing when loading the script (when comparing against a
103string with "infinity" in it... i.e. in the server list).
104
105Removed MMPM dependency. Now when starting up it tries to load
106MCIAPI.DLL and if it fails it disables sound support.
107
108Fixed a crash bug when SERVER_GROUPS is enabled, and it cycles
109through all the server entries.
110
111What's new in 1.0c16:
112
113Updated script to allow CTRL-X to switch windows as well as channels.
114If you turn off JOIN_NEW_WINDOW please also disable the rebinding of CTRL-X.
115
116Added some keybindings to bx-rc to make things easier.
117If you are an OpenChat user you may want to edit the bx-rc
118and uncomment a couple lines.
119
120Fixed crash bug when reloading menu.bx.
121
122PMPaste now pastes to your query.
123
124Fixed window close crash bug.
125
126Fixed Switch List to show only one window in MDI mode.
127
128Fixed background not redrawing in the MDI window in certain conditions.
129
130Added attached nicklist.
131
132Script enhancements to take advantage of the nicklist.
133
134Preliminary MDI code ... it's buggy in spots.
135
136New JOIN_NEW_WINDOW_TYPE, QUERY_NEW_WINDOW and QUERY_NEW_WINDOW_TYPE.
137Allows the JOIN_NEW_WINDOW variable to be used in console clients.
138
139Since DavidW2 and pana reautoconfed BitchX PMBitchX can now be configured
140via the configure script with the following options:
141./configure --with-pm --enable-sound
142
143Rewrote the copy code. It now allows you to select the entire window.
144Fixed a bug where it was using the wrong character size during the
145selection when more than one font is in use. It now strips trailing
146white space from the end of the line.
147
148Added tab stops to the properties notebook so it can be manuvered with
149the keyboard.
150
151New shared menu code in line with OpenChat.
152
153New function $menucontrol().
154
155Rewrote the font dialog, dialog is bigger, has the option to
156change the font for all windows. No longer blocks the UI while
157the dialog is open.
158
159Fixed a key binding problem with the delete key.
160
161Script updated to demonstrate the new functionality. (settings menu)
162
163New command /dialog in the source tree althought disabled for release
164because it is to incomplete/buggy at the moment.
165
166Debating best fix for keybinding differneces on OS/2 and Unix.
167
168What's new in 75p3 (rel 3):
169
170Fixed a bug in /window setwindowpos which core if the improper
171number of arguments was used.
172
173Fixed the scrollerbars in the pm and gtk, so they no longer use
174the bug work around in clients prior to 75p3.
175
176Fixed a bug which made /window menu -delete not function.
177
178What's new in 75p3 (rel 2):
179
180Bug fix for window #10 cores.
181
182ajoin, invite etc now obey the JOIN_NEW_WINDOW parameter.
183
184The Join menu now works properly.
185
186/window setwindowpos implemented.
187
188Bug fix in $winitem() so it properly returns the current position
189in pmbx and gtkbx.
190
191$screensize() implemented.
192
193Various updates to menu.bx.
194
195What's new 75p3:
196
197Renamed bxmenu.bx to menu.bx (which is what is used in gtkbx).
198
199Several menu.bx fixes, including adding the "quiet" alias.
200
201Merged with the latest source, fixed a bug with event sending when more
202than 10 windows were open.
203
204Fixed a bug in the nicklist when the window in focus was not on a channel.
205
206What's new 75p2 (rel3):
207
208Fixed a bug where the maximum file descriptor limit was incorrectly set to
20916, it is now set to FD_SETSIZE (which in emx 0.9d is 256). Solves a
210core problem with a large number of DCCs.
211
212Fixed a plugin bug where it would loop infinitely when there were less than
21320 nicks on a channel.
214
215Fixed /window show to properly change the current focus.
216
217What's new 75p2 (rel2):
218
219Readded /exec code fixes, and file dialog code that didn't get merged.
220
221What's new 75p2 (rel1):
222
223Fixed a bug in the input line.
224
225Subsequent calls to /nl (nicklist plugin) now correctly turn the
226nicklist on and off.
227
228Updated the nicklist plugin so you can /set nl_always_on_top on.
229
230Using new keybinding code.
231
232Fix for Aurora/Trident/GRADD/Cirrus Logic drivers. (IBM misdocumentation)
233
234Based on BitchX 75p2 (public) code, merged with main distribution.
235
236I have created an XP-like interface in the source code to ease
237porting to other OSes. A preliminary gtk port is available.
238
239Some performance changes in the caching code.
240
241File dialog no longer blocks the window which it was called from.
242It now runs in a separate thread.
243
244Added a clist window scripting function.
245
246Fixed a bug in $servergroup() which caused the script to screw up
247in the server menu server list.
248
249Fixed a bug in /window show which caused a crash when used with
250hidden windows.
251
252Added SIGINT on CTRL-C to allow you to break out of a server connect.
253(In both pmbx and gtkbx)
254
255Changed the installer to not add IRCSERVER to the CONFIG.SYS.
256
257Readded a couple patches that got missed in the last code merge.
258
259Fixed the corruption bug in gui_clreol().
260
261Known bugs:
262
263No PM specific ones known at the moment.
264
265Please don't report the above as bugs, I already know about them. :>
266
267Please send any comments to dbsoft@technologist.com
268