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