From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.129.124]) by sourceware.org (Postfix) with ESMTPS id DD4DB383D82B for ; Thu, 19 May 2022 14:24:43 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org DD4DB383D82B Received: from mail-wm1-f71.google.com (mail-wm1-f71.google.com [209.85.128.71]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-599-DIPsS0gxNtyLR1CtrRlxDg-1; Thu, 19 May 2022 10:24:42 -0400 X-MC-Unique: DIPsS0gxNtyLR1CtrRlxDg-1 Received: by mail-wm1-f71.google.com with SMTP id m26-20020a05600c3b1a00b00397220d6329so1573118wms.5 for ; Thu, 19 May 2022 07:24:42 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=na/kQcTvnWQVHecA/OR3v0BA/rbsBQOdgPBO//CKHs8=; b=OZpZo+eVIHuQRrLe/rMb4Od6rJR/ijw6UmIoTCHxrw1RRpiJ51ycXULLrusxBnpcSz lI1mVlXDYW4z2aOw0OKSbvyff6gWLiB5ozaQVaxiytdvGMvf3A6tOzQ4vDXeyHvgGofV VL8Vaik7W8xhlWJcXX2UCamgnXEPBLvgzbzdStB/7TIT3s4jWcdM7ASQ6Ibj2H4qHuZC PPiruMd5SHibVj88wLt7aWgh03Jw+7stU1DFJ6yALY536Cz7MfdktRZM3q+n27ZC0Ddi Nx9SkkCJtnGJCRBiVfg/Ni8fuu9/btbsRZXLf5h29E0DDvQ3vueWJeBiFD3oqckJCXaO CFiw== X-Gm-Message-State: AOAM530YlJZ3VfaDkG+PL66ZKyTTRFXkohEEfvvAL+z7Tg/lLKEQKHyU QcjIlKLh70XzA+QJXIip+zmcsd1SdESkDAlHAskbPdQ2MMOtM9XSRl5kh7tEBNxhPtCDwW0N+4F /eHF+9YuhXwwqiAWJQstM1Is4+Mdo+47LzxDcN90zkKJUZB/t+bZ0bWLKf5nqv5INapL2XKOAbw == X-Received: by 2002:a5d:674b:0:b0:20e:6164:d86f with SMTP id l11-20020a5d674b000000b0020e6164d86fmr4300800wrw.297.1652970281120; Thu, 19 May 2022 07:24:41 -0700 (PDT) X-Google-Smtp-Source: ABdhPJwW4Kk5eSm8UuewuqsZNPHKysLw8BKWgID055TI6/dvNZM9rWc3HSnGRx+BhV6lb4+X74XSfQ== X-Received: by 2002:a5d:674b:0:b0:20e:6164:d86f with SMTP id l11-20020a5d674b000000b0020e6164d86fmr4300783wrw.297.1652970280862; Thu, 19 May 2022 07:24:40 -0700 (PDT) Received: from localhost (host81-136-113-48.range81-136.btcentralplus.com. [81.136.113.48]) by smtp.gmail.com with ESMTPSA id d28-20020adfa41c000000b0020e5b4ebaecsm5433021wra.4.2022.05.19.07.24.40 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 19 May 2022 07:24:40 -0700 (PDT) From: Andrew Burgess To: gdb-patches@sourceware.org Cc: Andrew Burgess Subject: [PUSHED 2/3] gdb/doc: make use of group/end group in 'info pretty-printers' example Date: Thu, 19 May 2022 15:24:33 +0100 Message-Id: <62ec8e6dad018082e33e7dcb0633f28332f3520c.1652970188.git.aburgess@redhat.com> X-Mailer: git-send-email 2.25.4 In-Reply-To: References: MIME-Version: 1.0 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: 8bit Content-Type: text/plain; charset="US-ASCII"; x-default=true X-Spam-Status: No, score=-12.4 required=5.0 tests=BAYES_00, DKIMWL_WL_HIGH, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, GIT_PATCH_0, RCVD_IN_DNSWL_LOW, SPF_HELO_NONE, SPF_NONE, 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: gdb-patches@sourceware.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Gdb-patches mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 19 May 2022 14:24:45 -0000 The 'info pretty-printers' example is pretty long and consists of many commands and their output. Currently, when the pdf manual is generated this example spans a page-break, with the page-break falling part way through some example output from GDB. This commit breaks up the example using @group .... @end group, within each group is a single GDB command and all its output. Now, when the pdf manual is created, the page-break is placed after the output of one GDB command, and before the subsequent command, this looks much nicer. --- gdb/doc/gdb.texinfo | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index 68f7aba8d7d..76fc548fc84 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -12075,6 +12075,7 @@ @code{bar1} and @code{bar2}. @smallexample +@group (gdb) info pretty-printer library1.so: foo @@ -12082,11 +12083,15 @@ bar bar1 bar2 +@end group +@group (gdb) info pretty-printer library2 library2.so: bar bar1 bar2 +@end group +@group (gdb) disable pretty-printer library1 1 printer disabled 2 of 3 printers enabled @@ -12097,6 +12102,8 @@ bar bar1 bar2 +@end group +@group (gdb) disable pretty-printer library2 bar;bar1 1 printer disabled 1 of 3 printers enabled @@ -12105,6 +12112,8 @@ bar bar1 [disabled] bar2 +@end group +@group (gdb) disable pretty-printer library2 bar 1 printer disabled 0 of 3 printers enabled @@ -12115,6 +12124,7 @@ bar [disabled] bar1 [disabled] bar2 +@end group @end smallexample Note that for @code{bar} the entire printer can be disabled, -- 2.25.4