From patchwork Wed Jun 8 23:04:40 2011 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Nicola Pero X-Patchwork-Id: 99584 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from sourceware.org (server1.sourceware.org [209.132.180.131]) by ozlabs.org (Postfix) with SMTP id 92FABB6FD6 for ; Thu, 9 Jun 2011 09:04:59 +1000 (EST) Received: (qmail 26024 invoked by alias); 8 Jun 2011 23:04:58 -0000 Received: (qmail 26014 invoked by uid 22791); 8 Jun 2011 23:04:57 -0000 X-SWARE-Spam-Status: No, hits=-1.4 required=5.0 tests=AWL, BAYES_00, TW_BJ, T_RP_MATCHES_RCVD X-Spam-Check-By: sourceware.org Received: from fencepost.gnu.org (HELO fencepost.gnu.org) (140.186.70.10) by sourceware.org (qpsmtpd/0.43rc1) with ESMTP; Wed, 08 Jun 2011 23:04:43 +0000 Received: from eggs.gnu.org ([140.186.70.92]:34324) by fencepost.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1QURnm-0007gy-8f for gcc-patches@gnu.org; Wed, 08 Jun 2011 19:04:42 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1QURnl-0003jv-3b for gcc-patches@gnu.org; Wed, 08 Jun 2011 19:04:42 -0400 Received: from smtp131.iad.emailsrvr.com ([207.97.245.131]:49389) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QURnl-0003jr-03 for gcc-patches@gnu.org; Wed, 08 Jun 2011 19:04:41 -0400 Received: from localhost (localhost.localdomain [127.0.0.1]) by smtp23.relay.iad1a.emailsrvr.com (SMTP Server) with ESMTP id 2A5203489AE for ; Wed, 8 Jun 2011 19:04:40 -0400 (EDT) Received: from dynamic10.wm-web.iad.mlsrvr.com (dynamic10.wm-web.iad1a.rsapps.net [192.168.2.217]) by smtp23.relay.iad1a.emailsrvr.com (SMTP Server) with ESMTP id 174813489A6 for ; Wed, 8 Jun 2011 19:04:40 -0400 (EDT) Received: from meta-innovation.com (localhost [127.0.0.1]) by dynamic10.wm-web.iad.mlsrvr.com (Postfix) with ESMTP id 0393547880A9 for ; Wed, 8 Jun 2011 19:04:40 -0400 (EDT) Received: by www2.webmail.us (Authenticated sender: nicola.pero@meta-innovation.com, from: nicola.pero@meta-innovation.com) with HTTP; Thu, 9 Jun 2011 01:04:40 +0200 (CEST) Date: Thu, 9 Jun 2011 01:04:40 +0200 (CEST) Subject: libobjc: updated documentation for removal of traditional API From: "Nicola Pero" To: "gcc-patches@gnu.org" MIME-Version: 1.0 X-Type: plain Message-ID: <1307574280.013430755@www2.webmail.us> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-Received-From: 207.97.245.131 X-IsSubscribed: yes Mailing-List: contact gcc-patches-help@gcc.gnu.org; run by ezmlm Precedence: bulk List-Id: List-Unsubscribe: List-Archive: List-Post: List-Help: Sender: gcc-patches-owner@gcc.gnu.org Delivered-To: mailing list gcc-patches@gcc.gnu.org This patch (trivially) updates the libobjc documentation to state that the Traditional Objective-C runtime API is no longer available. Committed to trunk. Thanks Index: ChangeLog =================================================================== --- ChangeLog (revision 174821) +++ ChangeLog (working copy) @@ -1,3 +1,8 @@ +2011-06-09 Nicola Pero + + * doc/objc.texi (Traditional GNU Objective-C runtime API): + Updated. + 2011-06-08 Alexandre Oliva * tree-flow-inline.h (op_iter_init): Reject GIMPLE_PHI stmts. Index: doc/objc.texi =================================================================== --- doc/objc.texi (revision 174821) +++ doc/objc.texi (working copy) @@ -121,25 +121,9 @@ different naming convention, such as @code{class_g API). Software using this API includes the file @file{objc/objc-api.h} where it is declared. -The traditional API is deprecated but it is still supported in this -release of the runtime; you can access it as usual by including -@file{objc/objc-api.h}. +Starting with GCC 4.7.0, the traditional GNU runtime API is no longer +available. -If you are using the traditional API you are urged to upgrade your -software to use the modern API because the traditional API requires -access to private runtime internals to do anything serious with it; -for this reason, there is no guarantee that future releases of the GNU -Objective-C runtime library will be able to provide a fully compatible -@file{objc/objc-api.h} as the private runtime internals change. It is -expected that the next release will hide a number of runtime internals -making the traditional API nominally supported but fairly useless -beyond very simple use cases. - -Finally, you can not include both @file{objc/objc-api.h} and -@file{objc/runtime.h} at the same time. The traditional and modern -APIs unfortunately have some conflicting declarations (such as the one -for @code{Method}) and can not be used at the same time. - @c ========================================================================= @node Executing code before main @section @code{+load}: Executing code before main