emacs-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Poor quality documentation in edebug.el, and recursive documentation


From: Eli Zaretskii
Subject: Re: Poor quality documentation in edebug.el, and recursive documentation.
Date: Sat, 09 May 2020 16:53:09 +0300

> From: Stefan Monnier <address@hidden>
> Cc: Alan Mackenzie <address@hidden>,  address@hidden,  address@hidden
> Date: Sat, 09 May 2020 09:47:03 -0400
> 
> > Once again: "Return value" doesn't sound right to me, since it implies
> > read-only access to the value, something that AFAIU is inaccurate.  It
> > actually returns a settable "place", doesn't it?
> 
> AFAIK the official name for that in OO parlance is an "accessor".
> Which is why I used the verb "Access".

That's okay, but the patch in question proposes to replace "Access"
with "Return value of", and I think this will make the documentation
less accurate than the original.  Or am I missing something?



reply via email to

[Prev in Thread] Current Thread [Next in Thread]