Re: Opaque objects and Emacs documentation

[Dmitry Gutov]

On 17.07.2020 18:41, Drew Adams wrote:
> "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.

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.