{"id":2219679,"url":"http://patchwork.ozlabs.org/api/1.0/patches/2219679/?format=json","project":{"id":17,"url":"http://patchwork.ozlabs.org/api/1.0/projects/17/?format=json","name":"GNU Compiler Collection","link_name":"gcc","list_id":"gcc-patches.gcc.gnu.org","list_email":"gcc-patches@gcc.gnu.org","web_url":null,"scm_url":null,"webscm_url":null},"msgid":"<20260403173454.622036-1-sloosemore@baylibre.com>","date":"2026-04-03T17:34:53","name":"[PUSHED] doc: Document -g2 debugging level [PR94491]","commit_ref":null,"pull_url":null,"state":"new","archived":false,"hash":"9ca8e4a535e52bae1907f7e8344984c86268dd8e","submitter":{"id":87955,"url":"http://patchwork.ozlabs.org/api/1.0/people/87955/?format=json","name":"Sandra Loosemore","email":"sloosemore@baylibre.com"},"delegate":null,"mbox":"http://patchwork.ozlabs.org/project/gcc/patch/20260403173454.622036-1-sloosemore@baylibre.com/mbox/","series":[{"id":498660,"url":"http://patchwork.ozlabs.org/api/1.0/series/498660/?format=json","date":"2026-04-03T17:34:53","name":"[PUSHED] doc: Document -g2 debugging level [PR94491]","version":1,"mbox":"http://patchwork.ozlabs.org/series/498660/mbox/"}],"check":"pending","checks":"http://patchwork.ozlabs.org/api/patches/2219679/checks/","tags":{},"headers":{"Return-Path":"","X-Original-To":["incoming@patchwork.ozlabs.org","gcc-patches@gcc.gnu.org"],"Delivered-To":["patchwork-incoming@legolas.ozlabs.org","gcc-patches@gcc.gnu.org"],"Authentication-Results":["legolas.ozlabs.org;\n\tdkim=pass (2048-bit key;\n unprotected) header.d=baylibre-com.20251104.gappssmtp.com\n header.i=@baylibre-com.20251104.gappssmtp.com header.a=rsa-sha256\n header.s=20251104 header.b=f+dIIQMI;\n\tdkim-atps=neutral","legolas.ozlabs.org;\n spf=pass (sender SPF authorized) smtp.mailfrom=gcc.gnu.org\n (client-ip=2620:52:6:3111::32; helo=vm01.sourceware.org;\n envelope-from=gcc-patches-bounces~incoming=patchwork.ozlabs.org@gcc.gnu.org;\n receiver=patchwork.ozlabs.org)","sourceware.org;\n\tdkim=pass (2048-bit key,\n unprotected) header.d=baylibre-com.20251104.gappssmtp.com\n header.i=@baylibre-com.20251104.gappssmtp.com header.a=rsa-sha256\n header.s=20251104 header.b=f+dIIQMI","sourceware.org;\n dmarc=none (p=none dis=none) header.from=baylibre.com","sourceware.org; spf=pass smtp.mailfrom=baylibre.com","server2.sourceware.org;\n arc=none smtp.remote-ip=209.85.167.169"],"Received":["from vm01.sourceware.org (vm01.sourceware.org\n [IPv6:2620:52:6:3111::32])\n\t(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)\n\t key-exchange x25519 server-signature ECDSA (secp384r1) server-digest SHA384)\n\t(No client certificate requested)\n\tby legolas.ozlabs.org (Postfix) with ESMTPS id 4fnQq50nGwz1yCt\n\tfor ; Sat, 04 Apr 2026 04:35:29 +1100 (AEDT)","from vm01.sourceware.org (localhost [127.0.0.1])\n\tby sourceware.org (Postfix) with ESMTP id 356404BA23D9\n\tfor ; Fri, 3 Apr 2026 17:35:27 +0000 (GMT)","from mail-oi1-f169.google.com (mail-oi1-f169.google.com\n [209.85.167.169])\n by sourceware.org (Postfix) with ESMTPS id 1AEC94BA2E24\n for ; Fri, 3 Apr 2026 17:35:00 +0000 (GMT)","by mail-oi1-f169.google.com with SMTP id\n 5614622812f47-46fb6d65c89so189958b6e.1\n for ; Fri, 03 Apr 2026 10:35:00 -0700 (PDT)","from nenufar.hsd1.co.comcast.net ([2601:281:d901:97c0::9a27])\n by smtp.gmail.com with ESMTPSA id\n 586e51a60fabf-422eaed88dfsm5561468fac.3.2026.04.03.10.34.58\n (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256);\n Fri, 03 Apr 2026 10:34:58 -0700 (PDT)"],"DKIM-Filter":["OpenDKIM Filter v2.11.0 sourceware.org 356404BA23D9","OpenDKIM Filter v2.11.0 sourceware.org 1AEC94BA2E24"],"DMARC-Filter":"OpenDMARC Filter v1.4.2 sourceware.org 1AEC94BA2E24","ARC-Filter":"OpenARC Filter v1.0.0 sourceware.org 1AEC94BA2E24","ARC-Seal":"i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1775237700; cv=none;\n b=T2l1GPdGxLWTmoqZf+CptfEqSZx9bku4vxVjxoM7m6XQSZxAXGf/qrcEPmVcbU61JPtxp+SDj/bcsM4HIgBonsNb2Ekl4wSrO5gxu4p1rx8i7KUV4t7xCFbQBwfU/X+/YWTRrhWtTAAumIV4Wt+Z4pAoRvQVS8eegZi+YgfjA68=","ARC-Message-Signature":"i=1; a=rsa-sha256; d=sourceware.org; s=key;\n t=1775237700; c=relaxed/simple;\n bh=e/HhcsW8098wP6kV/dSZyM69bZEnmpYqPee8dDlfZi4=;\n h=DKIM-Signature:From:To:Subject:Date:Message-Id:MIME-Version;\n b=dlidf7qjM/wiO1rlDrQNDoEzjTu4PLAr937GFcrygH9HWdhqKnSivjGf8QlJQ13nG8KNFlYpDFjQlt45txJ46fVH2xVYQkqPDcuv6zvhsJR/5EOosA8W2q5LRrgVbNfdCXgDrkvVvUROZIOuNhtErzrbH3Dc1AkgS4vxoLz3P+E=","ARC-Authentication-Results":"i=1; server2.sourceware.org","DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/relaxed;\n d=baylibre-com.20251104.gappssmtp.com; s=20251104; t=1775237699;\n x=1775842499;\n darn=gcc.gnu.org;\n h=content-transfer-encoding:mime-version:message-id:date:subject:to\n :from:from:to:cc:subject:date:message-id:reply-to;\n bh=0wPrfM6YHOtnAJGFErxbzHF6wBzYPb6ZhUWxoPInuBE=;\n b=f+dIIQMIO+JGUNC5V6H/el8TLgJL5XSuKlbaaFs6L0yLyseIonaFisaqg6H3siikOn\n 6FizBNg6BRQxzrRCJYelFimRJwflyfS/J8DRrD79MvswwDI6fpij8BXqhfUBh91YZub/\n zpVKzBRZgNKHR50jUQS1IQqJfAdDsO/toIlOHaYZ4JOBJcjk9zGMb8ciXahShpj7ziW6\n WGXU1ujj0xvnQIzz0yWEFl3WEM6QxQJe+AjB9tA+N36WQJnwIyeZzPsHDN6OE+n4BIpc\n O9UgRCUOU+SM6vbBY3/o61P/Dt44xtd0yGZxf44iAxS2abyhVTK1tWjIlcDe55dc/8Xx\n LX4g==","X-Google-DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/relaxed;\n d=1e100.net; s=20251104; t=1775237699; x=1775842499;\n h=content-transfer-encoding:mime-version:message-id:date:subject:to\n :from:x-gm-gg:x-gm-message-state:from:to:cc:subject:date:message-id\n :reply-to;\n bh=0wPrfM6YHOtnAJGFErxbzHF6wBzYPb6ZhUWxoPInuBE=;\n b=Bn0eSIdu0PeYW5h9MbzMAGSc84iFPHsmKTKfABRAxKFHDlJ0YuhUqN9nrymagUk7mM\n 7ithtHaXxx8vaEs4sNQpFokc57r6V3BW2lj69Q9y9WOuDEWZ4buZjFOKz3GdZm2q8YU+\n 4PqTqhWL/u8TufI4P5IPCtL6NYpo9uCUcNMxw6BNPNrifVcr+9TcUm116VvRlg5zCn6d\n a/pvwA17wnOkKzMQem5hGbhbKu+Vkla1+XzFypS8d9LRH2m8MJPa1U2+m2CbjErvIPpV\n ZR86Q0cW9mqXUCMGQxeL73zoFCx2mhgpzI7PK9JdLcBU9Gbt8henZNCXRQblGtGtF7VP\n FpVg==","X-Gm-Message-State":"AOJu0Yz/7GGdb8WiBf5tQ0W7zqeI8c8X1CXQkL2CmeWd3pzxwpeR3ytJ\n S8xplnzpjzS+5VIsRbRb+mEkfUZdgXZveGx0s8FqVNRepIKab00w8wCkvYexx1jQ43Ccg02KlDq\n NoWue","X-Gm-Gg":"ATEYQzzndiNiQ7V36HGHVFiZbDFyNqwE1b2SsL2VHCFpxnD9Is19O/EgtVcLlPKsZai\n ptIO7C/uTnoSnsvkMhaaHkr3IlJpuugTYZxJkmWzTLgUCwyvFGEMQXg1y8B8853hzTxWkVN8QOs\n eKCySbM0AP/sGnX/i8yOB497XbV9qR4IXwqbzd+byfn+Q0AZfb2P1P/hvf31Vbck3qOdxm9lHPK\n 1mlly7+7YvJBukKXvy55SQebQX0+xzH3/XFYvtdFCjI/vWIXCKY5zqLAltX2qFAyKK1rZuSbjgj\n Qhu/syhkdWnl9ByDRHtS0bieFiqw57or2G1p+0e+emPk8xKnkJ/j0t6p/BaNFOS61A8q0zk5k3Z\n b2+iXobmxkEeMNBVS1iq48YaTw9/W3rAfYoqIeh5ZYzDQHUBiU36qmOj8kI5N7Mmrww/MH1MCv7\n 1M2H4fFjeubW4INF4WlRkbT01QGBYu13ob","X-Received":"by 2002:a05:6808:2208:b0:46c:e542:cc35 with SMTP id\n 5614622812f47-46ef7d0d522mr2375792b6e.37.1775237699227;\n Fri, 03 Apr 2026 10:34:59 -0700 (PDT)","From":"Sandra Loosemore ","To":"gcc-patches@gcc.gnu.org","Subject":"[PUSHED] doc: Document -g2 debugging level [PR94491]","Date":"Fri, 3 Apr 2026 11:34:53 -0600","Message-Id":"<20260403173454.622036-1-sloosemore@baylibre.com>","X-Mailer":"git-send-email 2.34.1","MIME-Version":"1.0","Content-Transfer-Encoding":"8bit","X-BeenThere":"gcc-patches@gcc.gnu.org","X-Mailman-Version":"2.1.30","Precedence":"list","List-Id":"Gcc-patches mailing list ","List-Unsubscribe":",\n ","List-Archive":"","List-Post":"","List-Help":"","List-Subscribe":",\n ","Errors-To":"gcc-patches-bounces~incoming=patchwork.ozlabs.org@gcc.gnu.org"},"content":"gcc/ChangeLog\n\tPR debug/94491\n\t* doc/invoke.texi (Debugging Options): Explicitly document what\n\t-g2 does instead of just saying it's the default.\n---\n gcc/doc/invoke.texi | 6 ++++++\n 1 file changed, 6 insertions(+)","diff":"diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi\nindex 396aabaea64..f0c2b4bc77c 100644\n--- a/gcc/doc/invoke.texi\n+++ b/gcc/doc/invoke.texi\n@@ -12920,6 +12920,12 @@ parts of the program that you don't plan to debug. This includes\n descriptions of functions and external variables, and line number\n tables, but no information about local variables.\n \n+Level 2 is the normal setting to produce debuggable code. The debug output\n+includes all the information from level 1, plus information about\n+local variables and typedefs to allow stepping through code and examining\n+its state. For C++ code, additional information is also emitted to assist\n+in debugging namespace, class, and template functions.\n+\n Level 3 includes extra information, such as all the macro definitions\n present in the program. Some debuggers support macro expansion when\n you use @option{-g3}.\n","prefixes":["PUSHED"]}