From patchwork Sat Nov 17 12:04:44 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Philippe Waroquiers X-Patchwork-Id: 30178 Received: (qmail 33372 invoked by alias); 17 Nov 2018 12:05:03 -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 33251 invoked by uid 89); 17 Nov 2018 12:05:02 -0000 Authentication-Results: sourceware.org; auth=none X-Spam-SWARE-Status: No, score=-26.6 required=5.0 tests=AWL, BAYES_00, GIT_PATCH_0, GIT_PATCH_1, GIT_PATCH_2, GIT_PATCH_3, RCVD_IN_DNSWL_LOW, SPF_PASS autolearn=ham version=3.3.2 spammy=Manually X-HELO: mailsec112.isp.belgacom.be Received: from mailsec112.isp.belgacom.be (HELO mailsec112.isp.belgacom.be) (195.238.20.108) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with ESMTP; Sat, 17 Nov 2018 12:05:00 +0000 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=skynet.be; i=@skynet.be; q=dns/txt; s=securemail; t=1542456301; x=1573992301; h=from:to:cc:subject:date:message-id:in-reply-to: references:mime-version:content-transfer-encoding; bh=uckfhG9rJ73o0/lHLd8H2/IPbJgTk5zb5uGeWbadxiw=; b=aYn4TAGkG7dwzTmr+z7V/U/FPSvtY13GoO75IxWRPiQcpQ01+Ah8Alj0 40G1G5qpd4IX90vfY1fHQl9Kc/92hA==; Received: from 110.212-243-81.adsl-dyn.isp.belgacom.be (HELO md.home) ([81.243.212.110]) by relay.skynet.be with ESMTP/TLS/DHE-RSA-AES128-GCM-SHA256; 17 Nov 2018 13:04:51 +0100 From: Philippe Waroquiers To: gdb-patches@sourceware.org Cc: Philippe Waroquiers Subject: [RFAv2 4/5] Document language choice in 'info [functions|variables|types]|rbreak' commands Date: Sat, 17 Nov 2018 13:04:44 +0100 Message-Id: <20181117120445.10805-5-philippe.waroquiers@skynet.be> In-Reply-To: <20181117120445.10805-1-philippe.waroquiers@skynet.be> References: <20181117120445.10805-1-philippe.waroquiers@skynet.be> MIME-Version: 1.0 X-IsSubscribed: yes doc/ChangeLog 2018-11-17 Philippe Waroquiers * gdb.texinfo (Examining the Symbol Table): Document language choice for 'info types|functions|variables' commands. (Setting Breakpoints): Document language choice to print the functions in which a breakpoint is set. --- gdb/doc/gdb.texinfo | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index 944a2c4383..3c3915b332 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -3873,6 +3873,13 @@ breakpoints are set, they are treated just like the breakpoints set with the @code{break} command. You can delete them, disable them, or make them conditional the same way as any other breakpoint. +In programs using different languages, @value{GDBN} chooses the syntax +to print the list of all breakpoints it sets according to the +@samp{set language} value: using @samp{set language auto} +(see @ref{Automatically, ,Set Language Automatically}) means to use the +language of the breakpoint's function, other values mean to use +the manually specified language (see @ref{Manually, ,Set Language Manually}). + The syntax of the regular expression is the standard one used with tools like @file{grep}. Note that this is different from the syntax used by shells, so for instance @code{foo*} matches all functions that include @@ -17903,6 +17910,13 @@ types in your program whose names include the string @code{value}, but @samp{i type ^value$} gives information only on types whose complete name is @code{value}. +In programs using different languages, @value{GDBN} chooses the syntax +to print the type description according to the +@samp{set language} value: using @samp{set language auto} +(see @ref{Automatically, ,Set Language Automatically}) means to use the +language of the type, other values mean to use +the manually specified language (see @ref{Manually, ,Set Language Manually}). + This command differs from @code{ptype} in two ways: first, like @code{whatis}, it does not print a detailed description; second, it lists all source files and line numbers where a type is defined. @@ -17987,6 +18001,13 @@ Similarly to @samp{info types}, this command groups its output by source files and annotates each function definition with its source line number. +In programs using different languages, @value{GDBN} chooses the syntax +to print the function name and type according to the +@samp{set language} value: using @samp{set language auto} +(see @ref{Automatically, ,Set Language Automatically}) means to use the +language of the function, other values mean to use +the manually specified language (see @ref{Manually, ,Set Language Manually}). + The optional flag @samp{-q}, which stands for @samp{quiet}, disables printing header information and messages explaining why no functions have been printed. @@ -18027,6 +18048,13 @@ outside of functions (i.e.@: excluding local variables). The printed variables are grouped by source files and annotated with their respective source line numbers. +In programs using different languages, @value{GDBN} chooses the syntax +to print the variable name and type according to the +@samp{set language} value: using @samp{set language auto} +(see @ref{Automatically, ,Set Language Automatically}) means to use the +language of the variable, other values mean to use +the manually specified language (see @ref{Manually, ,Set Language Manually}). + The optional flag @samp{-q}, which stands for @samp{quiet}, disables printing header information and messages explaining why no variables have been printed.