From patchwork Wed Jan 13 23:38:40 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Sandra Loosemore X-Patchwork-Id: 567182 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 3AAEC1402D2 for ; Thu, 14 Jan 2016 10:38:56 +1100 (AEDT) Authentication-Results: ozlabs.org; dkim=pass (1024-bit key; unprotected) header.d=gcc.gnu.org header.i=@gcc.gnu.org header.b=PuzjIPZC; 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 :subject:to:references:from:message-id:date:mime-version :in-reply-to:content-type; q=dns; s=default; b=M74p/tGiph3r7mJhd ClCvok45aYMg1GdH7Tj3EXVOF3joTyIuc1OmSdHImE74c4yRHh8e/XywPndQxA5r FxARfMucu/cMdDHzse9v1WaBaggYPqRyKWfDPMInZjs5uaG9ZJXCabP0DFRdlVYl blz7t0VRz5joEaXtOQ5k5TZuYg= 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 :subject:to:references:from:message-id:date:mime-version :in-reply-to:content-type; s=default; bh=a7k/0gzQYXPxTUQl1CNFsDI hzPo=; b=PuzjIPZCW/RB8RPEnrXOcncqja33BB2q4OeOxHSfs8RFgHlgnqrDU7G QIuYWZlrDdRZir98533stEwxmW+E9D4GRQUIa2pMgMnKOfPONjGhmf8Tu5+0ffM5 KSokgHJanHC7jHrotAcx10GJfqCOdG2aJbB6Ppaowm+Ha+skdM3M= Received: (qmail 86316 invoked by alias); 13 Jan 2016 23:38:48 -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 86304 invoked by uid 89); 13 Jan 2016 23:38:48 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-1.2 required=5.0 tests=AWL, BAYES_00, RCVD_IN_DNSWL_NONE, SPF_PASS autolearn=ham version=3.3.2 spammy=@menu, 1488, 148, 8, libatomi 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; Wed, 13 Jan 2016 23:38:46 +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 1aJUzy-0003PV-Tn from Sandra_Loosemore@mentor.com for gcc-patches@gcc.gnu.org; Wed, 13 Jan 2016 15:38:42 -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; Wed, 13 Jan 2016 15:38:42 -0800 Subject: [doc, 3.5/n] invoke.texi: rename "Machine-Dependent Options" section To: GCC Patches References: <5692EE28.1070502@codesourcery.com> From: Sandra Loosemore Message-ID: <5696E000.1050703@codesourcery.com> Date: Wed, 13 Jan 2016 16:38:40 -0700 User-Agent: Mozilla/5.0 (X11; Linux i686; rv:38.0) Gecko/20100101 Thunderbird/38.3.0 MIME-Version: 1.0 In-Reply-To: <5692EE28.1070502@codesourcery.com> This is another "extra" patch in my series to improve the organization of invoke.texi and make it easier for users to find things. It seemed to me that "Hardware Models and Configurations" was not an obvious name for the section on machine-dependent options. The "Option Summary" section already used "Machine-Dependent Options" (minus the hyphen) to describe this group of options, so I went with that instead. I also thought that using 30+-year-old processor names like "68010 vs 68020" as an example seemed pretty archaic, so I also rewrote the @menu description and introductory blurb for the section to be more generic and better reflect that nowadays target-specific options do a lot more than just let you choose the hardware model to compile for. I've committed this patch. -Sandra Index: gcc/doc/invoke.texi =================================================================== --- gcc/doc/invoke.texi (revision 232352) +++ gcc/doc/invoke.texi (working copy) @@ -148,8 +148,8 @@ only one of these two forms, whichever o Where to find the compiler executable files. * Code Gen Options:: Specifying conventions for function calls, data layout and register usage. -* Submodel Options:: Specifying minor hardware or convention variations, - such as 68010 vs 68020. +* Submodel Options:: Target-specific options, such as compiling for a + specific processor variant. * Spec Files:: How to pass switches to sub-processes. * Environment Variables:: Env vars that affect GCC. * Precompiled Headers:: Compiling a header once, and using it many times. @@ -541,8 +541,8 @@ Objective-C and Objective-C++ Dialects}. -fvisibility=@r{[}default@r{|}internal@r{|}hidden@r{|}protected@r{]} @gol -fstrict-volatile-bitfields -fsync-libcalls} -@item Machine Dependent Options -@xref{Submodel Options,,Hardware Models and Configurations}. +@item Machine-Dependent Options +@xref{Submodel Options,,Machine-Dependent Options}. @c This list is ordered alphanumerically by subsection name. @c Try and put the significant identifier (CPU or system) first, @c so users have a clue at guessing where the ones they want will be. @@ -12569,20 +12569,20 @@ the implementation of the @file{libatomi @end table @node Submodel Options -@section Hardware Models and Configurations +@section Machine-Dependent Options @cindex submodel options @cindex specifying hardware config @cindex hardware models and configurations, specifying -@cindex machine dependent options +@cindex target-dependent options +@cindex machine-dependent options -Each target machine types can have its own -special options, starting with @samp{-m}, to choose among various -hardware models or configurations---for example, 68010 vs 68020, -floating coprocessor or none. A single installed version of the -compiler can compile for any model or configuration, according to the -options specified. +Each target machine supported by GCC can have its own options---for +example, to allow you to compile for a particular processor variant or +ABI, or to control optimizations specific to that machine. By +convention, the names of machine-specific options start with +@samp{-m}. -Some configurations of the compiler also support additional special +Some configurations of the compiler also support additional target-specific options, usually for compatibility with other compilers on the same platform.