Added launch module, which allows running programs easily using the injector,
[rox-lib/lack.git] / Help / Changes
blob4495c17ac8bb36269f708d6860bce1ce5ae03dd6
1                         ROX-Lib2
2                         Shared code for ROX applications
3                         by Thomas Leonard
4                         http://rox.sourceforge.net
6 02-Sep-2005
7 ~~~~~~~~~~~
8 Added launch module, which allows running programs easily using the injector,
9 and made filer.py use 0launch if available (Thomas Leonard; requested by
10 Christopher Arndt).
12 30-Aug-2005
13 ~~~~~~~~~~~
14 If pygtk is found, but not gtk, give a better error (Thomas Leonard; reported
15 by Albert).
17 20-Aug-2005
18 ~~~~~~~~~~~
19 If 'xterm' isn't available, give a sensible error message when using the
20 su module (Thomas Leonard; reported by Vincent Lefevre).
22 18-Aug-2005
23 ~~~~~~~~~~~
24 Added ROX-Lib.xml file, which makes it easy to register a CVS copy of ROX-Lib
25 with the 0launch, using '0launch --add-feed' (Thomas Leonard).
27 25-Jul-2005 (Release 2.0.2)
28 ~~~~~~~~~~~
29 Bugfix: Installing MIME handlers under the XDG base dir system didn't 
30         work (Stephen Watson).
32 17-Jun-2005 (Release 2.0.1)
33 ~~~~~~~~~~~
34 Send deprecation warnings to stdout, not stderr, so only developers will
35 see them (Thomas Leonard).
37 10-Jun-2005
38 ~~~~~~~~~~~
39 Fixed deprecation warning in processes.py (Thomas Leonard).
41 01-Jun-2005
42 ~~~~~~~~~~~
43 Avoid apparent PyGTK bug related to icon themes, may result in a
44 memory leak but probably won't (Stephen Watson).
46 19-May-2005
47 ~~~~~~~~~~~
48 Clean up of icon theme handling (Stephen Watson).
50 18-May-2005
51 ~~~~~~~~~~~
52 Compatability with PyGTK 2.4 retaining backwards compatability with
53 2.2 at least (Ken Hayber, Stephen Watson).
55 12-May-2005
56 ~~~~~~~~~~~
57 Updated Chinese translation (Babyfai Cheung).
59 11-May-2005
60 ~~~~~~~~~~~
61 Added Portuguese translation (José Carlos do Nascimento).
63 07-May-2005
64 ~~~~~~~~~~~
65 Don't try to get pygtk through Zero Install. The injector can be used to
66 choose the implementation of pygtk to use, including a version in Zero
67 Install if desired (Thomas Leonard).
69 06-May-2005
70 ~~~~~~~~~~~
71 MIME handler install now uses basedir (Stephen Watson).
72 Tests use gtk.main() instead of the deprecated gtk.mainloop() (Stephen Watson).
74 05-May-2005
75 ~~~~~~~~~~~
76 Some versions of GTK silently remove '-' from sys.argv (GTK bug #303166).
77 Added a work-around (Thomas Leonard).
79 02-May-2005
80 ~~~~~~~~~~~
81 Put "root" back in su command, but detect what the exact string should be, as
82 Solaris needs something here (reported by Stephen Watson).
84 01-May-2005
85 ~~~~~~~~~~~
86 The default SaveArea.confirm_new_path() now shows an error if the target
87 exists as a directory, instead of asking if you want to overwrite it (Thomas
88 Leonard; reported by Jonatan Liljedahl).
89 Remove "root" from the su command, as some systems call user 0 something else
90 (Thomas Leonard; reported by Jonatan Liljedahl).
92 30-Apr-2005
93 ~~~~~~~~~~~
94 When getting an icon for saving, specify the size if PyGTK is recent enough.
95 This prevents SVG icons from appearing in huge sizes (Thomas Leonard;
96 requested by John Pettigrew).
97 Bugfix: Theme index parser failed to cope with comments at the start of the
98         file (Thomas Leonard).
100 29-Apr-2005
101 ~~~~~~~~~~~
102 Compatability fixes for the su module (Stephen Watson).
104 17-Apr-2005
105 ~~~~~~~~~~~
106 Fixed Zero Install version test in findrox.py (Thomas Leonard).
108 16-Apr-2005 (Release 2.0.0)
109 ~~~~~~~~~~~
110 Run unit tests in alphabetical order as it fixes a strange interaction between them (Stephen Watson).
112 10-Apr-2005
113 ~~~~~~~~~~~
114 Added unit tests for processes module, based on old tests in Archive (Thomas
115 Leonard).
117 09-Apr-2005
118 ~~~~~~~~~~~
119 Changed MakeDist to allow use of other SourceForge accounts (Stephen Watson).
121 01-Apr-2005
122 ~~~~~~~~~~~
123 Added 'testall' script to run all the unit tests together (Thomas Leonard).
125 23-Mar-2005 (Release 1.9.18)
126 ~~~~~~~~~~~
127 German translation (Guido Schimmels).
129 13-Mar-2005
130 ~~~~~~~~~~~
131 Added TODO file to track bugs and changes needed for 2.0.0 release.
133 10-Mar-2005
134 ~~~~~~~~~~~
135 Bugfix: Set default in Options box to OK to avoid triggering a GTK bug
136         (Thomas Leonard, reported by Guido Schimmels).
138 16-Jan-2005 (Release 1.9.17)
139 ~~~~~~~~~~~
140 Added OutputBlocker, which works in a similar way to InputBlocker (Thomas
141 Leonard).
143 15-Jan-2005
144 ~~~~~~~~~~~
145 Be consistent about URI escaping. set_uri() is now always passed an unescaped
146 UTF-8 string (Thomas Leonard).
148 03-Jan-2004
149 ~~~~~~~~~~~
150 Added fixedlist and varlist widgets to OptionsBox (Stephen Watson).
152 31-Dec-2004
153 ~~~~~~~~~~~
154 Added MIME type matching by file contents (Stephen Watson).
156 29-Dec-2004
157 ~~~~~~~~~~~
158 If a 'rox' module is in PYTHONPATH, use that without any searching (Thomas
159 Leonard).
161 23-Dec-2004
162 ~~~~~~~~~~~
163 Added Chinese translation (Babyfai Cheung).
165 11-Dec-2004
166 ~~~~~~~~~~~
167 Suppress warning when we use GtkItemFactory under pygtk 2.4 (Stephen Watson).
169 25-Nov-2004
170 ~~~~~~~~~~~
171 Added tasks.InputBlocker, which triggers when an input source becomes
172 readable (Thomas Leonard).
174 21-Nov-2004
175 ~~~~~~~~~~~
176 Bugfix: Use only text nodes when getting the tool tip from the Options.xml
177         file (Stephen Watson).
179 22-Oct-2004
180 ~~~~~~~~~~~
181 Bugfix: Theme subdirectories are separated by ',' not ';' (reported by
182         Denis Prost).
184 20-Oct-2004
185 ~~~~~~~~~~~
186 Bugfix: When a menu has more than one toggle item, only one is updated
187         correctly (Ken Hayber).
189 07-Oct-2004
190 ~~~~~~~~~~~
191 Replace g.mainloop() and g.mainquit() with g.main() and g.main_quit() as
192 recommended since pygtk 2.0.0 to avoid warnings with pygtk 2.4.0 (Stephen 
193 Watson).
195 03-Oct-2004
196 ~~~~~~~~~~~
197 Added options.ListOption to support multi-valued option widgets, such as
198 lists (Stephen Watson).
200 02-Oct-2004 (Release 1.9.16)
201 ~~~~~~~~~~~
202 Cope better with user cancelling su operation. New interface to replace
203 create_su_proxy (Thomas Leonard).
205 27-Sep-2004
206 ~~~~~~~~~~~
207 The choices module is now deprecated. You can use choices.migrate() to move
208 settings over to the basedir system (Thomas Leonard). Also added
209 basedir.load_first_config(), which works like the old choices.load().
211 26-Sep-2004
212 ~~~~~~~~~~~
213 Several incompatible changes to the experimental proxy API to make it simpler
214 (Thomas Leonard):
216 - Create_su_proxy now returns the MasterObject directly, not the MasterProxy.
217 - You can call finish on the MasterObject (so the MasterProxy isn't needed).
218 - Slave methods no longer take a 'request' argument. Instead, the return
219   value of the function is returned.
220 - Methods can only return one value. dequeue and dequeue_last have been
221   replaced with a 'result' property.
222 - Methods on MasterObject now return a RequestBlocker, not a Queue. This
223   means you just yield the object itself, not object.blocker.
225 Tasks API is no longer experimental, but proxy API is.
227 22-Sep-2004
228 ~~~~~~~~~~~
229 Added a Help button to the exception dialog, which opens the new Help/Errors
230 file (Thomas Leonard).
232 08-Sep-2004
233 ~~~~~~~~~~~
234 Bugfix: Failed to call the parent constructor to AbortSave correctly.
236 06-Sep-2004
237 ~~~~~~~~~~~
238 Simplified su code and interface.
239 New suchild methods: open, close, read, write, chmod and rename, which work
240 just like their normal Python counterparts (Thomas Leonard).
242 29-Aug-2004
243 ~~~~~~~~~~~
244 Removed code to turn off the separator in the debug dialog. GTK 2.4 doesn't
245 need it, and generates a warning if you use it (Thomas Leonard).
247 27-Aug-2004 (Release 1.9.15)
248 ~~~~~~~~~~~
249 Added spawnvpe and waitpid methods to suchild.
251 08-Aug-2004
252 ~~~~~~~~~~~
253 If the unit field for a <numentry> option is blank, don't try to translate it
254 (reported by Guido Schimmels).
256 30-Jun-2004
257 ~~~~~~~~~~~
258 Added 'su' module for performing operations as root.
260 11-Jun-2004
261 ~~~~~~~~~~~
262 Allow "" as a valid value in a OptionsBox menu (reported by Guido Schimmels).
264 10-Jun-2004
265 ~~~~~~~~~~~
266 Added 'proxy' module. This allows one Python process to invoke methods on
267 another asynchronously.
268 Added rox.UserAbort exception, to be raised when users cancel something
269 manually.
271 07-Jun-2004
272 ~~~~~~~~~~~
273 Fix syntax error I caused when I added a docstring (Stephen Watson).
275 30-May-2004
276 ~~~~~~~~~~~
277 Get update-mime-database command through Zero Install, if possible.
279 24-May-2004
280 ~~~~~~~~~~~
281 mime_handler can now uninstall (Stephen Watson).
283 04-May-2004
284 ~~~~~~~~~~~
285 Translate menu items in options (Guido Schimmels).
287 26-Apr-2004
288 ~~~~~~~~~~~
289 Added <slider> widget to options.
291 25-Apr-2004
292 ~~~~~~~~~~~
293 Added 'size-group' attribute to Options.xml elements. This allows grouping
294 elements so that their labels all appear the same width.
296 20-Apr-2004
297 ~~~~~~~~~~~
298 Bugfix: Colour buttons in the Options boxes didn't work with some themes
299         (Jonatan Liljedahl).
301 17-Apr-2004 (Release 1.9.14)
302 ~~~~~~~~~~~
303 Added ToggleItem (based on a patch from Ken Hayber).
305 15-Apr-2004
306 ~~~~~~~~~~~
307 Better <label> widgets (wrapping and icon). Taken from LookAndFeel.
309 20-Mar-2004
310 ~~~~~~~~~~~
311 Stop themes from overriding the display of the colour-picker buttons in
312 the options box (Rene Ejury).
314 17-Mar-2004
315 ~~~~~~~~~~~
316 Warn about old versions of findrox.py.
317 Bugfix: Bug in new menu API prevented submenus from working.
319 16-Mar-2004 (Release 1.9.13)
320 ~~~~~~~~~~~
321 Bugfix: Icon themes didn't work with python versions older than 2.2.2
322         (reported by Thomas Zajic).
324 15-Mar-2004
325 ~~~~~~~~~~~
326 Bugfix: Use filer module to show ROX-Lib help, rather than using os.system,
327         so that it works with Zero Install (reported by Keith Hopper).
329 14-Mar-2004
330 ~~~~~~~~~~~
331 Added widget_registry to OptionsBox, to provide an easy way to register
332 new option types. Removed build_button in favour of this method.
334 Bugfix: If an error occurred loading the ROX theme at startup it could not
335         be reported, because icon_theme wants debug, debug wants saving, and
336         saving wants icon_theme (reported by Thomas Zajic).
338 12-Mar-2004
339 ~~~~~~~~~~~
340 Cope with pygtk2.2 API change (Stephen Watson, reported by Guido Schimmels).
342 06-Mar-2004
343 ~~~~~~~~~~~
344 Added secretentry and button options to the OptionsBox (Stephen Watson).
346 26-Feb-2004
347 ~~~~~~~~~~~
348 Cope with option values split into multiple DOM text nodes (Rene Ejury).
350 22-Feb-2004
351 ~~~~~~~~~~~
352 Allow a list of values to be stored in each menu Action. These are used as
353 the arguments to the callback function.
354 If a file's details were recorded (in document.save_last_stat) when it was
355 loaded, make sure they haven't changed when saving. Saving also updates this
356 variable (requested by Arnaud Calvo).
358 20-Feb-2004
359 ~~~~~~~~~~~
360 Updated examples in documentation for new findrox (Yuri Bongiorno).
362 10-Feb-2004
363 ~~~~~~~~~~~
364 New API for menus. Instead of passing tuples for menu items, python classes
365 can be used. The old tuple interface is still supported.
367 07-Feb-2004
368 ~~~~~~~~~~~
369 Don't stop DnD working in the savebox just because no icon can be found
370 (reported by Martin Lucina).
372 02-Feb-2004
373 ~~~~~~~~~~~
374 Added French translation (Vincent Lefèvre).
376 30-Jan-2004
377 ~~~~~~~~~~~
378 Also translate <label> elements in the Options box (reported by Arnaud Calvo).
380 28-Jan-2004
381 ~~~~~~~~~~~
382 Also translate section names in the Options box (reported by Arnaud Calvo).
384 22-Jan-2004 (Release 1.9.12)
385 ~~~~~~~~~~~
386 Added 'tasks' module to provide a light-weight alternative to threads.
387 Bugfix: On non-zero-install systems, the sense of the version check in findrox
388         was wrong.
390 02-Jan-2004
391 ~~~~~~~~~~~
392 Added method to MIMEtype to fetch its icon. Install list window for
393 the MIME handler installation uses it (Stephen Watson).
395 13-Dec-2003
396 ~~~~~~~~~~~
397 Translate text in Options box.
399 28-Dec-2003
400 ~~~~~~~~~~~
401 Allow ROXLIB_DISABLE_ZEROINSTALL to override looking for ROX-Lib in Zero
402 Install (useful for ROX-Lib developers). Prefer a locally installed version
403 of ROX-Filer to the Zero Install version; this also allows users to select
404 which Zero Install version they want (eg, stable or developer).
405 Moved MIME handler installation into a separate module (mime_handler) and
406 made a few changes to the XML syntax.
408 24-Dec-2003
409 ~~~~~~~~~~~
410 Added <menu> OptionMenu widget for Options box (Chris Shaffer).
412 27-Nov-2003
413 ~~~~~~~~~~~
414 Fixed bug in findrox when not using Zero Install (Lionel Bringuier).
416 26-Nov-2003
417 ~~~~~~~~~~~
418 Escape and unescape URIs, as required by ROX-Filer 2.1.0 (reported by
419 Peter Geer).
420 Note that the xds_load_uris() method is now called with escaped URIs.
421 Try to run the filer through Zero Install, if possible.
423 11-Nov-2003
424 ~~~~~~~~~~~
425 If we can't get pygtk through Zero Install, try the local copy.
427 05-Nov-2003
428 ~~~~~~~~~~~
429 Added support in mime.py for an application to set MIME-type run
430 actions and thumbnail programs (Stephen Watson).
432 31-Oct-2003
433 ~~~~~~~~~~~
434 Simplified implementation of saving.SaveFilter by using the new
435 processes.PipeThroughCommand class. The child_run() method of SaveFilter
436 is no longer supported.
437 In processes.PipeThroughCommand, a None input stream gets /dev/null instead
438 of inheriting its parent's stream. The class has a new run_child_with_streams
439 to make overriding the behaviour easier.
440 findrox.py script now warns if ROX-Lib2 version is too old (unless requesting
441 a version too old to have a version number).
443 29-Oct-2003
444 ~~~~~~~~~~~
445 Changed 'Dismiss' to 'Close' (Chris Shaffer).
446 Bugfix: Error reporting in mime.py failed to import the _ function (reported
447         by Christopher Haines).
448 New AppInfo.py for parsing AppInfo.xml files (Christopher Arndt), InfoWin
449 converted to use it (Stephen Watson).
451 15-Oct-2003 (Release 1.9.11)
452 ~~~~~~~~~~~
453 Bugfix: Python 2.3's new bool type broke options saving (reported by Lars
454         Hansson).
456 13-Oct-2003
457 ~~~~~~~~~~~
458 Added PipeThroughCommand class (copied from Archive, with some minor
459 changes).
461 09-Oct-2003
462 ~~~~~~~~~~~
463 Allow event to be None for Menu.popup. This allows the menu to be activated
464 from the keyboard, using the 'popup-menu' signal.
466 08-Oct-2003
467 ~~~~~~~~~~~
468 Added French translation in AppInfo.xml (Vincent Lefèvre).
470 03-Oct-2003 (Release 1.9.10)
471 ~~~~~~~~~~~
472 Added support for icon themes (doesn't do inheritance yet).
474 28-Sep-2003
475 ~~~~~~~~~~~
476 Added some version information to the dialog you get when you run ROX-Lib
477 directly.
479 22-Sep-2003
480 ~~~~~~~~~~~
481 New bug() function to quickly bring up a debugging prompt.
483 15-Sep-2003
484 ~~~~~~~~~~~
485 The glob patterns in mime.py are now sorted longest first. Fix for setting 
486 icon in the old way when there was no icon (Stephen Watson).
488 25-Aug-2003
489 ~~~~~~~~~~~
490 Try to cope better with bad hostname setup (reported by Nathan Howell).
492 24-Aug-2003
493 ~~~~~~~~~~~
494 Added InfoWin.py to provide standardized information window (Stephen Watson).
496 24-Aug-2003
497 ~~~~~~~~~~~
498 Fall back to old way of setting default icon for older pygtk's (Stephen 
499 Watson).
501 20-Aug-2003
502 ~~~~~~~~~~~
503 Added Italian translation (Yuri Bongiorno).
505 18-Aug-2003
506 ~~~~~~~~~~~
507 Better way to set the default icon.
509 16-Aug-2003 (Release 1.9.9)
510 ~~~~~~~~~~~
511 Give windows a default icon from .DirIcon (Chris Shaffer).
513 01-Aug-2003
514 ~~~~~~~~~~~
515 Try to get pygtk through ZeroInstall.
517 25-Jul-2003
518 ~~~~~~~~~~~
519 Updated findrox to use ZeroInstall, if possible.
521 22-Jul-2003
522 ~~~~~~~~~~~
523 Work out correct application name even if invoked via a symlink. This stops
524 applications from calling themselves 'text_plain', etc (reported by Joe Hill).
526 19-Jul-2003 (Release 1.9.8)
527 ~~~~~~~~~~~
528 Make default menu positioning function keep the pointer inside the menu.
529 Allow stock icons in menus.
531 18-Jul-2003
532 ~~~~~~~~~~~
533 Added position_fn argument to rox.Menu.popup.
535 17-Jul-2003
536 ~~~~~~~~~~~
537 Cope with % escaped URIs.
539 04-Jul-2003
540 ~~~~~~~~~~~
541 Added italian translation in AppInfo.xml (Yuri Bongiorno)
543 26-Jun-2003
544 ~~~~~~~~~~~
545 When loading data from another application, pass the suggested leafname to
546 xds_load_from_stream().
548 04-Jun-2003
549 ~~~~~~~~~~~
550 Code tidying, thanks to pychecker.
552 26-May-2003
553 ~~~~~~~~~~~
554 Added fileutils module, which provides an interactive makedirs() function
555 (Richard Boulton).
556 Changed savebox module to use it.
558 16-May-2003 (Release 1.9.7)
559 ~~~~~~~~~~~
560 New icon (Geoff Youngs).
561 Added 'basedir' module for freedesktop.org Base Directory specification.
563 06-May-2003
564 ~~~~~~~~~~~
565 Added functions to read MIME database (Stephen Watson).
567 27-Jan-2003 (Release 1.9.6)
568 ~~~~~~~~~~~
569 Make the default window class the name of the application directory, not
570 'AppRun' (suggested by Albert Wagner).
571 Bugfix: With pygtk-1.99.14, only the first error message from a process
572         would be detected; this meant that ROX-Lib wouldn't detect when the
573         process quit (reported by joehill).
574 Bugfix: <hbox> and <vbox> layouts didn't work in the options box (Allen
575         Leonard).
577 22-Jan-2003
578 ~~~~~~~~~~~
579 If python is too old, raise SystemExit instead of quitting.
580 Ensure that True and False are defined.
582 16-Dec-2002
583 ~~~~~~~~~~~
584 Work around bug in some versions of pygtk that stopped the options window
585 from working.
587 12-Dec-2002 (Release 1.9.5)
588 ~~~~~~~~~~~
589 Upgrade Options box to new style.
591 11-Dec-2002
592 ~~~~~~~~~~~
593 Bugfix: If an option had an empty value, an exception was thrown on loading
594         (reported by Stephen Watson).
596 05-Dec-2002
597 ~~~~~~~~~~~
598 Cope with missing input_add_full.
600 25-Oct-2002
601 ~~~~~~~~~~~
602 Pygtk 1.99.12 seems to more-or-less work now (according to Alastair Porter), so
603 remove the warning for that so we can support RedHat 8.0.
605 20-Oct-2002 (Release 1.9.4)
606 ~~~~~~~~~~~
607 More warnings about old pygtk versions.
608 Added Dialog class (does ref-counting, like Window).
610 15-Oct-2002
611 ~~~~~~~~~~~
612 Trying to use ROX-Lib2 with earlier versions of python now gives a sensible
613 error message.
615 10-Oct-2002
616 ~~~~~~~~~~~
617 Make clicking on ROX-Lib itself work again (Christopher Arndt).
619 25-Aug-2002
620 ~~~~~~~~~~~
621 Updated findrox.py to use pygtk 1.99.13 -- update your programs!
623 25-Aug-2002 (Release 1.9.3)
624 ~~~~~~~~~~~
625 Switch to use new pygtk versioning system (requires pygtk 1.99.13).
627 19-Aug-2002
628 ~~~~~~~~~~~
629 Added 'processes' module, based on code in Archive, which makes controlling
630 subprocesses easier.
632 14-Aug-2002
633 ~~~~~~~~~~~
634 Bugfix: Changing the keys lost any builtin shortcuts (Gtk behaviour has
635         changed since 1.2).
637 08-Aug-2002
638 ~~~~~~~~~~~
639 Trap exceptions when activating menu items and report nicely.
641 07-Aug-2002
642 ~~~~~~~~~~~
643 Bugfix: Remember to call drop_finish() after a drag-and-drop operation.
645 05-Aug-2002 (Release 1.9.2)
646 ~~~~~~~~~~~
647 Renamed XDSLoader module to 'loading' (like 'saving').
648 Added 'mime' module for installing extra MIME information.
649 Bugfix: XDSLoader didn't handle the drag-drop signal, and so only worked for
650         widgets with their own implementation!
652 31-Jul-2002
653 ~~~~~~~~~~~
654 Show local variables in report_exception, and allow expressions to be
655 evaluated in the context of any frame.
656 Added StringSaver class.
658 25-Jul-2002
659 ~~~~~~~~~~~
660 Added applet module for creating ROX panel applets.
662 24-Jul-2002
663 ~~~~~~~~~~~
664 Bugfix: saving code didn't cope with missing images (reported by Musus Umbra).
666 21-Jul-2002
667 ~~~~~~~~~~~
668 If 'gtk2' isn't available, see if 'gtk' is actually the 2.0 version.
669 Added save_set_permissions to Saveable interface, allowing the default
670 save_to_file to preserve file permissions.
671 Changes to XDSLoader: xds_load_from_stream(name, type, stream)
672 replaces the old xds_load_data(data).
673 Loading files from remote filers works now.
674 Added much improved exception reporting system.
676 19-Jul-2002 (Release 1.9.1)
677 ~~~~~~~~~~~
678 Added support for translations.
680 18-Jul-2002
681 ~~~~~~~~~~~
682 License change to the LGPL (allows commercial programs to use this library).
683 Added AbortSave exception.
685 14-Jul-2002
686 ~~~~~~~~~~~
687 Saveable.save_to_file() should raise an exception when saving fails, rather
688 than returning 0. The return value is now ignored (note that raising an
689 exception will still work with 1.9.0).
690 toplevel_unref() ignores any arguments, so it is easier to use as a signal
691 handler.
693 12-Jul-2002 (Release 1.9.0)
694 ~~~~~~~~~~~
695 First release for Gtk+-2.0.