* ObjC documentation - standards
@ 2010-09-28 15:11 Nicola Pero
2010-09-29 14:27 ` Mike Stump
0 siblings, 1 reply; 2+ messages in thread
From: Nicola Pero @ 2010-09-28 15:11 UTC (permalink / raw)
To: gcc-patches
[-- Attachment #1: Type: text/plain, Size: 243 bytes --]
This fills in the gcc/doc/standards.texi document with information on what version of Objective-C is currently supported by GCC.
Hopefully we'll be able to say more positive things about "Objective-C 2.0" support in the future ;-)
Thanks
[-- Attachment #2: patch --]
[-- Type: application/octet-stream, Size: 3712 bytes --]
Index: gcc/doc/standards.texi
===================================================================
--- gcc/doc/standards.texi (revision 164678)
+++ gcc/doc/standards.texi (working copy)
@@ -208,24 +208,54 @@ no C++ language dialect options are given, is @opt
@cindex Objective-C
@cindex Objective-C++
-There is no formal written standard for Objective-C or Objective-C++@. The most
-authoritative manual is ``Object-Oriented Programming and the
-Objective-C Language'', available at a number of web sites:
+GCC supports ``traditional'' Objective-C (also known as ``Objective-C
+1.0''), and contains support for the Objective-C exception and
+synchronization syntax. At the time of writing, it has no support for
+``Objective-C 2.0'' language extensions. GCC supports Objective-C++
+and features available in Objective-C are also available in
+Objective-C++@.
+GCC by default uses the GNU Objective-C runtime library, which is part
+of GCC and is not the same as the Apple/NeXT Objective-C runtime
+library used on Apple systems. There are a number of differences
+documented in this manual. The options @option{-fgnu-runtime} and
+@option{-fnext-runtime} allow you to switch between producing output
+that works with the GNU Objective-C runtime library and output that
+works with the Apple/NeXT Objective-C runtime library.
+
+There is no formal written standard for Objective-C or Objective-C++@.
+The authoritative manual on traditional Objective-C (1.0) is
+``Object-Oriented Programming and the Objective-C Language'',
+available at a number of web sites:
@itemize
@item
-@uref{http://developer.apple.com/@/mac/@/library/@/documentation/@/Cocoa/@/Conceptual/@/ObjectiveC/}
-is a recent (and periodically updated) version;
+@uref{http://www.gnustep.org/@/resources/@/documentation/@/ObjectivCBook.pdf}
+is the original NeXTstep document;
@item
@uref{http://objc.toodarkpark.net}
-is an older example;
+is the same document in another format;
@item
-@uref{http://www.gnustep.org}
-and
-@uref{http://gcc.gnu.org/readings.html}
-have additional useful information.
+@uref{http://developer.apple.com/@/mac/@/library/@/documentation/@/Cocoa/@/Conceptual/@/ObjectiveC/}
+has an updated version but make sure you search for ``Object Oriented Programming and the Objective-C Programming Language 1.0'',
+not documentation on the newer ``Objective-C 2.0'' language
@end itemize
+The Objective-C exception and synchronization syntax (that is, the
+keywords @@try, @@throw, @@catch, @@finally and @@synchronized) is
+fully supported by GCC and is enabled with the option
+@option{-fobjc-exceptions}. The syntax is briefly documented in this
+manual and in the Objective-C 2.0 manuals from Apple.
+
+At the time of writing, GCC supports no Objective-C 2.0 features. The
+authoritative manual on Objective-C 2.0 is available from Apple:
+@itemize
+@item
+@uref{http://developer.apple.com/@/mac/@/library/@/documentation/@/Cocoa/@/Conceptual/@/ObjectiveC/}
+@end itemize
+
+For more information concerning the history of Objective-C that is
+available online, see @uref{http://gcc.gnu.org/readings.html}
+
@xref{Top, GNAT Reference Manual, About This Guide, gnat_rm,
GNAT Reference Manual}, for information on standard
conformance and compatibility of the Ada compiler.
Index: gcc/ChangeLog
===================================================================
--- gcc/ChangeLog (revision 164678)
+++ gcc/ChangeLog (working copy)
@@ -1,3 +1,8 @@
+2010-09-28 Nicola Pero <nicola.pero@meta-innovation.com>
+
+ * doc/standards.texi (Standards): Expanded the section on
+ Objective-C and Objective-C++.
+
2010-09-28 Tristan Gingold <gingold@adacore.com>
* config/avr/avr.c (expand_prologue): Set
^ permalink raw reply [flat|nested] 2+ messages in thread
* Re: ObjC documentation - standards
2010-09-28 15:11 ObjC documentation - standards Nicola Pero
@ 2010-09-29 14:27 ` Mike Stump
0 siblings, 0 replies; 2+ messages in thread
From: Mike Stump @ 2010-09-29 14:27 UTC (permalink / raw)
To: Nicola Pero; +Cc: gcc-patches
On Sep 28, 2010, at 3:40 AM, Nicola Pero wrote:
> This fills in the gcc/doc/standards.texi document with information on what version of Objective-C is currently supported by GCC.
You didn't ask Ok? I thought you just checked it in.
Ok.
^ permalink raw reply [flat|nested] 2+ messages in thread
end of thread, other threads:[~2010-09-28 22:02 UTC | newest]
Thread overview: 2+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2010-09-28 15:11 ObjC documentation - standards Nicola Pero
2010-09-29 14:27 ` Mike Stump
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).