>>>> "Hrvoje" == Hrvoje Niksic
<hniksic(a)iskon.hr> writes:
Hrvoje> wmperry(a)aventail.com (William M. Perry) writes:
> I was thrown off by the fact that the LDAP routines you are
supposed
> to use if you make the connection your self are all named
> 'xxx-internal', which means (to me) 'DO NOT USE THIS DIRECTLY', etc.
Hrvoje> I was begging Oscar not to use the name -internal if he doesn't mean
Hrvoje> it, but he convinced me that the -internal routines exist for the ease
Hrvoje> of implementation, and that the routines a Lisp user should call are
Hrvoje> the ones defined in ldap.el.
Hrvoje> Oscar, what's the current status of your API?
Please see my other post.
It's not that I insist on the -internal suffix. If we want to have -1 suffixes
instead or whatever it's fine with me. What's actually important is that
the API is designed in two layers:
- a low-level layer implemented in C which is to be kept as small as possible
and provides basic wrappers around the LDAP C API
- a higher-level layer written in Lisp which provides functions to access LDAP.
This higher-level layer should be the preferred (not exclusive) way for
package programmers to use LDAP. Therefore those functions should be safe,
efficient and general enough for most programmers to use
This design has been discussed a while ago and has even been presented at the
m17n99 conference. There has been no change in philosophy since then.
Oscar