Add some release notes

git-svn-id: svn+ssh://svn.gna.org/svn/gnustep/libs/base/trunk@26628 72102866-910b-0410-8b05-ffd578937521
This commit is contained in:
rfm 2008-06-12 10:03:39 +00:00
parent 5a11210fce
commit 112430e95c
2 changed files with 73 additions and 41 deletions

View file

@ -1,3 +1,8 @@
2008-06-12 Richard Frith-Macdonald <rfm@gnu.org>
* Documentation/ReleaseNotes.gsdoc: Add information about movement
to MacOS-X compatibility.
2008-06-11 David Ayers <ayers@fsfe.org> 2008-06-11 David Ayers <ayers@fsfe.org>
* Source/NSNumberFormatter.m ([-stringForObjectValue:]): Implement * Source/NSNumberFormatter.m ([-stringForObjectValue:]): Implement

View file

@ -24,12 +24,12 @@ notice and this notice are preserved.
<chapter> <chapter>
<heading>Base Release Notes</heading> <heading>Base Release Notes</heading>
<p> <p>
The release notes include descriptions of API changes, behavior The release notes include descriptions of API changes, behaviour
changes and other information that might help developers and users changes and other information that might help developers and users
migrate to using a newer version of the library. migrate to using a newer version of the library.
</p> </p>
<section> <section>
<heading>Version 1.15.4</heading> <heading>Version 1.16.0</heading>
<p> <p>
This is a stable release. This is a stable release.
</p> </p>
@ -42,13 +42,9 @@ notice and this notice are preserved.
<term>NSBundle</term> <term>NSBundle</term>
<desc>New OSX method stubs.</desc> <desc>New OSX method stubs.</desc>
<term>NSCoder</term> <term>NSCoder</term>
<desc> <desc>New OSX10.5 methods for NSInteger implemented.</desc>
New OSX10.5 methods for NSInteger implemented.
</desc>
<term>NSConnection</term> <term>NSConnection</term>
<desc> <desc>New OSX10.5 methods for server connections implemented.</desc>
New OSX10.5 methods for server connections implemented.
</desc>
<term>NSData</term> <term>NSData</term>
<desc>New OSX method stubs.</desc> <desc>New OSX method stubs.</desc>
<term>NSException</term> <term>NSException</term>
@ -59,31 +55,62 @@ notice and this notice are preserved.
<desc>OSX10.5 additions implemented</desc> <desc>OSX10.5 additions implemented</desc>
<term>NSSet</term> <term>NSSet</term>
<desc>Implemented new OSX methods.</desc> <desc>Implemented new OSX methods.</desc>
<term>NSStream</term>
<desc>Implemented basic SSL/TLS support using gnu-TLS.</desc>
<term>NSThread</term> <term>NSThread</term>
<desc>Implemented new OSX methods.</desc> <desc>Implemented new OSX methods.</desc>
<term>NSLock, NSRecursiveLock, NSConditionLock</term> <term>NSLock, NSRecursiveLock, NSConditionLock</term>
<desc>Implemented names.</desc> <desc>Implemented names.</desc>
<term>GSXML, NSXMLParser</term>
<desc>Fully support namespace handling and fix bugs.</desc>
<term>NSKeyValueCoding, NSKeyValueObserving</term>
<desc>Made fully functional and MacOS-X compatible.</desc>
</deflist> </deflist>
To do for MacOS-X 10.5 compatibility: <p>The current emphasis of the base library is MacOS-X compatibility,
Implement most new method stubs. and the headers in this release mark many non-MacOS-X methods as being
Implement new OSX10.5 NSCalendar class. scheduled for removal by the next release (from 1.17.0).<br />
Implement new OSX10.5 NSLocale class. These methods will mostly be moved to the 'additions' library,
Implement new OSX10.5 NSOperation class. (which can be built stand-alone in conjunction with the Cocoa Foundation
Implement new OSX10.5 XML classes. framework as libgnustep-baseadd on OSX) and their declarations will
Implement NSInteger coding for NSCoder subclasses. be in the headers of that library (&lt;GNUstepBase/...&gt;) rather
Implement support for now enumarated values in NSComparisonPredicate. than in the <em>Foundation</em> directory.<br />
Implement new OSX10.5 features of NSDateFormatter. NB. The markup in the headers and documentation should not be
Implement new OSX10.5 features of NSExpesssion. assumed to be exhaustive ... it is planned that the next stable
Implement new OSX10.5 features of NSPredicate. release of the base library will enforce MacOS-X compatibility
Implement new OSX10.5 features of NSFileManager. by default, and you will have to explicitly include headers from
Implement new OSX10.5 features of NSProcessInfo. &lt;GNUstepBase/...&gt; in order to use GNUstep specific
Implement new OSX10.5 NSHashTable class. additions.<br />
Implement new OSX10.5 NSMapTable class. You should track the unstable branch of the base library (subversion
Implement new OSX10.5 NSPointerArray class. trunk) to find out what changes your software actually needs to make.
Implement new OSX10.5 NSLocale additions. </p>
Implement new OSX10.5 features of NSNumberFormatter. <p>The TODO list for MacOS-X 10.5 compatibility follows,
Implement new OSX10.5 features of NSNumber/NSValue. this is all stuff which would ideally be done by the next
Update NSDistributedNotificationCenter with new OSX methods. stable release of this library.
</p>
<list>
<item>Remove all non OSX10.5 declarations from standard headers</item>
<item>Implement most new method stubs.</item>
<item>Implement new OSX10.5 NSCalendar class.</item>
<item>Implement new OSX10.5 NSLocale class.</item>
<item>Implement new OSX10.5 NSOperation class.</item>
<item>Implement new OSX10.5 XML classes.</item>
<item>Implement NSInteger coding for NSCoder subclasses.</item>
<item>Implement support for now enumerated values
in NSComparisonPredicate.</item>
<item>Implement new OSX10.5 features of NSDateFormatter.</item>
<item>Implement new OSX10.5 features of NSExpression.</item>
<item>Implement new OSX10.5 features of NSPredicate.</item>
<item>Implement new OSX10.5 features of NSFileManager.</item>
<item>Implement new OSX10.5 features of NSProcessInfo.</item>
<item>Implement new OSX10.5 NSHashTable class.</item>
<item>Implement new OSX10.5 NSMapTable class.</item>
<item>Implement new OSX10.5 NSPointerArray class.</item>
<item>Implement new OSX10.5 NSLocale additions.</item>
<item>Implement new OSX10.5 features of NSNumberFormatter.</item>
<item>Implement new OSX10.5 features of NSNumber/NSValue.</item>
<item>Update NSDistributedNotificationCenter
with new OSX methods.</item>
</list>
</section> </section>
<section> <section>
@ -111,7 +138,7 @@ notice and this notice are preserved.
<term>NSURLConnection</term> <term>NSURLConnection</term>
<desc> <desc>
Added support for https using new stream code.<br /> Added support for https using new stream code.<br />
Added support for basic and digest authentrication. Added support for basic and digest authentication.
</desc> </desc>
</deflist> </deflist>
</section> </section>
@ -175,7 +202,7 @@ notice and this notice are preserved.
<p> <p>
This is an unstable release from 1.14.0. It is otherwise This is an unstable release from 1.14.0. It is otherwise
identical to the 1.14.0 release. Releases in the 1.15 series identical to the 1.14.0 release. Releases in the 1.15 series
may not be foreward compatible with previous 1.15 releases. may not be forward compatible with previous 1.15 releases.
</p> </p>
</section> </section>
<section> <section>
@ -210,7 +237,7 @@ notice and this notice are preserved.
<term>NSObject</term> <term>NSObject</term>
<desc> <desc>
Fixes for lock contention with retain/release, so the performance Fixes for lock contention with retain/release, so the performance
of massively multithreaded applications is much better. of massively multi-threaded applications is much better.
</desc> </desc>
<term>NSNetServices</term> <term>NSNetServices</term>
<desc> <desc>
@ -248,18 +275,18 @@ notice and this notice are preserved.
<term>NSBundle</term> <term>NSBundle</term>
<desc> <desc>
Fix for crash when initialising the bundle system in Fix for crash when initialising the bundle system in
an applicatiuon linked with many frameworks. an application linked with many frameworks.
</desc> </desc>
<term>NSCalendarDate</term> <term>NSCalendarDate</term>
<desc> <desc>
Fix for buffer overrun problem mwhen initialising Fix for buffer overrun problem when initialising
date from string. Also fixed to return nil when date from string. Also fixed to return nil when
initialising from some illegal strings. initialising from some illegal strings.
</desc> </desc>
<term>NSConnection</term> <term>NSConnection</term>
<desc> <desc>
Some locking fixes to avoid rare deadlocks in heavily Some locking fixes to avoid rare deadlocks in heavily
multithreaded applications. multi-threaded applications.
</desc> </desc>
<term>NSDecimalNumber</term> <term>NSDecimalNumber</term>
<desc> <desc>
@ -302,17 +329,17 @@ notice and this notice are preserved.
<heading>Version 1.13.0</heading> <heading>Version 1.13.0</heading>
<p> <p>
Several sets of classes have been added for dealing with urls and Several sets of classes have been added for dealing with urls and
predicates. A few minor api changes have occured as well. predicates. A few minor api changes have occurred as well.
</p> </p>
<deflist> <deflist>
<term>Character sets</term> <term>Character sets</term>
<desc> <desc>
Character sets were improved with regard to ranges (chinese Character sets were improved with regard to ranges (Chinese
characters, etc). characters, etc).
</desc> </desc>
<term>Keyed Archiving</term> <term>Keyed Archiving</term>
<desc> <desc>
Better compatibility with MacOSX. In particular, some gueses Better compatibility with MacOSX. In particular, some guesses
are made as to how some objects should be encoded. are made as to how some objects should be encoded.
</desc> </desc>
<term>GNUstep configuration file</term> <term>GNUstep configuration file</term>
@ -330,14 +357,14 @@ notice and this notice are preserved.
Most of the code was updated to compile nicely with the new Most of the code was updated to compile nicely with the new
gcc objective-c++ compiler. gcc objective-c++ compiler.
</desc> </desc>
<term>NSString designated initializer</term> <term>NSString designated initialiser</term>
<desc> <desc>
The GNUstep designated initialiser for the NSString class The GNUstep designated initialiser for the NSString class
cluster has changed to cluster has changed to
<code>-initWithBytesNoCopy:length:encoding:freeWhenDone:</code> <code>-initWithBytesNoCopy:length:encoding:freeWhenDone:</code>
from from
<code>-initWithCharactersNoCopy:length:freeWhenDone:</code> <code>-initWithCharactersNoCopy:length:freeWhenDone:</code>
and older code subclassing NSString will need to be updated. and older code sub classing NSString will need to be updated.
</desc> </desc>
<term>NSBundle bundleWithIndentifier:</term> <term>NSBundle bundleWithIndentifier:</term>
<desc> <desc>
@ -362,7 +389,7 @@ notice and this notice are preserved.
</desc> </desc>
<term>Run loops</term> <term>Run loops</term>
<desc> <desc>
Removed the timeout facility for runloop watchers - you should Removed the timeout facility for run loop watchers - you should
use standard timers instead. The watcher interface is deprecated use standard timers instead. The watcher interface is deprecated
anyway. anyway.
</desc> </desc>
@ -398,7 +425,7 @@ notice and this notice are preserved.
Several deprecated and private methods were removed from Several deprecated and private methods were removed from
the public interface including the public interface including
<code>+gnustepBundle</code>, and <code>+gnustepBundle</code>, and
<code>+pathForGNUstepResource:ofTpye:inDirectory:</code>. <code>+pathForGNUstepResource:ofType:inDirectory:</code>.
</desc> </desc>
<term>NSNotificationCenter deprecated method</term> <term>NSNotificationCenter deprecated method</term>
<desc> <desc>