← Back to branch summary

~ubuntu-branches/ubuntu/oneiric/gnustep-base/oneiric

« back to all changes in this revision

Viewing changes to Headers/Additions/GNUstepBase/NSObject+GNUstepBase.h

  • Committer: Bazaar Package Importer
  • Author(s): Yavor Doganov
  • Date: 2011-05-31 11:03:16 UTC
  • mfrom: (1.2.12 upstream) (7.2.4 experimental)
  • Revision ID: james.westby@ubuntu.com-20110531110316-0uny1hmsdl3gmn5v
Tags: 1.22.0-1
http://bugs.debian.org/624928
http://bugs.debian.org/624054
* New major upstream release:
  + Includes support for the new Objective-C runtime (Closes: #624928).
* debian/control.m4 (Vcs-Arch): Replace with...
  (Vcs-Git): ...since tla-buildpackage is gone.
  (Vcs-Browser): New field.
  (Standards-Version): Bump to 3.9.2; no changes needed.
  (Build-Depends): Add libicu-dev, needed for NSLocale.
  (libgnustep-base`'SOV_BASE-dbg) <Conflicts>: Set to
  libgnustep-base1.20-dbg only.
  <Recommends>: Set to libobjc3-dbg.
* debian/control: Regenerate.
* debian/patches/gnutls-deprecated.patch: New; fix usage of deprecated
  GnuTLS function (Closes: #624054).
* debian/patches/missing-header.patch:
* debian/patches/no-march.patch: Delete; fixed upstream.
* debian/patches/NSBundle-PROCFS_EXE_LINK.patch: Delete; apparently not
  needed anymore.
* debian/patches/manpage-fixes.patch: A few more fixes.
* debian/patches/avoid-nsl-linkage.patch: Refresh.
* debian/patches/autoreconf.patch: Regenerate.
* debian/patches/series: Update.
* debian/rules (v_objc, v_make): Bump to 4:4.6 (for libobjc3) and 2.6
  (for the sake of the testsuite) accordingly.
  (debian/build-shared-stamp): Run the testsuite.
  (install-shared): Do not delete non-existent .swp file.
  (install-common): Use $(sov_base) instead of hardcoded version.
* debian/copyright: Update copyright years.

Show diffs side-by-side

added added

removed removed

Lines of Context:
Headers/Additions/GNUstepBase/NSObject+GNUstepBase.h
1
 
/** Declaration of extension methods for base additions
2
 
 
3
 
   Copyright (C) 2003-2010 Free Software Foundation, Inc.
4
 
 
5
 
   Written by:  Richard Frith-Macdonald <rfm@gnu.org>
6
 
   and:         Adam Fedor <fedor@gnu.org>
7
 
 
8
 
   This file is part of the GNUstep Base Library.
9
 
 
10
 
   This library is free software; you can redistribute it and/or
11
 
   modify it under the terms of the GNU Lesser General Public
12
 
   License as published by the Free Software Foundation; either
13
 
   version 2 of the License, or (at your option) any later version.
14
 
   
15
 
   This library is distributed in the hope that it will be useful,
16
 
   but WITHOUT ANY WARRANTY; without even the implied warranty of
17
 
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
18
 
   Library General Public License for more details.
19
 
 
20
 
   You should have received a copy of the GNU Lesser General Public
21
 
   License along with this library; if not, write to the Free
22
 
   Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
23
 
   Boston, MA 02111 USA.
24
 
 
25
 
*/
26
 
 
27
 
#ifndef INCLUDED_NSObject_GNUstepBase_h
28
 
#define INCLUDED_NSObject_GNUstepBase_h
29
 
 
30
 
#import <GNUstepBase/GSVersionMacros.h>
31
 
#import <Foundation/NSObject.h>
32
 
 
33
 
#if     defined(__cplusplus)
34
 
extern "C" {
35
 
#endif
36
 
 
37
 
#if     OS_API_VERSION(GS_API_NONE,GS_API_LATEST)
38
 
 
39
 
@interface NSObject (GNUstepBase)
40
 
 
41
 
/**
42
 
  WARNING: The -compare: method for NSObject is deprecated
43
 
           due to subclasses declaring the same selector with 
44
 
           conflicting signatures.
45
 
           Comparision of arbitrary objects is not just meaningless
46
 
           but also dangerous as most concrete implementations
47
 
           expect comparable objects as arguments often accessing
48
 
           instance variables directly.
49
 
           This method will be removed in a future release.
50
 
*/
51
 
- (NSComparisonResult) compare: (id)anObject;
52
 
 
53
 
/** For backward compatibility only ... use class_isMetaClass() on the
54
 
 * class of the receiver instead.
55
 
 */
56
 
- (BOOL) isInstance;
57
 
 
58
 
/**
59
 
 * Transmutes the receiver into an immutable version of the same object
60
 
 * and returns the result.<br />
61
 
 * If the receiver is not a mutable object or cannot be simply transmuted,
62
 
 * then this method either returns the receiver unchanged or,
63
 
 * if the force flag is set to YES, returns an autoreleased copy of the
64
 
 * receiver.<br />
65
 
 * Mutable classes should override this default implementation.<br />
66
 
 * This method is used in methods which are declared to return immutable
67
 
 * objects (eg. an NSArray), but which create and build mutable ones
68
 
 * internally.
69
 
 */
70
 
- (id) makeImmutableCopyOnFail: (BOOL)force;
71
 
 
72
 
/**
73
 
 * Message sent when an implementation wants to explicitly exclude a method
74
 
 * (but cannot due to compiler constraint), and wants to make sure it is not
75
 
 * called by mistake.  Default implementation raises an exception at runtime.
76
 
 */
77
 
- (id) notImplemented: (SEL)aSel;
78
 
 
79
 
/**
80
 
 * Message sent when an implementation wants to explicitly require a subclass
81
 
 * to implement a method (but cannot at compile time since there is no
82
 
 * <code>abstract</code> keyword in Objective-C).  Default implementation
83
 
 * raises an exception at runtime to alert developer that he/she forgot to
84
 
 * override a method.
85
 
 */
86
 
- (id) subclassResponsibility: (SEL)aSel;
87
 
 
88
 
/**
89
 
 * Message sent when an implementation wants to explicitly exclude a method
90
 
 * (but cannot due to compiler constraint) and forbid that subclasses
91
 
 * implement it.  Default implementation raises an exception at runtime.  If a
92
 
 * subclass <em>does</em> implement this method, however, the superclass's
93
 
 * implementation will not be called, so this is not a perfect mechanism.
94
 
 */
95
 
- (id) shouldNotImplement: (SEL)aSel;
96
 
 
97
 
@end
98
 
 
99
 
#endif  /* OS_API_VERSION */
100
 
 
101
 
#if     defined(__cplusplus)
102
 
}
103
 
#endif
104
 
 
105
 
#endif  /* INCLUDED_NSObject_GNUstepBase_h */
106