Re: seq.el and the complexity of Emacs Lisp.

[Emanuel Berg]

Eli Zaretskii wrote:

>> I looked at seq.el to try to get an idea what those
>> functions do. It was difficult to get this from the doc
>> strings, because it wasn't explicitly stated which ones are
>> for users and which ones are internal.
>
> Our convention nowadays is that any function/variable that
> has 2 dashes after the prefix, in this case seq--SOMETHING,
> is internal, and all the others are public.

Are you only allowed to use some--private-function in the same
file where it is defined?

Even as it is actually available everywhere, just like any
some-public-function defined?

To what extent has this convention been upheld in the
Emacs source?

Maybe the byte-compiler should warn when such functions are
used from elsewhere? But maybe then people would just rename
them with a single dash instead of two? But that, by all
means, at least would uphold the convention.

-- 
underground experts united
https://dataswamp.org/~incal