Re: [PATCH, doc RFA]: Add guile progspace support

[Doug Evans <xdje42@gmail.com>]

On Thu, May 22, 2014 at 8:27 AM, Eli Zaretskii <eliz@gnu.org> wrote:
>> From: Doug Evans <xdje42@gmail.com>
>> 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.

I'll work on improving the text.

However,

I wish to point out that the python version says this:

@defvar Progspace.filename
The file name of the progspace as a string.
@end defvar

I have to say it's a bit disappointing that if there were issues with
this text that they weren't addressed the first time.