root/trunk/doc/changelog.txt

5/2/2006 - 0.21:

* Merged in DMD 160 changes.
* Added std.c.posix.ucontext.
* Finished std.c.posix.signal.
* Fixed a corner case in the Posix suspendHandler.  Additional work is likely required to allow interrupted calls to restart after suspend completes.

4/18/2006 - 0.20:

* Merged in Mango changes.
* Merged in DMD 156 changes.
* Renamed onAssert to onAssertError.
* Renamed onOutOfMemory to onOutOfMemoryError.
* Added a new callback, onFinalizeError, to be called when an exception is thrown during finalization.
* Added a new callback, onCollectResource, to be called when collecting an object with a dtor.  This callback may be hooked by the user via setCollectHandler.
* Removed -I option from Linux makefiles, as it's presence is misleading.  Since -I paths are appended to the existing include path, the current code is only checked if no previous matches are found.  It would be easier to simply modify dmd.conf for the duration of the build or copy the source files into the proper include location.  Hopefully, a future release of DMD will check additional locations other than /etc for dmd.conf so this isn't necessary.
* Added sys.windows.winmain.d and sys.windows.winmain.def.  These have been packaged with Ares for a while and were left out of version control.
* Added doc/library_interaction.txt.

4/12/2006 - 0.19:

* Merged in DMD 154 changes.
* Added std.c.posix.dirent.
* Removed gc_setFinalizer.
* Removed 'nz' param from gc_calloc, as an object count doesn't make much sense within the context of a language where objects are not value types.  Now, gc_calloc is functionally identical to malloc except the memory is zero-initialized before it is returned.
* Added a new parameter, df (do finalize), to gc_malloc, gc_calloc, and gc_realloc.  This parameter defaults to false and is intended to replace gc_setFinalizer for indicating that a memory block should be finalized.  While this limits flexibility by binding finalization indication to allocation, it reduces the chance for user error and also makes for more efficient code as both allocation and setting the doFinalize flag can be accomplished with a single mutex lock.
* Added a new extern (C) function requirement: cr_finalize(void* p,bool det=true).  This function must be implemented by the compiler runtime (thus the 'cr_' prefix) and should perform any finalization required for the object referenced by 'p'.  Typically, this involves calling any associated dtors, cleaning up object monitors, etc.  If 'det' is true then the function is being called deterministically, false if otherwise.  Thus, 'det' would be false when cr_finalize is called on an orphaned object during a garbage collection run unless the garbage collector performing a final cleanup during termination.  Currently, the runtime is not required to do anything with respect to the value of 'det', but in the future it may be required to call an error routine similar to those already exposed by std.exception if the object being finalized has a dtor.  This error routine would likely be overridable by the user and would default to doing nothing.  The purpose of such a routine would be to allow the user to halt execution or report an error indicating object type, as non-deterministic finalization of an object with a dtor may be considered a resource leak and thus a programming error.
* Fixed a nasty bug that was corrupting the global thread list.
* Altered thread finalization code to occur on thread termination instead of on object disposal.

4/3/2006 - 0.18:

* Merged in DMD 151 changes.
* Added std.c.posix.fcntl.
* Added std.c.posix.sys.stat.
* std.c.posix.pthread - Updated some disabled code to be closer to usable.
* Removed Thread.suspend, Thread.suspendAll, Thread.remove, and Thread.removeAll.
* Rewrote thread_suspendAll, thread_removeAll, and thread_markAll.  Only the Windows code has been tested, but is both simpler and more efficient than the old code.
* Fixed Posix implementation of Thread.sleep.
* Added 'preserve' option to ThreadGroup.joinAll (default is true).
* Added missing return statement in ThreadGroup.create.
* Added missing import statement in std.array.
* Added support function to std.math.ieee for unit testing.
* Fixed documentation in std.memory to be more accurate.
* Added lowercase 'cin', 'cout', and 'cerr' aliases to std.io.Console.

3/21/2006 - 0.17:

* Merged in DMD 150 changes.
* Added first cut of std.traits.
* Renamed std.string to std.array.
* Switched to Knuth find ops in std.array -- the old code still exists in version(none) blocks.
* Made speculative fix for suspend op in std.thread.
* Changed documentation in std.memory to more accurately reflect intended behavior.
* Added support for sys/epoll to sys.linux.

3/7/2006 - 0.16:

