Help/Changes

   1                         ROX-Lib2
   2                         Shared code for ROX applications
   3                         by Thomas Leonard
   4                         http://rox.sourceforge.net
   5
   6 27-Sep-2004
   7 ~~~~~~~~~~~
   8 The choices module is now deprecated. You can use choices.migrate() to move
   9 settings over to the basedir system (Thomas Leonard). Also added
  10 basedir.load_first_config(), which works like the old choices.load().
  11
  12 26-Sep-2004
  13 ~~~~~~~~~~~
  14 Several incompatible changes to the experimental proxy API to make it simpler
  15 (Thomas Leonard):
  16
  17 - Create_su_proxy now returns the MasterObject directly, not the MasterProxy.
  18 - You can call finish on the MasterObject (so the MasterProxy isn't needed).
  19 - Slave methods no longer take a 'request' argument. Instead, the return
  20   value of the function is returned.
  21 - Methods can only return one value. dequeue and dequeue_last have been
  22   replaced with a 'result' property.
  23 - Methods on MasterObject now return a RequestBlocker, not a Queue. This
  24   means you just yield the object itself, not object.blocker.
  25
  26 Tasks API is no longer experimental, but proxy API is.
  27
  28 22-Sep-2004
  29 ~~~~~~~~~~~
  30 Added a Help button to the exception dialog, which opens the new Help/Errors
  31 file (Thomas Leonard).
  32
  33 06-Sep-2004
  34 ~~~~~~~~~~~
  35 Simplified su code and interface.
  36 New suchild methods: open, close, read, write, chmod and rename, which work
  37 just like their normal Python counterparts (Thomas Leonard).
  38
  39 29-Aug-2004
  40 ~~~~~~~~~~~
  41 Removed code to turn off the separator in the debug dialog. GTK 2.4 doesn't
  42 need it, and generates a warning if you use it (Thomas Leonard).
  43
  44 27-Aug-2004 (Release 1.9.15)
  45 ~~~~~~~~~~~
  46 Added spawnvpe and waitpid methods to suchild.
  47
  48 08-Aug-2004
  49 ~~~~~~~~~~~
  50 If the unit field for a <numentry> option is blank, don't try to translate it
  51 (reported by Guido Schimmels).
  52
  53 30-Jun-2004
  54 ~~~~~~~~~~~
  55 Added 'su' module for performing operations as root.
  56
  57 11-Jun-2004
  58 ~~~~~~~~~~~
  59 Allow "" as a valid value in a OptionsBox menu (reported by Guido Schimmels).
  60
  61 10-Jun-2004
  62 ~~~~~~~~~~~
  63 Added 'proxy' module. This allows one Python process to invoke methods on
  64 another asynchronously.
  65 Added rox.UserAbort exception, to be raised when users cancel something
  66 manually.
  67
  68 07-Jun-2004
  69 ~~~~~~~~~~~
  70 Fix syntax error I caused when I added a docstring (Stephen Watson).
  71
  72 30-May-2004
  73 ~~~~~~~~~~~
  74 Get update-mime-database command through Zero Install, if possible.
  75
  76 24-May-2004
  77 ~~~~~~~~~~~
  78 mime_handler can now uninstall (Stephen Watson).
  79
  80 04-May-2004
  81 ~~~~~~~~~~~
  82 Translate menu items in options (Guido Schimmels).
  83
  84 26-Apr-2004
  85 ~~~~~~~~~~~
  86 Added <slider> widget to options.
  87
  88 25-Apr-2004
  89 ~~~~~~~~~~~
  90 Added 'size-group' attribute to Options.xml elements. This allows grouping
  91 elements so that their labels all appear the same width.
  92
  93 20-Apr-2004
  94 ~~~~~~~~~~~
  95 Bugfix: Colour buttons in the Options boxes didn't work with some themes
  96         (Jonatan Liljedahl).
  97
  98 17-Apr-2004 (Release 1.9.14)
  99 ~~~~~~~~~~~
 100 Added ToggleItem (based on a patch from Ken Hayber).
 101
 102 15-Apr-2004
 103 ~~~~~~~~~~~
 104 Better <label> widgets (wrapping and icon). Taken from LookAndFeel.
 105
 106 20-Mar-2004
 107 ~~~~~~~~~~~
 108 Stop themes from overriding the display of the colour-picker buttons in
 109 the options box (Rene Ejury).
 110
 111 17-Mar-2004
 112 ~~~~~~~~~~~
 113 Warn about old versions of findrox.py.
 114 Bugfix: Bug in new menu API prevented submenus from working.
 115
 116 16-Mar-2004 (Release 1.9.13)
 117 ~~~~~~~~~~~
 118 Bugfix: Icon themes didn't work with python versions older than 2.2.2
 119         (reported by Thomas Zajic).
 120
 121 15-Mar-2004
 122 ~~~~~~~~~~~
 123 Bugfix: Use filer module to show ROX-Lib help, rather than using os.system,
 124         so that it works with Zero Install (reported by Keith Hopper).
 125
 126 14-Mar-2004
 127 ~~~~~~~~~~~
 128 Added widget_registry to OptionsBox, to provide an easy way to register
 129 new option types. Removed build_button in favour of this method.
 130
 131 Bugfix: If an error occurred loading the ROX theme at startup it could not
 132         be reported, because icon_theme wants debug, debug wants saving, and
 133         saving wants icon_theme (reported by Thomas Zajic).
 134
 135 12-Mar-2004
 136 ~~~~~~~~~~~
 137 Cope with pygtk2.2 API change (Stephen Watson, reported by Guido Schimmels).
 138
 139 06-Mar-2004
 140 ~~~~~~~~~~~
 141 Added secretentry and button options to the OptionsBox (Stephen Watson).
 142
 143 26-Feb-2004
 144 ~~~~~~~~~~~
 145 Cope with option values split into multiple DOM text nodes (Rene Ejury).
 146
 147 22-Feb-2004
 148 ~~~~~~~~~~~
 149 Allow a list of values to be stored in each menu Action. These are used as
 150 the arguments to the callback function.
 151 If a file's details were recorded (in document.save_last_stat) when it was
 152 loaded, make sure they haven't changed when saving. Saving also updates this
 153 variable (requested by Arnaud Calvo).
 154
 155 20-Feb-2004
 156 ~~~~~~~~~~~
 157 Updated examples in documentation for new findrox (Yuri Bongiorno).
 158
 159 10-Feb-2004
 160 ~~~~~~~~~~~
 161 New API for menus. Instead of passing tuples for menu items, python classes
 162 can be used. The old tuple interface is still supported.
 163
 164 07-Feb-2004
 165 ~~~~~~~~~~~
 166 Don't stop DnD working in the savebox just because no icon can be found
 167 (reported by Martin Lucina).
 168
 169 02-Feb-2004
 170 ~~~~~~~~~~~
 171 Added French translation (Vincent Lefèvre).
 172
 173 30-Jan-2004
 174 ~~~~~~~~~~~
 175 Also translate <label> elements in the Options box (reported by Arnaud Calvo).
 176
 177 28-Jan-2004
 178 ~~~~~~~~~~~
 179 Also translate section names in the Options box (reported by Arnaud Calvo).
 180
 181 22-Jan-2004 (Release 1.9.12)
 182 ~~~~~~~~~~~
 183 Added 'tasks' module to provide a light-weight alternative to threads.
 184 Bugfix: On non-zero-install systems, the sense of the version check in findrox
 185         was wrong.
 186
 187 02-Jan-2004
 188 ~~~~~~~~~~~
 189 Added method to MIMEtype to fetch its icon. Install list window for
 190 the MIME handler installation uses it (Stephen Watson).
 191
 192 13-Dec-2003
 193 ~~~~~~~~~~~
 194 Translate text in Options box.
 195
 196 28-Dec-2003
 197 ~~~~~~~~~~~
 198 Allow ROXLIB_DISABLE_ZEROINSTALL to override looking for ROX-Lib in Zero
 199 Install (useful for ROX-Lib developers). Prefer a locally installed version
 200 of ROX-Filer to the Zero Install version; this also allows users to select
 201 which Zero Install version they want (eg, stable or developer).
 202 Moved MIME handler installation into a separate module (mime_handler) and
 203 made a few changes to the XML syntax.
 204
 205 24-Dec-2003
 206 ~~~~~~~~~~~
 207 Added <menu> OptionMenu widget for Options box (Chris Shaffer).
 208
 209 27-Nov-2003
 210 ~~~~~~~~~~~
 211 Fixed bug in findrox when not using Zero Install (Lionel Bringuier).
 212
 213 26-Nov-2003
 214 ~~~~~~~~~~~
 215 Escape and unescape URIs, as required by ROX-Filer 2.1.0 (reported by
 216 Peter Geer).
 217 Note that the xds_load_uris() method is now called with escaped URIs.
 218 Try to run the filer through Zero Install, if possible.
 219
 220 11-Nov-2003
 221 ~~~~~~~~~~~
 222 If we can't get pygtk through Zero Install, try the local copy.
 223
 224 05-Nov-2003
 225 ~~~~~~~~~~~
 226 Added support in mime.py for an application to set MIME-type run
 227 actions and thumbnail programs (Stephen Watson).
 228
 229 31-Oct-2003
 230 ~~~~~~~~~~~
 231 Simplified implementation of saving.SaveFilter by using the new
 232 processes.PipeThroughCommand class. The child_run() method of SaveFilter
 233 is no longer supported.
 234 In processes.PipeThroughCommand, a None input stream gets /dev/null instead
 235 of inheriting its parent's stream. The class has a new run_child_with_streams
 236 to make overriding the behaviour easier.
 237 findrox.py script now warns if ROX-Lib2 version is too old (unless requesting
 238 a version too old to have a version number).
 239
 240 29-Oct-2003
 241 ~~~~~~~~~~~
 242 Changed 'Dismiss' to 'Close' (Chris Shaffer).
 243 Bugfix: Error reporting in mime.py failed to import the _ function (reported
 244         by Christopher Haines).
 245 New AppInfo.py for parsing AppInfo.xml files (Christopher Arndt), InfoWin
 246 converted to use it (Stephen Watson).
 247
 248 15-Oct-2003 (Release 1.9.11)
 249 ~~~~~~~~~~~
 250 Bugfix: Python 2.3's new bool type broke options saving (reported by Lars
 251         Hansson).
 252
 253 13-Oct-2003
 254 ~~~~~~~~~~~
 255 Added PipeThroughCommand class (copied from Archive, with some minor
 256 changes).
 257
 258 09-Oct-2003
 259 ~~~~~~~~~~~
 260 Allow event to be None for Menu.popup. This allows the menu to be activated
 261 from the keyboard, using the 'popup-menu' signal.
 262
 263 08-Oct-2003
 264 ~~~~~~~~~~~
 265 Added French translation in AppInfo.xml (Vincent Lefèvre).
 266
 267 03-Oct-2003 (Release 1.9.10)
 268 ~~~~~~~~~~~
 269 Added support for icon themes (doesn't do inheritance yet).
 270
 271 28-Sep-2003
 272 ~~~~~~~~~~~
 273 Added some version information to the dialog you get when you run ROX-Lib
 274 directly.
 275
 276 22-Sep-2003
 277 ~~~~~~~~~~~
 278 New bug() function to quickly bring up a debugging prompt.
 279
 280 15-Sep-2003
 281 ~~~~~~~~~~~
 282 The glob patterns in mime.py are now sorted longest first. Fix for setting
 283 icon in the old way when there was no icon (Stephen Watson).
 284
 285 25-Aug-2003
 286 ~~~~~~~~~~~
 287 Try to cope better with bad hostname setup (reported by Nathan Howell).
 288
 289 24-Aug-2003
 290 ~~~~~~~~~~~
 291 Added InfoWin.py to provide standardized information window (Stephen Watson).
 292
 293 24-Aug-2003
 294 ~~~~~~~~~~~
 295 Fall back to old way of setting default icon for older pygtk's (Stephen
 296 Watson).
 297
 298 20-Aug-2003
 299 ~~~~~~~~~~~
 300 Added Italian translation (Yuri Bongiorno).
 301
 302 18-Aug-2003
 303 ~~~~~~~~~~~
 304 Better way to set the default icon.
 305
 306 16-Aug-2003 (Release 1.9.9)
 307 ~~~~~~~~~~~
 308 Give windows a default icon from .DirIcon (Chris Shaffer).
 309
 310 01-Aug-2003
 311 ~~~~~~~~~~~
 312 Try to get pygtk through ZeroInstall.
 313
 314 25-Jul-2003
 315 ~~~~~~~~~~~
 316 Updated findrox to use ZeroInstall, if possible.
 317
 318 22-Jul-2003
 319 ~~~~~~~~~~~
 320 Work out correct application name even if invoked via a symlink. This stops
 321 applications from calling themselves 'text_plain', etc (reported by Joe Hill).
 322
 323 19-Jul-2003 (Release 1.9.8)
 324 ~~~~~~~~~~~
 325 Make default menu positioning function keep the pointer inside the menu.
 326 Allow stock icons in menus.
 327
 328 18-Jul-2003
 329 ~~~~~~~~~~~
 330 Added position_fn argument to rox.Menu.popup.
 331
 332 17-Jul-2003
 333 ~~~~~~~~~~~
 334 Cope with % escaped URIs.
 335
 336 04-Jul-2003
 337 ~~~~~~~~~~~
 338 Added italian translation in AppInfo.xml (Yuri Bongiorno)
 339
 340 26-Jun-2003
 341 ~~~~~~~~~~~
 342 When loading data from another application, pass the suggested leafname to
 343 xds_load_from_stream().
 344
 345 04-Jun-2003
 346 ~~~~~~~~~~~
 347 Code tidying, thanks to pychecker.
 348
 349 26-May-2003
 350 ~~~~~~~~~~~
 351 Added fileutils module, which provides an interactive makedirs() function
 352 (Richard Boulton).
 353 Changed savebox module to use it.
 354
 355 16-May-2003 (Release 1.9.7)
 356 ~~~~~~~~~~~
 357 New icon (Geoff Youngs).
 358 Added 'basedir' module for freedesktop.org Base Directory specification.
 359
 360 06-May-2003
 361 ~~~~~~~~~~~
 362 Added functions to read MIME database (Stephen Watson).
 363
 364 27-Jan-2003 (Release 1.9.6)
 365 ~~~~~~~~~~~
 366 Make the default window class the name of the application directory, not
 367 'AppRun' (suggested by Albert Wagner).
 368 Bugfix: With pygtk-1.99.14, only the first error message from a process
 369         would be detected; this meant that ROX-Lib wouldn't detect when the
 370         process quit (reported by joehill).
 371 Bugfix: <hbox> and <vbox> layouts didn't work in the options box (Allen
 372         Leonard).
 373
 374 22-Jan-2003
 375 ~~~~~~~~~~~
 376 If python is too old, raise SystemExit instead of quitting.
 377 Ensure that True and False are defined.
 378
 379 16-Dec-2002
 380 ~~~~~~~~~~~
 381 Work around bug in some versions of pygtk that stopped the options window
 382 from working.
 383
 384 12-Dec-2002 (Release 1.9.5)
 385 ~~~~~~~~~~~
 386 Upgrade Options box to new style.
 387
 388 11-Dec-2002
 389 ~~~~~~~~~~~
 390 Bugfix: If an option had an empty value, an exception was thrown on loading
 391         (reported by Stephen Watson).
 392
 393 05-Dec-2002
 394 ~~~~~~~~~~~
 395 Cope with missing input_add_full.
 396
 397 25-Oct-2002
 398 ~~~~~~~~~~~
 399 Pygtk 1.99.12 seems to more-or-less work now (according to Alastair Porter), so
 400 remove the warning for that so we can support RedHat 8.0.
 401
 402 20-Oct-2002 (Release 1.9.4)
 403 ~~~~~~~~~~~
 404 More warnings about old pygtk versions.
 405 Added Dialog class (does ref-counting, like Window).
 406
 407 15-Oct-2002
 408 ~~~~~~~~~~~
 409 Trying to use ROX-Lib2 with earlier versions of python now gives a sensible
 410 error message.
 411
 412 10-Oct-2002
 413 ~~~~~~~~~~~
 414 Make clicking on ROX-Lib itself work again (Christopher Arndt).
 415
 416 25-Aug-2002
 417 ~~~~~~~~~~~
 418 Updated findrox.py to use pygtk 1.99.13 -- update your programs!
 419
 420 25-Aug-2002 (Release 1.9.3)
 421 ~~~~~~~~~~~
 422 Switch to use new pygtk versioning system (requires pygtk 1.99.13).
 423
 424 19-Aug-2002
 425 ~~~~~~~~~~~
 426 Added 'processes' module, based on code in Archive, which makes controlling
 427 subprocesses easier.
 428
 429 14-Aug-2002
 430 ~~~~~~~~~~~
 431 Bugfix: Changing the keys lost any builtin shortcuts (Gtk behaviour has
 432         changed since 1.2).
 433
 434 08-Aug-2002
 435 ~~~~~~~~~~~
 436 Trap exceptions when activating menu items and report nicely.
 437
 438 07-Aug-2002
 439 ~~~~~~~~~~~
 440 Bugfix: Remember to call drop_finish() after a drag-and-drop operation.
 441
 442 05-Aug-2002 (Release 1.9.2)
 443 ~~~~~~~~~~~
 444 Renamed XDSLoader module to 'loading' (like 'saving').
 445 Added 'mime' module for installing extra MIME information.
 446 Bugfix: XDSLoader didn't handle the drag-drop signal, and so only worked for
 447         widgets with their own implementation!
 448
 449 31-Jul-2002
 450 ~~~~~~~~~~~
 451 Show local variables in report_exception, and allow expressions to be
 452 evaluated in the context of any frame.
 453 Added StringSaver class.
 454
 455 25-Jul-2002
 456 ~~~~~~~~~~~
 457 Added applet module for creating ROX panel applets.
 458
 459 24-Jul-2002
 460 ~~~~~~~~~~~
 461 Bugfix: saving code didn't cope with missing images (reported by Musus Umbra).
 462
 463 21-Jul-2002
 464 ~~~~~~~~~~~
 465 If 'gtk2' isn't available, see if 'gtk' is actually the 2.0 version.
 466 Added save_set_permissions to Saveable interface, allowing the default
 467 save_to_file to preserve file permissions.
 468 Changes to XDSLoader: xds_load_from_stream(name, type, stream)
 469 replaces the old xds_load_data(data).
 470 Loading files from remote filers works now.
 471 Added much improved exception reporting system.
 472
 473 19-Jul-2002 (Release 1.9.1)
 474 ~~~~~~~~~~~
 475 Added support for translations.
 476
 477 18-Jul-2002
 478 ~~~~~~~~~~~
 479 License change to the LGPL (allows commercial programs to use this library).
 480 Added AbortSave exception.
 481
 482 14-Jul-2002
 483 ~~~~~~~~~~~
 484 Saveable.save_to_file() should raise an exception when saving fails, rather
 485 than returning 0. The return value is now ignored (note that raising an
 486 exception will still work with 1.9.0).
 487 toplevel_unref() ignores any arguments, so it is easier to use as a signal
 488 handler.
 489
 490 12-Jul-2002 (Release 1.9.0)
 491 ~~~~~~~~~~~
 492 First release for Gtk+-2.0.