Re: Opaque objects and Emacs documentation

[Richard Stallman]

[[[ 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.

-- 
Dr Richard Stallman
Chief GNUisance of the GNU Project (https://gnu.org)
Founder, Free Software Foundation (https://fsf.org)
Internet Hall-of-Famer (https://internethalloffame.org)