Re: How close to C do you make your binding?

[Javier Guerra Giraldez <javier@...>]

On Wed, Jun 18, 2014 at 9:50 AM, Coda Highland <chighland@gmail.com> wrote:
> My goal, when I do such a direct binding, is to make it to where
> there's almost no documentation necessary -- that is, you can use the
> original C docs directly with only minor changes (mostly syntactical).


i prefer almost the opposite.  try to do things as much idiomatic Lua
as i can imagine.  if the C api is well known, then a two-layer
approach might be valuable, but not having an idiomatic Lua api is a
big turn off.

in fact, a "use the C docs" remark makes it even worse.  it means i'll
have to understand first the C library and then try to guess the
wrapper itself, which is effectively undocumented.  at that point it's
sometimes easier to whip a quick LuaJIT-FFI wrapper with just the
functionality i need.

-- 
Javier