TODO

   1 for 0.7.0:
   2
   3 * filed off the roughest edges (or, perhaps, at least hammered down the
   4         protruding rusty nails and snipped off the trailing razor wire,
   5         leaving some filing for later:-) from the monster
   6         EVAL/EVAL-WHEN/%COMPILE/DEFUN/DEFSTRUCT cleanup:
   7         ** made inlining DEFUN inside MACROLET work again
   8         ** bug 138
   9 * more renaming in global external names:
  10         ** reserved DO-FOO-style names for iteration macros
  11         ** finished s/FUNCTION/FUN/
  12         ** s/VARIABLE/VAR/
  13         ** perhaps s/DEF-FROB/DEF/ or s/DEF-FROB/DEFINE/
  14 * Perhaps rename "cold" stuff (e.g. SB-COLD and src/cold/) to "boot".
  15 * global style systematization:
  16         ** s/#'(lambda/(lambda/
  17 * pending patches and bug reports that go in (or else get handled
  18         somehow, rejected/logged/whatever) before 0.7.0:
  19         ** DIRECTORY problems (bug 139, CR patch sbcl-devel 2001-12-31)
  20 =======================================================================
  21 for early 0.7.x:
  22
  23 * patches postponed until after 0.7.0:
  24         ** Christophe Rhodes "rough patch to fix bug 106" 2001-10-28
  25         ** Alexey Dejneka "bug 111" 2001-12-30
  26 * building with CLISP (or explaining why not). This will likely involve
  27         a rearrangement of the build system so that it never renames
  28         the output from COMPILE-FILE, because CLISP's COMPILE-FILE
  29         outputs two (!) files and as far as I can tell LOAD uses both
  30         of them. Since I have other motivations for this rearrangement
  31         besides CLISPiosyncrasies, I'm reasonably motivated to do it.
  32 * urgent EVAL/EVAL-WHEN/%COMPILE/DEFUN/DEFSTRUCT cleanup:
  33         ** fixed bug 137
  34 * faster bootstrapping (both make.sh and slam.sh)
  35         ** added mechanisms for automatically finding dead code, and
  36                 used them to remove dead code
  37         ** moved stuff from warm init into cold init where possible
  38                 (so that slam.sh will run faster and also just because
  39                 ideally everything would be in cold init)
  40         ** profiled and tweaked
  41 * more EVAL/EVAL-WHEN/%COMPILE/DEFUN/DEFSTRUCT cleanup:
  42         ** made %COMPILE understand magicality of DEFUN FOO
  43                 w.r.t. e.g. preexisting inlineness of FOO
  44         ** used %COMPILE where COMPILE-TOP-LEVEL used to be used
  45         ** removed now-redundant COMPILE-TOP-LEVEL and
  46                 FUNCTIONAL-KIND=:TOP-LEVEL stuff from the compiler
  47         ** made FUNCTION-NAME logic work on closures, so that
  48                 various public functions like CL:PACKAGEP which
  49                 are now implemented as closures (because
  50                 they're structure slot accessors) won't be so
  51                 nasty in the debugger
  52         ** %SLOT-ACCESSOR/%SLOT-ACCESSOR stuff can probably go away,
  53                 since we inline expand all slot accessors into
  54                 %INSTANCE-REF and the optimizer knows all it needs
  55                 to know about that.
  56 * rewrote long-standing confusing error restarts for redefining
  57         DEFSTRUCTs
  58 * outstanding embarrassments
  59         ** cut-and-pasted DEF-BOOLEAN-ATTRIBUTE (maybe easier to fix
  60                 now that EVAL-WHEN does what it should..)
  61         ** incomplete manual
  62         ** :IGNORE-ERRORS-P cruft in stems-and-flags.lisp-expr
  63         ** weird double-loading (first in GENESIS, then in warm init)
  64                 of src/assembly/target/*.lisp stuff, and the associated
  65                 weirdness of the half-baked state (compiler almost but
  66                 not quite ready for prime time..) of the system after
  67                 cold init
  68 * fixups now feasible because of pre7 changes
  69         ** ANSIfied DECLAIM INLINE stuff (deprecating MAYBE-INLINE)
  70 * miscellaneous simple refactoring
  71         * belated renaming:
  72                 ** renamed %PRIMITIVE to %VOP
  73         * These days ANSI C has inline functions, so..
  74                 ** redid many cpp macros as inline functions:
  75                         HeaderValue, Pointerp, CEILING, ALIGNED_SIZE,
  76                         GET_FREE_POINTER, SET_FREE_POINTER,
  77                         GET_GC_TRIGGER, SET_GC_TRIGGER, GetBSP, SetBSP,
  78                         os_trunc_foo(), os_round_up_foo()
  79                 ** removed various avoid-evaluating-C-macro-arg-twice
  80                         cruft
  81 * added mechanisms for automatically finding dead symbols is
  82         package-data.lisp-expr (i.e. those symbols not bound,
  83         fbound, defined as types, or whatever), and used them
  84         to remove dead symbols
  85 * made system handle stack overflow safely unless SAFETY is dominated
  86         by SPEED or SPACE
  87 * Probably get rid of or at least rework the fdefinition/encapsulation
  88         system so that (SYMBOL-FUNCTION 'FOO) = (FDEFINITION 'FOO).
  89 =======================================================================
  90 for 0.9:
  91
  92 * refactored in preparation for moving CLOS into cold init and merging
  93         SB-PCL:FOO with CL:FOO (for FOO=CLASS, FOO=CLASS-OF, etc.)
  94         ** systematized support for MOP (new regression tests, maybe
  95                 new SB-MOP package..) to try to make sure things don't
  96                 get mislaid in the upcoming CLOS restructuring
  97         ** extracted type system from SB-KERNEL into new SB-TYPE
  98                 package
  99         ** reimplemented GENERIC-FUNCTION as a primitive object (or
 100                 maybe made SB-MOP:FUNCALLABLE-STANDARD-OBJECT the
 101                 primitive object, and then let GENERIC-FUNCTIONs
 102                 inherit from that) instead of structures with
 103                 :ALTERNATE-METACLASS and funcallableness. Now
 104                 FUNCALLABLE-INSTANCE can go away. (And now the new
 105                 funcallable primitive objects need to go into
 106                 collections like *FUN-HEADER-WIDETAGS* where
 107                 FUNCALLABLE-INSTANCE objects used to be.)
 108         ** reimplemented CONDITIONs as primitive objects instead of
 109                 structures with :ALTERNATE-METACLASS. Now (between
 110                 this and the change to GENERIC-FUNCTIONs)
 111                 DEFSTRUCT :ALTERNATE-METACLASS can go away.
 112         ** (maybe) Now INSTANCE_POINTER_LOWTAG can become just
 113                 STRUCTURE_POINTER_LOWTAG, and the concept of
 114                 SB-KERNEL:INSTANCE (including INSTANCEP,
 115                 (SPECIFIER-TYPE 'INSTANCE), etc.) can go away.
 116 * moved CLOS into cold init, in order to allow CLOS to be used in the
 117         implementation of the core system (e.g. the type system and the
 118         compiler) and in order to support merger of CL:CLASS with
 119         SB-PCL:CLASS
 120 * (maybe) eliminated warm init altogether in favor of cold init
 121 * (maybe, especially if warm init can be eliminated) rationalized
 122         the build process, fixing miscellaneous pre-0.5.0 stuff that's
 123         transparently not the right thing
 124         ** removed separate build directories, now just building in
 125                 place with .sbclcoldfasl extensions
 126 * (maybe) more refactoring in preparation for merging SB-PCL:FOO
 127         into CL:FOO: reimplemented type system OO dispatch
 128         (!DEFINE-TYPE-METHOD, etc.) in terms of CLOS OO dispatch
 129 * merged SB-PCL:FOO into CL:FOO (and similarly CLASS-OF, etc.)
 130 * added some automatic tests for basic binary compatibility, in hopes
 131         that it might be practical to maintain binary compatibility
 132         between minor maintenance releases on the stable branch (but no
 133         promises, sorry, since I've never tried to do this before, and
 134         have no idea how much of a pain this'll be)
 135 ========================================================================
 136 for 1.0 (fixes of lower priority which I'd nonetheless be embarrassed
 137 to leave unfixed in 1.0):
 138 * all too many BUGS entries and FIXMEs
 139 =======================================================================
 140 other priorities, no particular time:
 141
 142 * bug fixes, especially really annoying bugs (ANSI or not) and any
 143         ANSI bugs (i.e. not just bugs in extras like the debugger or
 144         "declarations are assertions", but violations of the standard)
 145 * better communication with the outside world (scratching WHN's
 146         personal itch): I don't want socket-level stuff so much as I
 147         want RPC-level or higher (CORBA?) interfaces and (possibly
 148         through RPC or CORBA) GUI support
 149 =======================================================================
 150 important but out of scope (for WHN, anyway: Patches from other people
 151 are still welcome!) until after 1.0:
 152         * DYNAMIC-EXTENT
 153         * sadly deteriorated support for ANSI-style block compilation
 154                 (static linking of DEFUNs within a single file or
 155                 WITH-COMPILATION-UNIT)
 156         * various GC issues (exuberant cut-and-paste coding,
 157                 possibly dangerously over-conservative handling
 158                 of neighbors of function objects, general GC efficiency)
 159         * package issues other than SB!TYPE, SB!MOP, and dead exported
 160                 symbols
 161         * Any systematic effort to fix compiler consistency checks is
 162                 out of scope. (However, it still might be possible to
 163                 determine that some or all of them are hopelessly stale
 164                 and delete them.)
 165 ===============================================================================
 166 other known issues with no particular target date:
 167
 168 bugs listed on the man page
 169
 170 hundreds of FIXME notes in the sources from WHN
 171
 172 various other unfinished business from CMU CL and before, marked with
 173   "XX" or "XXX" or "###" or "***" or "???" or "pfw" or "@@@@" or "zzzzz"
 174 or probably also other codes that I haven't noticed or have forgotten.
 175
 176 (Things marked as KLUDGE are in general things which are ugly or
 177 confusing, but that, for whatever reason, may stay that way
 178 indefinitely.)
 179 =======================================================================
 180 "There's nothing an agnostic can't do as long as he doesn't know
 181 whether he believes in anything or not."
 182   -- Monty Python.
 183
 184 "God grant me serenity to accept the code I cannot change, courage to
 185 change the code I can, and wisdom to know the difference."
 186   -- Erik Naggum
 187
 188 "Accumulation of half-understood design decisions eventually chokes a
 189 program as a water weed chokes a canal. By refactoring you can ensure
 190 that your full understanding of how the program should be designed is
 191 always reflected in the program. As a water weed quickly spreads its
 192 tendrils, partially understood design decisions quickly spread their
 193 effects throughout your program. No one or two or even ten individual
 194 actions will be enough to eradicate the problem."
 195   -- Martin Fowler, in _Refactoring: Improving the Design of Existing
 196      Code_, p. 360
 197
 198 "I wish I didn't know now what I didn't know then."
 199   -- Bob Seger