From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 130226 invoked by alias); 27 Jul 2019 16:45:53 -0000 Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sourceware.org Received: (qmail 130218 invoked by uid 89); 27 Jul 2019 16:45:53 -0000 Authentication-Results: sourceware.org; auth=none X-Spam-SWARE-Status: No, score=-15.9 required=5.0 tests=AWL,BAYES_00,GIT_PATCH_0,GIT_PATCH_1,GIT_PATCH_2,GIT_PATCH_3,SPF_PASS autolearn=ham version=3.3.1 spammy=HX-Languages-Length:1838 X-HELO: eggs.gnu.org Received: from eggs.gnu.org (HELO eggs.gnu.org) (209.51.188.92) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with ESMTP; Sat, 27 Jul 2019 16:45:52 +0000 Received: from fencepost.gnu.org ([2001:470:142:3::e]:42783) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hrPpN-0008EV-OV; Sat, 27 Jul 2019 12:45:50 -0400 Received: from [176.228.60.248] (port=4263 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1hrPpN-0007PE-8A; Sat, 27 Jul 2019 12:45:49 -0400 Date: Sat, 27 Jul 2019 16:45:00 -0000 Message-Id: <83mugzl93j.fsf@gnu.org> From: Eli Zaretskii To: Andrew Burgess CC: gdb-patches@sourceware.org, Richard.Bunt@arm.com In-reply-to: <4bd416c1771299f9acdd31818a6d435b452c71f7.1564243858.git.andrew.burgess@embecosm.com> (message from Andrew Burgess on Sat, 27 Jul 2019 17:22:34 +0100) Subject: Re: [PATCH 6/7] gdb/fortran: Add new 'info modules' command References: <4bd416c1771299f9acdd31818a6d435b452c71f7.1564243858.git.andrew.burgess@embecosm.com> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-IsSubscribed: yes X-SW-Source: 2019-07/txt/msg00617.txt.bz2 > From: Andrew Burgess > Cc: Richard Bunt , Andrew Burgess > Date: Sat, 27 Jul 2019 17:22:34 +0100 > > diff --git a/gdb/NEWS b/gdb/NEWS > index 40b56727227..14c931602f4 100644 > --- a/gdb/NEWS > +++ b/gdb/NEWS > @@ -104,6 +104,12 @@ maint show test-settings KIND > A set of commands used by the testsuite for exercising the settings > infrastructure. > > +info modules [-q] [REGEXP] > + Return a list of modules matching REGEXP, or all modules if no > + REGEXP is given. Only languages that generate DW_TAG_module in > + their DWARF (for example Fortran) will give any results for this > + command. Without saying what is a "module", or at least naming a couple of languages which support them, this is not a very useful entry, I'm afraid. I don't think it's reasonable to assume the reader knows the DWARF spec enough to understand that from the tag name. > +@kindex info modules > +@cindex modules > +@item info modules [-q] [@var{regexp}] > +List all modules for which there is debugging information available. > +Modules are identified by @code{DW_TAG_module} in DWARF debugging > +information, only languages that use this tag will list modules with > +this command. Currently Fortran is known to generate module > +information in its debug. I would drop the DW_TAG_module reference, and instead try to explain in less technical terms what is a module. What other languages are known to have modules in this meaning? Can we name them? > +The optional flag @samp{-q}, which stands for @samp{quiet}, disables > +printing header information and messages explaining why no functions > +have been printed. Not sure I understand from this text how is -q useful for "info modules". Thanks.