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