From patchwork Wed Apr 10 11:18:07 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jonathan Wakely X-Patchwork-Id: 1083325 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-499055-incoming=patchwork.ozlabs.org@gcc.gnu.org; receiver=) Authentication-Results: ozlabs.org; dmarc=fail (p=none dis=none) header.from=redhat.com Authentication-Results: ozlabs.org; dkim=pass (1024-bit key; unprotected) header.d=gcc.gnu.org header.i=@gcc.gnu.org header.b="L/C7LlYh"; 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 44fM8x15nqz9s00 for ; Wed, 10 Apr 2019 21:18:19 +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:date :from:to:cc:subject:message-id:mime-version:content-type; q=dns; s=default; b=c2DtTCfzBqkVwtQvgLaLdH7sg/iwN/Hr8OTFemJSUENl7YvH4u NOCN76QCf4SA9DNYj7SaOLhaHRGPxBWrmuQXcw4gql4V6gkZs+3l2PypcnD+dOeH ATteoh3ZCKgvpyV2vURaFFU2PyvjXe0kXLPHy2Myi6zfSovFQApTpsMVE= 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:date :from:to:cc:subject:message-id:mime-version:content-type; s= default; bh=BWqHYEQeZPlYcqhhaWAieYa/CXI=; b=L/C7LlYhRPXX5mIk4twr c2y4IzvwjyIs+IIk+y1NFdIIJcEP60kKsrPml4ZB+Juib7MuRaGsk3ZS+xA26kTm HZAEuL0NjcdczYD69YxGjQq7E0ymZtS2I27jQdFUmPhOLW31YbFgtlj43sZwGcR5 yDE03ID/3qmE3zcCFR8XtRo= Received: (qmail 35766 invoked by alias); 10 Apr 2019 11:18:12 -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 35753 invoked by uid 89); 10 Apr 2019 11:18:11 -0000 Authentication-Results: sourceware.org; auth=none X-Spam-SWARE-Status: No, score=-14.6 required=5.0 tests=AWL, BAYES_00, GIT_PATCH_0, GIT_PATCH_1, GIT_PATCH_2, GIT_PATCH_3, SPF_HELO_PASS autolearn=ham version=3.3.1 spammy= X-HELO: mx1.redhat.com Received: from mx1.redhat.com (HELO mx1.redhat.com) (209.132.183.28) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with ESMTP; Wed, 10 Apr 2019 11:18:10 +0000 Received: from smtp.corp.redhat.com (int-mx04.intmail.prod.int.phx2.redhat.com [10.5.11.14]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.redhat.com (Postfix) with ESMTPS id 22146308C216; Wed, 10 Apr 2019 11:18:09 +0000 (UTC) Received: from localhost (unknown [10.33.36.13]) by smtp.corp.redhat.com (Postfix) with ESMTP id A37945D962; Wed, 10 Apr 2019 11:18:08 +0000 (UTC) Date: Wed, 10 Apr 2019 12:18:07 +0100 From: Jonathan Wakely To: gcc-patches@gcc.gnu.org Cc: Gerald Pfeifer , Joseph Myers , Sandra Loosemore Subject: [PATCH] Clearly document behaviour of multiple -g options Message-ID: <20190410111807.GA16682@redhat.com> MIME-Version: 1.0 Content-Disposition: inline X-Clacks-Overhead: GNU Terry Pratchett User-Agent: Mutt/1.11.3 (2019-02-01) This copies the wording from the -O options to clearly state what happens if more than one -g option is used. * doc/invoke.texi (Debugging Options): Explicitly state the semantics of using multiple -g options. OK for trunk? commit 9d950d2398b0a01358520a1c0a69bbe46ba7d997 Author: Jonathan Wakely Date: Wed Apr 10 12:15:29 2019 +0100 Clearly document behaviour of multiple -g options This copies the wording from the -O options to clearly state what happens if more than one -g option is used. * doc/invoke.texi (Debugging Options): Explicitly state the semantics of using multiple -g options. diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi index cfc3063929b..73a7789d879 100644 --- a/gcc/doc/invoke.texi +++ b/gcc/doc/invoke.texi @@ -7818,6 +7818,9 @@ Level 3 includes extra information, such as all the macro definitions present in the program. Some debuggers support macro expansion when you use @option{-g3}. +If you use multiple @option{-g} options, with or without level numbers, +the last such option is the one that is effective. + @option{-gdwarf} does not accept a concatenated debug level, to avoid confusion with @option{-gdwarf-@var{level}}. Instead use an additional @option{-g@var{level}} option to change the