Re: misnomers

[Sam S. <sd...@gn...>]

> * Bruno Haible <oe...@py...t> [2017-06-02 19:32:43 +0200]:
>
> There are a couple of wrong terms in the source code:

In addition to being semantically correct, an important requirement is
that it should never be used anywhere in any other sense.
Ideally, it should be a new term in the source tree (`grep -ri new-term .`
should print nothing in the top directory).

> * NESTED_IBLOCK/ITAGBODY_frame_info, nest_fun, nest_env:
>   I'll rename "nested" to "captured".
>   Because what it does is to move values from the stack
>   (where they will disappear when the stack frame is unwound)
>   to other locations (where they cannot disappear, other
>   than being GCed).

"Capture" fails the grep test above.

What you are doing is _fishing_ stuff from stack and storing it into
heap - how about "haul"?

It appears in the tree as LOOP-SYNTAX-OVERHAUL:REPAIR in docs and in a
FIXME note in sources.

> * How to call the result of capturing a stack frame?
>   It's a simple-vector consisting of binding cells.
>   The previous term "closure" is wrong (see [1]).
>   I'm hesitating between
>     - "a capture" - because of the verb "capture" above,
>       but still a misnomer [2],
>     - "a prison" - because it's a container for *cell*s,
>       and contains *capture*d values.

gulag? kz? ;-)

You store your haul in a freezer.

Thanks!

-- 
Sam Steingold (http://sds.podval.org/) on darwin Ns 10.3.1504
http://steingoldpsychology.com http://www.childpsy.net http://www.memritv.org
http://no2bds.org http://mideasttruth.com http://memri.org
What garlic is to food, insanity is to art.