TODO

   1 for early 0.8.x:
   2
   3 * test file reworking
   4         ** non-x86 ports now pass irrat.pure.lisp
   5         ** ports with less than 256Mb of heap (sparc, ppc and mips)
   6                 now don't fail bit-vector.impure-cload.lisp
   7 * faster bootstrapping (both make.sh and slam.sh)
   8         ** added mechanisms for automatically finding dead code, and
   9                 used them to remove dead code
  10         ** moved stuff from warm init into cold init where possible
  11                 (so that slam.sh will run faster and also just because
  12                 ideally everything would be in cold init)
  13         ** profiled and tweaked
  14 * fixed (TRACE :REPORT PROFILE ...) interface to profiling
  15 * more EVAL/EVAL-WHEN/%COMPILE/DEFUN/DEFSTRUCT cleanup:
  16         ** made %COMPILE understand magicality of DEFUN FOO
  17                 w.r.t. e.g. preexisting inlineness of FOO
  18         ** used %COMPILE where COMPILE-TOP-LEVEL used to be used
  19         ** removed now-redundant COMPILE-TOP-LEVEL and
  20                 FUNCTIONAL-KIND=:TOP-LEVEL stuff from the compiler
  21         ** (ideally, but perhaps too hard, given what I've discovered
  22                 about the godawful internals of function debug names):
  23                 made FUNCTION-NAME logic work on closures, so that
  24                 various public functions like CL:PACKAGEP which
  25                 are now implemented as closures (because
  26                 they're structure slot accessors) won't be so
  27                 nasty in the debugger
  28 * outstanding embarrassments
  29         ** :IGNORE-ERRORS-P cruft in stems-and-flags.lisp-expr. (It's
  30                 reasonable to support this as a crutch when initially
  31                 bootstrapping from balky xc hosts with their own
  32                 idiosyncratic ideas of what merits FAILURE-P, but it's
  33                 embarrassing to have to use it when bootstrapping
  34                 under SBCL!),
  35 * fixups now feasible because of pre7 changes
  36         ** ANSIfied DECLAIM INLINE stuff (deprecating MAYBE-INLINE,
  37                 including e.g. on the man page)
  38         ** (maybe) allow INLINE of a recursive function, so that the
  39                 body is inlined once
  40 * miscellaneous simple refactoring
  41         * belated renaming:
  42                 ** renamed %PRIMITIVE to %VOP
  43                 ** A few hundred things named FN and FCN should be
  44                         named FUN (but maybe not while drichards is
  45                         working on a Windows port).
  46         * These days ANSI C has inline functions, so..
  47                 ** redid many cpp macros as inline functions:
  48                         HeaderValue, Pointerp, CEILING, ALIGNED_SIZE,
  49                         GET_FREE_POINTER, SET_FREE_POINTER,
  50                         GET_GC_TRIGGER, SET_GC_TRIGGER, GetBSP, SetBSP,
  51                         os_trunc_foo(), os_round_up_foo()
  52                 ** removed various avoid-evaluating-C-macro-arg-twice
  53                         cruft
  54 * Either get rid of or at least rework the fdefinition/encapsulation
  55         system so that (SYMBOL-FUNCTION 'FOO) is identically equal to
  56         (FDEFINITION 'FOO).
  57 * Make the system sources understandable to the system, so that
  58         searching for sources doesn't error out quite so often
  59         (e.g. in error handlers)
  60         ** provided a suitable readtable for reading in the source
  61                 files when necessary, and a mechanism for activating
  62                 this readtable rather than the standard one.
  63 * Some work on conditions emitted by the system
  64         ** eliminated COMPILER-WARN and COMPILER-STYLE-WARN, which
  65                 were simply limited versions of WARN and STYLE-WARN.
  66         ** eliminated use of INHIBIT-WARNINGS by code emitted by the
  67                 system from user code.
  68         ** caused use of INHIBIT-WARNINGS to signal a STYLE-WARNING.
  69         ** eliminated use of INHIBIT-WARNINGS within the system
  70         ** deprecated INHIBIT-WARNINGS, causing its use to signal a
  71                 full WARNING.
  72         ** began work on developing a class hierarchy of conditions
  73                 along semantic lines.
  74         ** annotated conditions emitted by the system to have
  75                 references to documentation where applicable, so that
  76                 users can easily find an explanation for the
  77                 conditions they're seeing.
  78
  79 =======================================================================
  80 for 0.9:
  81
  82 [ note: much of the below refers to preparation for merging SB-PCL:FOO
  83   and CL:FOO.  However, it turned out to be surprisingly
  84   straightforward to do this notional end goal without doing many of
  85   the preparatory operations.  That doesn't mean that plenty of the
  86   goals below aren't worthwhile, but the motivation is somewhat
  87   different. ]
  88
  89 * refactored in preparation for moving CLOS into cold init and merging
  90         SB-PCL:FOO with CL:FOO (for FOO=CLASS, FOO=CLASS-OF, etc.)
  91         ** systematized support for MOP (more regression tests, maybe)
  92                 to try to make sure things don't get mislaid in the
  93                 upcoming CLOS restructuring
  94         ** extracted type system (and maybe CLASSOIDs) from SB-KERNEL
  95                 into new SB-TYPE package
  96         ** reimplemented GENERIC-FUNCTION as a primitive object (or
  97                 maybe made SB-MOP:FUNCALLABLE-STANDARD-OBJECT the
  98                 primitive object, and then let GENERIC-FUNCTIONs
  99                 inherit from that) instead of structures with
 100                 :ALTERNATE-METACLASS and funcallableness. Now
 101                 FUNCALLABLE-INSTANCE can go away. (And now the new
 102                 funcallable primitive objects need to go into
 103                 collections like *FUN-HEADER-WIDETAGS* where
 104                 FUNCALLABLE-INSTANCE objects used to be.)
 105         ** reimplemented CONDITIONs as primitive objects instead of
 106                 structures with :ALTERNATE-METACLASS. Now (between
 107                 this and the change to GENERIC-FUNCTIONs)
 108                 DEFSTRUCT :ALTERNATE-METACLASS can go away.
 109         ** (maybe) Now INSTANCE_POINTER_LOWTAG can become just
 110                 STRUCTURE_POINTER_LOWTAG, and the concept of
 111                 SB-KERNEL:INSTANCE (including INSTANCEP,
 112                 (SPECIFIER-TYPE 'INSTANCE), etc.) can go away.
 113 * moved CLOS into cold init, in order to allow CLOS to be used in the
 114         implementation of the core system (e.g. the type system and the
 115         compiler) and in order to support merger of CL:CLASS with
 116         SB-PCL:CLASS
 117 * (maybe) eliminated warm init altogether in favor of cold init
 118 * (maybe, especially if warm init can be eliminated) rationalized
 119         the build process, fixing miscellaneous pre-0.5.0 stuff that's
 120         transparently not the right thing
 121         ** removed separate build directories, now just building in
 122                 place with .sbclcoldfasl extensions
 123 * (maybe) more refactoring in preparation for merging SB-PCL:FOO
 124         into CL:FOO: reimplemented type system OO dispatch
 125         (!DEFINE-TYPE-METHOD, etc.) in terms of CLOS OO dispatch
 126 * added some automatic tests for basic binary compatibility, in hopes
 127         that it might be practical to maintain binary compatibility
 128         between minor maintenance releases on the stable branch (but no
 129         promises, sorry, since I've never tried to do this before, and
 130         have no idea how much of a pain this'll be)
 131 ========================================================================
 132 for 1.0 (fixes of lower priority which I'd nonetheless be embarrassed
 133 to leave unfixed in 1.0):
 134 * all too many BUGS entries and FIXMEs
 135 =======================================================================
 136 other priorities, no particular time:
 137
 138 * bug fixes, especially really annoying bugs (ANSI or not) and any
 139         ANSI bugs (i.e. not just bugs in extras like the debugger or
 140         "declarations are assertions", but violations of the standard)
 141 * better communication with the outside world (scratching WHN's
 142         personal itch): I don't want socket-level stuff so much as I
 143         want RPC-level or higher (CORBA?) interfaces and (possibly
 144         through RPC or CORBA) GUI support
 145 * Especially when ldb is not compiled in, the default "assertion failed"
 146         behaviour in many parts of the runtime is unfriendly.  It may
 147         be appropriate to look at some of these and see if they can be
 148         handled in some less abrupt way than aborting
 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