[~andy/gtk] / TODO.xml

<!-- This is used to generate the online TODO list for GTK+ using
     the script docs/make-todo. Whenever a change to this file is
     committed to CVS,the file is run through make-todo and the online
     version updated. If you modify this file, you should check for
     parse errors by running:

     $ docs/make-todo TODO.xml > /dev/null

     before committing, or you may screw up the online version --> 
<todo logourl="gtk-logo-rgb.gif">
  <title>GTK+ TODO list</title>
  <section>
    <title>GDK</title>
    
    <entry size="medium" status="90%" target="2.0">
      <title>Add backing store support</title>
      <description>
        <p>
          GTK+'s drawing model involves clearing to a background, and
          then drawing widgets on top of this. Without having
          backing-store support, this results in flickering in various
          situations. Backing store cannot be added widget-by-widget,
          because the drawing in a particular window is not confined
          to a single widget. Instead it needs to be added per GDK
          window. 
        </p>
        <p>
          The way this is done is by having
          <tt>gdk_window_begin_paint()</tt>
          and <tt>gdk_window_end_paint()</tt> functions that
          redirect all drawing to a particular window to an offscreen
          pixmap, and then copy that offscreen pixmap back onto the
          screen when the paint operation is done. The implementation
          of this is mostly complete in the <tt>gtk-no-flicker</tt> branch of
          GTK+.
        </p>
      </description>
      <url>http://www.gtk.org/~otaylor/gtk/1.4/gdk-drawing.html</url>
      <contact>Owen Taylor &lt;otaylor@redhat.com&gt;</contact>
    </entry>

    <entry size="medium" status="90%" target="2.0">
      <title>32 Bit Coordinates</title>
      <description>
        <p>
          GTK+-1.2 and earlier share X's limitation on the
          size of coordinates and restrict all dimensions
          to 16 bit quantities. By clever use of X it is
          possible to lift this restriction and present a
          full 32-bit space to the user.
        </p>
        <p>
          There are some difficulties with performance in this
          approach - mostly because scrolling can involve mapping and
          unmapping lots of widgets, but in general, current
          trials in this area seem to work pretty well.  
        </p>
      </description>
      <url>http://www.gtk.org/~otaylor/gtk/1.4/gdk-drawing.html</url>
      <contact>Owen Taylor &lt;otaylor@redhat.com&gt;</contact>
    </entry>

    <entry size="small" status="0%" target="2.0">
      <title>Customizable double-click timeout</title>
      <description>
        <p>
          The current fixed double-click timeout in GTK+
          is too small for some users. This needs to be
          customizable
        </p>
      </description>
      <contact>gtk-devel-list@gnome.org</contact>
      <bugs>#3958</bugs>
    </entry>

    <entry size="small" status="0%" target="2.0">
      <title>Make color handling more convenient</title>
      <description>
        <p>
          Add some color convenience functions; such as a way to get an
          allocated GdkColor from GdkRGB, and export functions from gtkstyle.c
          that lighten/darken a given color, and set a color from HSV in
          addition to RGB. Also, consider having static variables that contain
          preallocated common colors (gdk_blue, gdk_red, etc.), the problem
          being colormap issues.
        </p>
      </description>
      <contact>gtk-devel-list@gnome.org</contact>
    </entry>

    <entry size="small" status="0%" target="2.0">
      <title>Cursors</title>
      <description>
        <p>
          Two tasks: 1) move the cursors in the cursor font that people actually
          care about to the top of the gdkcursor.h header file, and put a nice
          list of the 15 cursors people actually care about in the docs 2) if
          the cursor font lacks some commonly-useful cursors (like magnifying
          glass), add these cursors to gdkcursor.h and then emulate them in
          gdk_cursor_new by transparently creating the cursor from a bitmap.
          The list of Qt cursors is worth http://doc.trolltech.com/qcursor.html
          looking at for this task.
        </p>
      </description>
      <contact>gtk-devel-list@gnome.org</contact>
    </entry>

    <entry size="medium" status="100%" target="2.0">
      <title>Make GdkRGB work on any visual</title>
      <description>
        <p>
          GdkRGB should be able to render to an arbitrary visual
          (i.e. the visual shouldn't be fixed at gdk_rgb_init() 
          time). This will break gdk_rgb_gc_set_foreground() and 
          friends, though.
        </p>
      </description>
      <contact>gtk-devel-list@gnome.org</contact>
    </entry>

  </section> <!-- GDK -->

  <section>
    <title>Internationalization</title>
    
    <entry size="big" status="90%" target="2.0">
      <title>Integrate Pango</title>
      <description>
        <p>
          The purpose of the Pango project is to provide a system for
          layout and rendering of internationalized text. It handles
          most of the issues necessary to 
        </p>
      </description>
      <url>http://www.pango.org</url>
      <contact>gtk-i18n-list@redhat.com</contact>
    </entry>

    <entry size="medium" status="90%" target="2.0">
      <title>Switch to using UTF-8</title>
      <description>
        <p>
          This is closely related to Pango integration. Pango deals
          with all strings in terms of UTF-8; by switching GTK+ over
          to UTF-8 we make it considerably simpler for developers to
          support multiple languages properly while still retaining
          a large degree of compatibility with existing programs.
        </p>
        <p>
          Some work has already been done on this as part of the Win32
          port, since the Win32 port is currently using UTF-8 for all
          strings. In general, this should be an easy job; the hardest
          parts are places like GtkFileSelection, cut and paste, and
          input method support where there is interaction between GTK+
          and the operating system.
        </p>
      </description>
      <contact>gtk-i18n-list@redhat.com</contact>
    </entry>

    <entry size="big" status="60%" target="2.0">
      <title>Rewrite Input Method Support</title>
      <description>
        <p>
          Support for Input Methods is GTK+-1.2 is done via XIM, with
          supported styles being over-the-spot and the root-window
          styles. However, the over-the-spot style is not going to
          work well with the Pango integration, since it relies on the
          text rendering in the program being done in the standard
          Xlib style, so it will be necessary to also support
          on-the-spot input. On-the-spot input is done by supplying a
          set of callbacks that are invoked by the input methods.
        </p>
        <p>
          GTK+-2.0 will have a new system with loadable input method
          modules. These modules can either be implemented using XIM,
          or written from scratch.
        </p>
      </description>
      <contact>gtk-i18n-list@redhat.com</contact>
    </entry>
  </section> <!-- i18n -->

  <section>
    <title>GTK+ Core</title>

    <entry size="big" status="60%" target="2.0">
      <title>GLib based object and type system</title>
      <description>
        <p>
          The GTK+ object system is already in use in quite a few different
          non-GUI applications; it would be desirable for these uses
          to have the object and type systems separated from the GUI portions
          of GTK+ and be generalized for non-GUI usage.
        </p>
      </description>
      <contact>Tim Janik &lt;timj@gtk.org&gt;</contact>
    </entry>

    <entry size="big" status="1%" target="2.0">
      <title>Overall callback improvements</title>
      <description>
        <p>
          The GTK+ type and signal systems need significant improvements to
          allow signal creation with default handlers from language bindings
          and to aid language bindings in deriving new objects.
          One aspect of this is the Closure support, recently suggested by
          Karl Nelson &lt;kenelson@ece.ucdavis.edu&gt;, but this also
          requires a GLib based type and parameter system (ties in with
          "GLib based object and type system").
        </p>
      </description>
      <contact>gtk-devel-list@gnome.org</contact>
    </entry>

    <entry size="big" status="0%" target="2.0">
      <title>State change notification</title>
      <description>
        <p>
          GTK+ objects emit various types of signals, some to perform
          arbitrary actions, some to allow customization from user code,
          and some signals are emitted to notify of certain changes
          of an object. For the latter, what really is required is a
          gneneric signal that can be used to monitor *any* kind of object
          changes. For that, all object changes need to be routed through
          a central point (otherwise the signal emissions are spread all
          over the object implementation), i.e. an object argument setter.
          The state change notification signal doesn't need to be emitted
          syncronously, in fact, it's probably most effective to always
          emit this asynchronously, so subsequent changes are accumulated.
        </p>
      </description>
      <contact>Tim Janik &lt;timj@gtk.org&gt;</contact>
    </entry>

    <entry size="big" status="5%" target="2.0">
      <title>Widget as sensitivity/grab state machine</title>
      <description>
        <p>
          Maintenance of pointer and keybnoard grabs is currently very
          tedious and error-prone, most widget's cook up their own stuff
          in this regard.
          By moving the general concept of "Grabs" to the GTK+ level as
          a widget state, and providing a new signal for alterations of
          a widget's state ("visible", "visible+insensitive",
          "visible+grab", "hidden", "hidden+insensitive", etc.), things
          can be unified and more stabelize. A couple of bugs, such as
          insensitive widgets still holding a grab, or buttons that
          still think they are depressed when hidden, will be squeezed
          automatically with that.
        </p>
      </description>
      <contact>Tim Janik &lt;timj@gtk.org&gt;</contact>
    </entry>

    <entry size="big" status="0%" target="2.0">
      <title>Allow argument customization</title>
      <description>
        <p>
          Many types of object arguments (expander style in the CList,
          default padding in button boxes, etc), conceptually go with
          the theme, or as user preferences; they should not be set by
          a particular program.
        </p>
        <p>
          There needs to be a mechanism for themes to be able to
          control these arguments from the RC file. 
        </p>
      </description>
    </entry>

    <entry size="medium" status="0%" target="2.0">
      <title>Allow global customization</title>
      <description>
        <p>
          There are a number of global parameters in GTK+ and GDK that should be
          customizable by the user, such as the double-click timeout,
          or whether widgets should be backing-stored by default. 
        </p>
        <p>
          If we had argument customization from an RC file, it might
          be possible to do this simply with a global object with
          arguments for the various global parameters that was
          customized in the same fashion as object arguments.
        </p>
      </description>
    </entry>

    <entry size="small" status="0%" target="2.0">
      <title>Gtk+ Modules installation directory</title>
      <description>
        <p>
          Gtk+ needs to support an extra lib/ directory, to search
          for dynamically loadable modules, it also needs to support
          an environment variable to specify module search paths.
          This has quite some cross-platform issues with the GModule
          code (especially on AIX).
        </p>
      </description>
      <contact>gtk-devel-list@gnome.org</contact>
    </entry>


    <entry size="small" status="20%" target="2.0">
      <title>Convenient widget setup</title>
      <description>
        <p>
          Make it simpler to set all the basic attributes of a widget.  Might
          want set_tooltip(), set_accel(), set_color(FOREGROUND, color),
          set_min_size() (usize does this, but needs a rename), set_whatsthis(),
          etc. set_accel() may not work for all widgets, may need a convenience
          API for button and label accelerators specifically.
        </p>
        <p>
          The idea is that it should be easy, out of the box, to set up a widget
          with all the nice touches and features the widget really should
          have. Users shouldn't need to do their own convenience functions for
          this.
        </p>

      </description>
      <contact>gtk-devel-list@gnome.org</contact>
    </entry>

    <entry size="medium" status="0%" target="> 2.0">
      <title>Make selections/clipboard more convenient</title>
      <description>
        <p>
          Make GtkSelectionData more like the MIME blobs in Swing and Qt.
          Consider a GtkClipboard object to simplify cut-and-paste handling.
        </p>
      </description>
      <contact>gtk-devel-list@gnome.org</contact>
    </entry>


    <entry size="small" status="80%" target="2.0">
      <title>Stock label/icon system</title>
      <description>
        <p>
          A system like GnomeStock for getting a standard labels/icons 
          for menus and toolbars. Should be extensible by themes, and 
          by libgnomeui. Some work already done on this.
        </p>
      </description>
      <contact>hp@redhat.com</contact>
    </entry>


    <entry size="big" status="0%" target="> 2.0">
      <title>Session Management</title>
      <description>
        <p>
          Look in to session management. Consider whether to use 
          X11R6 SM, or some custom spec shared with KDE. Create
          GTK+ API for this.
        </p>
      </description>
      <contact>gtk-devel-list@gnome.org</contact>
    </entry>

    <entry size="big" status="0%" target="> 2.0">
      <title>Online help enhancements</title>
      <description>
        <p>
          Look at a small "What's This" popup widget, 
          and a What's This system in general (this part 
          could maybe be done for 2.0). A more difficult, probably 
          a post-2.0 task, is to integrate a very simple little
          help browser gizmo into GTK.
        </p>
      </description>
      <contact>gtk-devel-list@gnome.org</contact>
    </entry>


    <entry size="medium" status="0%" target="2.0">
      <title>GUI-editable means of user configuration</title>
      <description>
        <p>
          Need to be able to set double click time, whether cursors
          blink, etc., from a control panel type of deal.
        </p>
      </description>
      <contact>gtk-devel-list@gnome.org</contact>
    </entry>

  </section> <!-- Core -->

  <section>
    <title>GTK+ Widgets</title>

    <entry size="small" status="100%" target="2.0">
      <title>Make GtkFrame use a label</title>
      <description>
        <p>
          The title of a frame should simply be another child widget
          which, by default, holds a label widget. This will important
          with Pango where proper text behavior will be more complex to
          implement, but is also useful for certain user-interface
          designs. (It can be useful, for example, to put a checkbutton
          in that slot.)
        </p>
      </description>
      <contact>gtk-devel-list@gnome.org</contact>
    </entry>

    <entry size="big" status="90%" target="2.0">
      <title>Replace GtkText Widget</title>
      <description>
        <p>
          The GtkText widget is badly in need of replacement, since it
          is buggy and insufficiently feature rich. This is being done
          using Havoc Pennington's port of the Tk Text widget.
        </p>
        <p>
          As part of this job <a href="http://www.pango.org">Pango</a>
          support is being added to the replacement. The structure of
          the Tk text widget port is suited to this as it works
          paragraph-by-paragraph, and Pango works at a sub-paragraph
          scale. The main remaining tasks here are to implement
          incremental reflow to make performance acceptable and to
          implement embedded pixmaps and widgets.
        </p>
      </description>
      <contact>gtk-devel-list@gnome.org</contact>
    </entry>

    <entry size="small" status="20%" target="2.0">
      <title>Improve Radio/Checkbutton Look</title>
      <description>
        <p>
          The default look for the radio and checkbuttons is both
          unattractive and not friendly to the user . Motif did not
          get this one right, and we should not keep on following the
          Motif look. The right thing here is probably to copy the
          Windows appearance for these controls fairly closely. This
          will fit in with well with the rest of the GTK+ look.
        </p>
      </description>
      <contact>gtk-devel-list@gnome.org</contact>
    </entry>

    <entry size="small" status="99%" target="2.0">
      <title>Improve Submenu Navigation</title>
      <description>
        <p>
          Navigating through a deep menu tree in GTK+ is currently
          quite tricky, because as soon as one leaves a menu item,
          the submenu disappears. The way that the Macintosh is
          reputed to handle this is that to pop down the current
          submenu, you have to leave the triangle defined by the
          upper left hand corner of the menu item and right
          side of the submenu.
        </p>
      </description>
      <contact>gtk-devel-list@gnome.org</contact>
    </entry>

    <entry size="small" status="0%" target="2.0 ?">
      <title>Improve Spinbutton Look</title>
      <description>
        <p>
          Spinbuttons currently appear to have lumpy boundaries,
          because sides of the arrows aren't at an angle that
          meshes well with the pixel grid. However, fixing this
          would require making the spinbuttons narrower and
          harder to hit. This points out a general problem with
          the spinbutton (and the arrows on the scrollbars) - the
          target area for clicks actually the bounding box of the
          arrows, but the user thinks that they must click on the
          arrows themselves. It would probably be more friendly
          to use a square button with an arrow drawn on top instead
          of a arrow-shaped button, the approach taken by most other
          windowing systems.
        </p>
      </description>
      <contact>gtk-devel-list@gnome.org</contact>
    </entry>

    <entry size="big" status="90%" target="2.0">
      <title>Supply horizontable/vertical wrapping boxes</title>
      <description>
        <p>
          An often requested feature are wrapping containers, at this
          point, gimp's development version already uses such widgets:
          horizontable/vertical wrap boxes, that need to go into 2.0
          proper at some point.
        </p>
      </description>
      <contact>Tim Janik &lt;timj@gtk.org&gt;</contact>
    </entry>

    <entry size="medium" status="90%" target="2.0">
      <title>Improved generic combo support</title>
      <description>
        <p>
          Gtk+'s combo box has several drawbacks in design and
          implementation. An new attempt at providing the combo box
          functionality with improved flexibility has been made with
          the GtkClueHunter widget, sitting in the CVS module "gle".
        </p>
      </description>
      <contact>Tim Janik &lt;timj@gtk.org&gt;</contact>
    </entry>

    <entry size="big" status="40%" target="2.0?">
      <title>Add unified set of List/Tree/Grid widgets</title>
      <description>
        <p>
          Currently, GTK+ has a large number of list and tree widgets
          (GtkList, GtkTree, GtkCList, GtkCTree), none of which are
          ideal. The GtkList and GtkTree widgets perform badly on large
          number of items. (GtkTree widget is also quite buggy.) GtkCList
          and GtkCTree mostly solve the size problem, but are quite
          complex and, despite that, not very flexible. They are limited to
          displaying pixmaps and text, and can neither support arbitrary
          widgets nor custom drawing functions.
        </p>
        <p>
          In addition to list and tree widgets, a closely related need
          is a sheet widget that displays a (possibly editable) 2-D grid.
          It would be desirable to have a complete set of widgets that
          could be presented as the one-true-solution for these needs.
          Model/View techniques could be used effectively to increase
          both the simplicity and power of the interfaces.
        </p>
      </description>
      <contact>gtk-devel-list@gnome.org</contact>
    </entry>

    <entry size="small" status="0%" target="2.0">
      <title>GtkImage</title>
      <description>
        <p>
          gdk-pixbuf is moving to become a GTK+ dependency, a new image-display
          widget is thus needed.
        </p>
      </description>
      <contact>hp@redhat.com</contact>
    </entry>

    <entry size="small" status="0%" target="2.0">
      <title>Attempt to fix GtkStatusbar</title>
      <description>
        <p>
          GtkStatusbar is too inconvenient to use.
          The only non-breakage-inducing fix we could
          come up with is to permit 0 as a context ID, so you
          don't have to use gtk_statusbar_get_context_id().
        </p>
      </description>
      <contact>gtk-devel-list@gnome.org</contact>
    </entry>
    
    <entry size="small" status="95%" target="2.0">
      <title>Decruft GtkProgress, GtkProgressbar</title>
      <description>
        <p>UPDATE: this is done, just need to apply the patch.
        </p>
        
        <p>
          This interface is just a disaster of overcomplexity;
          it should pretty much just be set_percentage(), 
          pulse() (to move during activity mode), and set_text().
          There's no reason that there are two objects, should 
          just be one interface. Almost all the functions
          that currently exist should be deprecated.
        </p>
      </description>
      <contact>hp@redhat.com</contact>
    </entry>

    <entry size="small" status="0%" target="2.0">
      <title>Entry validation hooks</title>
      <description>
        <p>
          Simple hooks for validation in a GtkEntry.  Pretty much just a
          "validate" callback which takes a string (current entry contents) and
          returns either VALID, INVALID, or COULDBEVALID. Then the 
          GtkEntry calls this function if it's set, and does the appropriate 
          UI things. GTK should come with validators for int and float,
          see GtkSpinButton where these are already implemented.
        </p>
      </description>
      <contact>gtk-devel-list@gnome.org</contact>
    </entry>

    <entry size="big" status="0%" target="> 2.0">
      <title>pseudo-MDI Widget</title>
      <description>
        <p>
          Add a widget that lets you rearrange various views (similar to many
          IDEs, like Visual SlickEdit or JBuilder). Basically there should be a
          central slot and 4 slots around the sides; each slot holds one or more
          views. If two views are dropped in the same slot, then a notebook is
          created displaying both views. If a view is dropped outside the
          application window, it becomes a standalone window. It should be
          possible to restrict whether a view can be dropped on the sides,
          horizontal/vertical sides only, in the central content area, or in
          any of those places.
        </p>
        <p>
          (Havoc has a proposed interface for this, mail hp@redhat.com)
        </p>
      </description>
      <contact>gtk-devel-list@gnome.org</contact>
    </entry>

    <entry size="medium" status="0%" target="> 2.0">
      <title>Icon List Widget</title>
      <description>
        <p>
          A simple icon list widget, suitable for creating a file selector or
          the like.
        </p>
      </description>
      <contact>gtk-devel-list@gnome.org</contact>
    </entry>

    <entry size="medium" status="0%" target="> 2.0">
      <title>Dock widget</title>
      <description>
        <p>
          Add a widget like GnomeDock (perhaps based on GnomeDock)
          that allows people to put rearrangeable toolbars, menubars, etc. 
          around a central content area. The widget should have hooks for 
          saving the current positions of the various docked bars.
        </p>
      </description>
      <contact>gtk-devel-list@gnome.org</contact>
    </entry>

    <entry size="big" status="0%" target="> 2.0">
      <title>Canvas widget</title>
      <description>
        <p>
          Figure out how to get GnomeCanvas or a derived work into GTK+ itself.
        </p>
      </description>
      <contact>gtk-devel-list@gnome.org</contact>
    </entry>

    <entry size="medium" status="57%" target="2.0">
      <title>Menu scroll</title>
      <description>
        <p>
          When menus are bigger than the screen, allow scrolling
          as on the Mac.
        </p>
      </description>
      <contact>gtk-devel-list@gnome.org</contact>
    </entry>

    <entry size="medium" status="20%" target="2.0">
      <title>Toolbar/menubar wrap</title>
      <description>
        <p>
          When toolbars and menubars are too wide, do some sort of 
          wrapping or drop-down deal. (See Windows/Mac apps for examples.)
        </p>
      </description>
      <contact>gtk-devel-list@gnome.org</contact>
    </entry>

    <entry size="small" status="0%" target="2.0">
      <title>Blink cursor in GtkEntry</title>
      <description>
        <p>
          Make the cursor optionally blink in GtkEntry. Beware, the entry code
          is somewhat in flux; mail Owen and ask.
        </p>
      </description>
      <contact>otaylor@redhat.com</contact>
    </entry>

    <entry size="small" status="100%" target="2.0">
      <title>Don't highlight first menu item when menus come up</title>
      <description>
        <p>
          Keep GtkMenu from prelighting the first menu item.
        </p>
      </description>
      <contact>gtk-devel-list@gnome.org</contact>
    </entry>

    <entry size="small" status="100%" target="2.0">
      <title>Integrate new color selector</title>
      <description>
        <p>
          There's a new color selector in CVS (module gnome-colorsel),
          it needs to be folded in to GTK and any remaining issues resolved.
          (This new selector is API-compatible with the old one, and 
          still called GtkColorSelector).
        </p>
      </description>
      <contact>gtk-devel-list@gnome.org</contact>
    </entry>

    <entry size="medium" status="70%" target="2.0">
      <title>Write new font selector</title>
      <description>
        <p>
          Pango introduces a new font handling system,
          replacing the XLFD system. Need a font selector for this.
          The XLFD selector should probably remain, for apps where
          it makes sense (like gnome-terminal probably).
        </p>
      </description>
      <contact>gtk-devel-list@gnome.org</contact>
    </entry>

    <entry size="small" status="0%" target="2.0">
      <title>Stack Widget</title>
      <description>
        <p>
          Jonathan has a widget like a tabless/frameless notebook, used for
          something like the GNOME control center where you want to toggle which
          widget is visible to the user. Needs to be cleaned up and considered
          for GTK.
        </p>
      </description>
      <contact>gtk-devel-list@gnome.org, jrb@redhat.com</contact>
    </entry>

    <entry size="small" status="0%" target="2.0">
      <title>Clean up GtkNotebook</title>
      <description>
        <p>
          GtkNotebook currently breaks GTK invariants about
          mapping/visibility/etc., needs fixing.
        </p>
      </description>
      <contact>gtk-devel-list@gnome.org</contact>
    </entry>

  </section> <!-- GTK+ -->
</todo>