From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from AUS01-SY4-obe.outbound.protection.outlook.com (mail-sy4aus01olkn2169.outbound.protection.outlook.com [40.92.62.169]) by sourceware.org (Postfix) with ESMTPS id 81EC03858407 for ; Sat, 23 Apr 2022 09:16:16 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org 81EC03858407 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=KCB3hASG7fXnWxvVr7/U9xE7LYq9mx7SOmGx2fF3Tvu0Jru5G8qGmsiqXPeb6seB1fyRxA2HZMiQEDAmXVbhiBiopjcXAfQJ+SK9hIlQ50RsBMYh/QDIKm+Laqfw9bUcnrmiXv3mY4qOwSW7BThJHcmg2/zHHV7l9qfD1SahUdle7e2k9w4ml0inGa2o4EF9WGgoRGQvGbI+f+PNiSNscCR2MsHUu/zrqi3LpcI7auwZb+zpgJ1JkjZCAUFKrNIEYNndEEAfDO+nxGdT3gOz54ywyfJ4grVp2QIEcOcwF3g1Zv+3zJhFI+d+t8Mp+iJOsxJQ6cc+7WopuE2fu/4LCg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=7PTzvftoL2MbSXRgN86ZWvbtJzy9lZtsEpRsa21Zslw=; b=gE4v74XLSKmVoI8zpCyieKfDFpzqC7MyShB/ZJBTpv3AA8hhrDjizS6juEtVrZ7LsR7eiT0oeV4Rs7dWg46Pu41Dv4wXTTh+0HXwyFM6J6x4welx4EoLYwvTbzzv5eeCny4g6UVbdRB9lCtIC6lup+6/UC9dfiqh2xSnAr9B5HNsUCkKiT4JykBiedFhgK+S57jx2oByW8oGxnuojPDAa87u/x+/C4sDfrBMhcTiQkS/oIUdAlqCDlz42aMaY9153gg53BZJc9NXuxf9mtyW7YTO/j9SMmJHfJZ/uvj+zd6cDr1rfeS468waa5T+NMiNJuePkXn7jpd2D7q4E57iCQ== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=none; dmarc=none; dkim=none; arc=none Received: from MEAP282MB0293.AUSP282.PROD.OUTLOOK.COM (2603:10c6:220:71::10) by SYBP282MB2724.AUSP282.PROD.OUTLOOK.COM (2603:10c6:10:153::14) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5186.15; Sat, 23 Apr 2022 09:16:12 +0000 Received: from MEAP282MB0293.AUSP282.PROD.OUTLOOK.COM ([fe80::5804:c2bb:bc94:3cec]) by MEAP282MB0293.AUSP282.PROD.OUTLOOK.COM ([fe80::5804:c2bb:bc94:3cec%6]) with mapi id 15.20.5186.018; Sat, 23 Apr 2022 09:16:12 +0000 From: Enze Li To: pedro@palves.net, tom@tromey.com Cc: gdb-patches@sourceware.org Subject: [PATCH v8 2/3] gdb/doc: Documentation for the new print command Date: Sat, 23 Apr 2022 17:15:57 +0800 Message-ID: X-Mailer: git-send-email 2.35.3 In-Reply-To: References: Content-Transfer-Encoding: 8bit Content-Type: text/plain X-TMN: [O7Qs6aFMdT2bXzPHI4IXVSuaXuvPIGI7] X-ClientProxiedBy: HK2PR02CA0179.apcprd02.prod.outlook.com (2603:1096:201:21::15) To MEAP282MB0293.AUSP282.PROD.OUTLOOK.COM (2603:10c6:220:71::10) X-Microsoft-Original-Message-ID: <20220423091557.19178-1-lienze2010@hotmail.com> MIME-Version: 1.0 X-MS-Exchange-MessageSentRepresentingType: 1 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 0a5f7b8b-f20e-4fde-5c7e-08da2509e8d7 X-MS-TrafficTypeDiagnostic: SYBP282MB2724:EE_ X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: cWsToHThzPksLsWQQXkAVPs2Fy31P31Qpjz/7hmv6CifOLVCT5otL9IwKozYxEzm3NBiFStEDKQWP764zn6OKRSLdYB9O3ivZaSQLiF4yOCMjrrA0S7QrcX1JsB9oRyvfFrDtw6H81yZpX4SSeuqD3NAtxUO9E1JF6U72w3hIZIHWh74Xe5CBPXreaA2J59U8w22nwSxBoSfrWolmLzL8G/sN11fe3ds3UZSE7/lhLqOkvvvA5yFA6ToKB8f/QiGt79Sl4UEjrwKq2u6zkZFLi3z2ncxfACmZHQtO0Zoz1LWfF8OSTW/pXpoPKwEc3SS39H+xc+WKBeq/hwUu0EBJRu0b1ni0P5ozeZA41Hh1bykUee1s9w0We7DVGHXsagFszxF2DMtlrByF9wvfmZWilfAbPI3eK8lgCR9bSYpF4YHKirQ0KZhUY8GOMwxePf3FJlOpbvtcSSlQtUJwciqVdCLKcf3f1IqnQPtJevM4I07i4rvsfXWvjQctVO5nM+NOdIFKjyFsQyexDALxOZVOG6mxDUzJ7By13lbGIAXuke1QQ76Ebei+60fXRNyqqvYh0OorCcMffnOYmvZxvhjVQ== X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?lVr1tOyzJdd2QoSQuYZLc2yz3HAR1YM383OVCGjgIf/LA4687g3Iyce/nuen?= =?us-ascii?Q?mBWOabm6/YX5qJ0fVJaBm24BeoGfHEsbXsWrGG4lGeHO1PF7jIrxy0gF2Wvh?= =?us-ascii?Q?vRN/R6/XmdKPN6kn7M+/0OCp8zgmPjI+cMlJwdqeX44b02GvFCmOdQLi1WKS?= =?us-ascii?Q?Kmv3SmHoYBOlfQ/I2D/q6QBJDbJkQWXIhagXjWOd+LnbhKppfF6rxBIlQjWC?= =?us-ascii?Q?oWzZ0d6M4UtUSg52Jqb16lQcsVK727Vf6DSEgCCjItFw5XAsMm7tlsx+CLap?= =?us-ascii?Q?AVlkIySDfdw19HJrgEq8PSD28uoPyAVbt3H9D7NNqtVo9eF0CDmAO8T3y63R?= =?us-ascii?Q?yCqzN0cN9dhEe/fqXSHP6Y4a0ItLH5SOCOd3a0rIFsXvOXQ3RY/ZIQIQULT5?= =?us-ascii?Q?otdtyfh0H2zWRCT1AY98+AedGNaz2jFJj5i+qPdSeu48Fe6UvkmBZAi5XlDE?= =?us-ascii?Q?lkrNdPL9dLoCvnzn/SLO058At/1+u+YEOP+Gj+pHSPL1HbrNmmH5coZnEZfu?= =?us-ascii?Q?ZWk1OnVLRKHnXu+JvN/yHD49X46/lK0rg0Dxa2G0RMWGEPCUrD4vQOD1Qc2i?= =?us-ascii?Q?7Vr4wpykrYjMKfQAWpo+tGTbs9XKJAIQiiFpjFne1IPVFQnyOn35vR1FTz7W?= =?us-ascii?Q?48kIco6sTcuy0Tk+nx/5GwaYXvlM5EoGhdgiMdz3+XoLryb5ftTcRXTNlUkg?= =?us-ascii?Q?QmyclmAatdSMr5XwJs+CGB8cAlu3qjcCtYDy6E5K0li7WVSdG1c1VWdujNs4?= =?us-ascii?Q?lrMuxXel109sR65XHi1OvJQH6luF6CggUy5X5N5gdhVWYJ7GbNUPOtDvVSLZ?= =?us-ascii?Q?7fvZ21d9GxF0TsylTjJewlmvhSBrvEVaQR5MxY1RYo3i7JEtfI6nx989WGdV?= =?us-ascii?Q?WBK7qoHZEuIxFfE4loo22upaNuIULAenbYy1YE1LNK697SGeS5b30JhZG1/R?= =?us-ascii?Q?e5L54OYCtXBOcLPE1nCmKuuhkjJwfAdaJBPG+IfJt0jlUzAs+Ykk3Lr8uWEY?= =?us-ascii?Q?S7sbrMSQIsgPRApDnVbQ1/fQV+JyERpJ/MhLmRsaCwIMcsjT8zR0eaVWuNnY?= =?us-ascii?Q?1Fvy6NDctXG04Jk+hcG+jwioDVXn6I/EJ1hwOaTtbPhRbel6mWxzA2VtGBSP?= =?us-ascii?Q?jkLsaQSg7fMlxq8TDifTAdddR2Js3MkEXSclRQmzt+7yNG2WYfif6dhm6iFU?= =?us-ascii?Q?MPs7GpCBW8ukfAewurLxtlEG3OEZDJgk7Jz54nM4ZWWT7HM5e6rYkAS6VXhR?= =?us-ascii?Q?f0EKtUE4xx0wuYktnDC6EDtWKHWwnxj/M6AWvR6CY/gXqZ2GJp7OkuSxJYnA?= =?us-ascii?Q?ne+IuCY69mJIuLMNTnAAcsjkF73d7yxrNIU7sKG7OON8fvlPFSqohJ3ypEKa?= =?us-ascii?Q?mtmmaDYrwDxxyg4Pc2JbQ5OJJZrxFH/R4bxjAwzDcbwSTvpM38xr1QSrV+h0?= =?us-ascii?Q?PVacD8fPgbg=3D?= X-OriginatorOrg: sct-15-20-4755-11-msonline-outlook-746f3.templateTenant X-MS-Exchange-CrossTenant-Network-Message-Id: 0a5f7b8b-f20e-4fde-5c7e-08da2509e8d7 X-MS-Exchange-CrossTenant-AuthSource: MEAP282MB0293.AUSP282.PROD.OUTLOOK.COM X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 23 Apr 2022 09:16:12.0676 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 84df9e7f-e9f6-40af-b435-aaaaaaaaaaaa X-MS-Exchange-CrossTenant-RMS-PersistedConsumerOrg: 00000000-0000-0000-0000-000000000000 X-MS-Exchange-Transport-CrossTenantHeadersStamped: SYBP282MB2724 X-Spam-Status: No, score=-11.0 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, FREEMAIL_ENVFROM_END_DIGIT, FREEMAIL_FROM, GIT_PATCH_0, RCVD_IN_DNSWL_NONE, SPF_HELO_PASS, SPF_PASS, TXREP autolearn=ham autolearn_force=no version=3.4.4 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) 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: Sat, 23 Apr 2022 09:16:18 -0000 Document the new command "print nibbles" and add a NEWS entry. --- gdb/NEWS | 5 +++++ gdb/doc/gdb.texinfo | 35 +++++++++++++++++++++++++++++++---- 2 files changed, 36 insertions(+), 4 deletions(-) diff --git a/gdb/NEWS b/gdb/NEWS index 760cb2b7abc..f8502d5d238 100644 --- a/gdb/NEWS +++ b/gdb/NEWS @@ -23,6 +23,11 @@ maintenance show ignore-prologue-end-flag used to force GDB to use prologue analyzers if the line-table is constructed from erroneous debug information. +set print nibbles [on|off] +show print nibbles + This controls whether the 'print/t' command will display binary values + in groups of four bits, known as "nibbles". The default is 'off'. + * Changed commands maintenance info line-table diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index c1e9b09e833..7be872570a1 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -2142,10 +2142,10 @@ on @code{-} after the command name. For example: @smallexample (@value{GDBP}) print -@key{TAB}@key{TAB} --address -max-depth -pretty -symbol --array -memory-tag-violations -raw-values -union --array-indexes -null-stop -repeats -vtbl --elements -object -static-members +-address -max-depth -object -static-members +-array -memory-tag-violations -pretty -symbol +-array-indexes -nibbles -raw-values -union +-elements -null-stop -repeats -vtbl @end smallexample Completion will in some cases guide you with a suggestion of what kind @@ -10021,6 +10021,10 @@ Set limit on string chars or array elements to print. The value Set the threshold after which nested structures are replaced with ellipsis. Related setting: @ref{set print max-depth}. +@item -nibbles [@code{on}|@code{off}] +Set whether to print binary values in groups of four bits, known +as ``nibbles''. @xref{set print nibbles}. + @item -memory-tag-violations [@code{on}|@code{off}] Set printing of additional information about memory tag violations. @xref{set print memory-tag-violations}. @@ -11385,6 +11389,29 @@ Stop printing element indexes when displaying arrays. Show whether the index of each element is printed when displaying arrays. +@anchor{set print nibbles} +@item set print nibbles +@itemx set print nibbles on +@cindex print binary values in groups of four bits +Print binary values in groups of four bits, known as @dfn{nibbles}, +when using the print command of @value{GDBN} with the option @samp{/t}. +For example, this is what it looks like with @code{set print nibbles on}: + +@smallexample +@group +(@value{GDBP}) print val_flags +$1 = 1230 +(@value{GDBP}) print/t val_flags +$2 = 0100 1100 1110 +@end group +@end smallexample + +@item set print nibbles off +Don't printing binary values in groups. This is the default. + +@item show print nibbles +Show whether to print binary values in groups of four bits. + @anchor{set print elements} @item set print elements @var{number-of-elements} @itemx set print elements unlimited -- 2.35.3