From patchwork Thu Oct 29 16:55:30 2015 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: James Greenhalgh X-Patchwork-Id: 55792 Delivered-To: patch@linaro.org Received: by 10.112.61.134 with SMTP id p6csp674417lbr; Thu, 29 Oct 2015 09:56:00 -0700 (PDT) X-Received: by 10.107.170.220 with SMTP id g89mr4530330ioj.178.1446137759934; Thu, 29 Oct 2015 09:55:59 -0700 (PDT) Return-Path: Received: from sourceware.org (server1.sourceware.org. [209.132.180.131]) by mx.google.com with ESMTPS id cq3si27268158igb.32.2015.10.29.09.55.59 for (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Thu, 29 Oct 2015 09:55:59 -0700 (PDT) Received-SPF: pass (google.com: domain of gcc-patches-return-412011-patch=linaro.org@gcc.gnu.org designates 209.132.180.131 as permitted sender) client-ip=209.132.180.131; Authentication-Results: mx.google.com; spf=pass (google.com: domain of gcc-patches-return-412011-patch=linaro.org@gcc.gnu.org designates 209.132.180.131 as permitted sender) smtp.mailfrom=gcc-patches-return-412011-patch=linaro.org@gcc.gnu.org; dkim=pass header.i=@gcc.gnu.org DomainKey-Signature: a=rsa-sha1; c=nofws; d=gcc.gnu.org; h=list-id :list-unsubscribe:list-archive:list-post:list-help:sender:from :to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-type; q=dns; s=default; b=C3ppsFj9UKIgZgNI KTAyEDe7+BOyCe2qsb5hXT8IWkof24sQ2OAtNyJgUGtBJ/2tS7/cBmWqBEpJby2b iA5bVsM1L0zZQFa/vu+0YSWoP3DSs79xrVQ8QKAkwoZKP9zkKkiI+1zxlq6uFMxy 0xdcp7hvfCUB2o0Cb8HAKvKjNHU= 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:from :to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-type; s=default; bh=1ecN5uJNFIwfcYno+gr6ac Moy4g=; b=tM+GbjwZdPmRDeg04Zs05VzFd99t/X5uX1HVIxagAT/N1c/jh76CZ1 wUwK0nDy8jdnazsBnvvwBJ5xUtrN/IlPk/UZ9z9pJFFweS0HMlfwg/A+OSWOpPcR Ge6d/4UtFPVh3qh598dMsDA6Qo7SIUeSNfw/5ks0TQhEJRLiw1Bu8= Received: (qmail 64364 invoked by alias); 29 Oct 2015 16:55:43 -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 64355 invoked by uid 89); 29 Oct 2015 16:55:42 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-1.8 required=5.0 tests=AWL, BAYES_00, SPF_PASS autolearn=ham version=3.3.2 X-HELO: eu-smtp-delivery-143.mimecast.com Received: from eu-smtp-delivery-143.mimecast.com (HELO eu-smtp-delivery-143.mimecast.com) (146.101.78.143) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with ESMTP; Thu, 29 Oct 2015 16:55:40 +0000 Received: from cam-owa1.Emea.Arm.com (fw-tnat.cambridge.arm.com [217.140.96.140]) by eu-smtp-1.mimecast.com with ESMTP id uk-mta-11-LNLnssnBTM-C3nT0B-N3Dw-1; Thu, 29 Oct 2015 16:55:35 +0000 Received: from e107456-lin.cambridge.arm.com ([10.1.2.79]) by cam-owa1.Emea.Arm.com with Microsoft SMTPSVC(6.0.3790.3959); Thu, 29 Oct 2015 16:55:35 +0000 From: James Greenhalgh To: gcc-patches@gcc.gnu.org Cc: gerald@pfeifer.com, joseph@codesourcery.com, sandra@codesourcery.com Subject: Re: [Docs] Reword the documentation for -fdump-rtl- Date: Thu, 29 Oct 2015 16:55:30 +0000 Message-Id: <1446137730-22239-1-git-send-email-james.greenhalgh@arm.com> In-Reply-To: <563247A9.6080407@codesourcery.com> References: <563247A9.6080407@codesourcery.com> MIME-Version: 1.0 X-MC-Unique: LNLnssnBTM-C3nT0B-N3Dw-1 X-IsSubscribed: yes Hi Sandra, Thanks for the review. On Thu, Oct 29, 2015 at 10:22:01AM -0600, Sandra Loosemore wrote: > s/will be registered/are registered/ Fixed, alongside other occurrences. > >+registered by plugins, which are specific to compilation targets, or > >+which are otherwise registered after all the other passes, will be > > This is ambiguous. Do you mean > > "passes registered by plugins (which are specific to compilation > targets or otherwise registered after all the other passes)" > > or > > "passes registered by plugins, passes specific to compilation > targets, or passes that are otherwise registered after all the other > passes" > The latter, fixed. > -Sandra the nit-picky :-) OK for trunk? Thanks, James --- 2015-10-29 James Greenhalgh * doc/invoke.texi (fdump-rtl-@var{pass}): Clarify relationship between pass numbering and execution order. diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi index 76fdc31..5549f17 100644 --- a/gcc/doc/invoke.texi +++ b/gcc/doc/invoke.texi @@ -6665,17 +6665,19 @@ Says to make debugging dumps during compilation at times specified by @var{letters}. This is used for debugging the RTL-based passes of the compiler. The file names for most of the dumps are made by appending a pass number and a word to the @var{dumpname}, and the files are -created in the directory of the output file. In case of +created in the directory of the output file. In case of @option{=@var{filename}} option, the dump is output on the given file -instead of the pass numbered dump files. Note that the pass number is -computed statically as passes get registered into the pass manager. -Thus the numbering is not related to the dynamic order of execution of -passes. In particular, a pass installed by a plugin could have a -number over 200 even if it executed quite early. @var{dumpname} is -generated from the name of the output file, if explicitly specified -and it is not an executable, otherwise it is the basename of the -source file. These switches may have different effects when -@option{-E} is used for preprocessing. +instead of the pass numbered dump files. Note that the pass number is +assigned as passes are registered into the pass manager. Most passes +are registered in the order that they will execute and for these passes +the number corresponds to the pass execution order. However, passes +registered by plugins, passes specific to compilation targets, or +passes which are otherwise registered after all the other passes are +numbered higher than a pass named "final", even if they are executed +earlier. @var{dumpname} is generated from the name of the output +file if explicitly specified and not an executable, otherwise it is +the basename of the source file. These switches may have different +effects when @option{-E} is used for preprocessing. Debug dumps can be enabled with a @option{-fdump-rtl} switch or some @option{-d} option @var{letters}. Here are the possible