2 Shared code for ROX applications
4 http://rox.sourceforge.net
8 Added tasks.InputBlocker, which triggers when an input source becomes
9 readable (Thomas Leonard).
13 Bugfix: Use only text nodes when getting the tool tip from the Options.xml
14 file (Stephen Watson).
18 Bugfix: Theme subdirectories are separated by ',' not ';' (reported by
23 Bugfix: When a menu has more than one toggle item, only one is updated
24 correctly (Ken Hayber).
28 Replace g.mainloop() and g.mainquit() with g.main() and g.main_quit() as
29 recommended since pygtk 2.0.0 to avoid warnings with pygtk 2.4.0 (Stephen
34 Added options.ListOption to support multi-valued option widgets, such as
35 lists (Stephen Watson).
37 02-Oct-2004 (Release 1.9.16)
39 Cope better with user cancelling su operation. New interface to replace
40 create_su_proxy (Thomas Leonard).
44 The choices module is now deprecated. You can use choices.migrate() to move
45 settings over to the basedir system (Thomas Leonard). Also added
46 basedir.load_first_config(), which works like the old choices.load().
50 Several incompatible changes to the experimental proxy API to make it simpler
53 - Create_su_proxy now returns the MasterObject directly, not the MasterProxy.
54 - You can call finish on the MasterObject (so the MasterProxy isn't needed).
55 - Slave methods no longer take a 'request' argument. Instead, the return
56 value of the function is returned.
57 - Methods can only return one value. dequeue and dequeue_last have been
58 replaced with a 'result' property.
59 - Methods on MasterObject now return a RequestBlocker, not a Queue. This
60 means you just yield the object itself, not object.blocker.
62 Tasks API is no longer experimental, but proxy API is.
66 Added a Help button to the exception dialog, which opens the new Help/Errors
67 file (Thomas Leonard).
71 Simplified su code and interface.
72 New suchild methods: open, close, read, write, chmod and rename, which work
73 just like their normal Python counterparts (Thomas Leonard).
77 Removed code to turn off the separator in the debug dialog. GTK 2.4 doesn't
78 need it, and generates a warning if you use it (Thomas Leonard).
80 27-Aug-2004 (Release 1.9.15)
82 Added spawnvpe and waitpid methods to suchild.
86 If the unit field for a <numentry> option is blank, don't try to translate it
87 (reported by Guido Schimmels).
91 Added 'su' module for performing operations as root.
95 Allow "" as a valid value in a OptionsBox menu (reported by Guido Schimmels).
99 Added 'proxy' module. This allows one Python process to invoke methods on
100 another asynchronously.
101 Added rox.UserAbort exception, to be raised when users cancel something
106 Fix syntax error I caused when I added a docstring (Stephen Watson).
110 Get update-mime-database command through Zero Install, if possible.
114 mime_handler can now uninstall (Stephen Watson).
118 Translate menu items in options (Guido Schimmels).
122 Added <slider> widget to options.
126 Added 'size-group' attribute to Options.xml elements. This allows grouping
127 elements so that their labels all appear the same width.
131 Bugfix: Colour buttons in the Options boxes didn't work with some themes
134 17-Apr-2004 (Release 1.9.14)
136 Added ToggleItem (based on a patch from Ken Hayber).
140 Better <label> widgets (wrapping and icon). Taken from LookAndFeel.
144 Stop themes from overriding the display of the colour-picker buttons in
145 the options box (Rene Ejury).
149 Warn about old versions of findrox.py.
150 Bugfix: Bug in new menu API prevented submenus from working.
152 16-Mar-2004 (Release 1.9.13)
154 Bugfix: Icon themes didn't work with python versions older than 2.2.2
155 (reported by Thomas Zajic).
159 Bugfix: Use filer module to show ROX-Lib help, rather than using os.system,
160 so that it works with Zero Install (reported by Keith Hopper).
164 Added widget_registry to OptionsBox, to provide an easy way to register
165 new option types. Removed build_button in favour of this method.
167 Bugfix: If an error occurred loading the ROX theme at startup it could not
168 be reported, because icon_theme wants debug, debug wants saving, and
169 saving wants icon_theme (reported by Thomas Zajic).
173 Cope with pygtk2.2 API change (Stephen Watson, reported by Guido Schimmels).
177 Added secretentry and button options to the OptionsBox (Stephen Watson).
181 Cope with option values split into multiple DOM text nodes (Rene Ejury).
185 Allow a list of values to be stored in each menu Action. These are used as
186 the arguments to the callback function.
187 If a file's details were recorded (in document.save_last_stat) when it was
188 loaded, make sure they haven't changed when saving. Saving also updates this
189 variable (requested by Arnaud Calvo).
193 Updated examples in documentation for new findrox (Yuri Bongiorno).
197 New API for menus. Instead of passing tuples for menu items, python classes
198 can be used. The old tuple interface is still supported.
202 Don't stop DnD working in the savebox just because no icon can be found
203 (reported by Martin Lucina).
207 Added French translation (Vincent Lefèvre).
211 Also translate <label> elements in the Options box (reported by Arnaud Calvo).
215 Also translate section names in the Options box (reported by Arnaud Calvo).
217 22-Jan-2004 (Release 1.9.12)
219 Added 'tasks' module to provide a light-weight alternative to threads.
220 Bugfix: On non-zero-install systems, the sense of the version check in findrox
225 Added method to MIMEtype to fetch its icon. Install list window for
226 the MIME handler installation uses it (Stephen Watson).
230 Translate text in Options box.
234 Allow ROXLIB_DISABLE_ZEROINSTALL to override looking for ROX-Lib in Zero
235 Install (useful for ROX-Lib developers). Prefer a locally installed version
236 of ROX-Filer to the Zero Install version; this also allows users to select
237 which Zero Install version they want (eg, stable or developer).
238 Moved MIME handler installation into a separate module (mime_handler) and
239 made a few changes to the XML syntax.
243 Added <menu> OptionMenu widget for Options box (Chris Shaffer).
247 Fixed bug in findrox when not using Zero Install (Lionel Bringuier).
251 Escape and unescape URIs, as required by ROX-Filer 2.1.0 (reported by
253 Note that the xds_load_uris() method is now called with escaped URIs.
254 Try to run the filer through Zero Install, if possible.
258 If we can't get pygtk through Zero Install, try the local copy.
262 Added support in mime.py for an application to set MIME-type run
263 actions and thumbnail programs (Stephen Watson).
267 Simplified implementation of saving.SaveFilter by using the new
268 processes.PipeThroughCommand class. The child_run() method of SaveFilter
269 is no longer supported.
270 In processes.PipeThroughCommand, a None input stream gets /dev/null instead
271 of inheriting its parent's stream. The class has a new run_child_with_streams
272 to make overriding the behaviour easier.
273 findrox.py script now warns if ROX-Lib2 version is too old (unless requesting
274 a version too old to have a version number).
278 Changed 'Dismiss' to 'Close' (Chris Shaffer).
279 Bugfix: Error reporting in mime.py failed to import the _ function (reported
280 by Christopher Haines).
281 New AppInfo.py for parsing AppInfo.xml files (Christopher Arndt), InfoWin
282 converted to use it (Stephen Watson).
284 15-Oct-2003 (Release 1.9.11)
286 Bugfix: Python 2.3's new bool type broke options saving (reported by Lars
291 Added PipeThroughCommand class (copied from Archive, with some minor
296 Allow event to be None for Menu.popup. This allows the menu to be activated
297 from the keyboard, using the 'popup-menu' signal.
301 Added French translation in AppInfo.xml (Vincent Lefèvre).
303 03-Oct-2003 (Release 1.9.10)
305 Added support for icon themes (doesn't do inheritance yet).
309 Added some version information to the dialog you get when you run ROX-Lib
314 New bug() function to quickly bring up a debugging prompt.
318 The glob patterns in mime.py are now sorted longest first. Fix for setting
319 icon in the old way when there was no icon (Stephen Watson).
323 Try to cope better with bad hostname setup (reported by Nathan Howell).
327 Added InfoWin.py to provide standardized information window (Stephen Watson).
331 Fall back to old way of setting default icon for older pygtk's (Stephen
336 Added Italian translation (Yuri Bongiorno).
340 Better way to set the default icon.
342 16-Aug-2003 (Release 1.9.9)
344 Give windows a default icon from .DirIcon (Chris Shaffer).
348 Try to get pygtk through ZeroInstall.
352 Updated findrox to use ZeroInstall, if possible.
356 Work out correct application name even if invoked via a symlink. This stops
357 applications from calling themselves 'text_plain', etc (reported by Joe Hill).
359 19-Jul-2003 (Release 1.9.8)
361 Make default menu positioning function keep the pointer inside the menu.
362 Allow stock icons in menus.
366 Added position_fn argument to rox.Menu.popup.
370 Cope with % escaped URIs.
374 Added italian translation in AppInfo.xml (Yuri Bongiorno)
378 When loading data from another application, pass the suggested leafname to
379 xds_load_from_stream().
383 Code tidying, thanks to pychecker.
387 Added fileutils module, which provides an interactive makedirs() function
389 Changed savebox module to use it.
391 16-May-2003 (Release 1.9.7)
393 New icon (Geoff Youngs).
394 Added 'basedir' module for freedesktop.org Base Directory specification.
398 Added functions to read MIME database (Stephen Watson).
400 27-Jan-2003 (Release 1.9.6)
402 Make the default window class the name of the application directory, not
403 'AppRun' (suggested by Albert Wagner).
404 Bugfix: With pygtk-1.99.14, only the first error message from a process
405 would be detected; this meant that ROX-Lib wouldn't detect when the
406 process quit (reported by joehill).
407 Bugfix: <hbox> and <vbox> layouts didn't work in the options box (Allen
412 If python is too old, raise SystemExit instead of quitting.
413 Ensure that True and False are defined.
417 Work around bug in some versions of pygtk that stopped the options window
420 12-Dec-2002 (Release 1.9.5)
422 Upgrade Options box to new style.
426 Bugfix: If an option had an empty value, an exception was thrown on loading
427 (reported by Stephen Watson).
431 Cope with missing input_add_full.
435 Pygtk 1.99.12 seems to more-or-less work now (according to Alastair Porter), so
436 remove the warning for that so we can support RedHat 8.0.
438 20-Oct-2002 (Release 1.9.4)
440 More warnings about old pygtk versions.
441 Added Dialog class (does ref-counting, like Window).
445 Trying to use ROX-Lib2 with earlier versions of python now gives a sensible
450 Make clicking on ROX-Lib itself work again (Christopher Arndt).
454 Updated findrox.py to use pygtk 1.99.13 -- update your programs!
456 25-Aug-2002 (Release 1.9.3)
458 Switch to use new pygtk versioning system (requires pygtk 1.99.13).
462 Added 'processes' module, based on code in Archive, which makes controlling
467 Bugfix: Changing the keys lost any builtin shortcuts (Gtk behaviour has
472 Trap exceptions when activating menu items and report nicely.
476 Bugfix: Remember to call drop_finish() after a drag-and-drop operation.
478 05-Aug-2002 (Release 1.9.2)
480 Renamed XDSLoader module to 'loading' (like 'saving').
481 Added 'mime' module for installing extra MIME information.
482 Bugfix: XDSLoader didn't handle the drag-drop signal, and so only worked for
483 widgets with their own implementation!
487 Show local variables in report_exception, and allow expressions to be
488 evaluated in the context of any frame.
489 Added StringSaver class.
493 Added applet module for creating ROX panel applets.
497 Bugfix: saving code didn't cope with missing images (reported by Musus Umbra).
501 If 'gtk2' isn't available, see if 'gtk' is actually the 2.0 version.
502 Added save_set_permissions to Saveable interface, allowing the default
503 save_to_file to preserve file permissions.
504 Changes to XDSLoader: xds_load_from_stream(name, type, stream)
505 replaces the old xds_load_data(data).
506 Loading files from remote filers works now.
507 Added much improved exception reporting system.
509 19-Jul-2002 (Release 1.9.1)
511 Added support for translations.
515 License change to the LGPL (allows commercial programs to use this library).
516 Added AbortSave exception.
520 Saveable.save_to_file() should raise an exception when saving fails, rather
521 than returning 0. The return value is now ignored (note that raising an
522 exception will still work with 1.9.0).
523 toplevel_unref() ignores any arguments, so it is easier to use as a signal
526 12-Jul-2002 (Release 1.9.0)
528 First release for Gtk+-2.0.