From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 6575 invoked by alias); 1 Jun 2014 20:37:42 -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 6547 invoked by uid 89); 1 Jun 2014 20:37:39 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-1.9 required=5.0 tests=AWL,BAYES_00,FREEMAIL_ENVFROM_END_DIGIT,FREEMAIL_FROM,RCVD_IN_DNSWL_LOW,SPF_PASS autolearn=ham version=3.3.2 X-HELO: mail-pb0-f47.google.com Received: from mail-pb0-f47.google.com (HELO mail-pb0-f47.google.com) (209.85.160.47) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with (AES128-SHA encrypted) ESMTPS; Sun, 01 Jun 2014 20:37:38 +0000 Received: by mail-pb0-f47.google.com with SMTP id rp16so3507704pbb.34 for ; Sun, 01 Jun 2014 13:37:36 -0700 (PDT) X-Received: by 10.69.31.11 with SMTP id ki11mr35628581pbd.88.1401655056569; Sun, 01 Jun 2014 13:37:36 -0700 (PDT) Received: from seba.sebabeach.org.gmail.com (173-13-178-50-sfba.hfc.comcastbusiness.net. [173.13.178.50]) by mx.google.com with ESMTPSA id sv10sm53153664pab.32.2014.06.01.13.37.33 for (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Sun, 01 Jun 2014 13:37:33 -0700 (PDT) From: Doug Evans To: Eli Zaretskii Cc: gdb-patches@sourceware.org Subject: Re: [PATCH, doc RFA]: Add guile progspace support References: <83lhttn88w.fsf@gnu.org> Date: Sun, 01 Jun 2014 20:37:00 -0000 In-Reply-To: <83lhttn88w.fsf@gnu.org> (Eli Zaretskii's message of "Thu, 22 May 2014 18:27:59 +0300") Message-ID: User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.3 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-IsSubscribed: yes X-SW-Source: 2014-06/txt/msg00004.txt.bz2 Eli Zaretskii writes: >> From: Doug Evans >> Date: Wed, 21 May 2014 12:22:20 -0700 >> >> This patch adds guile progspace support. > > Thanks. > >> +@deffn {Scheme Procedure} progspace-filename progspace >> +Return the file name of @var{progspace} as a string. >> +If the program space does not have an associated file name, >> +then @code{#f} is returned. This occurs, for example, when @value{GDBN} >> +is started without a program to debug. > > I guess this is the file name of the executable program running in the > progspace? If so, why not tell that explicitly? This text as written > begs the question what file is named by that string. Also, is the > file absolute, relative, something else? Is it just the value of > argv[0] in that program? Etc. etc. How about this? +@deffn {Scheme Procedure} progspace-filename progspace +Return the file name of @var{progspace} as a string, +as an absolute path. +This is the name of file passed as the argument to the @code{file} +or @code{symbol-file} commands. +If the program space does not have an associated file name, +then @code{#f} is returned. This occurs, for example, when @value{GDBN} +is started without a program to debug. + +A @code{gdb:invalid-object-error} exception is thrown if @var{progspace} +is invalid. +@end deffn >> +A @code{gdb:invalid-object-error} exception is thrown if @var{PROGSPACE} >> +is invalid. ^^^^^^^^^ > > "progspace", in lower case. Fixed. >> +@deffn {Scheme Procedure} progspace-objfiles progspace >> +Return the list of objfiles of @var{progspace}. >> +The order of objfiles in the result is arbitrary. > > "Arbitrary" or in the same order they are stored in some symbol table? Arbitrary. gdb makes no promises to the user regarding the order. >> +A @code{gdb:invalid-object-error} exception is thrown if @var{PROGSPACE} >> +is invalid. ^^^^^^^^^ > > "progspace" in lower case. Fixed.