WINGs/ChangeLog

   1 changes since wmaker 0.62.1:
   2 ............................
   3 - added WRuler widget
   4 - added WText widget (rtf multiline text widget)
   5         Nwanua Elumeze <nwanua@colorado.edu>
   6 - added a new AUTO option for the UseMultiByte option
   7 - added WMRaiseWidget()/WMLowerWidget()
   8 - added missing EscapeTextMovement to textfield delegate/notification
   9 - added WMGetLabelText()
  10 - added WMReparentWidget()
  11 - added WMCreateTabViewItem()
  12 - added W_CreateUnmanagedTopView()
  13 - added wtokenjoin(), wtokensplit(), wtokenfree(), wtrimspace()
  14 - added WMWidgetIsMapped()
  15 - added WMSetApplicationIconWindow()
  16 - restructured the directory tree. Added Documentation, Examples and Tests
  17   subdirectories
  18 - removed WMArrayBag and reorganized WMTreeBag to be WMBag.
  19 - added WMArray class.
  20 - added WMSetWindowUserPosition()
  21 - added WMGetListSelectedItems()
  22 - added WMSetListAllowMultipleSelection(), WMListAllowsMultipleSelection().
  23 - added WMSetListAllowEmptySelection(), WMListAllowsEmptySelection().
  24 - WMListSelectionDidChangeNotification passes NULL as the notification
  25   client data (previously passed the selected item row).
  26 - added WMUnselectListItem(), WMSelectAllListItems(), WMUnselectAllListItems()
  27 - better behavior of wheel mices in WMList. Simple mouse wheel events
  28   will scroll by 1/3 of the WMList height. Using Shift as a modifier will
  29   scroll line by line, while using Control as a modifier will scroll page
  30   by page.
  31 - better behavior of WMScroller regarding mouse wheel events. 'Shift' modifier
  32   will scroll line by line, while 'Control' modifier will scroll page by page.
  33 - fixed some buffer overflow allowing bugs.
  34 - added WSDecrementWheel and WSIncrementWheel for handling mouse wheel in
  35   scrollers and scrolled widgets. This should be treated like the WSxxxPage
  36   counterparts, except it should scroll by page_size/3 instead of one full page
  37 - added WMSetBrowserAllowMultipleSelection(), WMSetBrowserAllowEmptySelection()
  38   WMBrowserAllowsMultipleSelection() and WMBrowserAllowsEmptySelection()
  39 - WMBrowser now allows multiple selections.
  40 - Added WMGetBrowserPaths() to retrieve the paths for browsers that allow
  41   multiple selections.
  42 - WMDestroyWidget() now calls WMUnmapWidget() first
  43 - added WMScrollerDidScrollNotification to scroller
  44 - added WMGetScrollViewVisibleRect()
  45 - fixed a mem leak in the browser code.
  46 - renamed wstrappend() to wstrconcat(). wstrconcat(str1, str2) concatenates
  47   str1 with str2 and returns that in a newly malloc'ed string.
  48   Be sure to rename wstrappend with wstrconcat in your code too, else
  49   hazardous things can happen!
  50 - implemented a new wstrappend() function. wstrappend(dst, src) will append
  51   src to dst modifing dst and returning a pointer to it. No new string is
  52   generated, except if dst is NULL, in which case its the same as calling
  53   wstrdup(src).
  54   dst can ONLY be NULL or a dynamically allocated string (obtained from a
  55   call to malloc, realloc, wmalloc, wrealloc, ...). dst CANNOT be a static
  56   or a constant string!
  57 - added wmessage() for printing a variable formatted string to stderr, with
  58   the program name prepended to it. Similar to wwarning(), except that it
  59   doesn't add "warning:" in the output message.
  60 - added WMBox widget
  61
  62
  63 changes since wmaker 0.62.0:
  64 ............................
  65 - added WMSetWidgetDefaultFont(), WMSetWidgetDefaultBoldFont()
  66
  67
  68
  69 changes since wmaker 0.62.0:
  70 ............................
  71 - added WM{S,G}etDataFormat()
  72 - added drag and drop
  73 - changed selection code
  74 - added clientdata to WMFindInBag
  75 - removed SetWindowInitialSize()
  76 - added SetWindowAspectRatio()
  77 - added initial timeout when establishing a connection.
  78 - added WMSetConnectionDefaultTimeout() and WMSetConnectionOpenTimeout();
  79 - added WMGetConnectionTimeoutState()
  80
  81 changes since wmaker 0.61.1:
  82 ............................
  83
  84 - WARNING: semantic of bags has changed!
  85         An index assigned to an item will always keep that index unless
  86         you insert an item before it.
  87
  88         For example:
  89                 bag = WMCreateBag();
  90                 WMSetInBag(bag, 10, "bla");
  91         That code will put "bla" in index 10, instead of 0, as it used to be.
  92 - fixed WMInsertInBag(). It ignored index, and always put the new item at end.
  93 - added WMSaveUserDefaults().
  94 - rewrote WMPopUpButton to use WMMenuItem
  95 - added WMGetPopUpButtonMenuItem(WMPopUpButton *bPtr, int index)
  96 - WMSortListItemsWithComparer(WMList *lPtr, (int)(f)(const void*, const void*))
  97 - WMSortBrowserColumnWithComparer()
  98 - fixed bug with sorting list items.
  99 - fixed bug in handling keyboard input associated with selection and
 100   notification sending.
 101 - filepanel puts dirs on top of list (Wolff <wolff@cybercable.fr>)
 102 - added WMReplaceInBag (Wolff <wolff@cybercable.fr>)
 103 - added vertical views and multiple views in WMSplitView (Wolff <wolff@cybercable.fr>)
 104 - changed values of parameter values of WMSplitViewConstrainProc()
 105 - configurable default fontsize patch (Igor P. Roboul <igor@mordor.myip.org>)
 106 - fixed a bug that crashed the programm when a popup button was scrolled.
 107 - fixed a bug that caused incorrect drawing position of the popup indicator.
 108 - fixed a bug that prevented selecting no item (-1) in a popup button.
 109 - an assertion will be raised if the program tries to select a popup button
 110   item that is beyond the total number of items present in the popup button.
 111 - changed names of functions for SplitView to be consistent. Some contained
 112   SubView while other Subview. Now all have Subview.
 113 - fixed a bug in how input events were posted. Establishing 2 or more input
 114   handlers for the same file descriptor, handling different (read/write/except)
 115   events, caused wrong handlers to be called.
 116 - Reimplemented the input and idle handlers with WMBag to avoid a functional
 117   problem with them: inability to remove handlers next to the called one, from
 118   the called handler itself. Trying to do this with the old version caused the
 119   program to crash.
 120 - changed wrealloc behaviour to be like this: new = wrealloc(old, new_size);
 121     1. if old is NULL, return wmalloc(new_size).
 122     2. if new_size is 0, call wfree(old), and return NULL.
 123     3. if both old is a valid pointer and new_size>0, call realloc.
 124 - added wstrerror(int errnum) to return the string associated with errnum.
 125 - new wsyserrorwithcode(int error, const char* fmt, ...), similar to
 126   wsyserror(), but printing the message for the specified error code.
 127 - added 3 new classes: WMData, WMHost and WMConnection
 128 - fixed a big memory leak in the color panel code (from Pascal Hofstee).
 129 - added scrolling to tabview
 130
 131 changes since wmaker 0.61.0:
 132 ............................
 133
 134 - added WMGetTextFieldFont()
 135 - escape key in panels (craig nellist <crn@ozemail.com.au>)
 136 - applied patch with fixes and enhancements to textfield
 137         (Franck Wolff <wolff@cybercable.fr>)
 138 - changed WMList to use WMBag internally, instead of a linked list
 139 - replaced WMAddSortedListItem() with WMSortListItems()
 140 - replaced WMAddSortedBrowserItem() with WMSortBrowserColumn()
 141
 142 changes since wmaker 0.60.0:
 143 ............................
 144
 145 - added WMScreenWidth() and WMScreenHeight() functions.
 146 - fixed some problems when compiling with non gcc compilers.
 147 - added WMSetTextFieldFont()
 148 - added WMSetButtonImageDefault() (craig nellist <crn@ozemail.com.au>)
 149 - added WMBag (array/list)
 150 - added libWUtil, a library that is a subset of libWINGs. It contains utils
 151   that can be used in writing non-GUI programs. They include: hashes,
 152   notifications, input/idle/timer handlers, user defaults database handling,
 153   memory handling, application resource handling, etc.
 154   All the non-GUI stuff from libWINGs is present.
 155   Still linWINGs contain all this stuff so if you use libWINGs, you don't
 156   need to link against libWUtil too.
 157   One notable aspect of libWUtil is that it has a modified version of the
 158   event handling function. It is named WHandleEvents() and will handle all
 159   input/idle/timer events the app has.
 160   If your app has a permanent input handler (as for example a socket a server
 161   is listening on), then the main loop of the app can be:
 162         while(1) {
 163             WHandleEvents();
 164         }
 165   but if there is no permanent input handler, you need to add some delay to
 166   avoid a too high cpu load by your program:
 167         while(1) {
 168             WHandleEvents();
 169             wusleep(5000);
 170         }
 171   A permanent input handler is one that is established when the program starts
 172   and is present until the program exits.
 173   One that is deleted and later reinstalled, is not considered permanent.
 174   This difference is because if there is some input handler, the function will
 175   block until some event appears, while if there is no input handler the
 176   function will return almost immediately (after handling the timer/idle
 177   stuff).
 178
 179   Except the stuff declared in WUtil.h, the following functions declared in
 180   WINGs.h are also present in libWUtil (you will need to #include <WINGs.h>
 181   if you use one of these):
 182         WMInitializeApplication(char *applicationName, int *argc, char **argv);
 183         WMSetResourcePath(char *path);
 184         WMGetApplicationName();
 185         WMPathForResourceOfType(char *resource, char *ext);
 186         WMAddTimerHandler(int milliseconds, WMCallback *callback, void *cdata);
 187         WMDeleteTimerWithClientData(void *cdata);
 188         WMDeleteTimerHandler(WMHandlerID handlerID);
 189         WMAddIdleHandler(WMCallback *callback, void *cdata);
 190         WMDeleteIdleHandler(WMHandlerID handlerID);
 191         WMAddInputHandler(int fd, int condition, WMInputProc *proc,
 192                           void *clientData);
 193         WMDeleteInputHandler(WMHandlerID handlerID);
 194 - added progress indicator widget
 195 - Changed WMSetWindowUPosition() and WMSetWindowUSize() to
 196   WMSetWindowInitialPosition() and WMSetWindowInitialSize() respectively,
 197   for better naming conventions.
 198
 199
 200 changes since wmaker 0.53.0:
 201 ............................
 202
 203 - added balloon help
 204 - fixed a bug with setting initial path in browsers.
 205 - added WMSetButtonImageDimsWhenDisabled()
 206 - changed simple callback/notifications to delegate-like stuff. Affected
 207   widgets are:
 208         WMBrowser
 209         - WMSetBrowserFillProc() was replaced with WMSetBrowserDelegate
 210         - WMBrowserDidScrollNotification was replaced with a delegate callback
 211
 212         WMTextField (not completed yet)
 213         The notifications will still work, but using the delegate is preferable
 214
 215   How to convert old code to delegate callbacks:
 216         1 - create a variable (static or dynamic) of the type of the
 217             delegate for the widget type.
 218         2 - Replace the notification observers with the equivalent
 219             delegate callbacks.
 220         3 - Put pointers to the callbacks in the delegate variable.
 221
 222         Take a look in wfilepanel.c to see how it is used there.
 223
 224 - changed W_ViewProcedureTable to delegates
 225         This will only affect user created widgets. If you have a custom
 226         widget, you will need to update the callbacks and the declaration
 227         of the W_ViewProcedureTable variable to be a W_ViewDelegate,
 228         which is declared in WINGsP.h  To setup the delegate, assign
 229         the delegate variable to view->delegate.
 230
 231 - WMTextField
 232         Removed all the didChange notifications that were sent when the text
 233         was changed programmatically. Only changes made by user interaction
 234         will be notified now. If you need the old behaviour, send notifications
 235         manually when you change the text.
 236
 237 - added WMTabView
 238 - added WMGetColorPanelColor(WMColorPanel *panel)
 239 - made WMGetUDStringForKey() to only return a reference to the string, not a
 240   wstrdup()'ed copy. DO NOT FREE IT ANYMORE!
 241 - added MultiByteText option to userdefaults file to control use of multibyte
 242   string drawing functions
 243 - renamed WMCreateFont() to WMCreateFontSet()
 244 - renamed WMCreateFontInDefaultEncoding() to WMCreateNormalFont()
 245 - added WMCreateFont() with different semantics
 246
 247
 248 changes since wmaker 0.52.0:
 249 ............................
 250
 251 - added int WMGetBrowserMaxVisibleColumns(WMBrowser *bPtr);
 252
 253
 254 changes since wmaker 0.51.2:
 255 ............................
 256
 257 - added WMColorWellDidChangeNotification
 258 - added wfindfileinarray()
 259 - fixed bug in window title setting
 260         (MANOME Tomonori <manome@itlb.te.noda.sut.ac.jp>)
 261
 262 changes since wmaker 0.51.1:
 263 ............................
 264
 265 - wusergnusteppath() will return a statically allocated string now.
 266  DO NOT FREE IT ANYMORE!!
 267
 268
 269
 270 changes since wmaker 0.51.0:
 271 ............................
 272
 273 - applied c++ compat header patch from Martynas Kunigelis <mkunigelis@alna.lt>
 274 - added WMSetTextFieldBeveled()
 275 - removed W_GC() : use WMColorGC() instead
 276 - added WMCreatePixmap()
 277 - changed WMSetTextFieldEnabled() to WMSetTextFieldEditable()
 278
 279 changes since wmaker 0.50.1:
 280 ............................
 281
 282 - fixed various bugs
 283 - added patch from Franck Wolff <frawolff@club-internet.fr>, with
 284   many fixes and enhancements
 285 - added notification queues, asynchronous notifications etc.
 286 - added WMSetBrowserDoubleAction()
 287 - fixed list double click action
 288
 289 changes since wmaker 0.50.2:
 290 ............................
 291
 292 - added wsetabort() - look WUtil.h
 293 - fixed bug in WMList resize
 294 - added notification sending when changing textfield programatically
 295 - removed WMHideWindow()
 296 - fixed bug in WMCloseWindow()
 297 - added textfield selection patch
 298 - added color panel code
 299 - added auto name completion for the file panel
 300 - added function to select text range, and to set cursor position in text
 301   fields programatically
 302
 303 changes since wmaker 0.20.3:
 304 ............................
 305
 306 - added WMSetSliderImage(), WMSetSliderKnobThickness()
 307 - added WMGetListItemHeight()
 308 - added WMListDidScrollNotification
 309 - added WSetColorWellBordered()
 310 - added hacky color dragging in colorwell
 311 - added poll() support in WMNextEvent. WARNING: the stuff needed for
 312   WMAddInputHandler() is not yet implemented for the poll stuff
 313 - added WMSetFilePanelAccessoryView(), WMGetFilePanelAccessoryView()
 314 - added WMSetPopUpButtonEnabled()
 315 - added WMGetLabelImage()
 316 - autoscroll for popup button menus
 317 - added WMDrawPixmap()
 318 - WARNING: changed parameter list for WMListDrawProc
 319
 320 changes since wmaker 0.20.2:
 321 ............................
 322
 323 - WMSetBrowserMaxVisibleColumns() - untested
 324
 325
 326
 327 changes since wmaker 0.20.0:
 328 ............................
 329
 330 - added generic object field for WMListItem. This is for hanging generic
 331   clientdata
 332
 333
 334 changes since wmaker 0.20.0:
 335 ............................
 336
 337 - changed WMGetFilePanelFile() with WMGetFilePanelFileName()
 338 - made SavePanel
 339
 340 changes since wmaker 0.19.3:
 341 ............................
 342
 343 - added WMCreatePanelForWindow()
 344 - added extra parent parameter for filepanel, alertpanel and inputpanel
 345 - WMCloseWindow()
 346 - WMChangePanelOwner()
 347 - added WMAddInputHandler()
 348 - change range related function arguments (WMTextField) to use WMRange
 349
 350 changes since wmaker 0.19.1:
 351 ............................
 352
 353 - added wstrappend()
 354 - fixed bug when changing selected radio button by hand
 355
 356 changes since wmaker 0.18.1:
 357 ............................
 358
 359 - removed textHeight arg from W_PaintImageAndText
 360 - added WMCreateWindowWithStyle()
 361 - added WMSetWindowBaseSize() and ResizeIncrements()
 362 - added WMSetWindowLeve()
 363 - added WMSetWindowDocumentEdited()
 364 - added WMSetScrollViewLineScroll(), WMSetScrollViewPageScroll()
 365 - added WMSetWindowMiniwindowTitle()
 366 - added WMSetWindowMiniwindowImage()
 367
 368 changes since wmaker 0.18.0:
 369 ............................
 370
 371 - added functions to get RGB components and "#rrggbb" string from WMColor.
 372 - added function to create color from a name
 373 - fixed bug that caused blocking until some new event arrives, even
 374   when there already were events in the queue
 375   (like having to move the pointer over window to force the window to be
 376   painted)
 377
 378 changes since wmaker 0.17.5:
 379 ............................
 380
 381 I don't remember everything, but here it goes:
 382
 383 - fixed some bugs in text field
 384 - added a incomplete implementation of split view (not yet usable)
 385 - added a slider
 386 - changed the filepanel stuff. Each application can have only 1 file panel.
 387 The same panel will be reused every time you call for it, unless you free it.
 388 - changed semantics of WMCreateFont() so that it returns NULL if the requested
 389   font can't be loaded
 390 - removed WMAddDestroyCallback()
 391 - fixed bug in WMRemovePopUpButtonItem()
 392 - added function for user specified item height in WMList
 393 - added WMSetPopUpButtonText(). It will set the default text in the button
 394   when no options are selected
 395 - fixed bug in remove/add item in already mapped popupbuttons. Note: it is
 396   not good practice to change the contents of a popup button when it's
 397   already visible and the user has probably interacted with it.
 398 - fixed behaviour of "radio buttons"
 399 - WMInitializeApplication() must be the first function to be called in the
 400   program
 401 - removed applicationName, argc and argv arguments from the WMCreateScree...
 402   functions
 403 - WMReleaseColor(scr,color) changed to WMReleaseColor(color)
 404 - WMPaintColorRectangle() changed to WMPaintColorSwatch()
 405 - added various functions in font and color handling
 406 - added WMSetButtonFont()
 407 - changed WMCreateCommandButton() so that the buttons it creates will change
 408         their label when pushed
 409 - added WMGetSystemPixmap(WMScreen *scr, int image)
 410 - added partial I18N support
 411 - added libPropList requirement and some related utility functions
 412 - added a interface to prooplist, so that it works as a user defaults db
 413 - added WMWidthOfString() (removed WMFontWidthOfString())
 414 - added WMDrawString()
 415 - added WMSetTextFieldSecure(WMTextField *tPtr, Bool flag)
 416 - WMGetListItem() will dup the returned string
 417 - removed need for ProgName being defined
 418 - rewrote hashtable stuff and made it available for outside use
 419 - added notification functions, with view resize notification
 420 - added WMSetWindowMinSize() and MaxSize()
 421 - text editing notification
 422 - added WMSetListPosition() etc.
 423 - added WMInsertBrowserItem()
 424 - the above 2 functions return WMListItem*, instead of Bool
 425 - rewrote browser
 426 - WMGetListItem() will return WMListItem*
 427 - removed WMGetListItems() and WMSetListItems()
 428 - fixed focus stuff for multi-window apps
 429 - changed all WMList function names that contained index to row