Re: proced-refine: confusing doc string

[Jim Blandy]

On Sun, Sep 28, 2008 at 12:47 PM, Lennart Borgman (gmail)
<address@hidden> wrote:
> T. V. Raman wrote:
>> The proced-refine command has the following  as part of its doc
>> string:
>>
>> <cite>
>> If point is on the attribute ATTR, this command compares the value of ATTR
>> of every process with the value of ATTR of the process at the position
>> of point.  One can select processes for which the value of ATTR is
>> \"less than\", \"equal\", and / or \"larger\" than ATTR of the process
>> point is on.
>>
>> </cite>
>>
>> The initial sentence talks about point being in the header, the
>> latter half talks about the  process that point is on. How can
>> point be in both places at once?
>
> Doesn't it mean the column ATTR (or however it is layed out, I do not know)?

It does --- but Raman is certainly not the only user reading it that
way.  Should the docstring be more explicit?  Attached is what would
make sense to me.

jimb.proced-refine-doc.patch
Description: Text Data