[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: Opaque objects and Emacs documentation
From: |
tomas |
Subject: |
Re: Opaque objects and Emacs documentation |
Date: |
Tue, 21 Jul 2020 10:57:35 +0200 |
User-agent: |
Mutt/1.5.21 (2010-09-15) |
Hi,
On Tue, Jul 21, 2020 at 04:09:18AM +0300, Dmitry Gutov wrote:
[...]
I don't think it's intentional, but please reconsider this:
> [...] The core of the dispute is whether
> project-current's docstring should document the return value in
> detail (giving an example of built-in project instances's
> structure). Eli is insisting on it because (AFAICT) that suits his
> thought process and he thinks that will help users/clients to make
> sense of how things work.
in a few words: Eli's thought process vs...
> I am adamantly against this because it's against the design (clients
> should program against the public interface, not against the
> implementation), and is likely to encourage incorrect programs.
... The Right Way To Do It (TM).
It comes across as a little... biased. Which is understandable,
but not a good position when bargaining, nevertheless ;-)
Cheers
-- t
signature.asc
Description: Digital signature
- Re: Opaque objects and Emacs documentation, (continued)
- Re: Opaque objects and Emacs documentation, John Yates, 2020/07/21
- Re: Opaque objects and Emacs documentation, Dmitry Gutov, 2020/07/21
- Re: Opaque objects and Emacs documentation, Eli Zaretskii, 2020/07/22
- Re: Opaque objects and Emacs documentation, Dmitry Gutov, 2020/07/19
- Re: Opaque objects and Emacs documentation, Richard Stallman, 2020/07/19
- Re: Opaque objects and Emacs documentation, Dmitry Gutov, 2020/07/20
- Re: Opaque objects and Emacs documentation,
tomas <=
- Re: Opaque objects and Emacs documentation, Dmitry Gutov, 2020/07/21
- Re: Opaque objects and Emacs documentation, tomas, 2020/07/21
- Re: Opaque objects and Emacs documentation, Eli Zaretskii, 2020/07/21
- Re: Opaque objects and Emacs documentation, Dmitry Gutov, 2020/07/21
- Re: Opaque objects and Emacs documentation, Eli Zaretskii, 2020/07/21
- Re: Opaque objects and Emacs documentation, Dmitry Gutov, 2020/07/21
- Re: Opaque objects and Emacs documentation, Eli Zaretskii, 2020/07/22
- Re: Opaque objects and Emacs documentation, Dmitry Gutov, 2020/07/22
- Re: Opaque objects and Emacs documentation, Eli Zaretskii, 2020/07/22
- Re: Opaque objects and Emacs documentation, Dmitry Gutov, 2020/07/22