From patchwork Tue Oct 29 09:53:03 2013 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: =?utf-8?q?Martin_Li=C5=A1ka?= X-Patchwork-Id: 286775 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]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (Client did not present a certificate) by ozlabs.org (Postfix) with ESMTPS id 1ABE42C0146 for ; Tue, 29 Oct 2013 20:53:20 +1100 (EST) DomainKey-Signature: a=rsa-sha1; c=nofws; d=gcc.gnu.org; h=list-id :list-unsubscribe:list-archive:list-post:list-help:sender :mime-version:date:message-id:subject:from:to:content-type; q= dns; s=default; b=y2Abyo434LVbd0c699R9y9b7HkRhz1VG3lyRVnx7jKQjkF pn1g3F2Netdm9yVXRB/h+sVsECjc96j4TWgqN326DXVhvbLvHruFXjaqRsxDQDv7 89bq574oBO3jllQkev6nUW1H86cWhMv9OpHuzz1WNiXE4t8Xn4xlQcJpP1qYE= DKIM-Signature: v=1; a=rsa-sha1; c=relaxed; d=gcc.gnu.org; h=list-id :list-unsubscribe:list-archive:list-post:list-help:sender :mime-version:date:message-id:subject:from:to:content-type; s= default; bh=nlVrmvZ5vdrLfkeH8mFYqNBh+3E=; b=flUYDjcfj0I1pxopMlN9 LCNV2NAH5rNog/MyzSGtJQqjhCX4SWTnD0VSdS4Y5TSTl8PX+h+6Inhr7tjVomuo XVsCYbdNs1OVL4M63Q2+Ddgjz9Qo4ZsPHr1N2Uum83BGew85TQs9FQVk03ZbpYBy XO3G7soyc4U34i+eBMHufGU= Received: (qmail 32767 invoked by alias); 29 Oct 2013 09:53:10 -0000 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 Received: (qmail 32667 invoked by uid 89); 29 Oct 2013 09:53:09 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-2.9 required=5.0 tests=AWL, BAYES_00, FREEMAIL_FROM, RCVD_IN_DNSWL_LOW, SPF_PASS autolearn=ham version=3.3.2 X-HELO: mail-pa0-f45.google.com Received: from mail-pa0-f45.google.com (HELO mail-pa0-f45.google.com) (209.85.220.45) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with (AES128-SHA encrypted) ESMTPS; Tue, 29 Oct 2013 09:53:08 +0000 Received: by mail-pa0-f45.google.com with SMTP id kp14so8317738pab.32 for ; Tue, 29 Oct 2013 02:53:03 -0700 (PDT) MIME-Version: 1.0 X-Received: by 10.67.23.164 with SMTP id ib4mr30389404pad.42.1383040383230; Tue, 29 Oct 2013 02:53:03 -0700 (PDT) Received: by 10.68.28.70 with HTTP; Tue, 29 Oct 2013 02:53:03 -0700 (PDT) Date: Tue, 29 Oct 2013 10:53:03 +0100 Message-ID: Subject: [PATCH] tree-ssa documetation fix From: =?UTF-8?Q?Martin_Li=C5=A1ka?= To: gcc-patches X-IsSubscribed: yes Hello, I've noticed that some part of documentation is obsolete and this patch adds documentation for new functions that replace old macros. Thanks, Martin diff --git a/ChangeLog b/ChangeLog index 1c50b9b..d64fbcf 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,8 @@ +2013-10-29 Martin Liska + + * doc/tree-ssa.texi: Newly added functions that replace old macros + are documented. + 2013-10-21 Cong Hou * MAINTAINERS (Write After Approval): Add myself. diff --git a/gcc/doc/tree-ssa.texi b/gcc/doc/tree-ssa.texi index aaf741b..93f596d 100644 --- a/gcc/doc/tree-ssa.texi +++ b/gcc/doc/tree-ssa.texi @@ -526,31 +526,29 @@ the result of ``merging'' @code{a_1}, @code{a_2} and @code{a_3}. Hence, PHI nodes mean ``one of these operands. I don't know which''. -The following macros can be used to examine PHI nodes +The following functions can be used to examine PHI nodes -@defmac PHI_RESULT (@var{phi}) +@defun gimple_phi_result (@var{phi}) Returns the @code{SSA_NAME} created by PHI node @var{phi} (i.e., @var{phi}'s LHS)@. -@end defmac +@end defun -@defmac PHI_NUM_ARGS (@var{phi}) +@defun gimple_phi_num_args (@var{phi}) Returns the number of arguments in @var{phi}. This number is exactly the number of incoming edges to the basic block holding @var{phi}@. -@end defmac +@end defun -@defmac PHI_ARG_ELT (@var{phi}, @var{i}) -Returns a tuple representing the @var{i}th argument of @var{phi}@. -Each element of this tuple contains an @code{SSA_NAME} @var{var} and -the incoming edge through which @var{var} flows. -@end defmac +@defun gimple_phi_arg (@var{phi}, @var{i}) +Returns @var{i}th argument of @var{phi}@. +@end defun -@defmac PHI_ARG_EDGE (@var{phi}, @var{i}) +@defun gimple_phi_arg_edge (@var{phi}, @var{i}) Returns the incoming edge for the @var{i}th argument of @var{phi}. -@end defmac +@end defun -@defmac PHI_ARG_DEF (@var{phi}, @var{i}) +@defun gimple_phi_arg_def (@var{phi}, @var{i}) Returns the @code{SSA_NAME} for the @var{i}th argument of @var{phi}. -@end defmac +@end defun @subsection Preserving the SSA form