emacs-devel
[Top][All Lists]
Advanced

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

Re: Opaque objects and Emacs documentation


From: Dmitry Gutov
Subject: Re: Opaque objects and Emacs documentation
Date: Sat, 18 Jul 2020 22:17:02 +0300
User-agent: Mozilla/5.0 (X11; Linux x86_64; rv:68.0) Gecko/20100101 Thunderbird/68.10.0

On 18.07.2020 04:54, Richard Stallman wrote:
[[[ To any NSA and FBI agents reading my email: please consider    ]]]
[[[ whether defending the US Constitution against all enemies,     ]]]
[[[ foreign or domestic, requires you to follow Snowden's example. ]]]

If we want to dowplay the current subsctructure of a piece of data,
that does not require mystifying that current subsctructure.  It is
easy to avoid that.

We define an accessor defsubst for each of the data it contains.  We
document its meaning.  We define a constructor function, and document
the meaning of each argument.  We manipulate them always through those
functions.  VoilĂ !

The subsctructure is clearly shown and yet changing it later is painless.

This is pretty much what I'm doing here.

Only a little more complex, because there are multiple data types that implement the same interface.



reply via email to

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