From patchwork Fri May 10 13:13:27 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Tom Tromey X-Patchwork-Id: 32631 Received: (qmail 57383 invoked by alias); 10 May 2019 13:13:35 -0000 Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Unsubscribe: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sourceware.org Delivered-To: mailing list gdb-patches@sourceware.org Received: (qmail 57375 invoked by uid 89); 10 May 2019 13:13:35 -0000 Authentication-Results: sourceware.org; auth=none X-Spam-SWARE-Status: No, score=-22.0 required=5.0 tests=AWL, BAYES_00, GIT_PATCH_0, GIT_PATCH_1, GIT_PATCH_2, GIT_PATCH_3, RCVD_IN_DNSWL_NONE, SPF_PASS autolearn=ham version=3.3.1 spammy=H*F:U*tromey, HX-Envelope-From:sk:tromey@, HContent-Transfer-Encoding:8bit X-HELO: rock.gnat.com Received: from rock.gnat.com (HELO rock.gnat.com) (205.232.38.15) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with ESMTP; Fri, 10 May 2019 13:13:33 +0000 Received: from localhost (localhost.localdomain [127.0.0.1]) by filtered-rock.gnat.com (Postfix) with ESMTP id 3AE4B117196; Fri, 10 May 2019 09:13:32 -0400 (EDT) Received: from rock.gnat.com ([127.0.0.1]) by localhost (rock.gnat.com [127.0.0.1]) (amavisd-new, port 10024) with LMTP id oyavCiG3Pr7s; Fri, 10 May 2019 09:13:32 -0400 (EDT) Received: from murgatroyd.Home (97-122-168-123.hlrn.qwest.net [97.122.168.123]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by rock.gnat.com (Postfix) with ESMTPSA id DA7B3116BCE; Fri, 10 May 2019 09:13:31 -0400 (EDT) From: Tom Tromey To: gdb-patches@sourceware.org Cc: Tom Tromey Subject: [PATCH] Minor "catch" documentation improvements Date: Fri, 10 May 2019 07:13:27 -0600 Message-Id: <20190510131327.14790-1-tromey@adacore.com> MIME-Version: 1.0 This patch makes a few minor improvements to the catchpoint documentation: * "catch exception" and "catch handlers" now mention the argument in the @item. * "catch exception unhandled" is moved to be closer to "catch exception", rather than after "catch handlers". * "catch load" and "catch unload" now wrap the argument in @var. gdb/doc/ChangeLog 2019-05-10 Tom Tromey * gdb.texinfo (Set Catchpoints): Add text for parameter to "catch exception" and "catch handlers". Move "catch exception unhandled" text. Use @var for "catch load" and "catch unload" --- gdb/doc/ChangeLog | 6 ++++++ gdb/doc/gdb.texinfo | 16 ++++++++-------- 2 files changed, 14 insertions(+), 8 deletions(-) diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index b7f3b271d1f..1fb4e3df6a3 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -4509,7 +4509,7 @@ You cannot raise an exception interactively. You cannot install an exception handler interactively. @end itemize -@item exception +@item exception @r{[}@var{name}@r{]} @kindex catch exception @cindex Ada exception catching @cindex catch Ada exceptions @@ -4527,7 +4527,11 @@ called @code{Constraint_Error} is defined in package @code{Pck}, then the command to use to catch such exceptions is @kbd{catch exception Pck.Constraint_Error}. -@item handlers +@item exception unhandled +@kindex catch exception unhandled +An exception that was raised but is not handled by the program. + +@item handlers @r{[}@var{name}@r{]} @kindex catch handlers @cindex Ada exception handlers catching @cindex catch Ada exceptions when handled @@ -4547,10 +4551,6 @@ user-defined one. For instance, assuming an exception called command to use to catch such exceptions handling is @kbd{catch handlers Pck.Constraint_Error}. -@item exception unhandled -@kindex catch exception unhandled -An exception that was raised but is not handled by the program. - @item assert @kindex catch assert A failed Ada assertion. @@ -4727,8 +4727,8 @@ A call to @code{fork}. @kindex catch vfork A call to @code{vfork}. -@item load @r{[}regexp@r{]} -@itemx unload @r{[}regexp@r{]} +@item load @r{[}@var{regexp}@r{]} +@itemx unload @r{[}@var{regexp}@r{]} @kindex catch load @kindex catch unload The loading or unloading of a shared library. If @var{regexp} is