path: root/TODO

For 1.2.0 release:
-	remove deprecated functions from *.[hc] files.
-	finish composite child stuff.
-	implement constructor functionality for all widgets.
-	fix enum generation code which still puts out
	GTK_TYPE_C_TREE_POS instead of GTK_TYPE_CTREE_POS
	
Bugs:
 * Change bitfields to guints from enums, or vice versa?

 * MappingNotify events produce warnings.

 * the type system (gtktypeutils.c) has to handle creations of fundamental
   types seperatedly from derived types, so we don't screw foreign
   fundamental types with an already extensively increased seqno.
 
 * A filter function which destroys the GDK window it is filtering
   events on is bad news.

Additions:
 * focus handling for GtkOptionMenu (needs the previous)

 * implement gtk_default_draw_oval and other missing things in gtkstyle.c.
 
 * Lists should scroll to center the recently selected item if it isn't
   visible.

 * enforce invariants on *_RESIZE* and *_REDRAW* flags.

 * GtkToolTips:
   allocate GtkTooltipsData from memchunks
   look into incorporation of outdated/gtk-dairiki-971208-[01].patch.gz
                          
 * Make all widget attributes configurable after the widget is created (timj).
 
 * Widgets dervied from GtkButton need to be able to override
   GtkButtonClass.paint. e.g. redrawing of GtkToggleButton with CAN_DEFAULT
   is messed up otheriwse. This does in fact not only apply to (toggle)buttons,
   we should introduce a common paint member for the GtkWidgetClass.
 
 * Radio buttons need to display CAN/HAS_DEFAULT correctly.

 * Seperate GtkObject, type and signaling system from Gdk dependancies,
   by moving them into a seperate libgtkobj.
 * move *_input_add (wrappers for select(2)) mechanism into glib.

 * gdk_expose_compress: ala-Xt, this would really help for opaque moves and
   such

 * Entry should have a password mode (and it should show stars
   for user feedback).

 * Entry should allow set_usize to work better, and should compute
   a different width when a maximum length is used.

 * More dialogs: Print, GtkFontSelector, maybe others...

 * make the gtk_main callbacks consistent in their add/remove behaviour.
 
 * More work on Documentation

 * Check return values on all calls to XIC[Get/Set]Values

 * Rewrite the interface to the i18n stuff so GTK widgets don't need to
   retrieve X values, and so they don't have to know the value of the
   XNxxx character constants.

 * The "--geometry" option should be supported

  - Having gdk_init() parse the geometry option. (putting it into
    GDK means you can use XParseGeometry() without wrapping it)

  - Add a call gdk_get_geometry() that retrieves the results 
    in a form like that returned by XParseGeometry()

  - The application then can modify the results (as would gemvt)
    then call a routine gtk_window_set_geometry() on whatever
    it considers to be its main window.

  - Then in some manner GtkWindow takes that into account when
    setting its hints. (Probably it uses the size and position
    as the current uposition and usize, and modulates that
    be the equivalents of the X flags

     XValue, YValue, WidthValue, HeightValue, XNegative, or YNegative

    ( You'd have to extend gdk_window_set_hints to accept the
      window gravity option to get it right. )

 ? Allow moving the separator for paned widgets by dragging 
   it directly instead of using the handle. 

 ? Mark public use of gtk_tree_remove_item as deprecated - it should be used
   as:
         gtk_container_remove (GTK_CONTAINER(tree), widget);

 * Standardize that all strings should be passed as gchar *, not 
   guchar *. But what about non-string data? (gdk_property_change,
   gtk_selection_data_set) X makes these sort of things guchar...

 * Check into XAddConnectionWatch - is this needed for XIM?

 * Places where a _full variant is needed:

    gtk_clist_set_row_data
    gtk_init_add
    gtk_menu_popup
    gtk_toolbar_prepend_element
    gtk_toolbar_insert_element
    gtk_widget_dnd_data_set (should be guchar * with a copy?
                             shouldn't be there at all...)
 
 * gtk_rc_add_[name/class]_style are broken for bg pixmaps, because
   styles are broken for bg pixmaps, and RC styles only hack around
   that.

 * Try to rationally deal with someone else deleting one of our
   windows??? This would mean keeping track of our window heirarchy
   ourselves, for one thing, and will never be safe, because of
   race conditions.

 * If a window spontaneously resizes itself N times before any
   ConfigureNotify events are received, then due to the interaction
   of the ConfigureNotify compression code in GDK and the resize
   count used for the window, the window will be size_allocated
   the next N-1 times it is moved.

   Fix: Only send GDK_EVENT_CONFIGURE when the window is resized,
   create a new event type for toplevel motion. (GDK_EVENT_REPOSITION?)
   and eliminate the resize count in GtkWindow.

 * Generic ScrolledWindow interface, which provide automatic scrollbar
   capability to Viewport, Text, and CList widgets.

 * GTK_POLICY_NEVER for scrolled windows.

 * Consider caching more state in GdkWindowPrivate. Currently, 
   every widget realization involves a XGetGeometry and a
   XGetWindowAttributes. And every GdkWindow destruction
   involves a XQueryTree.

 * Should all the default handlers really return FALSE? This can
   cause confusing presses to be sent to containers that actually
   want to get events on themselves.

Text/Edit widget:

  Bugs:

  - Really big font (150 pt), plus lots of editing caused segfault

  Improvements:

  - Unify the key binding support in some fashion between the
    Entry and Text widget widgets (???)

  - Figure out a way not to recompute the geometry on insertions/deletions
    which are large, but not a significant fraction of the
    entire text. (e.g., compute the changes as when the widget
    is not frozen, but without the actual scrolling)

  - Prune the line start cache. But since it is only 68 bytes
    per line, and it is a lot faster when lines are in the cache,
    it may be better not to, at least for now.

  - Show the non-editable state by changing colors. (Use the
    style entries for insensitive?)

  - Multibyte support for the Text widget.

  - Unicode support to do the multi-byte right.

  - Support an .inputrc. (The readline one doesn't really work,
    unless it is extended because it can't represent X keysyms,
    just terminal type input)

  - A vi mode

  - Word wrap, instead of line folding. (Should the continuation
    characters be shown?)

  - Horizontal scrolling

  - Disable pasting compound text

  - When showing background pixmap (not editable) actually set
    the background pixmap as the windows bg pixmap, to improve
    appearance on exposes. But this would require using another
    window to get the origins.

  - In word wrap mode, break:

     aaaaaaaaaaa bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb

     as:
                            | Maximum column
     aaaaaaaaaaa bbbbbbbbbbb|
     bbbbbbbbbbbbbbbbbbbbbbb|
     bbbbbbbbb              |

     Instead of:
                            | 
     aaaaaaaaaaa            |
     bbbbbbbbbbbbbbbbbbbbbbb|
     bbbbbbbbbbbbbbbbbbbb   |

  - Blinking cursor

  - API's : gtk_text_clear, gtk_text_delete_lines (gint start, gint end),
    gtk_text_append/prepend, gtk_text_insert_at (gint row, gint column),
    some function to get the row/column from the x/y-coordinates of a 
    mouse click, some function to get the word/line under the mouse pointer 
    [ From: Stefan Jeske <jeske@braunschweig.netsurf.de> ]

  - "changed" emitted when doing deletes on empty Text widget.

  - Delete IC in editable->unrealize, not editable->finalize?

Themes
======

 - When a scale gets shown/hidden only queue a redraw on the
   non-window portion, not the whole area.

 - In various places, to avoid shaping windows excessively,
   we set parent relative backgrounds. This is an ugly
   hack and needs a better solution. Plus, I don't think
   these parent-relative backgrounds always persist to
   when they are actually needed.

   Such calls exist in: GtkButton, GtkHandeBox, GtkItem,
   GtkListItem, GtkMenu, GtkMenuItem, GtkMisc, 
   GtkNoteBook, GtkOptionMenu, GtkPaned, GtkPreview,
   GtkSpinButton and GtkTreeItem.

 - For menus and for GtkWindow's, the realize() function
   calls paint(), so that background pixmaps can be set
   ahead of time, and prevent flashing when the window is
   shown. This is an ugly hack and needs a better solution.

=======

Calendar Widget:

 - The widget should be nicely resizeable vertical too.

 - CALENDAR_MARGIN should be removed, uses INNER_BORDER and
   style->class->[xy]thickness insted.

 - Flag to choose between using standard three letter abbreviated
   weekday name or just the first character from it. It looks like
   that is what most other calendar-widgets do.

 - Arrows should resize with the header-font.

 - The keyboard support has to be finished.

DND
===

 - Use a cursor instead of an ICON when over Motif windows,
   to get rid of the current junk that Motif leaves because
   of it's XCopyArea stupidity for doing highlighting.

 - Add a GTK_DRAG_VERIFY target flag and a "drag_data_verify"   
   signal so that apps can easily check if a, say, 
   text/uri-list URL looks OK during the drop.

 - Check more for memory leaks.

 - Drag and drop for Entry and Text widgets.

 - Send synthetic motion events on structure changes so 
   drag_enter/leave get sent properly. (See the popup
   in testdnd)