2 Shared code for ROX applications
4 http://rox.sourceforge.net
6 16-Apr-2005 (Release 2.0.0)
8 Run unit tests in alphabetical order as it fixes a strange interaction between them (Stephen Watson).
12 Added unit tests for processes module, based on old tests in Archive (Thomas
17 Changed MakeDist to allow use of other SourceForge accounts (Stephen Watson).
21 Added 'testall' script to run all the unit tests together (Thomas Leonard).
23 23-Mar-2005 (Release 1.9.18)
25 German translation (Guido Schimmels).
29 Added TODO file to track bugs and changes needed for 2.0.0 release.
33 Bugfix: Set default in Options box to OK to avoid triggering a GTK bug
34 (Thomas Leonard, reported by Guido Schimmels).
36 16-Jan-2005 (Release 1.9.17)
38 Added OutputBlocker, which works in a similar way to InputBlocker (Thomas
43 Be consistent about URI escaping. set_uri() is now always passed an unescaped
44 UTF-8 string (Thomas Leonard).
48 Added fixedlist and varlist widgets to OptionsBox (Stephen Watson).
52 Added MIME type matching by file contents (Stephen Watson).
56 If a 'rox' module is in PYTHONPATH, use that without any searching (Thomas
61 Added Chinese translation (Babyfai Cheung).
65 Suppress warning when we use GtkItemFactory under pygtk 2.4 (Stephen Watson).
69 Added tasks.InputBlocker, which triggers when an input source becomes
70 readable (Thomas Leonard).
74 Bugfix: Use only text nodes when getting the tool tip from the Options.xml
75 file (Stephen Watson).
79 Bugfix: Theme subdirectories are separated by ',' not ';' (reported by
84 Bugfix: When a menu has more than one toggle item, only one is updated
85 correctly (Ken Hayber).
89 Replace g.mainloop() and g.mainquit() with g.main() and g.main_quit() as
90 recommended since pygtk 2.0.0 to avoid warnings with pygtk 2.4.0 (Stephen
95 Added options.ListOption to support multi-valued option widgets, such as
96 lists (Stephen Watson).
98 02-Oct-2004 (Release 1.9.16)
100 Cope better with user cancelling su operation. New interface to replace
101 create_su_proxy (Thomas Leonard).
105 The choices module is now deprecated. You can use choices.migrate() to move
106 settings over to the basedir system (Thomas Leonard). Also added
107 basedir.load_first_config(), which works like the old choices.load().
111 Several incompatible changes to the experimental proxy API to make it simpler
114 - Create_su_proxy now returns the MasterObject directly, not the MasterProxy.
115 - You can call finish on the MasterObject (so the MasterProxy isn't needed).
116 - Slave methods no longer take a 'request' argument. Instead, the return
117 value of the function is returned.
118 - Methods can only return one value. dequeue and dequeue_last have been
119 replaced with a 'result' property.
120 - Methods on MasterObject now return a RequestBlocker, not a Queue. This
121 means you just yield the object itself, not object.blocker.
123 Tasks API is no longer experimental, but proxy API is.
127 Added a Help button to the exception dialog, which opens the new Help/Errors
128 file (Thomas Leonard).
132 Bugfix: Failed to call the parent constructor to AbortSave correctly.
136 Simplified su code and interface.
137 New suchild methods: open, close, read, write, chmod and rename, which work
138 just like their normal Python counterparts (Thomas Leonard).
142 Removed code to turn off the separator in the debug dialog. GTK 2.4 doesn't
143 need it, and generates a warning if you use it (Thomas Leonard).
145 27-Aug-2004 (Release 1.9.15)
147 Added spawnvpe and waitpid methods to suchild.
151 If the unit field for a <numentry> option is blank, don't try to translate it
152 (reported by Guido Schimmels).
156 Added 'su' module for performing operations as root.
160 Allow "" as a valid value in a OptionsBox menu (reported by Guido Schimmels).
164 Added 'proxy' module. This allows one Python process to invoke methods on
165 another asynchronously.
166 Added rox.UserAbort exception, to be raised when users cancel something
171 Fix syntax error I caused when I added a docstring (Stephen Watson).
175 Get update-mime-database command through Zero Install, if possible.
179 mime_handler can now uninstall (Stephen Watson).
183 Translate menu items in options (Guido Schimmels).
187 Added <slider> widget to options.
191 Added 'size-group' attribute to Options.xml elements. This allows grouping
192 elements so that their labels all appear the same width.
196 Bugfix: Colour buttons in the Options boxes didn't work with some themes
199 17-Apr-2004 (Release 1.9.14)
201 Added ToggleItem (based on a patch from Ken Hayber).
205 Better <label> widgets (wrapping and icon). Taken from LookAndFeel.
209 Stop themes from overriding the display of the colour-picker buttons in
210 the options box (Rene Ejury).
214 Warn about old versions of findrox.py.
215 Bugfix: Bug in new menu API prevented submenus from working.
217 16-Mar-2004 (Release 1.9.13)
219 Bugfix: Icon themes didn't work with python versions older than 2.2.2
220 (reported by Thomas Zajic).
224 Bugfix: Use filer module to show ROX-Lib help, rather than using os.system,
225 so that it works with Zero Install (reported by Keith Hopper).
229 Added widget_registry to OptionsBox, to provide an easy way to register
230 new option types. Removed build_button in favour of this method.
232 Bugfix: If an error occurred loading the ROX theme at startup it could not
233 be reported, because icon_theme wants debug, debug wants saving, and
234 saving wants icon_theme (reported by Thomas Zajic).
238 Cope with pygtk2.2 API change (Stephen Watson, reported by Guido Schimmels).
242 Added secretentry and button options to the OptionsBox (Stephen Watson).
246 Cope with option values split into multiple DOM text nodes (Rene Ejury).
250 Allow a list of values to be stored in each menu Action. These are used as
251 the arguments to the callback function.
252 If a file's details were recorded (in document.save_last_stat) when it was
253 loaded, make sure they haven't changed when saving. Saving also updates this
254 variable (requested by Arnaud Calvo).
258 Updated examples in documentation for new findrox (Yuri Bongiorno).
262 New API for menus. Instead of passing tuples for menu items, python classes
263 can be used. The old tuple interface is still supported.
267 Don't stop DnD working in the savebox just because no icon can be found
268 (reported by Martin Lucina).
272 Added French translation (Vincent Lefèvre).
276 Also translate <label> elements in the Options box (reported by Arnaud Calvo).
280 Also translate section names in the Options box (reported by Arnaud Calvo).
282 22-Jan-2004 (Release 1.9.12)
284 Added 'tasks' module to provide a light-weight alternative to threads.
285 Bugfix: On non-zero-install systems, the sense of the version check in findrox
290 Added method to MIMEtype to fetch its icon. Install list window for
291 the MIME handler installation uses it (Stephen Watson).
295 Translate text in Options box.
299 Allow ROXLIB_DISABLE_ZEROINSTALL to override looking for ROX-Lib in Zero
300 Install (useful for ROX-Lib developers). Prefer a locally installed version
301 of ROX-Filer to the Zero Install version; this also allows users to select
302 which Zero Install version they want (eg, stable or developer).
303 Moved MIME handler installation into a separate module (mime_handler) and
304 made a few changes to the XML syntax.
308 Added <menu> OptionMenu widget for Options box (Chris Shaffer).
312 Fixed bug in findrox when not using Zero Install (Lionel Bringuier).
316 Escape and unescape URIs, as required by ROX-Filer 2.1.0 (reported by
318 Note that the xds_load_uris() method is now called with escaped URIs.
319 Try to run the filer through Zero Install, if possible.
323 If we can't get pygtk through Zero Install, try the local copy.
327 Added support in mime.py for an application to set MIME-type run
328 actions and thumbnail programs (Stephen Watson).
332 Simplified implementation of saving.SaveFilter by using the new
333 processes.PipeThroughCommand class. The child_run() method of SaveFilter
334 is no longer supported.
335 In processes.PipeThroughCommand, a None input stream gets /dev/null instead
336 of inheriting its parent's stream. The class has a new run_child_with_streams
337 to make overriding the behaviour easier.
338 findrox.py script now warns if ROX-Lib2 version is too old (unless requesting
339 a version too old to have a version number).
343 Changed 'Dismiss' to 'Close' (Chris Shaffer).
344 Bugfix: Error reporting in mime.py failed to import the _ function (reported
345 by Christopher Haines).
346 New AppInfo.py for parsing AppInfo.xml files (Christopher Arndt), InfoWin
347 converted to use it (Stephen Watson).
349 15-Oct-2003 (Release 1.9.11)
351 Bugfix: Python 2.3's new bool type broke options saving (reported by Lars
356 Added PipeThroughCommand class (copied from Archive, with some minor
361 Allow event to be None for Menu.popup. This allows the menu to be activated
362 from the keyboard, using the 'popup-menu' signal.
366 Added French translation in AppInfo.xml (Vincent Lefèvre).
368 03-Oct-2003 (Release 1.9.10)
370 Added support for icon themes (doesn't do inheritance yet).
374 Added some version information to the dialog you get when you run ROX-Lib
379 New bug() function to quickly bring up a debugging prompt.
383 The glob patterns in mime.py are now sorted longest first. Fix for setting
384 icon in the old way when there was no icon (Stephen Watson).
388 Try to cope better with bad hostname setup (reported by Nathan Howell).
392 Added InfoWin.py to provide standardized information window (Stephen Watson).
396 Fall back to old way of setting default icon for older pygtk's (Stephen
401 Added Italian translation (Yuri Bongiorno).
405 Better way to set the default icon.
407 16-Aug-2003 (Release 1.9.9)
409 Give windows a default icon from .DirIcon (Chris Shaffer).
413 Try to get pygtk through ZeroInstall.
417 Updated findrox to use ZeroInstall, if possible.
421 Work out correct application name even if invoked via a symlink. This stops
422 applications from calling themselves 'text_plain', etc (reported by Joe Hill).
424 19-Jul-2003 (Release 1.9.8)
426 Make default menu positioning function keep the pointer inside the menu.
427 Allow stock icons in menus.
431 Added position_fn argument to rox.Menu.popup.
435 Cope with % escaped URIs.
439 Added italian translation in AppInfo.xml (Yuri Bongiorno)
443 When loading data from another application, pass the suggested leafname to
444 xds_load_from_stream().
448 Code tidying, thanks to pychecker.
452 Added fileutils module, which provides an interactive makedirs() function
454 Changed savebox module to use it.
456 16-May-2003 (Release 1.9.7)
458 New icon (Geoff Youngs).
459 Added 'basedir' module for freedesktop.org Base Directory specification.
463 Added functions to read MIME database (Stephen Watson).
465 27-Jan-2003 (Release 1.9.6)
467 Make the default window class the name of the application directory, not
468 'AppRun' (suggested by Albert Wagner).
469 Bugfix: With pygtk-1.99.14, only the first error message from a process
470 would be detected; this meant that ROX-Lib wouldn't detect when the
471 process quit (reported by joehill).
472 Bugfix: <hbox> and <vbox> layouts didn't work in the options box (Allen
477 If python is too old, raise SystemExit instead of quitting.
478 Ensure that True and False are defined.
482 Work around bug in some versions of pygtk that stopped the options window
485 12-Dec-2002 (Release 1.9.5)
487 Upgrade Options box to new style.
491 Bugfix: If an option had an empty value, an exception was thrown on loading
492 (reported by Stephen Watson).
496 Cope with missing input_add_full.
500 Pygtk 1.99.12 seems to more-or-less work now (according to Alastair Porter), so
501 remove the warning for that so we can support RedHat 8.0.
503 20-Oct-2002 (Release 1.9.4)
505 More warnings about old pygtk versions.
506 Added Dialog class (does ref-counting, like Window).
510 Trying to use ROX-Lib2 with earlier versions of python now gives a sensible
515 Make clicking on ROX-Lib itself work again (Christopher Arndt).
519 Updated findrox.py to use pygtk 1.99.13 -- update your programs!
521 25-Aug-2002 (Release 1.9.3)
523 Switch to use new pygtk versioning system (requires pygtk 1.99.13).
527 Added 'processes' module, based on code in Archive, which makes controlling
532 Bugfix: Changing the keys lost any builtin shortcuts (Gtk behaviour has
537 Trap exceptions when activating menu items and report nicely.
541 Bugfix: Remember to call drop_finish() after a drag-and-drop operation.
543 05-Aug-2002 (Release 1.9.2)
545 Renamed XDSLoader module to 'loading' (like 'saving').
546 Added 'mime' module for installing extra MIME information.
547 Bugfix: XDSLoader didn't handle the drag-drop signal, and so only worked for
548 widgets with their own implementation!
552 Show local variables in report_exception, and allow expressions to be
553 evaluated in the context of any frame.
554 Added StringSaver class.
558 Added applet module for creating ROX panel applets.
562 Bugfix: saving code didn't cope with missing images (reported by Musus Umbra).
566 If 'gtk2' isn't available, see if 'gtk' is actually the 2.0 version.
567 Added save_set_permissions to Saveable interface, allowing the default
568 save_to_file to preserve file permissions.
569 Changes to XDSLoader: xds_load_from_stream(name, type, stream)
570 replaces the old xds_load_data(data).
571 Loading files from remote filers works now.
572 Added much improved exception reporting system.
574 19-Jul-2002 (Release 1.9.1)
576 Added support for translations.
580 License change to the LGPL (allows commercial programs to use this library).
581 Added AbortSave exception.
585 Saveable.save_to_file() should raise an exception when saving fails, rather
586 than returning 0. The return value is now ignored (note that raising an
587 exception will still work with 1.9.0).
588 toplevel_unref() ignores any arguments, so it is easier to use as a signal
591 12-Jul-2002 (Release 1.9.0)
593 First release for Gtk+-2.0.