From patchwork Sun Jan 4 00:59:40 2015 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Sandra Loosemore X-Patchwork-Id: 425135 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 CADDD1400A0 for ; Sun, 4 Jan 2015 12:00:00 +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 :message-id:date:from:mime-version:to:subject:content-type; q= dns; s=default; b=TqsSOyvaEtYuGCr77fKzJzPI41JcLErqIyvUOtH3WYNhG4 GKu5DRp7KBg1O05S4DZER2c9DWRahwJ9XU2bT4UuADlFR6TxST6a9PJ0v9ivx6en 4rHb3qrKfvCeofpHFvrp3kdfdfeokA62W4pPCV9o66VEsJghxOWrc0q8IMHIw= 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:date:from:mime-version:to:subject:content-type; s= default; bh=mYcpl7xEcoJe9lU2MkImCh7drg0=; b=lCS/CyFYwpPdLERUt+Fe UiSkuEpuDR1N9F50axNxZj7G6rVgjYgI9a/Xo4N6gWLKNaI9O8ObOB1LkGgCHw+a Qi34CiNewyRLK+4nF5x4szDLLMfjakU9me2IiXo4dIJYwREQEgmSpHTYmrZLC0hl 86BKigGLc5UGZfmcNdTEq08= Received: (qmail 21723 invoked by alias); 4 Jan 2015 00:59:52 -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 21711 invoked by uid 89); 4 Jan 2015 00:59:51 -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, RCVD_IN_DNSWL_NONE, SPF_PASS autolearn=ham version=3.3.2 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; Sun, 04 Jan 2015 00:59:49 +0000 Received: from svr-orw-fem-02x.mgc.mentorg.com ([147.34.96.206] helo=SVR-ORW-FEM-02.mgc.mentorg.com) by relay1.mentorg.com with esmtp id 1Y7ZXl-0005Ao-RH from Sandra_Loosemore@mentor.com for gcc-patches@gcc.gnu.org; Sat, 03 Jan 2015 16:59:45 -0800 Received: from [IPv6:::1] (147.34.91.1) by svr-orw-fem-02.mgc.mentorg.com (147.34.96.168) with Microsoft SMTP Server id 14.3.224.2; Sat, 3 Jan 2015 16:59:45 -0800 Message-ID: <54A8907C.8040809@codesourcery.com> Date: Sat, 3 Jan 2015 17:59:40 -0700 From: Sandra Loosemore User-Agent: Mozilla/5.0 (X11; Linux i686; rv:17.0) Gecko/20130329 Thunderbird/17.0.5 MIME-Version: 1.0 To: GCC Patches Subject: [doc, committed] copy-edit documentation for -fisolate-erroneous-paths-* This patch fixes a bunch of small problems in the descriptions of -fisolate-erroneous-paths-dereference and -fisolate-erroneous-paths-attribute: * "which"/"that" confusion * use American spelling of "behavior" vs British "behaviour" * most places in the manual use "null" or more rarely "@code{NULL}" rather than "NULL" * wrong markup on option I also added a note that -fisolate-erroneous-paths-dereference is enabled by default at -O2 since it seemed odd to mention only that the other option is *not* enabled. Committed under the obvious fix rule, since this is more boring tech-writer stuff. -Sandra 2015-01-03 Sandra Loosemore gcc/ * doc/invoke.texi ([-fisolate-erroneous-paths-dereference]): Copy-edit description. ([-fisolate-erroneous-paths-attribute]): Likewise. * common.opt (fisolate-erroneous-paths-dereference): Copy-edit description. (fisolate-erroneous-paths-attribute): Likewise. Index: gcc/common.opt =================================================================== --- gcc/common.opt (revision 219165) +++ gcc/common.opt (working copy) @@ -2241,16 +2241,16 @@ Enable string length optimizations on tr fisolate-erroneous-paths-dereference Common Report Var(flag_isolate_erroneous_paths_dereference) Optimization -Detect paths which trigger erroneous or undefined behaviour due to -dereferencing a NULL pointer. Isolate those paths from the main control -flow and turn the statement with erroneous or undefined behaviour into a trap. +Detect paths that trigger erroneous or undefined behavior due to +dereferencing a null pointer. Isolate those paths from the main control +flow and turn the statement with erroneous or undefined behavior into a trap. fisolate-erroneous-paths-attribute Common Report Var(flag_isolate_erroneous_paths_attribute) Optimization -Detect paths which trigger erroneous or undefined behaviour due a NULL value -being used in a way which is forbidden by a returns_nonnull or nonnull +Detect paths that trigger erroneous or undefined behavior due a null value +being used in a way forbidden by a returns_nonnull or nonnull attribute. Isolate those paths from the main control flow and turn the -statement with erroneous or undefined behaviour into a trap. +statement with erroneous or undefined behavior into a trap. ftree-loop-distribution Common Report Var(flag_tree_loop_distribution) Optimization Index: gcc/doc/invoke.texi =================================================================== --- gcc/doc/invoke.texi (revision 219166) +++ gcc/doc/invoke.texi (working copy) @@ -8234,17 +8234,18 @@ This flag is enabled by default at @opti @item -fisolate-erroneous-paths-dereference @opindex fisolate-erroneous-paths-dereference -Detect paths which trigger erroneous or undefined behaviour due to -dereferencing a NULL pointer. Isolate those paths from the main control -flow and turn the statement with erroneous or undefined behaviour into a trap. +Detect paths that trigger erroneous or undefined behavior due to +dereferencing a null pointer. Isolate those paths from the main control +flow and turn the statement with erroneous or undefined behavior into a trap. +This flag is enabled by default at @option{-O2} and higher. @item -fisolate-erroneous-paths-attribute @opindex fisolate-erroneous-paths-attribute -Detect paths which trigger erroneous or undefined behaviour due a NULL value -being used in a way which is forbidden by a @code{returns_nonnull} or @code{nonnull} +Detect paths that trigger erroneous or undefined behavior due a null value +being used in a way forbidden by a @code{returns_nonnull} or @code{nonnull} attribute. Isolate those paths from the main control flow and turn the -statement with erroneous or undefined behaviour into a trap. This is not -currently enabled, but may be enabled by @code{-O2} in the future. +statement with erroneous or undefined behavior into a trap. This is not +currently enabled, but may be enabled by @option{-O2} in the future. @item -ftree-sink @opindex ftree-sink