mirror of
https://github.com/gnustep/libs-base.git
synced 2025-05-31 00:30:53 +00:00
The GNUstep Base Library is a library of general-purpose, non-graphical Objective C objects.
e486341176
The -pointerValue method now returns the value cast to a pointer, not some random value, as the documentation says it should. This is a change from OpenStep, which said: > It's an error to send this message to an NSValue that doesn't store a pointer. The OS X docs now say: > The receiver's value as a pointer to void. If the receiver was not created to hold a pointer-sized data item, the result is undefined. This means that any NSNumber created with a word-sized integer should return the same value. Fixed a number of corner-cases in the compare: implementation caused by incorrect type promotion. The OS X docs say: > The compare: method follows the standard C rules for type conversion. The OS X implementation does not do this. We now match Apple's conversion rules bug-for-bug: Every value is stored in the smallest signed type that will hold it, unless there is no unsigned type that can hold it, in which case it is stored in an `unsigned long long`, comparisons between integer and floating point values cast both to a double, comparisons between integer types perform a real comparison (so an unsigned long long is always greater than any negative number, at any precision). The Apple implementation is actually quite sane, it is just completely unrelated to the documentation in any way. We now use the same range of reusable objects. Note that there is an error in Cocoa Design Patterns in the description of how Apple's implementation works. Do not use this as a reference. We now return `nil` when an NSNumber is sent an -init message. This is consistent with Apple's implementation but breaks some things in the GNUstep test suite (which RFM said he will fix). There is a small change in NSValue.h so that the locale parameter is now an `id` not an `NSString*`. This is because, under recent OS X, it may also be an `NSLocale` instance. I am not sure how much GNUstep supports `NSLocale`, but this change shouldn't affect anything. The new (private) GSNumberTypes.h file lets you define macros that are instantiated with each of the names of primitive C types. These might be useful for simplifying other classes that have -intValue, -floatValue, and so on methods, such as the `NSCell` family. The old NSConcreteNumberTemplate and NSConcreteNumber stuff has been removed. The code is now a bit more than 10% of the size of the old NSNumber code, and is hopefully maintainable now, so the next change won't require a complete rewrite. git-svn-id: svn+ssh://svn.gna.org/svn/gnustep/libs/base/trunk@29618 72102866-910b-0410-8b05-ffd578937521 |
||
|---|---|---|
| config | ||
| Documentation | ||
| Examples | ||
| Headers | ||
| macosx | ||
| NSCharacterSets | ||
| NSTimeZones | ||
| Resources | ||
| Source | ||
| SSL | ||
| Tools | ||
| .cvsignore | ||
| ANNOUNCE | ||
| base.make.in | ||
| ChangeLog | ||
| ChangeLog.1 | ||
| ChangeLog.2 | ||
| config.mak.in | ||
| configure | ||
| configure.ac | ||
| COPYING | ||
| COPYING.LIB | ||
| COPYINGv3 | ||
| GNUmakefile | ||
| gnustep-base.script.spec.in | ||
| gnustep-base.spec.in | ||
| gnustep-base.spec.old | ||
| INSTALL | ||
| install.sh | ||
| Makefile | ||
| Makefile.postamble | ||
| NEWS | ||
| README | ||
| Version | ||
1 Readme
********
The GNUstep Base Library is a library of general-purpose, non-graphical
Objective C objects. For example, it includes classes for strings,
object collections, byte streams, typed coders, invocations,
notifications, notification dispatchers, moments in time, network ports,
remote object messaging support (distributed objects), and event loops.
It provides functionality that aims to implement the non-graphical
portion of the OpenStep standard (the Foundation library).
1.1 Initial reading
===================
The file `NEWS' has the library's feature history.
The files `INSTALL' or `GNUstep-HOWTO' (from the web site) gives
instructions for installing the library.
1.2 License
===========
The GNUstep libraries and library resources are covered under the GNU
Lesser Public License. This means you can use these libraries in any
program (even non-free programs). If you distribute the libraries along
with your program, you must make the improvements you have made to the
libraries freely available. You should read the COPYING.LIB file for
more information. All files in the `Source', `Headers'
`NSCharacterSets', `NSTimeZones', `Resources', and `SSL' directories
and subdirectories under this are covered under the GLPL.
GNUstep tools, test programs, and other files are covered under the
GNU Public License. This means if you make changes to these programs,
you cannot charge a fee, other than distribution fees, for others to
use the program. You should read the COPYING file for more information.
All files in the `Documentation', `Examples', `Tools', `config', and
`macosx' directories are covered under the GPL.
With GNUstep-Base, we strongly recommend the use of the ffcall
libraries, which provides stack frame handling for NSInvocation and
NSConnection. "Ffcall is under GNU GPL. As a special exception, if used
in GNUstep or in derivate works of GNUstep, the included parts of ffcall
are under GNU LGPL" (Text in quotes provided by the author of ffcall).
1.3 How can you help?
=====================
* Give us feedback! Tell us what you like; tell us what you think
could be better.
Please log bug reports on the GNUstep project page
`http://savannah.gnu.org/bugs/?group=gnustep' or send bug reports
to <bug-gnustep@gnu.org>.
Happy hacking!
Copyright (C) 2005 Free Software Foundation
Copying and distribution of this file, with or without modification,
are permitted in any medium without royalty provided the copyright
notice and this notice are preserved.