src/ui/gui/ChangeLog

   1 2007-07-16  John Darrington <john@darrington.wattle.id.au>
   2
   3         * data-editor.c: File Open dialog remembers directory.  Thanks to
   4         Ben Pfaff for this suggestion.
   5
   6 2007-07-15  John Darrington <john@darrington.wattle.id.au>
   7
   8         * compute-dialog.c: Only generate NUMERIC/STRING command if the
   9         type-and-label dialog was used.
  10
  11 2007-07-12  John Darrington <john@darrington.wattle.id.au>
  12
  13         * psppire-data-store.c: Added call to g_sheet_model_range_changed to
  14         ensure that datasheet displays the current store.
  15
  16         * psppire-data-store.h: Formatting tidy up.
  17
  18 2007-07-11  John Darrington <john@darrington.wattle.id.au>
  19
  20         * compute-dialog.c : Set type-and-label dialog to sensible state,               and made syntax generation depend upon existence of target variable.
  21
  22 2007-07-08  John Darrington <john@darrington.wattle.id.au>
  23
  24         * data-editor.c data-editor.glade data-editor.h: Implemented
  25         the "Insert Case" button/dialog.
  26
  27 2007-07-08  John Darrington <john@darrington.wattle.id.au>
  28
  29         * goto-case-dialog.c goto-case-dialog.h (new files)
  30         * automake.mk data-editor.c data-editor.glade data-editor.h
  31         psppire-case-file.c psppire-case-file.h psppire-data-store.c
  32         psppire-data-store.h psppire.glade :  Implemented the goto-case dialog
  33
  34
  35 2007-07-07  John Darrington <john@darrington.wattle.id.au>
  36
  37         * psppire-data-store.c psppire-data-store.h: Made cases number from
  38         1 instead of 0.
  39
  40         * psppire-data-store.c: Added a tooltip like feature to display
  41         the label of variables.
  42
  43 2007-07-03  John Darrington <john@darrington.wattle.id.au>
  44
  45         * data-editor.c data-sheet.c: Turned off autoscrolling, and
  46         manually move to cell on column click instead.
  47
  48 2007-06-29  John Darrington <john@darrington.wattle.id.au>
  49
  50         * data-editor.c data-editor.glade psppire-data-store.c
  51         psppire-data-store.h: Enabled cell reference entry and datum
  52         entry widgets.
  53
  54 2007-06-29  John Darrington <john@darrington.wattle.id.au>
  55
  56         * data-editor.c data-sheet.c: Moved update_cell_ref_entry from
  57         data-sheet.c to data-editor.c and made it work again.
  58
  59 2007-06-06  Ben Pfaff  <blp@gnu.org>
  60
  61         Adapt case sources, sinks, and clients of procedure code to the
  62         new infrastructure.
  63
  64         * automake.mk: Removed files.
  65
  66         * flexifile-factory.c: Removed, dead code.
  67         * flexifile-factory.h: Ditto.
  68
  69         * helper.c: Adapt to new procedure and datasheet code.
  70         * missing-val-dialog.c: Ditto.
  71         * psppire-case-file.c: Ditto.
  72         * psppire-data-store.c: Ditto.
  73         * psppire.c: Ditto.
  74
  75 2007-06-03  Ben Pfaff  <blp@gnu.org>
  76
  77         * psppire-var-store.c (psppire_var_store_item_editable): Use
  78         var_is_alpha.
  79
  80 2007-05-07 John Darrington <john@darrington.wattle.id.au>
  81
  82         * psppire-dialog.c psppire-dialog.h: Added "orientation" property,
  83         to allow dialogs to be either vertical or horizontal.
  84
  85         * comments-dialog.c comments-dialog.h: New files, invoking
  86         ADD DOCUMENT cmd.
  87
  88 2007-04-30 John Darrington <john@darrington.wattle.id.au>
  89
  90         * var-display.c var-display.h variable-info-dialog.c
  91         variable-info-dialog.h : New files.
  92
  93         * data-editor.c :
  94
  95         * psppire-buttonbox.c psppire-buttonbox.h : Added the "buttons"
  96         property, and optional  GOTO and CONTINUE buttons.
  97
  98         * psppire-dialog.h: Added response codes for the new buttons.
  99
 100         * psppire-var-store.c : Moved some code to var-display.[ch]
 101
 102 2007-04-25 John Darrington <john@darrington.wattle.id.au>
 103
 104         * icons/scalable/splash.c icons/splash.png : More eye candy.
 105
 106         * main.c psppire.h : new files.
 107
 108         * psppire.c : Seperated the command line parsing and other
 109         environment startup from the core psppire code.
 110
 111 2007-04-25 John Darrington <john@darrington.wattle.id.au>
 112
 113         * icons/scalable icons/16x16: new directories.
 114         * psppire.c : Add new icons to factory.
 115
 116         * dict-display.c: Refactor code get model from modelfilter.
 117         Added cellrenderer to display icon indicating variables' types.
 118         Displayed the label of variables, if there is one.
 119
 120
 121 2007-04-15  Ben Pfaff  <blp@gnu.org>
 122
 123         * compute-dialog.c (function_list_populate): Use new accessor
 124         functions exported by language/expressions/public.h.
 125
 126 2007-04-15  Ben Pfaff  <blp@gnu.org>
 127
 128         * compute-dialog.c: Make #include for parse.inc work with VPATH
 129         builds.
 130
 131 2007-04-13   John Darrington <john@darrington.wattle.id.au>
 132
 133         * var-type-dialog.c: Added a FMT_DATETIME20 template.
 134
 135 2007-04-04   John Darrington <john@darrington.wattle.id.au>
 136
 137         * compute-dialog.c compute-dialog.h: New files
 138
 139         * data-editor.c data-editor.h data-editor.glade : Added Transform
 140         menu, and support for Compute dialog
 141
 142         * glade-register.c psppire-buttonbox.c psppire-buttonbox.h
 143           psppire-vbottonbox.c psppire-vbuttonbox.h psppire-hbuttonbox.c
 144           psppire-vbuttonbox.h : Made buttonbox an abstract base class
 145          and separated it into vbuttonbox and hbuttonbox.
 146
 147         * psppire-selector.c : Allowed GtkTextView to be the destination
 148         widget.
 149
 150         * psppire-keypad.c: Added an "erase" signal.  Fixed other
 151         minor problems.
 152
 153 2007-04-03  Ben Pfaff  <blp@gnu.org>
 154             John McCabe-Dansted <gmatht@gmail.com>
 155
 156         * psppire-selector.c (psppire_selector_set_subjects): Add an
 157         assert that may or may not trap some Windows-related bugs.
 158
 159 2007-04-03   John Darrington <john@darrington.wattle.id.au>
 160
 161         * data-editor.c data-editor.glade helper.h syntax-editor.c
 162         syntax-editor.h : Implemented the File->Recently_Used_ menus.
 163
 164
 165 2007-03-31   John Darrington <john@darrington.wattle.id.au>
 166
 167         * data-editor.c data-editor.glade data-editor.h dialog-common.c
 168         psppire-buttonbox.c psppire-dialog.c psppire-dialog.h
 169         psppire-selector.c psppire-selector.h psppire.c psppire.glade
 170         sort-cases-dialog.c sort-cases-dialog.h split-file-dialog.c
 171         transpose-dialog.c weight-cases-dialog.c : Fixed the Refresh
 172         button on all the dialogs.
 173
 174 2007-03-31   John Darrington <john@darrington.wattle.id.au>
 175
 176         * data-editor.c: Added hooks for the split-file-dialog
 177
 178         * psppire.glade: Added the split file dialog box.
 179
 180         * split-file-dialog.c split-file-dialog.h: New files.
 181
 182         * dialog-common.c dialog-common.h: New files containing functions
 183         which seem to be used a lot in dialog box implementations.
 184
 185         * psppire-keypad.c psppire-keypad.h: New files.  Implements keypad
 186         thingumy widget.
 187
 188         * psppire-selector.c: Made the orientation of the arrow a property
 189         of the widget, so that it can be selected from glade.
 190
 191 2007-03-18  Ben Pfaff  <blp@gnu.org>
 192
 193         * syntax-editor-source.c (close): Rename do_close to avoid naming
 194         conflict with POSIX function of same name.
 195
 196 Tue Mar 13 17:20:05 CET 2007 John Darrington <john@darrington.wattle.id.au>
 197         * psppire.c:  Changed gtk_init to gtk_parse_args, followed by a delayed         call to gdk_init, so that psppire --version will succeed, even if it
 198         cannot connect to a display .
 199
 200 Wed Mar  7 19:05:12 CET 2007 John Darrington <john@darrington.wattle.id.au>
 201
 202         * var-sheet.c: Replaced call to nl_langinfo with locale_charset
 203         from gnulib.
 204
 205 Thu Feb 22 12:27:41 CET 2007 John Darrington <john@darrington.wattle.id.au>
 206
 207         * data-editor.c : called new gen_quoted_string function to properly
 208           quote filenames in generated syntax.
 209
 210         * window-manager.c : Converted name from filename encoding to UTF8
 211           before displaying in title bar.
 212
 213 Tue Jan 30 20:13:46 WST 2007 John Darrington <john@darrington.wattle.id.au>
 214
 215         * psppire-dict.c: Call all the callbacks when a new dictionary becomes current.
 216
 217         * data-editor.c: Clear existing file name on FILE NEW.
 218
 219 Sat Jan 27 09:48:21 WST 2007 John Darrington <john@darrington.wattle.id.au>
 220
 221         * var-type-dialog.c: Fixed bugs closing window, apparent when compiled
 222         against gtk.2.10
 223
 224 Fri Jan 26 15:51:34 WST 2007 John Darrington <john@darrington.wattle.id.au>
 225
 226         * psppire-var-select.c psppire-var-select.h : Deleted.
 227
 228         * psppire-selector.c psppire-selector.h : New files.
 229
 230         * transpose-dialog.c transpose-dialog.h : New files.
 231
 232         * psppire-dict.c psppire-dict.h : Added missing GtkTreeModel
 233         interface functions.
 234
 235         * weight-cases-dialog.c weight-cases-dialog.h : Re-implemented,
 236         using new PsppireSelector widget.
 237
 238         * dict-display.c dict-display.h : New files.
 239
 240         * psppire-object.c psppire-object.h : Deleted.  Seemed like a good idea at the time.
 241
 242 Tue Jan 23 21:10:01 WST 2007 John Darrington <john@darrington.wattle.id.au>
 243
 244         * helper.c helper.h: New function execute_syntax.
 245
 246         * syntax-editor.c syntax-editor.glade: Disabled data open/save menu
 247         items.
 248
 249         * data-editor.c data-editor.glade data-editor.h: Enabled data
 250         open/save/save_as  menu-items.
 251
 252         * window-manager.h window-manager.c (default_window_name) : New
 253         function.
 254
 255 Sat Jan 13 07:47:26 WST 2007 John Darrington <john@darrington.wattle.id.au>
 256
 257         * psppire-case-file.c psppire-data-store.c psppire-dialog.c
 258         psppire-dict.c psppire-var-select.c : Replaced identifier 'signal'
 259         with 'signals' to avoid conflict with sysv based systems which use
 260         this identifer for something else.
 261         Thanks to Daniel E WILLIAMS for reporting this problem.
 262
 263 Wed Jan 10 07:20:39 WST 2007 John Darrington <john@darrington.wattle.id.au>
 264
 265         * psppire-case-file.c : Make sure there is always a valid flexifile
 266
 267         * psppire-data-store.c : assertions.
 268
 269         * psppire.c: Ignore replace source callbacks if the new source is
 270           not of storiage_source_class
 271
 272         * syntax-editor.c: Close/Abort source after parsing is complete.
 273
 274 Sun Jan  7 08:38:29 WST 2007 John Darrington <john@darrington.wattle.id.au>
 275
 276         * psppire-dict.c: Add FILTER_CHANGED and SPLIT_CHANGED signals
 277         corresponding to the callbacks in src/data/dictionary.c
 278
 279         * data-editor.c : Connect functions to the FILTER_CHANGED and
 280         SPLIT_CHANGED signals to update the status bar accordingly.
 281
 282 Mon Jan  1 10:37:07 WST 2007 John Darrington <john@darrington.wattle.id.au>
 283
 284         * psppire-case-file.c psppire-case-file.h: Changed the backend
 285         semantics. An object is now created without any backend.  A new function        ( psppire_case_file_replace_flexifile ) sets the backend to use.
 286
 287         * psppire-data-store.c : Updated callers accordingly.
 288
 289         * psppire-dict.c psppire-dict.h : New function
 290         (psppire_dict_replace_dictionary) .
 291
 292         * psppire.c : Updated to use new dataset replace_{source, dictionary}
 293         callbacks.
 294
 295         * syntax-editor.c : parses in state CMD_STATE_DATA unless there are
 296         no variables in the dictionary.
 297
 298 Mon Dec 25 12:38:24 WST 2006 John Darrington <john@darrington.wattle.id.au>
 299
 300         * data-editor.c data-editor.glade: Enabled deleting of variables from
 301         the variable sheet.
 302
 303 Mon Dec 25 11:28:29 WST 2006 John Darrington <john@darrington.wattle.id.au>
 304
 305         * psppire-dict.c psppire-dict.h: Removed explicit signal emit calls.
 306         These are not required, now that src/data/dictionary.c has callbacks
 307
 308 Mon Dec 25 08:49:57 WST 2006 John Darrington <john@darrington.wattle.id.au>
 309
 310         * var-sheet.c val-labs-dialog.c val-labs-dialog.h: Fixed bug in value
 311         labels dialog box.
 312
 313 Sun Dec 17 08:26:10 WST 2006 John Darrington <john@darrington.wattle.id.au>
 314
 315         * syntax-editor-source.c syntax-editor-source.h syntax-editor.h:
 316         New files.
 317
 318         * message-dialog.c :  Now reports the filename and line number in
 319         error messages.
 320
 321         * psppire.c psppire.glade syntax-editor.c: Added the ability to run
 322         syntax from the syntax editor.
 323
 324
 325 Sat Dec 16 14:13:07 2006  Ben Pfaff  <blp@gnu.org>
 326
 327         * psppire-data-store.c (geometry_get_justification): Don't assume
 328         that ALIGN_* and GTK_JUSTIFY_* values coincide.
 329
 330 Sat Dec 16 14:10:43 2006  Ben Pfaff  <blp@gnu.org>
 331
 332         * psppire-var-store.c (text_for_column): Adjust to account for new
 333         values of the MEASURE_* enums.
 334
 335         * var-sheet.c (change_measure): Ditto.
 336
 337 Sat Dec 16 12:24:35 WST 2006 John Darrington <john@darrington.wattle.id.au>
 338
 339         * psppire-variable.c psppire-variable.h: Deleted.
 340
 341         * psppire-dict.c psppire-dict.h: Removed the caching of the variable
 342             data, which is now unecessary because src/data/vardict.h maintains
 343             an association between variables and their dictionary.
 344
 345         * data-sheet.c menu-actions.c missing-val-dialog.c
 346           missing-val-dialog.h psppire-data-store.c
 347           psppire-var-store.c psppire-var-store.h
 348           sort-cases-dialog.c val-labs-dialog.c val-labs-dialog.h
 349           var-sheet.c var-type-dialog.c var-type-dialog.h: Dealt with the
 350             consequences of deleting psppire-variable.[ch].
 351
 352
 353 Sat Dec  9 20:03:04 2006  Ben Pfaff  <blp@gnu.org>
 354
 355         * var-type-dialog.c (var_type_dialog_create): Use
 356         fmt_dollar_template from data/format.c.
 357         (dollar_format_template) Removed.
 358
 359 Sat Dec  9 07:19:53 WST 2006 John Darrington <john@darrington.wattle.id.au>
 360
 361         * syntax-editor.c : New file.
 362
 363 Tue Oct 31 19:25:31 2006  Ben Pfaff  <blp@gnu.org>
 364
 365         * var-type-dialog.c: Add missing "#include <config.h>".
 366
 367         * psppire.c: Ditto.
 368
 369 Mon Jul 17 18:21:29 WST 2006 John Darrington <john@darrington.wattle.id.au>
 370
 371     * automake.mk menu-actions.c psppire-case-file.c psppire-case-file.h
 372     psppire-data-store.c psppire-dict.c psppire-dict.h psppire-variable.c
 373     psppire.c psppire.glade: Adjusted code to use the new flexifile object.
 374
 375 Sat Jul 15 11:27:15 WST 2006 John Darrington <john@darrington.wattle.id.au>
 376
 377    * psppire.c psppire.glade automake.mk icons/* : Added toolbar icons where
 378         there's no suitable gtk stock icon.
 379
 380 Tue Jul  4 09:08:38 WST 2006 John Darrington <john@darrington.wattle.id.au>
 381
 382    * psppire.c: Fixed --help and --version options.
 383
 384 Sat Jun 24 16:56:22 WST 2006 John Darrington <john@darrington.wattle.id.au>
 385
 386    * menu-actions.c: Added goto case and sort cases dialogs.
 387
 388    * psppire-case-file.c psppire-case-file.h: Added sort function.
 389
 390    * psppire-data-store.c psppire-variable.c psppire-variable.h:
 391      Renamed  psppire_variable_get_index to psppire_variable_get_fv and
 392      dealt with the consequences.  Added a psppire_variable_get_index
 393      function which actually does what the name suggests.
 394
 395    * psppire-dict.c psppire-dict.h: Implemented GtkTreeModel interface,
 396      which allows a dictionary to be displayed in a GtkTreeView.
 397
 398    * psppire.glade: Added dialog boxes for Goto Case and Sort Case.
 399
 400    * sort-cases-dialog.c sort-cases-dialog.h (new files).
 401
 402 Mon Jun 19 18:10:53 WST 2006 John Darrington <john@darrington.wattle.id.au>
 403
 404    * psppire-case-file.c psppire-case-file.h (new files)
 405
 406    * automake.mk data-sheet.c data-sheet.h menu-actions.c
 407    psppire-data-store.c psppire-data-store.h psppire-dict.c
 408    psppire-dict.h psppire-var-store.c psppire.c
 409
 410      Replaced psppire-case-array.c  with psppire-case-file.c, so as to
 411      allow an arbitrary number of cases to be represented.
 412
 413 Sun Jun  4 15:50:28 WST 2006 John Darrington <john@darrington.wattle.id.au>
 414
 415    * psppire-var-store.c, psppire.c, var-sheet.c :  Unlimited the number of
 416    variables that can be displayed. Minor i18n issues.
 417
 418 Tue May 30 19:53:35 WST 2006 John Darrington <john@darrington.wattle.id.au>
 419
 420    * menu-actions.c menu-actions.h psppire.c: Fixed up load/new
 421    interactions with startup.
 422
 423    * psppire-data-store.c: Fixed bad i18n call.
 424
 425    * pspppire-var-store.c, psppire-var-store.h: constness.
 426
 427    * helper.c: Implemented proper way to convert from PSPP to UTF8 encoding.
 428
 429
 430 Sat May 27 16:25:38 WST 2006 John Darrington <john@darrington.wattle.id.au>
 431
 432    * customentry.c data-sheet.c menu-actions.c message-dialog.c
 433      missing-val-dialog.c psppire-data-store.c psppire-var-store.c
 434      psppire.c psppire.glade var-sheet.c: Fixed internationalisation.
 435
 436 Thu May 25 18:01:17 WST 2006 John Darrington <john@darrington.wattle.id.au>
 437
 438    * psppire-var-store.c: Converted strings to utf8 and returned them on the
 439    heap.
 440
 441 Sat May 20 21:08:18 WST 2006 John Darrington <john@darrington.wattle.id.au>
 442
 443    * data-sheet.c, menu-actions.c menu-actions: Fixed data sheet so that
 444    active cell is never on a deleted variable.
 445
 446    * psppire-data-store.c psppire-data-store.h:  Added get_var_count and
 447    get_case_count functions.
 448
 449    * psppire-dict.c: removed VARIABLE_DELETED (singular) signal.
 450
 451    * psppire.c: Allowed user to specify *.sav file on command line.
 452
 453 Mon May 15 20:01:25 WST 2006 John Darrington <john@darrington.wattle.id.au>
 454
 455         * menu-actions.c psppire-case-array.c psppire-case-array.h
 456           psppire-data-store.c  psppire-dict.c psppire-dict.h
 457           psppire-variable.c:
 458
 459           Initialised new cases to SYSMIS/blank when inserting in data sheet.
 460
 461 Sat May 13 08:00:50 WST 2006 John Darrington <john@darrington.wattle.id.au>
 462
 463         * data-sheet.c, helper.c, helper.h, psppire-data-store.c,
 464           psppire-var-store.c:
 465
 466           Set free_strings flag so that the gtksheet frees the string data
 467           when it's done with them.
 468
 469 Thu May 11 22:25:49 WST 2006 John Darrington <john@darrington.wattle.id.au>
 470
 471         * data-sheet.c helper.c helper.h psppire-data-store.c psppire-var-store.c
 472         psppire.c: Converted strings to utf8 before passing to gtksheet.
 473
 474         * psppire-dict.c: Changed buffer to more reasonable length
 475
 476         * var-sheet.c: Changed maximum string length to use macro from
 477         data/values.h
 478
 479
 480 Sun May  7 10:07:28 WST 2006 John Darrington <john@darrington.wattle.id.au>
 481
 482         * psppire-data-store.c: Fixed buglet initialising string members.
 483
 484 Thu May  4 18:04:04 WST 2006 John Darrington <john@darrington.wattle.id.au>
 485
 486         * message-dialog.c message-dialog.h: Added simple queuing to messages
 487         reported, and ensure that dialog boxes dont appear when pointer grab
 488         is active.
 489
 490         * psppire-data-store.c: Fix overflow on very long string variables.
 491
 492         * automake.mk: Fix broken dependency.
 493
 494
 495 Tue Apr 25 11:08:04 2006  Ben Pfaff  <blp@gnu.org>
 496
 497         Finish reforming error message support.  In this phase, move
 498         message.c into libpspp.
 499
 500         * automake.mk: (src_ui_gui_psppire_SOURCES) Remove src/message.c.
 501
 502 Tue Apr 25 10:56:53 2006  Ben Pfaff  <blp@gnu.org>
 503
 504         Continue reforming error message support.  In this phase, drop
 505         actual message printing from core code, substituting a callback,
 506         and add the callback to each UI.  Also, move verbose_msg() into
 507         its own module.
 508
 509         * automake.mk: (src_ui_gui_psppire_SOURCES) Add src/message.c.
 510
 511         * message-dialog.c: (message_dialog_init) New function.
 512         (vmsg) Rename handle_msg(), rewrite as callback function.
 513         (msg) Removed.
 514         (msg_emit) Removed.
 515         (msg_assert_fail) Removed.
 516         (verbose_msg) Removed.
 517
 518         * psppire.c: (main) Call message_dialog_init().
 519
 520 Sun Apr 23 22:07:49 2006  Ben Pfaff  <blp@gnu.org>
 521
 522         Continue reforming error message support.  In this phase, get rid
 523         of message "titles" and put the message text in `struct error'.
 524         Now `struct error' encapsulates a message more properly.
 525
 526         * message-dialog.c: (err_vmsg) Rename err_msg().  Updated
 527         interface.
 528
 529 Sun Apr 16 20:45:35 2006  Ben Pfaff  <blp@gnu.org>
 530
 531         Continue reforming error message support.  In this phase, we
 532         divide the classification of messages along "category" and
 533         "severity" axes.
 534
 535         * message-dialog.c: (vmsg) Use severity and category in
 536         straightforward fashion instead of the less obvious "class".
 537         (err_vmsg) Construct class before passing along to vmsg().
 538
 539 Sun Apr 16 16:06:54 2006  Ben Pfaff  <blp@gnu.org>
 540
 541         Continue reforming error message support.  In this phase, we get
 542         rid of VM() and the other msg() support for "verbosity", replacing
 543         it by a new function verbose_msg().
 544
 545         * message-dialog.c: (verbose_msg) New function.
 546         (err_cond_fail) Removed (dead code).
 547         (err_failure) Removed (dead code).
 548
 549 Sun Apr 16 11:53:25 2006  Ben Pfaff  <blp@gnu.org>
 550
 551         Start reforming error message support.  In this phase, we get rid
 552         of "installation errors" and change all uses of msg() in the
 553         output drivers to uses of error() or error_at_line().
 554
 555         * message-dialog.c: (vmsg) Removed IE, IS support.
 556
 557 Mon Mar 13 16:42:44 WST 2006 John Darrington <john@darrington.wattle.id.au>
 558
 559     * psppire.c: Supported (sort of) the --help and --version options.
 560
 561     * Rename error-dialog.[ch] -> message-dialog.[ch]
 562
 563     * Moved code from the psppire module.
 564
 565 Sat Jan 28 16:22:23 WST 2006 John Darrington <john@darrington.wattle.id.au>
 566
 567     * Separated the data out of the GtkSheet.
 568
 569 Tue Nov  2 19:00:28 WST 2004 John Darrington <john@darrington.wattle.id.au>
 570
 571     * Very first incarnation.