* Merged in DMD 149 changes.
* Merged in Mango changes.
* Renamed std.stdarg to std.vararg.
* Added std.regexp from Phobos.
* Added std.bitarray from Phobos.
* Added std.unicode, which includes functionality from std.io.convert.Unicode (ie. from Mango).
* Added std.string.  This module may contain some functionality from Phobos, but only when there is an overlap in desired functionality.  Most or all functions here will be template functions and will require implicit template instantiation to operate correctly.  At the moment, some functions are commented out because template overloading is not yet implemented.
* Changed inline asm in a math function to refer to the parameter by name rather than stack offset.  This will be marginally less efficient, but should be more maintainable and hopefully will allow the code to be inlined at some point.
* Rearranged code in std.atomic to use 'static if' to avoid the need for concept parameters.
* Renamed onInvalidUtfError to onUnicodeError.
* Reversed template parameters in std.atomic in anticipation of implicit template instantiation.
* Refactored ares.object and dmdrt.object to more closely match Phobos.  The presence of TypeInfo objects is necessary, and the rest should ease merging a bit.
* Rebuilt dmdrt.typeinfo to match phobos.std.typeinfo.  It seems DMD references TypeInfo modules by some form of the decorated name, and storing them in differently named files was not working.
* Refactored std.thread C interface and fixed a few GC-related bugs.
* Fixed array append bug.

2/26/2006 - 0.15:

* Merged in DMD 148 changes.
* Renamed some TypeInfo files and split a few into per-class modules.
* Removed util.regexp and util.outbuffer from the build, as they are no longer needed.  std.regexp will reappear in the next release.

2/25/2006 - 0.14:

* Made substantial changes to std.c.posix modules for Linux and Darwin compatibility.
* Changed Linux makefiles to match Win32 makefiles.
* Added std.c.posix.sys.mman.
* Trimmed out some now redundant declarations from sys.linux.c.linux.
* Added atomicIncrement and atomicDecrement for use with value and pointer types.
* Made miscellanious improvements in std.thread to support Posix threads.
* Added Windows and Linux constants to std.c.errno for error reporting.

2/16/2006 - 0.13:

* Removed std.regexp as it is somewhat redundant with DMD 147 regexp support.
* Added regexp support code as required by DMD 147.
* Moved all Phobos std modules needed by DMD runtime code into new package dmdrt.util.
* Modified dmdrt and dmdrt.typeinfo modules to use util functions where appropriate (some modules previously contained inline code as a hack).
* Refactored code in std.thread to eliminate code duplication.
* Fixed inline asm in std.math.core as per an update in DMD 146.
* Added std.math.ieee.fcis function.  Please note that there may be offset issues on non-Windows platforms.
* Fixed Ares makefile macro errors and cleaned up file format a bit more.
* Altered dmdgc and dmdrt makefiles to match Ares "standard" makefile format.
* Added trace.obj to dmdrt build.  Note that this object is not necessary for a successful DMD runtime.
* Added std.c.config for internal data size configuration.  Note that this file is for internal use and should never be imported publicly.
* Changed std.c files to use aliases defined in std.c.config where appropriate.
* Beautified std.c declarations format for readability and fixed a few declaration errors.

2/1/2006 - 0.12:

* Merged in DMD .145 changes.
* Fixed DMD runtime to use new GC functionality where appropriate.
* Within GC implementation, renamed capacityOf to sizeOf to match function name to actual behavior.
* std.memory - Fixed documentation to include throw specs.
* Fixed compiler flags for std.stard and std.c.stdarg.
* Added module-level documentation for std.intrinsic and std.stdarg.
* Added the ThreadGroup class to std.thread.
* Changed the Ares makefile to be a bit more generic.  Now, the only explicitly handled files are those that need explicit handling.
* Added comments to all files that have been modified from their original form as shipped with DMD.  While adding these comments to the TypeInfo modules, the standard Digital Mars copyright header was added if missing as well.  This was done for consistency, as some TypeInfo modules contained this header while others did not (so I assumed its presence was intended in all such modules).
* Ares now has IO functionality!  With Kris' permission, a minimal working subset of Mango has beed added to Ares in the new std.io package area.  The primary goal for this release was to get the basics in and working, so expect more integration work or more features to be added in a future release.
* Ares now does math!  The first of a collection of mathematics modules have been added to the new std.math package area, following a model suggested by Don Clugston.  Please note that the mathematic functions mentioned in the documentation for std.intrinsic in Phobos currently do not work as a result of compiler and library issues in DMD.  This will be addressed in the next Ares release.

1/25/2006 - 0.11:

* std.atomic - Uncommented all unit tests and removed bug workaround code, as the problems have been addressed.  Also added module comments.
* Added std.memory and std.stdarg to documentation.
* Added TypeInfo declarations to object.d, as they are now required by DMD.
* Added documentation for std.memory.
* std.memory - Added the sizeOf function.
* Added the object file for std.memory to the build (it was accidentally omitted).

1/23/2006 - 0.10:

