WINGs/ChangeLog

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