From patchwork Thu May 4 17:45:50 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Steve Ellcey X-Patchwork-Id: 758734 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.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 3wJjBY362kz9s65 for ; Fri, 5 May 2017 03:46:29 +1000 (AEST) Authentication-Results: ozlabs.org; dkim=pass (1024-bit key; unprotected) header.d=gcc.gnu.org header.i=@gcc.gnu.org header.b="QGAOce5F"; dkim-atps=neutral DomainKey-Signature: a=rsa-sha1; c=nofws; d=gcc.gnu.org; h=list-id :list-unsubscribe:list-archive:list-post:list-help:sender :message-id:subject:from:reply-to:to:cc:date:in-reply-to :references:content-type:mime-version:content-transfer-encoding; q=dns; s=default; b=akRrU5qeZy980YlQzRcq8jVVaZUN8OtHYjf6ROsGPHq /OHjUbWtRzxfAS+5MbAnjMWdGfSGfPJN5j1nJBibso8tLRbqH5JyPzTXsSVa7nNn 92YO/bGQ4L2ZNzPYcanzsWHaowvZISEHBDBsnblZ3UeJxQtSTyFxn2f9AsoyJX10 = 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 :message-id:subject:from:reply-to:to:cc:date:in-reply-to :references:content-type:mime-version:content-transfer-encoding; s=default; bh=tnnaP4VRqjoKApaSo/ed1Dg6P6s=; b=QGAOce5Fv3FrwoxxH GekMApSvTyKVNkyvWSfc0Ui/U5c8b/vNYWUu1oLHxRFasVqgdPBf52cdGaOed5At I6+JXaE+EExiiyJEi2sop+SimZgjejLX5ugD/TPkWlJk9NrQgqdRUV9Oa+LHpEMp xh0FbMpqvxJjsKc55sdLVG41II= Received: (qmail 79070 invoked by alias); 4 May 2017 17:46:04 -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 78894 invoked by uid 89); 4 May 2017 17:45:56 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-25.6 required=5.0 tests=AWL, BAYES_00, GIT_PATCH_0, GIT_PATCH_1, GIT_PATCH_2, GIT_PATCH_3, RCVD_IN_DNSWL_NONE, SPF_HELO_PASS autolearn=ham version=3.3.2 spammy=tweaking, tomorrow X-HELO: NAM02-CY1-obe.outbound.protection.outlook.com Received: from mail-cys01nam02on0062.outbound.protection.outlook.com (HELO NAM02-CY1-obe.outbound.protection.outlook.com) (104.47.37.62) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with ESMTP; Thu, 04 May 2017 17:45:54 +0000 Authentication-Results: gmail.com; dkim=none (message not signed) header.d=none; gmail.com; dmarc=none action=none header.from=cavium.com; Received: from sellcey-dt.caveonetworks.com (50.233.148.156) by DM5PR07MB3468.namprd07.prod.outlook.com (10.164.153.23) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256_P256) id 15.1.1061.12; Thu, 4 May 2017 17:45:52 +0000 Message-ID: <1493919950.9224.6.camel@cavium.com> Subject: Re: [PATCH] Fix -fopt-info documentation in invoke.texi From: Steve Ellcey Reply-To: sellcey@cavium.com To: Richard Biener Cc: gcc-patches Date: Thu, 04 May 2017 10:45:50 -0700 In-Reply-To: References: <1493851880.29498.16.camel@cavium.com> Mime-Version: 1.0 X-ClientProxiedBy: CY4PR1201CA0017.namprd12.prod.outlook.com (10.172.75.27) To DM5PR07MB3468.namprd07.prod.outlook.com (10.164.153.23) X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 333614de-1231-4db3-115d-08d4931568c6 X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(22001)(201703131423075)(201703031133081); SRVR:DM5PR07MB3468; X-Microsoft-Exchange-Diagnostics: 1; DM5PR07MB3468; 3:nX56hFzspXcmdq78lNEsRoSqlkwbzSxQMLzWkq1hSSIJEpENfXyeBgx4wVOcS4uHNOouJg2NJOHD2DxUqkJwTwntxW5SfaL6YFHux9EyYllAPy4Mu1yNOQDqAx5M22oOzgxEgroeN3k7vu1xc5lDItAPhQvJnisyt9wQsI1F2d2KLKpi5HqR+Bt6A6dVGb+ZerKeb3eIa8OtEqDgy9U3NbSQkdR1CI5GLoWkm7nPO87BUJ8VIZcCau0DKrXgLS7WVTELqjnQc78KcipjKetqkYesbuwaMr9d2AfJMjUD/Ttg0e8hfbfDyqVUrR9Sva5ZyJQDGwJFmUcL8W0S7QPKlw==; 25:Jg5onRsKD+/rTjRfxl+F1M1t9ju2IXHCgYTsnAXRN48BKCJcIDeMqmK/LCDPNOcaga+KsmaDqAGGvnR9KZu93LdrQf2gEJtx7Zq3Imq5goRqO7Z5JNE4dJdIZo0F+L5QUwlFDM9VZX9PHGbgudOAM2rXQNWLxj9LJiNAAC7FuwrXR7bplbMalVLU/vCbbDIpKXRBTTooz3/voUYJOMHiSTpPNu6+eLWNXBhtNJlLxHUL6beOEPp7IcPWXuXWKgkinNxtE1q/magsnyiz/bm6oscSZaAWH5bYFeM7qxm2vzTkFsI4+MG/KhrdqYRwAtssflB7Tw5y+vTM0K9hfL59MWPubnEeTBbZu+6HOZA1jmg6TVvzUsscq2EglDJSFJKCDJ+BRocLdERQuil1AkdhJr6aAmCldco4UBs3MstT0SeQjBxVKZ3iMVTFA5QlblPiikYy0fyxona+8NpuiWar9Q== X-Microsoft-Exchange-Diagnostics: 1; DM5PR07MB3468; 31:O10p70Qoy5s84PZihX/o2wluDy9fR0sl5lmQEl34DoXLEiRsYTejgh0la3LWxkGQvalSqM3XDXwcIxoMIEZ2/UNpEWuwzUyT4FSmtvOqxAVUw6EUhSMyDMXKyoMqbJa657cLWsRchvC3Gcz3LJD7OU87eT3j5nJ+99hYUjvJULGnc1SF93qrZ/ogYJAkfA5gp/lSC6uXWtzQe6BVo6xnbswfLYaoTnx8QYDGlf7oZVYzKyrrNotFYNzV0GHIFRY2QE0jsdV6c7hwjEO8JAMB3KN6hFsnsGKvNFdN7klGFHI=; 20:KwdHNiSFoozjWgiETOxvyAOjsXAEI74jQjXzYmazpgyDU4LQQbJusBKzKZzMKjLSJvNRXO3IhUqplftMR8A9FwIWHORdkbt1gr4P0Mpa7JeJzbwMvfOCO7nKxTNeG2ewHb6mLZdDvDmODmVQPljqHOFbi7emOFGmPCccOMEDrWa9Lt3+80eml8XcpQWztR85G2s6WeYTmYLtwES/9VNTXpiDDqzBe/0fIjJDsaAbX3qSZZtWu1MrJRMhcfNOk8THFIeuS3gDhn1Fy4amYjckmtg2k65YacmoDcHaDBfeTvL8BJm0KbRhcNhOhLVwey3MfJSHyDeDl9TTX4CgOoLgK5he/ng4yVhOtmzUifp5Loa0WZIgBJ8M0hzt3wf6SixuhtR3GcnKceMFI7p5NcYQJjP0F6lGfa1mj96uTZMPvVa2KGooWigholMzlPwDTU1BFPsjUI8WJPaAnn8boPaFRL9aTqwSoTLmwHE0z2A4gPVemVyhgLbs4YuWWYRdb/HZ X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:; X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(6040450)(601004)(2401047)(5005006)(8121501046)(10201501046)(3002001)(93006095)(93001095)(6041248)(20161123562025)(20161123555025)(20161123560025)(20161123564025)(20161123558100)(201703131423075)(201702281528075)(201703061421075)(201703061406153)(6072148); SRVR:DM5PR07MB3468; BCL:0; PCL:0; RULEID:; SRVR:DM5PR07MB3468; X-Microsoft-Exchange-Diagnostics: 1; DM5PR07MB3468; 4:TbBFf2LyDvuecZuu0zmx9gf7D48leHTn7n01/OZmF1Ek5mA3cR2SPhmZJCKkax2XxO6mUVD5oVndfezEFaNvWrLWS0pAsPUDKQEiQWjXKORgwfjFzMMCt8tpuV0QZVWdPVqCJnKfTDuhmJP8i4Pz8LpZoHlTACCJwd7qK83aDOBD0S5lcIn0fSokiT2RTMiYverxwjc+o2QHlWG4XDD28SLE2Ys3wAn9MopZ9PNHaXFR/sefcSU9fUSnRIkllT7pjMDKPjxg6sjLZ/fXHgrWL92tJ8P4Xum2iVBef3ZS3EhdRQQ21wZdmWq6Fs44ZpSSGmXWk04mpqFe35OIf5pRbVeR0vXVeE47ZKo3mqisOG9ylZOUUGSzbHFch9J2d3pL7Gk2o22ed5sH2B/CnBzRmfSji1tJLV0FlUXQX7y/TRNgwAPd/vvEz6LApEUh3Z4ZA10GtXzMaSLf/057kl9HC9q+PUr46ZPDXSk2wHS2nDCLJZfg7+5fgwFtCqCFRPs8BXEH3JN+NcMvI32pSwav0/OYh4NMliqRyH6k4Yhbwq7UFSO3hVo7sl/Y5LG3+QDG9WnXzUuYtkOdIl+3iizRbdRV7pQ7m4NXdpzWFwnLaS+FF+dd48sGbu0oXHZO5R0jVfGGibJSZ9gJu7iP7r3cNWrBXB7UOIOdB113Tc/VTaVkNhOuKWh9H9xet0PQQwKYmBn2r4Qe9uyO7vhIUKDXCAtldW7TNhluUjPRNPoSmMbdcNblF3iaawPR6ftDzzN5VKXgKylSvuTb8htqmeo8koidZZFWjgB896DslfQzLzM= X-Forefront-PRVS: 02973C87BC X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10009020)(4630300001)(6009001)(39850400002)(39410400002)(39450400003)(39400400002)(39840400002)(377424004)(24454002)(50226002)(8676002)(189998001)(53936002)(81166006)(38730400002)(3450700001)(2870700001)(2906002)(36756003)(6116002)(110136004)(3846002)(229853002)(50466002)(6486002)(6506006)(6916009)(2950100002)(6512007)(66066001)(43066003)(5820100001)(47776003)(23676002)(5660300001)(7736002)(53416004)(103116003)(50986999)(25786009)(76176999)(305945005)(4326008)(42186005)(478600001)(33646002); DIR:OUT; SFP:1101; SCL:1; SRVR:DM5PR07MB3468; H:sellcey-dt.caveonetworks.com; FPR:; SPF:None; MLV:sfv; LANG:en; X-Microsoft-Exchange-Diagnostics: =?utf-8?B?MTtETTVQUjA3TUIzNDY4OzIzOmliNFJ4Qzd2b0hJeW1xS1NIMnhTK0VyVk9B?= =?utf-8?B?WnNaVTlhRUN0VkdPSGhuVkRrNExwclp1Um1laVBzKy9yek1CbjYvcm1zeUdR?= =?utf-8?B?VU9Ca0RhZ29uOTNHYXRYa2duS3hSall0TWRiN2NaTEJ6dlJ4YTBMZGhyeFZw?= =?utf-8?B?NzJHMHdxNURYNGMvS2NnN3dJSmNXSGw0cXJIS093Y3VxVUw4TGZmcGk2ZVJz?= =?utf-8?B?dUxUNmJ2dk44ciszZHJPclhpQm5YRlZqM240YnFyaDdvblFoV1ZpcjVQRHVj?= =?utf-8?B?NTNRVEhLeVRnRzhoOUpjSHErS2s5UkRQL1ZuQ2JwdjFoQm1PclhtakhMS3pR?= =?utf-8?B?WkM4OVRmV0M5OUlvbWV0L29WTU5WclZSUU12dVc3eWNIWVUxTGc1aVNHdWY3?= =?utf-8?B?cFZ6VE56YUxVd2ZNVFRyYkg2Yk1qWnBsdDU3aVlmUFdqbUNPUzI3T2JjSTZs?= =?utf-8?B?Z2VqNFpMbVV6aVZScGZSeHQ1VStpMWRtMnIwbVJVeUNNKzBaUzBYZmdPRnpq?= =?utf-8?B?VGNXdDhsNHdPSkxFTk9MdjgzWC9TSHVQaEFwSGNHY2lIQU1tZzh3UDNzbmJT?= =?utf-8?B?eFdSQ2hLYU9BVnA2dGZLbkRjVkc0V0grdXdHTzlZZVJIS0RZeTJuVDJmdmdt?= =?utf-8?B?TDdnSzJsSzZvbU5TdnZmVXYrU0lQVkVuSk1pMG40SHRYemdLazhWU2l0NHAz?= =?utf-8?B?VXlqcjRaL1ErdEhNYU05YXVJWUM2ZUZtYVdmb0FCbktYd21pN1VTaE1Pa2dU?= =?utf-8?B?MnZlWVNQeElCbm44M2hjNE9HblI2T0pQRzA1RjlqNTRCVzgrU1kzaFBwcmxM?= =?utf-8?B?ZmR6M2x6b2hkNEdMdFVFdjFYaU9pTFB4V2pTYjdmNmUvZytlenJuWnR3anVL?= =?utf-8?B?eXQ5WjRrS0xzL1gyUXIwTmVIbFhtZVVrbE41TWU0RlUrSFk4TDIzbHlGbU1i?= =?utf-8?B?VFhBaStuUllNOFNFVzg0K2g5NkRWcFhmbEQyRFR0K25sWlhnRGhCc3NiMFVX?= =?utf-8?B?VHBEL3QwZi9JTFVZbWRLWWMwL3djUGJ5WndmSSs3U05XWEpoZ2Z3bmg0TUpD?= =?utf-8?B?RjVYV2dOczhQZFpGOVdtWEpmM1lvSHU0b3RuU2hNVUNKRkhscmFJQklpREJt?= =?utf-8?B?U09pV2ttTEF4RWtkOXM0dGVxU1RmbkoydkRxUWVzanBlYXhtaGRmeHFiSlFV?= =?utf-8?B?ajlwWkphc3BCZW9FdVFkcFZ2Qk9kYnNRZmpBWVErVjlGODlvZFVGb1k2Rnhy?= =?utf-8?B?cFFKK0dncVdYZ1BudkFGc3pudEN0djN5SmdXUFBKQUJaM1c4eG9ZRDZFRGtO?= =?utf-8?B?d2xzVlZhREp6YlJydU5QRTMwUzZyTXA4cWZXaTBNSitmcmhKQ0Z0RGFWL3F5?= =?utf-8?B?TWsydWRCVFZhQ3ErbWQxaXFBL3QrM21MM0NnMVM2ZFNwdHNydjJrU0xteVFj?= =?utf-8?B?NmRJZlRKTjAxSmVqb0Z0ak1KU0hoNG54eTZkRUM2THF3MjFVL25IK21Qenph?= =?utf-8?B?QW80YnBIMGFjQzBYbjBlVitWdEg4NExiajV6K1JTNFZCZTdMd2J5QnpPSHY2?= =?utf-8?B?bmV0T1h5dnM4b2tMeStvUDJtcFhuR0E9PQ==?= X-Microsoft-Exchange-Diagnostics: 1; DM5PR07MB3468; 6:3uAEVnSuB+uGCqOuMeMg4+LgW8KaM4fOI/eGbk5mDSqhYHbeUf/slVvx33w/G+cl93W0exL4laS7UwyUixraKaMEVZcomcnJbXgx4WiZJnPTiujxOfq0r55B+x7n3KjTt+1YTcB0qRRsaKDrW6BLiiPa4BZNIzwNGe4iUC3bPLRXiNXxLoZOembJO7BDmVX26y/DWiApO0iag3wX0Bm7534iqzalvO77OruaDtbE4gzMNGDFRvUwQgwto7S7JengYkqyseVCXxZu3GiqRPgHj2wAFILQIZyp8PLmoKCr9DR3XlkP4KRS8b8VwdUztsiQCzXaMtb10MxANSsHY0GR1LUr/blhU1pbQMIl8XthqD09z6hj42IUnOjsRlrrnGbi7i/bls6lYgnoqP0XGAwCcFjltM4RIxA5TQtOwdX76cwUmhvnv9asib7eF6I4vVjXOOUEAv8AoHhTFxYw5DR6FL5Tbxb3iC2pQwYyBH4ez4Iw5+PmgA12GOKso0zbZ/rXLbfqqNsPrWd4R9YmfGp1Wg==; 5:Gym7hFVTA2uZqPwz9pDuSjmZdQpXH5n4M9+bOYKKjeEsBaKsa9JPvOaxKzZtnK4+HDM5o/Ot/kqH2j+mPKBM9FZvCaKSFaAggaoajH0WVrRQn66jurRFujnJYN+7BbXwdxV1PXinl2PNnepfX2aFfw==; 24:M7XzPkyxDrAReHuCNyfag8Km7CGGrGht06N2LhgCUcU08EdgTi3rBWEYoUG7YiQOJrfiyEwsuBwSUrOIQz1F8/T43MxeU3B6iK4jIIgh79Q= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1; DM5PR07MB3468; 7:NKLie0XYTflE1MrtNmc3ceuaRJldhhHM4ADqBn6DqZKaz5XPpW7IlO+h/AeyxxjM0uectHfDa9YrHQzb5SxssHcURuY9ZpJAD9pozHeGEhHMetY5ehtvT01bwb+kmGMZhIiVYl1l+jXuUepoXMiUjc9Ql3FHSXIsaK3RNox7U6D/5tcQsYD56xzY7DlzXG5fCroohfbEoesS91kWvBKM1lwp/MBxRd9JfbrDBF/QLYPFsB/gFoLJ8b/MTxCbXRvzsWTA8T4CL1n+CVPR5MPTtaEOfkYgRNcoD7f2jBtvL3K3pXRgJiCUkL3oQRy4YII/x0X5AbLOk3GTLbsnM+MSBA== X-OriginatorOrg: cavium.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 04 May 2017 17:45:52.5098 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM5PR07MB3468 On Thu, 2017-05-04 at 12:24 +0200, Richard Biener wrote: > > > > OK to checkin? > Ok for trunk and branches. > > Richard. I just realized there is a problem/inconsistency with my patch. The ChangeLog says I am changing invoke.texi but the change is actually to optinfo.texi. It looks like invoke.texi and optinfo.texi have the same examples in them but changes in one did not necessarily get duplicated in the other. That is why I got confused. invoke.texi already has the right default (optimized-optall) for -fopt-info but optinfo.texi has the wrong one. Here is an updated patch, the changes to optinfo.texi are the same but I am also tweaking invoke.texi to include the explicit ordering statement I put in optinfo.texi and I fixed the ChangeLog entry to match the actual patch. Since the actual textual changes are the same as before (just not where I said they were) I will go ahead and check this in tomorrow unless there are objections. Steve Ellcey sellcey@cavium.com 2017-05-05  Steve Ellcey   * doc/invoke.texi (-fopt-info): Explicitly say order of options included in -fopt-info does not matter. * doc/optinfo.texi (-fopt-info): Fix description of default behavour. Explicitly say order of options included in -fopt-info does not matter. diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi index 68a558e..57c9678 100644 --- a/gcc/doc/invoke.texi +++ b/gcc/doc/invoke.texi @@ -13219,7 +13219,8 @@ gcc -O2 -ftree-vectorize -fopt-info-vec-missed  prints information about missed optimization opportunities from  vectorization passes on @file{stderr}.    Note that @option{-fopt-info-vec-missed} is equivalent to  -@option{-fopt-info-missed-vec}. +@option{-fopt-info-missed-vec}.  The order of the optimization group +names and message types listed after @option{-fopt-info} does not matter.    As another example,  @smallexample diff --git a/gcc/doc/optinfo.texi b/gcc/doc/optinfo.texi index e17cb37..7e32efe 100644 --- a/gcc/doc/optinfo.texi +++ b/gcc/doc/optinfo.texi @@ -208,16 +208,18 @@ optimized locations from all the inlining passes into  If the @var{filename} is provided, then the dumps from all the  applicable optimizations are concatenated into the @file{filename}.  Otherwise the dump is output onto @file{stderr}. If @var{options} is -omitted, it defaults to @option{all-all}, which means dump all -available optimization info from all the passes. In the following -example, all optimization info is output on to @file{stderr}. +omitted, it defaults to @option{optimized-optall}, which means dump +all information about successful optimizations from all the passes. +In the following example, the optimization information is output on +to @file{stderr}.    @smallexample  gcc -O3 -fopt-info  @end smallexample    Note that @option{-fopt-info-vec-missed} behaves the same as -@option{-fopt-info-missed-vec}. +@option{-fopt-info-missed-vec}.  The order of the optimization group +names and message types listed after @option{-fopt-info} does not matter.    As another example, consider