From patchwork Mon Sep 5 07:25:50 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: =?utf-8?q?Marc_Poulhi=C3=A8s?= X-Patchwork-Id: 963 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a5d:5044:0:0:0:0:0 with SMTP id h4csp56342wrt; Mon, 5 Sep 2022 00:27:28 -0700 (PDT) X-Google-Smtp-Source: AA6agR7g+2NrnfHrZakh11itm/ZDAnjsRNpFHvItBbERfv9VcRfi8lnVMIn6WXkjSkEPgjmjYMiP X-Received: by 2002:a05:6402:348f:b0:448:6005:68af with SMTP id v15-20020a056402348f00b00448600568afmr31197812edc.184.1662362848176; Mon, 05 Sep 2022 00:27:28 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1662362848; cv=none; d=google.com; s=arc-20160816; b=DdF5WkOgshj5OpMrWlLnVA08b2vQecNhNucf5kqBE/d26kig0y2kismbFUx0lLkvHx ElweSKvJfDCAVxdH3oUkZ2LDLLuEfm9gtu6kHF3W62hwomUKy6FiE/MNarE4rxyhTmp+ sSLL9nnRZ/n1ZgvDniqfdWX3WwOABKqA8alCvvLznttw/Izh5qRyGw4pS402wBRZAmhn K66R31Y2s+3NpZXt2jhT+75eHNTNZ9dbP1c7nBvLkH9+9H4T3oaPV0lNb7c3FoMKZ4ps eENkkve/X2f4rFKd044G3I+i+mUlSIyrOrPyLuGKe9CEYyclSAzx1upYchmnHkHU4bx+ 0pNg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=sender:errors-to:reply-to:from:list-subscribe:list-help:list-post :list-archive:list-unsubscribe:list-id:precedence :content-transfer-encoding:content-disposition:mime-version :message-id:subject:to:date:dmarc-filter:delivered-to:dkim-signature :dkim-filter; bh=J4CL8YAuYW+oiLnH4VcGihzxlttjJ1JqOKCaNT+vT0k=; b=M8/uZxkMFnnsVKk23cuzOunORUjGln55Hp27BnCm39XnDeiQTbtZHXqoNgMToiObpn iJzFkmjN0fVVQRq9B9V749MoO9jaAKqmpxJHiUTaheD0uH6J0w6kYZaYjCjreHWInJdd y8/3rYun8xwV1yYjHwLRh/u6BOKttd5lg5To+oXum/klIOeexMT5+L9n9emu724zeY7Q JYbfrrl0qyNIguO3JqcRaURvv6mkJ0gChB9zx7Lw2sXh07Giw3Ua0PDlsvTl0fIzEtZx BKgwczc+9pj923Qfr5fxEVTdUBOefXfQEQZxTV3n4u/Ixk3Bg3bgSxDiC07JjQYmtL5f yfww== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@gcc.gnu.org header.s=default header.b="GIbCnKe/"; spf=pass (google.com: domain of gcc-patches-bounces+ouuuleilei=gmail.com@gcc.gnu.org designates 8.43.85.97 as permitted sender) smtp.mailfrom="gcc-patches-bounces+ouuuleilei=gmail.com@gcc.gnu.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=gnu.org Received: from sourceware.org (ip-8-43-85-97.sourceware.org. [8.43.85.97]) by mx.google.com with ESMTPS id y6-20020a056402270600b00449141f7055si7650679edd.515.2022.09.05.00.27.28 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 05 Sep 2022 00:27:28 -0700 (PDT) Received-SPF: pass (google.com: domain of gcc-patches-bounces+ouuuleilei=gmail.com@gcc.gnu.org designates 8.43.85.97 as permitted sender) client-ip=8.43.85.97; Authentication-Results: mx.google.com; dkim=pass header.i=@gcc.gnu.org header.s=default header.b="GIbCnKe/"; spf=pass (google.com: domain of gcc-patches-bounces+ouuuleilei=gmail.com@gcc.gnu.org designates 8.43.85.97 as permitted sender) smtp.mailfrom="gcc-patches-bounces+ouuuleilei=gmail.com@gcc.gnu.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=gnu.org Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 61FD538515E2 for ; Mon, 5 Sep 2022 07:26:40 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 61FD538515E2 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gcc.gnu.org; s=default; t=1662362800; bh=J4CL8YAuYW+oiLnH4VcGihzxlttjJ1JqOKCaNT+vT0k=; h=Date:To:Subject:List-Id:List-Unsubscribe:List-Archive:List-Post: List-Help:List-Subscribe:From:Reply-To:From; b=GIbCnKe/IFDuHC8YvxgXvD/GHfpOd4pqUMHXZQxCBJR3vjzhgRUjQX2aIh6Iwn+5b hc5SAzoO08d0Psz+x9yvpqtTty36OXKlAR/ptjLjv348e7EnUtezX/Q3xwUV7eqakM bvuxRBnBmPrD0g3jJG2eRcx7nHrO+OK438AdsP+A= X-Original-To: gcc-patches@gcc.gnu.org Delivered-To: gcc-patches@gcc.gnu.org Received: from mail-wm1-x32d.google.com (mail-wm1-x32d.google.com [IPv6:2a00:1450:4864:20::32d]) by sourceware.org (Postfix) with ESMTPS id 03F993858D32 for ; Mon, 5 Sep 2022 07:25:53 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org 03F993858D32 Received: by mail-wm1-x32d.google.com with SMTP id d12-20020a05600c34cc00b003a83d20812fso5158513wmq.1 for ; Mon, 05 Sep 2022 00:25:52 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=content-transfer-encoding:content-disposition:mime-version :message-id:subject:cc:to:from:date:x-gm-message-state:from:to:cc :subject:date; bh=J4CL8YAuYW+oiLnH4VcGihzxlttjJ1JqOKCaNT+vT0k=; b=bOHA0Ms1rqPbcSy+aiszBx3nMXeQNDDV9lvKXeqOpgSgfbsXbvCv8XyPC3HJaSBTwp N+mqd9d6vgW97KX1mwSQ4oHgB4TKRT+jzWfa02nCHJI/HOfRW3Ud6x8txhyR5gCWm2mM MaRv5ySxogKvujjkHgZQp9g3gh+zXa8/PAbltwZHGG41r45bkQEhdJmeIJflHJiv53YT uA3Dumlg1tmz14QbvLMVeG9Vt5I1J9SOgBurX4zGhFPfqEO1tXnK9nB4k8T4dgKambe8 4Wop3ddROmHcKjhO8dWjnBHX/ASV9sxwy74LZEsmqjSiSDbyUG+zehBp6jcX7D6x43ov yDyg== X-Gm-Message-State: ACgBeo00spm4X+XCy62i+UJpxYSIHXoG5TjPgN8cZAqzbWkFBqyrnw8a ltnXpv4u56JihpdsQtGTwIFH03HxNUeAUg== X-Received: by 2002:a05:600c:ad2:b0:3a5:36ca:ec38 with SMTP id c18-20020a05600c0ad200b003a536caec38mr9246177wmr.21.1662362751385; Mon, 05 Sep 2022 00:25:51 -0700 (PDT) Received: from poulhies-Precision-5550 (static-176-191-105-132.ftth.abo.bbox.fr. [176.191.105.132]) by smtp.gmail.com with ESMTPSA id k1-20020a5d6d41000000b0021db7b0162esm8009538wri.105.2022.09.05.00.25.50 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 05 Sep 2022 00:25:50 -0700 (PDT) Date: Mon, 5 Sep 2022 09:25:50 +0200 To: gcc-patches@gcc.gnu.org Subject: [Ada] Fix syntax in documentation Message-ID: <20220905072550.GA1174480@poulhies-Precision-5550> MIME-Version: 1.0 Content-Disposition: inline X-Spam-Status: No, score=-12.0 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, GIT_PATCH_0, RCVD_IN_DNSWL_NONE, SPF_HELO_NONE, SPF_PASS, TXREP, T_SCC_BODY_TEXT_LINE autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on server2.sourceware.org X-BeenThere: gcc-patches@gcc.gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Gcc-patches mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-Patchwork-Original-From: =?utf-8?q?Marc_Poulhi=C3=A8s_via_Gcc-patches?= From: =?utf-8?q?Marc_Poulhi=C3=A8s?= Reply-To: Marc =?iso-8859-1?q?Poulhi=E8s?= Errors-To: gcc-patches-bounces+ouuuleilei=gmail.com@gcc.gnu.org Sender: "Gcc-patches" X-getmail-retrieved-from-mailbox: =?utf-8?q?INBOX?= X-GMAIL-THRID: =?utf-8?q?1743113785925789160?= X-GMAIL-MSGID: =?utf-8?q?1743113785925789160?= Leading to a poorly formatted example section. Tested on x86_64-pc-linux-gnu, committed on trunk gcc/ada/ * doc/gnat_ugn/gnat_and_program_execution.rst: Fix rest syntax * gnat_ugn.texi: Regenerate. diff --git a/gcc/ada/doc/gnat_ugn/gnat_and_program_execution.rst b/gcc/ada/doc/gnat_ugn/gnat_and_program_execution.rst --- a/gcc/ada/doc/gnat_ugn/gnat_and_program_execution.rst +++ b/gcc/ada/doc/gnat_ugn/gnat_and_program_execution.rst @@ -844,9 +844,7 @@ assorted runtime routines and the output will vary from platform to platform. It is also possible to use ``GDB`` with these traceback addresses to debug the program. For example, we can break at a given code location, as reported -in the stack traceback: - - :: +in the stack traceback:: $ gdb -nw stb @@ -870,9 +868,8 @@ Executables on recent Windows versions, in other words without using the switch with :switch:`--load` instead of the ``addr2line`` tool. The main difference is that you need to copy the Load Address output in the traceback ahead of the sequence of addresses. And the default mode of ``gnatsymbolize`` is equivalent -to that of ``addr2line`` with the above switches, so none of them is needed: +to that of ``addr2line`` with the above switches, so none of them is needed:: - :: $ gnatmake stb -g -bargs -E $ stb diff --git a/gcc/ada/gnat_ugn.texi b/gcc/ada/gnat_ugn.texi --- a/gcc/ada/gnat_ugn.texi +++ b/gcc/ada/gnat_ugn.texi @@ -19023,15 +19023,12 @@ It is also possible to use @code{GDB} with these traceback addresses to debug the program. For example, we can break at a given code location, as reported in the stack traceback: -@quotation - @example $ gdb -nw stb (gdb) break *0x401373 Breakpoint 1 at 0x401373: file stb.adb, line 5. @end example -@end quotation It is important to note that the stack traceback addresses do not change when debug information is included. This is particularly useful because it makes it @@ -19052,13 +19049,7 @@ is that you need to copy the Load Address output in the traceback ahead of the sequence of addresses. And the default mode of @code{gnatsymbolize} is equivalent to that of @code{addr2line} with the above switches, so none of them is needed: -@quotation - - -@table @asis - -@item :: - +@example $ gnatmake stb -g -bargs -E $ stb @@ -19068,13 +19059,8 @@ Load address: 0x400000 Call stack traceback locations: 0x401373 0x40138b 0x40139c 0x401335 0x4011c4 0x4011f1 0x77e892a4 - -@table @asis - -@item $ gnatsymbolize –load stb 0x400000 0x401373 0x40138b 0x40139c 0x401335 - -0x4011c4 0x4011f1 0x77e892a4 -@end table +$ gnatsymbolize --load stb 0x400000 0x401373 0x40138b 0x40139c 0x401335 + 0x4011c4 0x4011f1 0x77e892a4 0x00401373 Stb.P1 at stb.adb:5 0x0040138B Stb.P2 at stb.adb:10 @@ -19083,8 +19069,7 @@ Call stack traceback locations: 0x004011c4 __tmainCRTStartup at ??? 0x004011f1 mainCRTStartup at ??? 0x77e892a4 ??? at ??? -@end table -@end quotation +@end example @subsubheading Tracebacks From Exception Occurrences