* Merged in DMD .144 changes.
* Renamed std.gc to std.memory.
* Redefined GC library interaction.  Some code that was in dmdgc now lives in dmdrt within the new file, memory.d.
* Defined new standard interface to the GC, in std.memory.  All calls now go through an instance of the GC struct: gc.  This dummy class is present to allow for future interface changes that may allow dynamic swapping of GCs.
* Removed an unnecessary 'static' from std.exception.

12/30/2005 - 0.9:

* Merged in DMD .142 changes.
* Added std.stdarg.
* Now printing error messages to stderr.
* Replaced std.thread.threadCount with std.thread.multiThreaded.

12/05/2005 - 0.8:

* Merged in DMD .141 changes.
* Made temporary change in std.atomic to workaround compiler bug ("volatile" modifier to "asm" statement commented out).
* Added separate variable to track Thread.count.  This was done to eliminate a race condition with the GC that may have resulted in corrupted GC data.  This should also make memory allocation run faster for single-threaded programs.  I'm not entirely happy with the way the GC integrates with the global thread list, and this is liable to change at some point.

11/25/2005 - 0.7:

* Added code support for synchronized load ops on x86, even though that option is not currently available given the msync options available for atomicLoad.
* Merged in DMD .140 changes.
* Added thread local storage.
* Moved std.regexp from sub area.  Be aware that this module is under evaluation and the interface may change.

11/08/2005 - 0.6:

* Merged in DMD .139 changes.
* Changed Win32 Thread.yield() from Sleep(0) to Sleep(1).  See comments in code regarding why.
* Added 'extern' qualifiers where appropriate in std.c headers.
* Modified size_t to use typeof for size determination.
* Added documentation for std modules.
* Renamed std.error to std.exception (the module name was incorrect).
* Fixed documentation generation code.
* Changed extern callback reference from _d_outOfMemory to onOutOfMemory.
* Added 'make doc' line to build script.

10/18/2005 - 0.5:

* Merged in DMD .136 changes.
* Finished std.c.inttypes (constants added in a VerboseC version block).

10/14/2005 - 0.4:

* Merged in DMD .135 changes.
* Added documentation for std.thread.
* Added some documentation for std.atomic.
* Cleaned up version blocks in std.c and made all inline functions extern (D).
* Renamed std.error to std.exception.
* Renamed exception classes from *Error to *Exception.
* Removed RuntineError and LogicError classes.
* All system exception classes now derive from Exception.

09/27/2005 - 0.3:

* Merged in DMD .133 changes.

09/21/2005 - 0.2:

* Moved sys.c.windows to sys.windows.c.
* Moved sys.c.linux to sys.linux.c.
* Changed C compiler alias to refer to DMC instead of SC.
* Added doc generation for modules in std.
* Added stub comments for document generator.
* Created two new exception classes, LogicError and RuntimeError, which derive from Exception.
* Changed all system error classes to derive from the two new children of Exception.
* Fixed error reporting for system errors so file name and line number are displayed.

09/15/2005 - 0.1:

* Renamed Thread.stackHead to Thread.stackTop.  Thread.stackTop returns a pointer to the logical top of the execution stack, and on some systems its address may evaluate to less than the stack bottom (x86, for example).
* Renamed Thread.stackTail to Thread.stackBottom.  Thread.stackBottom returns a pointer to the logical bottom of the execution stack, and on some systems its address may evaluate to greater than the stack top (x86, for example).
* Renamed Thread.regHead to Thread.regFirst.  Thread.regFirst returns a pointer to the beginning of a list of register entries.  Entry order (and population) will be such that a PUSHA plus a memcpy can populate the list directly on x86 systems.
* Renamed Thread.regTail to Thread.regLast.  Thread.regLast returns a pointer to the last valid element of a list of register entries in the order specified above.
* Added some Posix code in the Thread module to support the aforementioned changes.  As with all non-Windows code, these changes are untested.
* Altered the GC support code in the Thread module to use the new conventions.  This should also eliminate a bug where pointers to defunct stack data were being used in some cases.  Upon review of the GC code, it appears that mark is inteded to operate on the range [pbot..ptop).  This is consistent with standard coding practice, but it also implies that the address referenced by ptop will never be used by the GC.  In any case, the Thread code has been written such that the entire stack and set of registers will be scanned even though the Thread functions expose an inclusive range.
* Moved reference to onOutOfMemory from dmdrt to dmdgc (where it belongs).

09/10/2005:

* Merged in DMD .131 changes (nothing but a rebuild)
* Added a Posix version of Thread.sleep (untested)
* Fleshed out Posix headers

08/18/2005:

* Merged in DMD .129 changes
* Fixed names for moved windows/linux modules (from std to sys prefix)

