release-chore: Update docs for a future 1.28 release.

This commit is contained in:
Ivan Vučica 2021-04-22 22:41:04 +01:00
parent ea7e2c1e30
commit d2eca82730
No known key found for this signature in database
GPG key ID: 6E4D7BA2D93CAC9D
6 changed files with 465 additions and 230 deletions

View file

@ -29,6 +29,98 @@ notice and this notice are preserved.
migrate to using a newer version of the library.
</p>
<section>
<heading>Version 1.28.0</heading>
<p>
Aside from an assortment of bugfixes, this release includes a lot of
improvements for Windows support as well as numerous new classes and methods.
</p>
<p>
Not every bugfix, improvement or a new feature will be listed here.
</p>
Reading and setting File Creation Date attribute on Windows.<br />
Added new <code>ASSIGNMUTABLECOPY()</code> macro for consistency with
<code>ASSIGNCOPY()</code>.<br />
Replaced character set data headers for URLs with loading these from a
standard data source, and updated bitmap representation to use much less space
for character sets residing wholly in the base plane, such as the URL charsets
(given they are purely ASCII).<br />
Updated character set data with newer Unicode data set.<br />
<code>[NSURLProtocol -initWithRequest:cachedResponse:client:]</code> will now
retain the client up until the last message is sent to it, which improves
compatibility with OS X.<br />
Percent-escaping code in <code>NSURL</code> simplified.<br />
Removed mixed ABI support.<br />
Use of Apple runtime now assumes non-fragile ABI (which is true on modern
systems).<br />
Improve typing on method implementation pointers in some classes.<br />
In <code>NSHTTPCookie</code>, rewritten code for extracting individual cookies
from the HTTP header.<br />
In <code>NSKeyedArchiver</code>, implement secure coding methods.<br />
New methods in <code>NSDateComponents</code>.<br />
Improvements in <code>NSCalendar</code> and <code>NSLocale</code> for calendar locale
and <code>NSDateComponents</code>.<br />
In <code>NSFileManager</code>, use <code>utimensat()</code> to set file modification
date, if available.<br />
Correctly stop parsing number being decoded in <code>NSJSONSerialization</code>
when encountering a number with an invalid exponent.<br />
Improve OS X compatibility for <code>NSURLQueryItem</code> initializers.<br />
For <code>NSFileManager</code>, in <code>changeFileAttributes</code>, implement
setting creation date for Unix-like systems. Implement reading the creation
date if a supported method was detected.<br />
Support reading Android assets from the main bundle in
<code>NSInputStream</code>.<br />
Support Android assets directories in <code>NSBundle</code> and <code>NSFileManager</code>.<br />
Implement <code>-[NSXMLParser initWithStream:]</code>.<br />
Allow clearer choice between 'sloppy' <code>GSSloppyXMLParser</code> used in
<code>NSXMLParser</code> and the libxml2-based <code>GSStrictXMLParser</code>.<br />
Fix building Win32 implementations for <code>GSFileHandle</code> and
<code>NSMessagePort</code> with nonfragile ABI.<br />
Use <code>NSNumber</code> and not <code>NSString</code> in
<code>-[NSUserDefaults setBool:forKey:]</code>.<br />
Posting notification before <code>NSThread</code> exit.<br />
Actually declare optional <code>NSFilePresenter</code> methods as optional.<br />
In <code>NSConcreteMapTable</code>, fix replacing existing values in a weak
objects map table.<br />
Fix leaks in <code>NSOperation</code>.<br />
Various compat fixes for various MSYS systems, particularly around
sockets code.<br />
In <code>NSData</code>, <code>NSFileManager</code> and more, various improvements when
overwriting and creating files with respect to file attributes (owners, creation
timestamp, etc).<br />
Improve <code>NSLog</code> output on Android.<br />
Use <code>instancetype</code> in <code>NSURLRequest</code> header.<br />
Define <code>NSAttributedStringKey</code> and <code>NSNotificationName</code>.<br />
Add new <code>NSURL</code> methods.<br />
In <code>GSMime</code>, have <code>-contentFile</code> check the <code>Content-Type</code>
header before checking <code>Content-Disposition</code>.<br />
Fix a bug linking with WEAK symbols where binutils 2.3.5 would fail to
link due to not all expected symbols being exported.<br />
New <code>plutil</code> utility.<br />
Implementation of <code>[NSData rangeOfData:options:range:]</code> which finds
the <code>NSRange</code> in which the passed data occurs.<br />
Change <code>ENTER_POOL</code>/<code>LEAVE_POOL</code> so they no longer wrap the
enclosed code in a loop, enabling use in some loops.<br />
New 10.5 methods in <code>NSRunLoop</code>/<code>NSURLConnection</code>.<br />
Improve compatibility when building with ICU 68.<br />
Fix compiling libdispatch integration of <code>NSRunLoop</code> on Windows.<br />
Add support for building on Windows with MSVC's Clang by passing the
<code>configure</code> flag <code>--host=x86_64-pc-windows</code>. Use of an MSYS2 shell
without <code>-devel</code> packages is recommended.<br />
Implementation of <code>NSURLSession</code> and related classes. This adds some
dependencies on more recent versions of <code>libcurl</code>, <code>libdispatch</code> etc.<br />
Fix initializing <code>NSUUID</code> from a string.<br />
Disable use of <code>libcurl</code> if its headers are not found.<br />
In <code>NSURLProtocol</code>, continue writing data if not all of it was
written.<br />
Fix use of GnuTLS under MinGW by using <code>send/recv</code> rather than
<code>read/write</code>.<br />
Add support for libobjc2 runtime on Windows.<br />
Fix BOM insertion when generating data from a string using one of the
Unicode encodings.
</section>
<section>
<heading>Version 1.27.0</heading>
<p>