From patchwork Thu May 17 18:36:03 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Toon Moene X-Patchwork-Id: 915712 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Authentication-Results: ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=gcc.gnu.org (client-ip=209.132.180.131; helo=sourceware.org; envelope-from=gcc-patches-return-477881-incoming=patchwork.ozlabs.org@gcc.gnu.org; receiver=) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=moene.org Authentication-Results: ozlabs.org; dkim=pass (1024-bit key; unprotected) header.d=gcc.gnu.org header.i=@gcc.gnu.org header.b="sbKHu6WM"; dkim-atps=neutral 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 40n0PY2v5rz9s47 for ; Fri, 18 May 2018 04:36:16 +1000 (AEST) DomainKey-Signature: a=rsa-sha1; c=nofws; d=gcc.gnu.org; h=list-id :list-unsubscribe:list-archive:list-post:list-help:sender:to :from:subject:message-id:date:mime-version:content-type; q=dns; s=default; b=pDI7g2Bab6qoBfWcnidJh7cgY8ZF1InzAossHzGeCBknYEj0Pm sxLpKMJQ6Iw4LD8Bd2ooRjAQYbIwhyozmS4bWSUf/nkc5TDUoKtq6KLo8LKpN7fw Gvibc6taGE76GwfEa7G9vuWWdPZHr1wagfkHyr4E+SUhjSkPq1H+GnNCs= 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:to :from:subject:message-id:date:mime-version:content-type; s= default; bh=6NiBQEVhRaNuKPrTNTb2D5avCJI=; b=sbKHu6WMhrTn+VPwiqrU p2sBgs7AV5ajvxfDo2pEXORrUMLYScBKgXCZIQAn+zwTPq/x0jekVH/EwADeqBpB lWHnezMzRaNqPCwZ+FBa3lIJYbfjW+45OYBR5ugyXo07SDLDVkHiVojB2kyt5J1v eNoiZH4W3xMvptRCmizvMOg= Received: (qmail 5951 invoked by alias); 17 May 2018 18:36:08 -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 5928 invoked by uid 89); 17 May 2018 18:36:07 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-14.4 required=5.0 tests=AWL, BAYES_00, GIT_PATCH_1, GIT_PATCH_2, GIT_PATCH_3, KAM_LAZY_DOMAIN_SECURITY, KAM_SHORT autolearn=ham version=3.3.2 spammy=Netherlands, netherlands, opindex, @opindex X-HELO: moene.org Received: from moene.org (HELO moene.org) (80.101.130.238) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with ESMTP; Thu, 17 May 2018 18:36:06 +0000 Received: from [::1] (helo=moene.org) by moene.org with esmtp (Exim 4.91) (envelope-from ) id 1fJNkx-000G4h-FD for gcc-patches@gcc.gnu.org; Thu, 17 May 2018 20:36:03 +0200 To: "gcc-patches@gcc.gnu.org" From: Toon Moene Subject: Documentation patch for -floop-interchange and -floop-unroll-and-jam. Message-ID: <98c60f5c-cd60-3826-6f4c-d8940980e011@moene.org> Date: Thu, 17 May 2018 20:36:03 +0200 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/20100101 Thunderbird/52.7.0 MIME-Version: 1.0 X-IsSubscribed: yes The documentation of both options is still inconsistent, in both the trunk and the gcc-8 branch. The following is my suggestion to clear this up (and move -floop-unroll-and-jam close to -floop-interchange. ChangeLog: 2018-05-17 Toon Moene * doc/invoke.texi: Move -floop-unroll-and-jam documentation directly after that of -floop-interchange. Indicate that both options are enabled by default when specifying -O3. OK for trunk and gcc-8 ? Index: invoke.texi =================================================================== --- invoke.texi (revision 260287) +++ invoke.texi (working copy) @@ -8866,7 +8866,14 @@ for (int j = 0; j < N; j++) c[i][j] = c[i][j] + a[i][k]*b[k][j]; @end smallexample +This flag is enabled by default at @option{-O3}. +@item -floop-unroll-and-jam +@opindex floop-unroll-and-jam +Apply unroll and jam transformations on feasible loops. In a loop +nest this unrolls the outer loop by some factor and fuses the resulting +multiple inner loops. This flag is enabled by default at @option{-O3}. + @item -ftree-loop-im @opindex ftree-loop-im Perform loop invariant motion on trees. This pass moves only invariants that @@ -10038,12 +10045,6 @@ Move branches with loop invariant conditions out of the loop, with duplicates of the loop on both branches (modified according to result of the condition). -@item -floop-unroll-and-jam -@opindex floop-unroll-and-jam -Apply unroll and jam transformations on feasible loops. In a loop -nest this unrolls the outer loop by some factor and fuses the resulting -multiple inner loops. - @item -ffunction-sections @itemx -fdata-sections @opindex ffunction-sections