[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
RE: Opaque objects and Emacs documentation
From: |
Drew Adams |
Subject: |
RE: Opaque objects and Emacs documentation |
Date: |
Fri, 17 Jul 2020 08:59:12 -0700 (PDT) |
> > "Don't look! - INTERNAL" is, in particular,
> > not a good reason. It's not a reason at all,
> > except perhaps in the context of protecting
> > private property, which we're not in the
> > business of doing, here. Opaqueness should
> > be anathema to free software.
>
> "You may look, but try not to touch" would perhaps be a better analogy.
Fine. And a comment as to why is a plus.
> Lisp indeed is a special language, and any concerns that my choice
> would actually be _hiding_ something from the users is a dramatic
> overstatement. Both the code and the returned values are trivial to
> examine.
My post didn't speak about your choice for anything.
It's not about you. I replied to Eli's request for
input on the general question. An interesting and
useful question, IMO.
A general comment on your reply, here, is that the
trivialness of code and return values can be in the
eye of the reader.
And accompanying description rarely _hurts_.
It hurts when it's _wrong_ or misleading, and in
that case, especially if written by the code author,
such inaccuracy can be a sign that something isn't
understood as well as it should be.
That's another purpose doc/description serves: it
can be a check on our understanding. This is one
of the reasons for careful _specifying_, whether
for requirements, design, tests, whatever.
- Re: Opaque objects and Emacs documentation, (continued)
- Re: Opaque objects and Emacs documentation, Dmitry Gutov, 2020/07/17
- Re: Opaque objects and Emacs documentation, Gregory Heytings, 2020/07/17
- RE: Opaque objects and Emacs documentation, Drew Adams, 2020/07/17
- Re: Opaque objects and Emacs documentation, Dmitry Gutov, 2020/07/17
- Re: Opaque objects and Emacs documentation, Gregory Heytings, 2020/07/17
- Re: Opaque objects and Emacs documentation, Yuan Fu, 2020/07/17
- RE: Opaque objects and Emacs documentation, Drew Adams, 2020/07/17
- Re: Opaque objects and Emacs documentation, Richard Stallman, 2020/07/17
- RE: Opaque objects and Emacs documentation, Drew Adams, 2020/07/17
- Re: Opaque objects and Emacs documentation, Dmitry Gutov, 2020/07/17
- RE: Opaque objects and Emacs documentation,
Drew Adams <=
- Re: Opaque objects and Emacs documentation, Stefan Monnier, 2020/07/17
- Re: Opaque objects and Emacs documentation, Andy Moreton, 2020/07/23
- Re: Opaque objects and Emacs documentation, Andy Moreton, 2020/07/23
- Re: Opaque objects and Emacs documentation, Eli Zaretskii, 2020/07/24
- Re: Opaque objects and Emacs documentation, Andy Moreton, 2020/07/24
- Re: Opaque objects and Emacs documentation, Eli Zaretskii, 2020/07/24
- Re: Opaque objects and Emacs documentation, Dmitry Gutov, 2020/07/23
- Re: Opaque objects and Emacs documentation, Andy Moreton, 2020/07/23
- Re: Opaque objects and Emacs documentation, Eli Zaretskii, 2020/07/24
- Re: Opaque objects and Emacs documentation, Andy Moreton, 2020/07/25