Re: Opaque objects and Emacs documentation

[Dmitry Gutov]

On 19.07.2020 17:48, Eli Zaretskii wrote:
> Because having user commands
> that allude to "project instance" without even a minimal explanation
> of what that is makes our documentation of such commands almost
> useless, and the question that bothers me is how to keep the quality
> of our documentation at its usual high level while using these or
> similar design and implementation patterns.

I started replying to say that you are welcome to propose improvements 
for better description of allowed semantics, but then again, you 
probably meant something like more details about which cons cell 
contains which values.

In the meantime, I have added more text to Commentary in project.el. 
Please take a look whenever convenient.