docs/todo30.txt

   1 Enhancements for wxWindows 3.0
   2 ==============================
   3
   4 This table contains the brief summary of the issues below. Priority and
   5 Difficulty are values from 1 to 10 with 1 being the least important/difficult
   6 and 10 the most.
   7
   8 Item                                                            Prio    Diff
   9 ----------------------------------------------------------------------------
  10 Namespaces                                                        8      6
  11 STLization                                                       10      8
  12 Making code exception-friendly                                    8      10
  13 Native RTTI                                                       7      7
  14 TRUE/true                                                         9      1
  15
  16
  17 C++ Features
  18 ============
  19
  20 - Namespaces:
  21     We want to have all wxWindows identifiers in "wx" namespace but provide
  22     typedefs/#defines for backwards compatibility. This can be done easily
  23     for the classes and the only real problem are the enums as they would
  24     all have to be duplicated at both the global scope (with "wx" prefix) and
  25     in wx namespace (without it)
  26
  27 - STLization
  28     This involves providing optional wxString implementation using std::string
  29     and doing the same for all our containers with the exception of wxHashMap
  30     which should simply be rewritten using templates (but keeping the old
  31     version for backwards compatibility -- ideally wx 3.0 would still be usable
  32     without templates, even if not all of its features would be available then)
  33
  34 - Exceptions
  35     We are not going to use exceptions in wxWindows itself but our code should
  36     become exception safe. This is a very difficult task as it means that no
  37     resource allocations (including memory, files, whatever) should be done
  38     without using a smart pointer-like object to store the result as it is the
  39     only way to prevent resource leaks in presence of exceptions
  40
  41 - Real RTTI
  42     Optionally use the real RTTI instead of wx emulation of it. Keep the
  43     current stuff for backwards compatibility.
  44
  45 - Complete replacing TRUE/FALSE with true/false
  46     Trivial
  47
  48
  49 Core
  50 ====
  51
  52 - use wxEventLoop in all builds
  53     wxApp and wxDialog should use wxEventLoop objects (the exact class can be
  54     customized by user code by overriding some wxApp::CreateEventLoop())
  55     instead of duplicating the same code
  56
  57 - remove wxCOMPATIBILITY (1.X)
  58     At least WXWIN_COMPATIBILITY and maybe WXWIN_COMPATIBILITY_2 code should be
  59     removed from the library. wxDEPRECATED() should be used with everything
  60     inside WXWIN_COMPATIBILITY_2_2. The stuff inside WXWIN_COMPATIBILITY_2_4
  61     probably should not be deprecated (yet?) because this would give thousands
  62     of warnings for the existing code.
  63
  64 - Modularization/Build System
  65     Candidates for components:
  66         +   contrib widgets (and maybe some of the ones currently in the core)
  67         +   wxHTML
  68         +   network stuff
  69         +   printing (?)
  70         +   ODBC classes
  71         +   ...
  72
  73 - Project File Generation
  74     We need a (GUI) tool to generate the project/makefiles for all supported
  75     platforms/compilers. Not sure if it should be used for the library itself
  76     (would be nice to have something like "make menuconfig" for Linux kernel
  77      which allows you to navigate easily amon all of the configure/setup.h
  78      options but there is a problem with distributing such tool as it can't be
  79      compiled by the user because it is needed before the library is built) but
  80     we definitely need it for the users makefiles.
  81
  82 - Properties/Member-Metadata, 2-Step Init with virtual create
  83     TODO: still unclear what do we need exactly
  84
  85 - Tidy code and add comments to headers (preferably in
  86   Doxygen/Javadoc style)
  87
  88
  89 Documentation
  90 =============
  91
  92 - The possibility of moving doc into header files with tool
  93   support.
  94 - Detailed review of doc accuracy.
  95 - wxDC : Precise definition of default/initial state.
  96 - wxDC : Pixelwise definition of operations (e.g. last point of a
  97   line not drawn).
  98 - Events:
  99     For all controls state clearly when calling a member function results in an
 100     event being generated and when it doesn't.
 101 - Update the coding standards guide
 102
 103
 104 wxEvents
 105 ========
 106
 107 - Change Idle Handling
 108     Current Implementation is using too many CPU cycles
 109
 110 - Loose Coupling Event-Source Event-Sink
 111     kind of the NextStep/C# very performant coupling, exposing events via
 112     Metadata
 113
 114 - Add Lazy Init of Eventtables
 115
 116
 117 Modules/Plugins
 118 ===============
 119
 120 Architecture
 121 ------------
 122
 123 We aim to arrive at a lazy initializiation of modules only when they are first
 124 needed. Dependency information between modules is needed. Dynamic Plug-In
 125 loading and unloading must be compatible with that.
 126
 127
 128 wxUniversal
 129 ===========
 130
 131 - Renderers within native ports.
 132
 133
 134 wxPrinting
 135 ==========
 136
 137 - Page preflighting capabilities in order to determine number
 138   of pages.
 139 - Preview UI enhancement.
 140
 141
 142 wxStaticBox
 143 ===========
 144
 145 Hide the platform problems (GTK: 'children' must be siblings) in encapsulation
 146 in order to avoid problems on ports where the hierarchy must be
 147 'correct'.
 148
 149
 150 Removal of old code
 151 ===================
 152
 153 In addition to wxCOMPATIBILITY code:
 154
 155 - wxProperty classes.
 156 - All wxCOMPATIBILITY (1.X) code.
 157 - contrib/src/canvas?
 158 - contrib/src/mmedia
 159 - contrib/src/applet?
 160 - Old wxODBC code
 161 - Dialog Editor
 162
 163 wxMiscellaneous
 164 ===============
 165
 166 - wxDC Support for point to char-position with text rendering
 167 - wxLocale Extension (eg Currency)
 168 - wxStreams review
 169 - wxURL?
 170 - a way to tell wxWindows to check for any non-portable usage,
 171   for a given set of platforms. Sometimes you want to be able
 172   to get away with non-portable usage, and sometimes not.
 173   This is probably way too time-consuming to implement.
 174 - In headers, don't silently omit contents if the features for this
 175   header is switched off. Instead, emit an error message.
 176 - Implement native tree view and colour dialog in wxGTK.
 177 - Better way to specify About, Preferences menu ids under wxMac.
 178 - Must be able to portably specify relaying out a frame after the toolbar
 179   has been destroyed or recreated. On wxMSW, this is done in
 180   ~wxToolBar. On wxGTK, in SetToolBar. In wxMac, not at all,
 181   but sending a wxSizeEvent will do it.
 182 - Need wxRect wxToolBar::GetToolRect(int id) or similar so we can
 183   align a popup menu with a toolbar button.
 184 - wxMac font selector dialog is the generic font selector -
 185   horrible.
 186 - No Append(wxArrayString&) for wxChoice and wxComboBox in wxGTK.
 187   Probably other functions too. Consider adding Insert to
 188   these classes, as per the patch on SF.
 189 - Rewrite wxFileHistory using wxString and wxArrayString, and
 190   put in separate file.
 191 - Add wxArrayString methods to wxTextValidator and any other
 192   class that needs them.
 193 - Add wxNotebook::GetTabRect or similar so we can estimate
 194   page size better in wxNotebookBase::CalcSizeFromPage.
 195 - Add function to clear all wxNotebook tabs without
 196   destroying the pages.
 197 - Add individual setters to wxScrollBar and other classes
 198   that use a combined setter.
 199 - Remove traces of old resource system from wxWizard.
 200 - Have wxDirCtrl as alias for wxGenericDirCtrl.
 201 - Allow instant reaction to left-up in a wxGrid cell
 202   (extend editor API) to work around bad checkbox
 203   behaviour (click, click, click, click away...) and
 204   reduce checkbox size on non-Windows platforms.
 205 - Add wxNotebook::HitTest for non-Windows platforms.
 206 - Implement rebar for all platforms. This will help us
 207   get closer to native look and feel, e.g. the gradient
 208   shadow on XP toolbars.
 209
 210 Version:      $Id$