WINGs/ChangeLog

   1 Changes since wmaker 0.80.0:
   2 ............................
   3
   4 - fixed a bug in wfindfile() (rewrote wfindfile() with better logic).
   5 - separated the font caches for normal fonts and fontsets in WINGs (they can
   6   have the same names and collide in the cache giving unwanted results)
   7 - fixed labels not to display '\n' as a character if multiple '\n' are passed
   8   but just skip to the next line.
   9 - better warning when importing non-digit characters in PropList Data.
  10 - rewrote WMBox to use a WMArray for subviews. with this change fixed a bug
  11   about arranging subviews after removing one and a memleak occuring in the
  12   same case.
  13 - Fixed WMGetViewScreenPosition() to consider the window decorations.
  14 - Added ability to enable/disable individual WMTableViewItems.
  15 - Fixed textfields regarding interpretation of special keys with modifiers.
  16
  17
  18 Changes since wmaker 0.70.0:
  19 ............................
  20
  21 - added an internal strcasecmp() (only on systems where is not present)
  22 - removed some redundant includes of ../src/config.h when wconfig.h is
  23   included too
  24 - removed a wsyserror() message when reading a property list from file
  25   (the programmer should decide if to give that message or just ignore).
  26 - added a 'Bool recursive' flag to WMMergePLDictionaries()
  27 - added WMSubtractPLDictionaries()
  28
  29
  30 Changes since wmaker 0.65.0:
  31 ............................
  32
  33 - fixed problem with WINGs based apps exiting with a "X_RotateProperties"
  34   related error when text was selected in a textfiled.
  35 - moved wstrdup(), wstrconcat() and wstrappend() from memory.c to string.c
  36 - added property list handling code making libPropList unnecessary and
  37   obsolete. Backward compatibility is provided through the
  38   WINGs/proplist-compat.h header file which has #defines from old libPropList
  39   function names to new function names with minimal changes. Read this
  40   header file and the NEWS file for more details about this subject.
  41 - Renamed WMGetUDAllKeys() to WMGetUDKeys()
  42
  43
  44 Changes since wmaker 0.64.0:
  45 ............................
  46
  47 - made programmatic scroller changes send notifications
  48 - replaced WMSetBoxExpandsToParent with WMSetViewExpands...
  49 - added WMGetLabelFont()
  50 - added WMAddPersistentTimerHandler()
  51 - Moved all internal handlers (timer, idle and input) to handlers.c
  52 - simplified wevent.c and wutil.c.
  53 - fixed handling of input with poll (was broken)
  54 - fixed mem leak that occured when input handling was done with poll
  55 - simpler and more straightforward event handling for timer, idle, input
  56   and X events (also fixed some problems the old handling logic had)
  57 - moved timer, idle and input handler definitions and prototypes from
  58   WINGs.h to WUtil.h because they're not GUI related.
  59 - better and more robust handling of events (timer, idle, input, X) in
  60   WMMaskEvent(). Also fixed a bug where input and timer events were not
  61   treated for undefined periods of time under some circumstances.
  62 - fixed secure textfields not to allow text selection, to avoid compromising
  63   sensitive information by pasting it to a terminal.
  64 - replaced wmkrange(), wmkpoint() and wmksize() functions with macros.
  65 - added WMRemoveFromArrayMatching(array, match, cdata), which will remove the
  66   first element in the array that is matched by match(item, cdata)==True.
  67 - added WMArrayFirst(), WMArrayLast(), WMArrayNext() and WMArrayPrevious()
  68   functions and also WM_ITERATE_ARRAY() and WM_ETARETI_ARRAY() macros, to make
  69   interfaces to WMBag and WMArray similar and to make life a little simpler
  70   when iterating through all elements of an array.
  71 - replaced bags with arrays wherever appropriate. This will improve
  72   performance a bit.
  73 - replaced some recursive code with iterative code in selection.c
  74 - added WMCreateBlendedPixmapFromRImage()
  75 - small API change:
  76   1. Renamed WMSetApplicationIconImage(), WMGetApplicationIconImage() and
  77      WMSetWindowMiniwindowImage() to respectively WMSetApplicationIconPixmap(),
  78      WMGetApplicationIconPixmap() and WMSetWindowMiniwindowPixmap()
  79      They operate on a WMPixmap which is practically an X Pixmap with no alpha
  80      channel information and the new name is more suggestive and also leaves
  81      room for the new functions added for operating on images with alpha info.
  82   2. Added WMSetApplicationIconImage() and WMGetApplicationIconImage() which
  83      operate on an RImage and store alpha information too.
  84   3. Added WMCreateApplicationIconBlendedPixmap() which will take the image
  85      set by WMSetApplicationIconImage() and will combine it with a color.
  86      If color is NULL it will blend using the default panel color (#aeaaae)
  87   All these changes will allow WINGs to handle images with alpha blending
  88   correctly in panels and wherever else needed. More about in NEWS.
  89 - updated panels to use the newly available RImages if present and fallback
  90   to old WMPixmaps if not, to properly show alpha blended images.
  91 - replaced some still left malloc's with wmalloc's.
  92 - fixed a bug in WMReparentWidget()
  93 - added WMReparentWidget() to WINGs.h
  94 - fixed a bug that made the scroller knob jump backwards when dragged (this
  95   bug had no relation with the behavior that #define STRICT_NEXT_BEHAVIOUR
  96   attempts to accomplish).
  97 - fixed scrolling direction with mouse wheel for horizontal scroller.
  98
  99
 100 changes since wmaker 0.63.1:
 101 ............................
 102 - added WMRunModalLoop() and WMBreakModalLoop()
 103 - added WMSetBoxExpandsToParent()
 104 - added WMRemoveBoxSubview()
 105 - moved WINGs headers in a WINGs subdirectory when installed.
 106   use #include <WINGs/header_file_name> in your application from now on.
 107   Also updated get-{wings|wutil}-flags.
 108 - Fixed a mem leak in WMList.
 109 - Fixed a bug that caused sigsegv for a WMList with more than 32767 items.
 110 - Added an example of how to create a server type program with WMConnection.
 111 - added WMOpenScreen()
 112
 113
 114 changes since wmaker 0.62.1:
 115 ............................
 116 - added WRuler widget
 117 - added WText widget (rtf multiline text widget)
 118         Nwanua Elumeze <nwanua@colorado.edu>
 119 - added a new AUTO option for the UseMultiByte option
 120 - added WMRaiseWidget()/WMLowerWidget()
 121 - added missing EscapeTextMovement to textfield delegate/notification
 122 - added WMGetLabelText()
 123 - added WMReparentWidget()
 124 - added WMCreateTabViewItem()
 125 - added W_CreateUnmanagedTopView()
 126 - added wtokenjoin(), wtokensplit(), wtokenfree(), wtrimspace()
 127 - added WMWidgetIsMapped()
 128 - added WMSetApplicationIconWindow()
 129 - restructured the directory tree. Added Documentation, Examples and Tests
 130   subdirectories
 131 - removed WMArrayBag and reorganized WMTreeBag to be WMBag.
 132 - added WMArray class.
 133 - added WMSetWindowUserPosition()
 134 - added WMGetListSelectedItems()
 135 - added WMSetListAllowMultipleSelection(), WMListAllowsMultipleSelection().
 136 - added WMSetListAllowEmptySelection(), WMListAllowsEmptySelection().
 137 - WMListSelectionDidChangeNotification passes NULL as the notification
 138   client data (previously passed the selected item row).
 139 - added WMUnselectListItem(), WMSelectAllListItems(), WMUnselectAllListItems()
 140 - better behavior of wheel mices in WMList. Simple mouse wheel events
 141   will scroll by 1/3 of the WMList height. Using Shift as a modifier will
 142   scroll line by line, while using Control as a modifier will scroll page
 143   by page.
 144 - better behavior of WMScroller regarding mouse wheel events. 'Shift' modifier
 145   will scroll line by line, while 'Control' modifier will scroll page by page.
 146 - fixed some buffer overflow allowing bugs.
 147 - added WSDecrementWheel and WSIncrementWheel for handling mouse wheel in
 148   scrollers and scrolled widgets. This should be treated like the WSxxxPage
 149   counterparts, except it should scroll by page_size/3 instead of one full page
 150 - added WMSetBrowserAllowMultipleSelection(), WMSetBrowserAllowEmptySelection()
 151   WMBrowserAllowsMultipleSelection() and WMBrowserAllowsEmptySelection()
 152 - WMBrowser now allows multiple selections.
 153 - Added WMGetBrowserPaths() to retrieve the paths for browsers that allow
 154   multiple selections.
 155 - WMDestroyWidget() now calls WMUnmapWidget() first
 156 - added WMScrollerDidScrollNotification to scroller
 157 - added WMGetScrollViewVisibleRect()
 158 - fixed a mem leak in the browser code.
 159 - renamed wstrappend() to wstrconcat(). wstrconcat(str1, str2) concatenates
 160   str1 with str2 and returns that in a newly malloc'ed string.
 161   Be sure to rename wstrappend with wstrconcat in your code too, else
 162   hazardous things can happen!
 163 - implemented a new wstrappend() function. wstrappend(dst, src) will append
 164   src to dst modifing dst and returning a pointer to it. No new string is
 165   generated, except if dst is NULL, in which case its the same as calling
 166   wstrdup(src).
 167   dst can ONLY be NULL or a dynamically allocated string (obtained from a
 168   call to malloc, realloc, wmalloc, wrealloc, ...). dst CANNOT be a static
 169   or a constant string!
 170 - added wmessage() for printing a variable formatted string to stderr, with
 171   the program name prepended to it. Similar to wwarning(), except that it
 172   doesn't add "warning:" in the output message.
 173 - added WMBox widget
 174 - added WMAddTabViewItemWithView()
 175 - added W_SetViewCursor()
 176 - made Extra widgets library
 177 - added table widget in Extras library
 178 - added WMGetConnectionUnsentData() (WMGetConnectionQueuedData() too as an
 179   alias).
 180 - added WMSetConnectionCloseOnExec() to specify if the socket associated
 181   with a connection survives an exec* call or not. When a new connection is
 182   created using the WMCreate... or WMAcceptConnection() calls, it has the
 183   close on exec flag set automatically to 'True' by the library. Unless
 184   you want to let the socket of some connection to survive across an exec*
 185   call, you need not to call this function.
 186 - removed all the wsyserror() and wwarning() calls from host.c and
 187   connection.c and replaced where appropriate with assertions. If a function
 188   returns some invalid result, you can still get the system error message if
 189   you need, by calling wsyserrorwithcode() and passing WCErrorCode, if
 190   WCErrorCode > 0. If WCErrorCode==0, that is not a system error, and
 191   wsyserrorwithcode() should not be called in this case.
 192 - added WMNextHashEnumeratorKey() to retrieve all keys in some hash enumerator
 193   one by one.
 194 - fixed a bug with mouse wheels scrolling in scrollers even with the widget
 195   fully visible.
 196 - Fixed a memory leak (the destroy function for a view was never called and
 197   as a result the shaded windows didn't go away when closed. The non-shaded
 198   windows were unmapped on close but not destroyed either so they only
 199   apparently went away, but continued to use memory).
 200
 201
 202
 203 changes since wmaker 0.62.0:
 204 ............................
 205 - added WMSetWidgetDefaultFont(), WMSetWidgetDefaultBoldFont()
 206
 207
 208
 209 changes since wmaker 0.62.0:
 210 ............................
 211 - added WM{S,G}etDataFormat()
 212 - added drag and drop
 213 - changed selection code
 214 - added clientdata to WMFindInBag
 215 - removed SetWindowInitialSize()
 216 - added SetWindowAspectRatio()
 217 - added initial timeout when establishing a connection.
 218 - added WMSetConnectionDefaultTimeout() and WMSetConnectionOpenTimeout();
 219 - added WMGetConnectionTimeoutState()
 220
 221 changes since wmaker 0.61.1:
 222 ............................
 223
 224 - WARNING: semantic of bags has changed!
 225         An index assigned to an item will always keep that index unless
 226         you insert an item before it.
 227
 228         For example:
 229                 bag = WMCreateBag();
 230                 WMSetInBag(bag, 10, "bla");
 231         That code will put "bla" in index 10, instead of 0, as it used to be.
 232 - fixed WMInsertInBag(). It ignored index, and always put the new item at end.
 233 - added WMSaveUserDefaults().
 234 - rewrote WMPopUpButton to use WMMenuItem
 235 - added WMGetPopUpButtonMenuItem(WMPopUpButton *bPtr, int index)
 236 - WMSortListItemsWithComparer(WMList *lPtr, (int)(f)(const void*, const void*))
 237 - WMSortBrowserColumnWithComparer()
 238 - fixed bug with sorting list items.
 239 - fixed bug in handling keyboard input associated with selection and
 240   notification sending.
 241 - filepanel puts dirs on top of list (Wolff <wolff@cybercable.fr>)
 242 - added WMReplaceInBag (Wolff <wolff@cybercable.fr>)
 243 - added vertical views and multiple views in WMSplitView (Wolff <wolff@cybercable.fr>)
 244 - changed values of parameter values of WMSplitViewConstrainProc()
 245 - configurable default fontsize patch (Igor P. Roboul <igor@mordor.myip.org>)
 246 - fixed a bug that crashed the programm when a popup button was scrolled.
 247 - fixed a bug that caused incorrect drawing position of the popup indicator.
 248 - fixed a bug that prevented selecting no item (-1) in a popup button.
 249 - an assertion will be raised if the program tries to select a popup button
 250   item that is beyond the total number of items present in the popup button.
 251 - changed names of functions for SplitView to be consistent. Some contained
 252   SubView while other Subview. Now all have Subview.
 253 - fixed a bug in how input events were posted. Establishing 2 or more input
 254   handlers for the same file descriptor, handling different (read/write/except)
 255   events, caused wrong handlers to be called.
 256 - Reimplemented the input and idle handlers with WMBag to avoid a functional
 257   problem with them: inability to remove handlers next to the called one, from
 258   the called handler itself. Trying to do this with the old version caused the
 259   program to crash.
 260 - changed wrealloc behaviour to be like this: new = wrealloc(old, new_size);
 261     1. if old is NULL, return wmalloc(new_size).
 262     2. if new_size is 0, call wfree(old), and return NULL.
 263     3. if both old is a valid pointer and new_size>0, call realloc.
 264 - added wstrerror(int errnum) to return the string associated with errnum.
 265 - new wsyserrorwithcode(int error, const char* fmt, ...), similar to
 266   wsyserror(), but printing the message for the specified error code.
 267 - added 3 new classes: WMData, WMHost and WMConnection
 268 - fixed a big memory leak in the color panel code (from Pascal Hofstee).
 269 - added scrolling to tabview
 270
 271 changes since wmaker 0.61.0:
 272 ............................
 273
 274 - added WMGetTextFieldFont()
 275 - escape key in panels (craig nellist <crn@ozemail.com.au>)
 276 - applied patch with fixes and enhancements to textfield
 277         (Franck Wolff <wolff@cybercable.fr>)
 278 - changed WMList to use WMBag internally, instead of a linked list
 279 - replaced WMAddSortedListItem() with WMSortListItems()
 280 - replaced WMAddSortedBrowserItem() with WMSortBrowserColumn()
 281
 282 changes since wmaker 0.60.0:
 283 ............................
 284
 285 - added WMScreenWidth() and WMScreenHeight() functions.
 286 - fixed some problems when compiling with non gcc compilers.
 287 - added WMSetTextFieldFont()
 288 - added WMSetButtonImageDefault() (craig nellist <crn@ozemail.com.au>)
 289 - added WMBag (array/list)
 290 - added libWUtil, a library that is a subset of libWINGs. It contains utils
 291   that can be used in writing non-GUI programs. They include: hashes,
 292   notifications, input/idle/timer handlers, user defaults database handling,
 293   memory handling, application resource handling, etc.
 294   All the non-GUI stuff from libWINGs is present.
 295   Still linWINGs contain all this stuff so if you use libWINGs, you don't
 296   need to link against libWUtil too.
 297   One notable aspect of libWUtil is that it has a modified version of the
 298   event handling function. It is named WHandleEvents() and will handle all
 299   input/idle/timer events the app has.
 300   If your app has a permanent input handler (as for example a socket a server
 301   is listening on), then the main loop of the app can be:
 302         while(1) {
 303             WHandleEvents();
 304         }
 305   but if there is no permanent input handler, you need to add some delay to
 306   avoid a too high cpu load by your program:
 307         while(1) {
 308             WHandleEvents();
 309             wusleep(5000);
 310         }
 311   A permanent input handler is one that is established when the program starts
 312   and is present until the program exits.
 313   One that is deleted and later reinstalled, is not considered permanent.
 314   This difference is because if there is some input handler, the function will
 315   block until some event appears, while if there is no input handler the
 316   function will return almost immediately (after handling the timer/idle
 317   stuff).
 318
 319   Except the stuff declared in WUtil.h, the following functions declared in
 320   WINGs.h are also present in libWUtil (you will need to #include <WINGs.h>
 321   if you use one of these):
 322         WMInitializeApplication(char *applicationName, int *argc, char **argv);
 323         WMSetResourcePath(char *path);
 324         WMGetApplicationName();
 325         WMPathForResourceOfType(char *resource, char *ext);
 326         WMAddTimerHandler(int milliseconds, WMCallback *callback, void *cdata);
 327         WMDeleteTimerWithClientData(void *cdata);
 328         WMDeleteTimerHandler(WMHandlerID handlerID);
 329         WMAddIdleHandler(WMCallback *callback, void *cdata);
 330         WMDeleteIdleHandler(WMHandlerID handlerID);
 331         WMAddInputHandler(int fd, int condition, WMInputProc *proc,
 332                           void *clientData);
 333         WMDeleteInputHandler(WMHandlerID handlerID);
 334 - added progress indicator widget
 335 - Changed WMSetWindowUPosition() and WMSetWindowUSize() to
 336   WMSetWindowInitialPosition() and WMSetWindowInitialSize() respectively,
 337   for better naming conventions.
 338
 339
 340 changes since wmaker 0.53.0:
 341 ............................
 342
 343 - added balloon help
 344 - fixed a bug with setting initial path in browsers.
 345 - added WMSetButtonImageDimsWhenDisabled()
 346 - changed simple callback/notifications to delegate-like stuff. Affected
 347   widgets are:
 348         WMBrowser
 349         - WMSetBrowserFillProc() was replaced with WMSetBrowserDelegate
 350         - WMBrowserDidScrollNotification was replaced with a delegate callback
 351
 352         WMTextField (not completed yet)
 353         The notifications will still work, but using the delegate is preferable
 354
 355   How to convert old code to delegate callbacks:
 356         1 - create a variable (static or dynamic) of the type of the
 357             delegate for the widget type.
 358         2 - Replace the notification observers with the equivalent
 359             delegate callbacks.
 360         3 - Put pointers to the callbacks in the delegate variable.
 361
 362         Take a look in wfilepanel.c to see how it is used there.
 363
 364 - changed W_ViewProcedureTable to delegates
 365         This will only affect user created widgets. If you have a custom
 366         widget, you will need to update the callbacks and the declaration
 367         of the W_ViewProcedureTable variable to be a W_ViewDelegate,
 368         which is declared in WINGsP.h  To setup the delegate, assign
 369         the delegate variable to view->delegate.
 370
 371 - WMTextField
 372         Removed all the didChange notifications that were sent when the text
 373         was changed programmatically. Only changes made by user interaction
 374         will be notified now. If you need the old behaviour, send notifications
 375         manually when you change the text.
 376
 377 - added WMTabView
 378 - added WMGetColorPanelColor(WMColorPanel *panel)
 379 - made WMGetUDStringForKey() to only return a reference to the string, not a
 380   wstrdup()'ed copy. DO NOT FREE IT ANYMORE!
 381 - added MultiByteText option to userdefaults file to control use of multibyte
 382   string drawing functions
 383 - renamed WMCreateFont() to WMCreateFontSet()
 384 - renamed WMCreateFontInDefaultEncoding() to WMCreateNormalFont()
 385 - added WMCreateFont() with different semantics
 386
 387
 388 changes since wmaker 0.52.0:
 389 ............................
 390
 391 - added int WMGetBrowserMaxVisibleColumns(WMBrowser *bPtr);
 392
 393
 394 changes since wmaker 0.51.2:
 395 ............................
 396
 397 - added WMColorWellDidChangeNotification
 398 - added wfindfileinarray()
 399 - fixed bug in window title setting
 400         (MANOME Tomonori <manome@itlb.te.noda.sut.ac.jp>)
 401
 402 changes since wmaker 0.51.1:
 403 ............................
 404
 405 - wusergnusteppath() will return a statically allocated string now.
 406  DO NOT FREE IT ANYMORE!!
 407
 408
 409
 410 changes since wmaker 0.51.0:
 411 ............................
 412
 413 - applied c++ compat header patch from Martynas Kunigelis <mkunigelis@alna.lt>
 414 - added WMSetTextFieldBeveled()
 415 - removed W_GC() : use WMColorGC() instead
 416 - added WMCreatePixmap()
 417 - changed WMSetTextFieldEnabled() to WMSetTextFieldEditable()
 418
 419 changes since wmaker 0.50.1:
 420 ............................
 421
 422 - fixed various bugs
 423 - added patch from Franck Wolff <frawolff@club-internet.fr>, with
 424   many fixes and enhancements
 425 - added notification queues, asynchronous notifications etc.
 426 - added WMSetBrowserDoubleAction()
 427 - fixed list double click action
 428
 429 changes since wmaker 0.50.2:
 430 ............................
 431
 432 - added wsetabort() - look WUtil.h
 433 - fixed bug in WMList resize
 434 - added notification sending when changing textfield programatically
 435 - removed WMHideWindow()
 436 - fixed bug in WMCloseWindow()
 437 - added textfield selection patch
 438 - added color panel code
 439 - added auto name completion for the file panel
 440 - added function to select text range, and to set cursor position in text
 441   fields programatically
 442
 443 changes since wmaker 0.20.3:
 444 ............................
 445
 446 - added WMSetSliderImage(), WMSetSliderKnobThickness()
 447 - added WMGetListItemHeight()
 448 - added WMListDidScrollNotification
 449 - added WSetColorWellBordered()
 450 - added hacky color dragging in colorwell
 451 - added poll() support in WMNextEvent. WARNING: the stuff needed for
 452   WMAddInputHandler() is not yet implemented for the poll stuff
 453 - added WMSetFilePanelAccessoryView(), WMGetFilePanelAccessoryView()
 454 - added WMSetPopUpButtonEnabled()
 455 - added WMGetLabelImage()
 456 - autoscroll for popup button menus
 457 - added WMDrawPixmap()
 458 - WARNING: changed parameter list for WMListDrawProc
 459
 460 changes since wmaker 0.20.2:
 461 ............................
 462
 463 - WMSetBrowserMaxVisibleColumns() - untested
 464
 465
 466
 467 changes since wmaker 0.20.0:
 468 ............................
 469
 470 - added generic object field for WMListItem. This is for hanging generic
 471   clientdata
 472
 473
 474 changes since wmaker 0.20.0:
 475 ............................
 476
 477 - changed WMGetFilePanelFile() with WMGetFilePanelFileName()
 478 - made SavePanel
 479
 480 changes since wmaker 0.19.3:
 481 ............................
 482
 483 - added WMCreatePanelForWindow()
 484 - added extra parent parameter for filepanel, alertpanel and inputpanel
 485 - WMCloseWindow()
 486 - WMChangePanelOwner()
 487 - added WMAddInputHandler()
 488 - change range related function arguments (WMTextField) to use WMRange
 489
 490 changes since wmaker 0.19.1:
 491 ............................
 492
 493 - added wstrappend()
 494 - fixed bug when changing selected radio button by hand
 495
 496 changes since wmaker 0.18.1:
 497 ............................
 498
 499 - removed textHeight arg from W_PaintImageAndText
 500 - added WMCreateWindowWithStyle()
 501 - added WMSetWindowBaseSize() and ResizeIncrements()
 502 - added WMSetWindowLeve()
 503 - added WMSetWindowDocumentEdited()
 504 - added WMSetScrollViewLineScroll(), WMSetScrollViewPageScroll()
 505 - added WMSetWindowMiniwindowTitle()
 506 - added WMSetWindowMiniwindowImage()
 507
 508 changes since wmaker 0.18.0:
 509 ............................
 510
 511 - added functions to get RGB components and "#rrggbb" string from WMColor.
 512 - added function to create color from a name
 513 - fixed bug that caused blocking until some new event arrives, even
 514   when there already were events in the queue
 515   (like having to move the pointer over window to force the window to be
 516   painted)
 517
 518 changes since wmaker 0.17.5:
 519 ............................
 520
 521 I don't remember everything, but here it goes:
 522
 523 - fixed some bugs in text field
 524 - added a incomplete implementation of split view (not yet usable)
 525 - added a slider
 526 - changed the filepanel stuff. Each application can have only 1 file panel.
 527 The same panel will be reused every time you call for it, unless you free it.
 528 - changed semantics of WMCreateFont() so that it returns NULL if the requested
 529   font can't be loaded
 530 - removed WMAddDestroyCallback()
 531 - fixed bug in WMRemovePopUpButtonItem()
 532 - added function for user specified item height in WMList
 533 - added WMSetPopUpButtonText(). It will set the default text in the button
 534   when no options are selected
 535 - fixed bug in remove/add item in already mapped popupbuttons. Note: it is
 536   not good practice to change the contents of a popup button when it's
 537   already visible and the user has probably interacted with it.
 538 - fixed behaviour of "radio buttons"
 539 - WMInitializeApplication() must be the first function to be called in the
 540   program
 541 - removed applicationName, argc and argv arguments from the WMCreateScree...
 542   functions
 543 - WMReleaseColor(scr,color) changed to WMReleaseColor(color)
 544 - WMPaintColorRectangle() changed to WMPaintColorSwatch()
 545 - added various functions in font and color handling
 546 - added WMSetButtonFont()
 547 - changed WMCreateCommandButton() so that the buttons it creates will change
 548         their label when pushed
 549 - added WMGetSystemPixmap(WMScreen *scr, int image)
 550 - added partial I18N support
 551 - added libPropList requirement and some related utility functions
 552 - added a interface to prooplist, so that it works as a user defaults db
 553 - added WMWidthOfString() (removed WMFontWidthOfString())
 554 - added WMDrawString()
 555 - added WMSetTextFieldSecure(WMTextField *tPtr, Bool flag)
 556 - WMGetListItem() will dup the returned string
 557 - removed need for ProgName being defined
 558 - rewrote hashtable stuff and made it available for outside use
 559 - added notification functions, with view resize notification
 560 - added WMSetWindowMinSize() and MaxSize()
 561 - text editing notification
 562 - added WMSetListPosition() etc.
 563 - added WMInsertBrowserItem()
 564 - the above 2 functions return WMListItem*, instead of Bool
 565 - rewrote browser
 566 - WMGetListItem() will return WMListItem*
 567 - removed WMGetListItems() and WMSetListItems()
 568 - fixed focus stuff for multi-window apps
 569 - changed all WMList function names that contained index to row