From patchwork Mon Dec 18 05:54:07 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Sandra Loosemore X-Patchwork-Id: 849799 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-469442-incoming=patchwork.ozlabs.org@gcc.gnu.org; receiver=) Authentication-Results: ozlabs.org; dkim=pass (1024-bit key; unprotected) header.d=gcc.gnu.org header.i=@gcc.gnu.org header.b="CEbBFMzX"; 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 3z0Vbq5LZjz9s7m for ; Mon, 18 Dec 2017 16:54:28 +1100 (AEDT) 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=RXEELev/eeWDHgaRS/X4umxQHraayuUYDfP8v4B7veZ9olrLun hSP7qQK4MVhKu0CX91VbFWpggD//oRZtVqy0h2r/R+p7vMhk82B5NpZgpwtkMyh2 W1NUIxH/RICdjPs3Oky3Y7CZ4Pk0uCc6mU2zgClUo4nFDwfSEWlETDRU0= 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=dByrrFZ6Cd6TZ1dkFcRsKZ+gRXM=; b=CEbBFMzXFcAhteLMrm8Y smaj406Jl7368Ily95j88WNxiS99ewb0/LopjUJ+OGOL8RX+b661jCGHqwWaRz09 HJ+NOGPM1HzX5CxNYbndWgPyHhX83EeJD8C4f7Ov2h03ZoqjLn7JxOQRJlJWKB2j O0RAcMraHdIS7dusHTDwgus= Received: (qmail 43218 invoked by alias); 18 Dec 2017 05:54:19 -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 43201 invoked by uid 89); 18 Dec 2017 05:54:17 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-15.0 required=5.0 tests=AWL, BAYES_00, GIT_PATCH_1, GIT_PATCH_2, GIT_PATCH_3, KAM_ASCII_DIVIDERS, RCVD_IN_DNSWL_NONE, SPF_PASS, URIBL_RED autolearn=ham version=3.3.2 spammy= X-HELO: relay1.mentorg.com Received: from relay1.mentorg.com (HELO relay1.mentorg.com) (192.94.38.131) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with ESMTP; Mon, 18 Dec 2017 05:54:15 +0000 Received: from svr-orw-mbx-03.mgc.mentorg.com ([147.34.90.203]) by relay1.mentorg.com with esmtps (TLSv1.2:ECDHE-RSA-AES256-SHA384:256) id 1eQoNQ-0002Hc-PP from Sandra_Loosemore@mentor.com for gcc-patches@gcc.gnu.org; Sun, 17 Dec 2017 21:54:12 -0800 Received: from [127.0.0.1] (147.34.91.1) by svr-orw-mbx-03.mgc.mentorg.com (147.34.90.203) with Microsoft SMTP Server (TLS) id 15.0.1320.4; Sun, 17 Dec 2017 21:54:10 -0800 To: "gcc-patches@gcc.gnu.org" From: Sandra Loosemore Subject: [patch, doc] fix some overfull hboxes Message-ID: Date: Sun, 17 Dec 2017 22:54:07 -0700 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/20100101 Thunderbird/52.5.0 MIME-Version: 1.0 X-ClientProxiedBy: SVR-ORW-MBX-07.mgc.mentorg.com (147.34.90.207) To svr-orw-mbx-03.mgc.mentorg.com (147.34.90.203) I've checked in this patch to fix some formatting problems that caused overfull hbox (that is, lines that overflow the margin) warnings when building the GCC user manual. This isn't exhaustive -- in particular, I see that the long CPU names in the AArch64 and ARM options sections are causing a pile of both underfull and overfull hbox warnings. I think the solution here is to format these lists in a more tabular way instead of as flowed text (perhaps like @gccoptlist formatting in the "Option Summary" section) and do it that way uniformly for all targets that have such lists. That's a bigger project which I'll throw back into the pile for now. -Sandra Index: gcc/doc/extend.texi =================================================================== --- gcc/doc/extend.texi (revision 255772) +++ gcc/doc/extend.texi (working copy) @@ -5765,21 +5765,27 @@ int foo (void) __attribute__(nocf_check) void (*foo1)(void) __attribute__(nocf_check); void (*foo2)(void); +/* foo's address is assumed to be valid. */ int -foo (void) /* The function's address is assumed to be valid. */ +foo (void) - /* This call site is not checked for control-flow validity. */ + /* This call site is not checked for control-flow + validity. */ (*foo1)(); - foo1 = foo2; /* A warning is printed about attribute mismatch. */ - /* This call site is still not checked for control-flow validity. */ + /* A warning is issued about attribute mismatch. */ + foo1 = foo2; + + /* This call site is still not checked. */ (*foo1)(); - /* This call site is checked for control-flow validity. */ + /* This call site is checked. */ (*foo2)(); - foo2 = foo1; /* A warning is printed about attribute mismatch. */ - /* This call site is still checked for control-flow validity. */ + /* A warning is issued about attribute mismatch. */ + foo2 = foo1; + + /* This call site is still checked. */ (*foo2)(); return 0; Index: gcc/doc/invoke.texi =================================================================== --- gcc/doc/invoke.texi (revision 255773) +++ gcc/doc/invoke.texi (working copy) @@ -549,7 +549,7 @@ Objective-C and Objective-C++ Dialects}. -fdisable-tree-@var{pass-name}=@var{range-list} @gol -fdump-noaddr -fdump-unnumbered -fdump-unnumbered-links @gol -fdump-class-hierarchy@r{[}-@var{n}@r{]} @gol --fdump-final-insns@r{[}=@var{file}@r{]} +-fdump-final-insns@r{[}=@var{file}@r{]} @gol -fdump-ipa-all -fdump-ipa-cgraph -fdump-ipa-inline @gol -fdump-lang-all @gol -fdump-lang-@var{switch} @gol @@ -2935,12 +2935,18 @@ Warn if the C++17 feature making @code{n type changes the mangled name of a symbol relative to C++14. Enabled by @option{-Wabi} and @option{-Wc++17-compat}. +As an example: + @smallexample template void f(T t) @{ t(); @}; void g() noexcept; -void h() @{ f(g); @} // in C++14 calls f, in C++17 calls f +void h() @{ f(g); @} @end smallexample +@noindent +In C++14, @code{f} calls calls @code{f}, but in +C++17 it calls @code{f}. + @item -Wclass-memaccess @r{(C++ and Objective-C++ only)} @opindex Wclass-memaccess Warn when the destination of a call to a raw memory function such as