08/02/2005:

* std.atomic - Finalized design and added to the build
* std.atomic - Fixed a bug where code setting the membar template parameter was backwards
* std.atomic - Added temporary code to support atomic pointer types (32-bit only--this is temporary after all)
* std.atomic - Added public atomicLoad, atomicStore, and atomicStoreIf functions.  These are inteded to provide some means to perform atomic operations on values outsie the Atomic struct.  if template function overloading ends up being supported, these may be replaced with statics within Atomic

07/17/2005:

* Merged in DMD .128 changes

06/17/2005:

* Merged in DMD .127 changes (there actually weren't any this time)
* Made some minor bugfixes to std.thread
* Re-implemented the first set of changes to the Posix thread class

06/09/2005:

* Merged in DMD .126 changes
* NOTE: the new Posix code in std.thread (from 05/18) was lost a few updates ago.  I'm re-implementing it, but the changes will take a few days.

05/27/2005:

* Moved intrinsic from dmdgc to ares.std

05/27/2005:

* std.thread - Removed debug reference to std.c.stdio
* object - imported std.c.stdbool (for bool alias)
* object - added file, line, and next properties to Exception
* std.c.windows.winsock - fixed reference to std.c.stdint
* dmdgc.gcx - changed pauseAllThreads to suspendAllThreads (this was done before but the change was lost)
* dmdgc.gcbits - reverted to old (bad) usage of intrinsic.  this version compiles and works okay, but intrinsic still has to be moved.  initial attempts were unsuccessful, and I wanted a working version of Ares available until this can be looked into more closely

05/26/2005:

* Merged in DMD .125 changes

05/19/2005:

* Merged in DMD .124 changes

05/18/2005:

* Merged in DMD .123 changes

05/18/2005:

* Changed std.c.unix to std.c.posix
* Created new headers for std.c.posix--most are currently incomplete
* Changed std.thread to refer to std.c.posix.pthread for non-Win32 builds

05/10/2005:

* Merged in DMD .122 changes

05/03/2005:

* Changed Thread.pause to Thread.suspend, also changed pauseAll and pauseAllThreads
* Nearly finished the Linux threading code

04/19/2005:

* Merged in DMD .121 changes

04/13/2005:

* Removed Object.print
* Partial implementation of POSIX Thread class

04/06/2005:

* Merged in DMD .120 changes

03/30/2005:

* Removed Thread.thread_init().  GC support functions must now be functional before
  any explicit module initialization is performed.
* Added extern threadCount(), pauseAllThreads(), resumeAllThreads(), and
  scanAllThreads() to decouple std.Thread from the garbage collector.
* Removed temp code meant to solve a problem with foreach during a gc run.  It seems
  to work okay using the new extern functions.

03/23/2005:

* Merged in DMD .119 changes
* Cleaned up the dmdrt makefile a bit
* Added dmdrt/trace.d but it isn't being compiled at the moment as it relies on some
  stuff from Phobos.std.

03/15/2005:

* Merged in DMD .118 changes

02/16/2005:

* Merged in DMD .113 changes

01/13/2005:

* Merged in DMD .110 changes

12/08/2004:

* added temporary code to [std.thread] to support current gc requirements -- something
  that doesn't use foreach or DMA that the gc can use to iterate across active threads
* cleaned out Linux thread code until the Windows code can be finished, the two were
  out of synch

12/02/2004:

* Changed associative array behavior to make allocations more atomic

12/01/2004:

* Temporary fixes in [std.thread] and the garbage collector for a few crashing errors.

11/30/2004:

* Merged in DMD .108 changes
* Added static count() property to Thread
* Added name() property to Thread
* Eliminated [std.hook] and moved the remaining bits into [std.error]
* Added setAssertHandler()

11/23/2004:

* Removed onModuleCtorError hook, since it seems largely useless.  This error now throws
  an Exception.

* Began work on POSIX Thread class.

11/22/2004:

* Redesigned Thread class and reworked the garbage collection code involding this class.
  Linux version of this code is still under development.

11/16/2004:

* Moved TypeInfo_Class and TypeInfo_Typedef from object.d to their own files in
  the typeinfo directory.

11/15/2004:

* Removed ArrayCastError and ArrayCopyError hooks as there doesn't seem to be any
  reason to override them.  Both now throw standard Exceptions.

11/12/2004:

* Added ArrayCastError, ArrayCopyError, ModuleCtorError, and InvalidUtfError hooks
* Removed Error class and switched all children to derive from Exception instead
* NOTE: Exception is expected by the compiler to exist and to be in object.d.  If
        it is to be changed or removed, changes to the runtime code (deh.c, mars.h)
        will be necessary.