[Openmcl-devel] Help with lapfunctions

[R. Matthew Emerson]

On Jan 9, 2014, at 1:08 PM, Taoufik Dachraoui <dachraoui.taoufik at gmail.com> wrote:

> Why lapfunctions are not documented? I am trying hard to understand
> the code delivered by CCL without success; so much details I am not aware
> of, so much syntax (! ^..) so much macros, how can I understand the code
> without basic knowledge. I am sure it is not that difficult for someone
> who has access to proper documentation or working with experts who developed
> the compiler.
> 
> Could someone volunteer and write a proper documentation for lapfunctions, or
> maybe add something like
>    (progn
>       (asm .. assembly code or something understood by gcc where
>            there is plenty of docs ...)
>      ....)
> 
> like  in C __asm { ... }
> 
> Since there is no help from CCL, it is probably better to write a small C library 
> with assembly code that I need in my program (then I call it from CCL)

LAP is for the internal use of the implementation.  We don't have any plans to document it.  Sorry.

Even if the notation were documented, there are other implicit requirements (maintaining gc-safety, etc.) that must be followed, and this requires great familiarity with implementation internals.