gnustep/libs-base
0
0
Fork 0
mirror of https://github.com/gnustep/libs-base.git synced 2025-04-23 00:41:02 +00:00
Code Issues Projects Releases Packages Wiki Activity

Version 1.0.2

Browse source 
git-svn-id: svn+ssh://svn.gna.org/svn/gnustep/libs/base/trunk@10174 72102866-910b-0410-8b05-ffd578937521
This commit is contained in:
fedor 2001-06-13 02:30:25 +00:00
parent 26dde4db5a
commit 6aa0b94342
8 changed files with 148 additions and 30 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

4
ANNOUNCE
View file

@ -1,7 +1,7 @@
Announcement
************
The GNUstep Base Library, version 1.0.1, is now available.
The GNUstep Base Library, version 1.0.2, is now available.
What is the GNUstep Base Library?
=================================
@ -22,7 +22,7 @@ portion of the OpenStep standard (the Foundation library).
Where can you get it? How can you compile it?
==============================================
The gnustep-base-1.0.1.tar.gz distribution file has been placed on
The gnustep-base-1.0.2.tar.gz distribution file has been placed on
`ftp.gnustep.org' in `pub/gnustep/core'.
The library requires gcc 2.8.0 or higher. See the `GNUstep-HOWTO'

8
ChangeLog
View file

@ -1,3 +1,11 @@
2001-06-12 Adam Fedor <fedor@gnu.org>
* Version: 1.0.2
* Documentation/news.texi: Update
* Documentation/gsdoc/NSArray.gsdoc: Updates (from
Pierre-Yves Rivaille <pyrivail@ens-lyon.fr>).
2001-06-11 Adam Fedor <fedor@gnu.org>
* configure.in (enable-openssl): New option, disabled by default.

94
Documentation/gsdoc/NSArray.gsdoc
View file

@ -7,6 +7,10 @@
<email address="rfm@gnu.org"/>
<url url="http://www.gnustep.org/developers/whoiswho.html"/>
</author>
<author name="Pierre-Yves Rivaille">
<email address="piking@shellyeah.com"/>
<url url=""/>
</author>
<version>$Revision$</version>
<date>$Date$</date>
</head>
@ -22,165 +26,229 @@
<sel>allocWithZone:</sel>
<arg type="NSZone*">zone</arg>
<desc>
TODO
</desc>
</method>
<method type="id" factory="yes">
<sel>array</sel>
<desc>
Returns a new empty array.
</desc>
</method>
<method type="id" factory="yes">
<sel>arrayWithArray:</sel>
<arg type="NSArray*">anArray</arg>
<desc>
Returns a new array containing the same elements as anArray.
</desc>
</method>
<method type="id" factory="yes">
<sel>arrayWithContentsOfFile:</sel>
<arg type="NSString*">aPath</arg>
<desc>
Returns a new array based upon the file located at aPath.
This file may be in property list format or in XML format (if XML is available).
This method returns nil if the file does not represent an array.
</desc>
</method>
<method type="id" factory="yes">
<sel>arrayWithObject:</sel>
<arg type="id">anObject</arg>
<desc>
Returns a new array containing only one object, anObject.
</desc>
</method>
<method type="id" factory="yes">
<sel>arrayWithObjects:</sel>
<arg type="id">firstObj,</arg>
<desc>
Returns a new array containing the objects passed as arguments to the method. The order is preserved.
</desc>
</method>
<method type="id" factory="yes">
<sel>arrayWithObjects:</sel>
<arg type="id*">objects</arg>
<sel>count:</sel>
<arg type="unsigned">count</arg>
<desc>
Returns a new array containing the objects that are in
the C-array objects and which size is count.
The order is preserved.
</desc>
</method>
<method type="NSArray*">
<sel>arrayByAddingObject:</sel>
<arg type="id">anObject</arg>
<desc>
Returns a new array created by adding anObject at the end of seld. The order is respected.
</desc>
</method>
<method type="NSArray*">
<sel>arrayByAddingObjectsFromArray:</sel>
<arg type="NSArray*">otherArray</arg>
<desc>
Returns a new array which is the concatenation of self and otherArray (in this precise order).
</desc>
</method>
<method type="NSString*">
<sel>componentsJoinedByString:</sel>
<arg type="NSString*">separator</arg>
<desc>
Returns a string created by the concatenation of self's elements' description separated by the string separator.
The order is preserved.
</desc>
</method>
<method type="BOOL">
<sel>containsObject:</sel>
<arg type="id">anObject</arg>
<desc>
Returns YES if anObject belongs to self. No otherwise. The isEqual: method of anObject is used to test equality.
</desc>
</method>
<method type="unsigned int">
<sel>count</sel>
<desc>
Returns the number of elements contained in self.
</desc>
</method>
<method type="NSString*">
<sel>descriptionWithLocale:</sel>
<arg type="NSDictionary*">locale</arg>
<desc>
TODO
</desc>
</method>
<method type="NSString*">
<sel>descriptionWithLocale:</sel>
<arg type="NSDictionary*">locale</arg>
<desc>
TODO
</desc>
</method>
<method type="id">
<sel>firstObjectCommonWithArray:</sel>
<arg type="NSArray*">otherArray</arg>
<desc>
Returns the first element of the array which can be found in otherArray.
Equality is tested with the isEqual method.
</desc>
</method>
<method type="void">
<sel>getObjects:</sel>
<arg type="id*">aBuffer</arg>
<desc>
This methods store all the elements of self inside aBuffer which is a C-array.
The order is preserved. You should get sure aBuffer's size is sufficient.
</desc>
</method>
<method type="void">
<sel>getObjects:</sel>
<arg type="id*">aBuffer</arg>
<sel>range:</sel>
<arg type="NSRange">aRange</arg>
<desc>
This methods store the elements of self in the range aRange inside aBuffer which is a C-array.
The order is preserved. You should get sure aBuffer's size is sufficient.
</desc>
</method>
<method type="unsigned int">
<sel>indexOfObject:</sel>
<arg type="id">anObject</arg>
<desc>
Returns the index of the first object of the array which is equal to anObject.
Equality is tested with the isEqual: method of anObject.
</desc>
</method>
<method type="unsigned int">
<sel>indexOfObject:</sel>
<arg type="id">anObject</arg>
<sel>range:</sel>
<arg type="NSRange">aRange</arg>
<desc>
Returns the index of the first object of the array which is equal to anObject and which is in aRange range.
Equality is tested with the isEqual: method of anObject.
</desc>
</method>
<method type="unsigned int">
<sel>indexOfObjectIdenticalTo:</sel>
<arg type="id">anObject</arg>
<desc>
Returns the index of the first object of the array which is physically equal to anObject.
Physical equality is tested with ==.
</desc>
</method>
<method type="unsigned int">
<sel>indexOfObjectIdenticalTo:</sel>
<arg type="id">anObject</arg>
<sel>range:</sel>
<arg type="NSRange">aRange</arg>
<desc>
Returns the index of the first object of the array which is physically equal to anObject and which is in aRange range.
Physical equality is tested with ==.
</desc>
</method>
<method type="id">
<sel>initWithArray:</sel>
<arg type="NSArray*">anArray</arg>
<desc>
Initialize the array with the content of anArray. The order is preserved.
Returns self.
</desc>
</method>
<method type="id">
<sel>initWithContentsOfFile:</sel>
<arg type="NSString*">aPath</arg>
<desc>
Initialize the array based upon the file located at aPath.
This file may be in property list format or in XML format (if XML is available).
If the file does not represent an array, self is left uninitialized and nil is returned.
Otherwise self is returned.
</desc>
</method>
<method type="id">
<sel>initWithObjects:</sel>
<arg type="id">firstObj,</arg>
<desc>
Initialize the array with the objects passed as arguments. The order is preserved.
Returns self.
NSInvalidArgumentException is raised if nil is one of the objects.
</desc>
</method>
<method type="id">
<sel>initWithObjects:</sel>
<arg type="id*">objects</arg>
<sel>count:</sel>
<arg type="unsigned">count</arg>
<desc>
Initialize the array with the objects contained in the
C-array argument which size is count.
The order is preserved.
Returns self.
NSInvalidArgumentException is raised if nil is one of the objects.
</desc>
</method>
<method type="BOOL">
<sel>isEqualToArray:</sel>
<arg type="NSArray*">otherArray</arg>
<desc>
Returns YES if the two arrays contain the same elements,
i.e. the two arrays have the same length and <br/>
for i from 0 to length - 1,
[[self objectAtIndex: i] isEqual: [anArray objectAtIndex: i]] returns YES.
</desc>
</method>
<method type="id">
<sel>lastObject</sel>
<desc>
Returns the last element of the array. If the array is empty, returns nil.
</desc>
</method>
<method type="void">
<sel>makeObjectsPerformSelector:</sel>
<arg type="SEL">aSelector</arg>
<desc>
Perform aSelector on every object of the array.
This is done sequentially from the last to the first object.
</desc>
</method>
<method type="void">
@ -189,33 +257,49 @@
<sel>withObject:</sel>
<arg type="id">anObject</arg>
<desc>
Perform aSelector with the argument anObject on every object of the array.
This is done sequentially from the last to the first object.
</desc>
</method>
<method type="id">
<method type="id">
<sel>objectAtIndex:</sel>
<arg type="unsigned int">index</arg>
<desc>
Returns located in the array at position index.
Raise NSRangeException if index is out of bounds
</desc>
</method>
<method type="NSEnumerator*">
<sel>objectEnumerator</sel>
<desc>
Returns an enumerator describing the array sequentially
from the first to the last element.<br/>
If you use a mutable subclass of NSArray,
you should not modify the array during enumeration
</desc>
</method>
<method type="NSArray*">
<sel>pathsMatchingExtensions:</sel>
<arg type="NSArray*">filterTypes</arg>
<desc>
Returns all the elements of the array which are NSString which
extensions are within the filterTypes NSArray.
</desc>
</method>
<method type="NSEnumerator*">
<sel>reverseObjectEnumerator</sel>
<desc>
Returns an enumerator describing the array sequentially
from the last to the first element.<br/>
If you use a mutable subclass of NSArray,
you should not modify the array during enumeration
</desc>
</method>
<method type="NSData*">
<sel>sortedArrayHint</sel>
<desc>
Returns nil. Does not do anything. TODO
</desc>
</method>
<method type="NSArray*">
@ -224,6 +308,7 @@
<sel>context:</sel>
<arg type="void*">context</arg>
<desc>
TODO
</desc>
</method>
<method type="NSArray*">
@ -232,18 +317,24 @@
<sel>context:</sel>
<arg type="void*">context</arg>
<desc>
TODO
</desc>
</method>
<method type="NSArray*">
<sel>sortedArrayUsingSelector:</sel>
<arg type="SEL">comparator</arg>
<sel>hint:</sel>
<arg type="NSDate*">hint</arg>
<desc>
TODO
</desc>
</method>
<method type="NSArray*">
<sel>subarrayWithRange:</sel>
<arg type="NSRange">range</arg>
<desc>
Returns a new array which contains self's elements located in range.
The order is preserved.
</desc>
</method>
<method type="BOOL">
@ -252,6 +343,7 @@
<sel>atomically:</sel>
<arg type="BOOL">flag</arg>
<desc>
TODO
</desc>
</method>
</class>

22
Documentation/install.texi
View file

@ -5,19 +5,11 @@
@c set the vars GNUSTEP_BASE_VERSION and GNUSTEP_BASE_GCC_VERSION
@include version.texi
@menu
* Introduction::
* Configuration::
* Compilation::
@end menu
@node Top, Introduction, (dir), (dir)
@menu
* Introduction::
* Configuration::
* Reading Command-Line Arguments::
* FFI Library::
* Compilation::
@end menu
@ -31,10 +23,10 @@ GNUstep-HOWTO is located in the gnustep-make package or at
@url{http://www.gnustep.org}
If you are installing the GNUstep libraries individually, make sure you
have installed the GNUstep Makefile package (gnustep-make) already.
In addition you should probably install an Objective-C library (gnustep-objc),
as well some other libraries (notable ffcall). See the GNUstep-HOWTO for more
information.
have installed the GNUstep Makefile package (gnustep-make) already. In
addition you should install an Objective-C library (gnustep-objc) if you
are not using gcc 3.x, as well some other libraries (notably
ffcall). See the GNUstep-HOWTO for more information.
When you configure this library, make sure you use the same
configuration options as with gstep-make. Some additional options to
@ -118,9 +110,9 @@ but this rarely works on non ix86 machines and is not supported.
You need to have the ffcall libraries, which you can
get from @url{ftp://www.gnustep.org/pub/gnustep/libs/} or
@url{http://clisp.cons.org/~haible/}. You also need to have a special
version of the Objective-C library (as of gcc 2.95.x the required hooks
are not in the standard library). You can get this library from
@url{ftp://www.gnustep.org/pub/gnustep/libs/libobjc-0.9.1.tar.gz}.
version of the Objective-C library (before gcc 3.0 the required hooks
were not in the standard library). You can get this library from
@url{ftp://www.gnustep.org/pub/gnustep/libs/libobjc-1.0.0.tar.gz}.
@node OpenSSL, , FFI Library, Configuration
@subsection OpenSSL

16
Documentation/news.texi
View file

@ -7,6 +7,18 @@
The currently released version of the library is
@samp{@value{GNUSTEP-BASE-VERSION}}.
@section Noteworthy changes in version @samp{1.0.2}
Mostly a bug fix release to work with the new gcc 3.0.
@itemize @bullet
@item Added support for special gcc 3.0 options (constant string support).
@end itemize
@c ====================================================================
@c Keep the next line just below the list of changes in most recent version.
@ifclear ANNOUNCE-ONLY
@section Noteworthy changes in version @samp{1.0.1}
@itemize @bullet
@ -19,10 +31,6 @@ bridges from other languages).
@item More memory debugging support.
@end itemize
@c ====================================================================
@c Keep the next line just below the list of changes in most recent version.
@ifclear ANNOUNCE-ONLY
@section Noteworthy changes in version @samp{1.0.0}
@itemize @bullet

22
INSTALL
View file

@ -9,9 +9,9 @@ GNUstep-HOWTO is located in the gnustep-make package or at
If you are installing the GNUstep libraries individually, make sure
you have installed the GNUstep Makefile package (gnustep-make) already.
In addition you should probably install an Objective-C library
(gnustep-objc), as well some other libraries (notable ffcall). See the
GNUstep-HOWTO for more information.
In addition you should install an Objective-C library (gnustep-objc)
if you are not using gcc 3.x, as well some other libraries (notably
ffcall). See the GNUstep-HOWTO for more information.
When you configure this library, make sure you use the same
configuration options as with gstep-make. Some additional options to
@ -87,9 +87,19 @@ machines and is not supported.
You need to have the ffcall libraries, which you can get from
<ftp://www.gnustep.org/pub/gnustep/libs/> or
<http://clisp.cons.org/~haible/>. You also need to have a special
version of the Objective-C library (as of gcc 2.95.x the required hooks
are not in the standard library). You can get this library from
<ftp://www.gnustep.org/pub/gnustep/libs/libobjc-0.9.1.tar.gz>.
version of the Objective-C library (before gcc 3.0 the required hooks
were not in the standard library). You can get this library from
<ftp://www.gnustep.org/pub/gnustep/libs/libobjc-1.0.0.tar.gz>.
OpenSSL
-------
GNUstep base has optional support for using the OpenSSL libraries for
secure URL connections (with the NSURL classes). To enable this option
you need to have the openssl libraries installed and add the option
`--enable-openssl' when running the `configure' script. Note that the
OpenSSL license is not compatible with GPL, so do not use this option
if you want your programs to be GPL compatible.
Compilation
===========

10
NEWS
View file

@ -1,7 +1,15 @@
News
****
The currently released version of the library is `1.0.1'.
The currently released version of the library is `1.0.2'.
Noteworthy changes in version `1.0.2'
=====================================
Mostly a bug fix release to work with the new gcc 3.0.
* Added support for special gcc 3.0 options (constant string
support).
Noteworthy changes in version `1.0.1'
=====================================

2
Version
View file

@ -7,7 +7,7 @@ GCC_VERSION=2.8.0
# The version number of this release.
MAJOR_VERSION=1
MINOR_VERSION=0
SUBMINOR_VERSION=1
SUBMINOR_VERSION=2
GNUSTEP_BASE_VERSION=${MAJOR_VERSION}.${MINOR_VERSION}.${SUBMINOR_VERSION}
VERSION=${GNUSTEP_BASE_VERSION}