Document jlapi

[ViralBShah]

jlapi is likely to be of interest to many people. It should probably have a section in the manual.

[ViralBShah]

Marking this as 0.2 milestone as we have people using this and trying this out. We can move it to a later version if that is what everyone thinks.

[Keno]

Not sure if we consider this stable enough yet. @JeffBezanson?

[Keno]

Bumping this to 0.3 as we don't feel this is mature enough yet. If people really want to use it, they can look at the code.

[tknopp]

I am working on some documentation of the C API:

https://github.com/tknopp/julia/blob/docuCAPI/doc/manual/embedding.rst

This is at a really early stage. I would work on this in an iterative way:

• Check how to achieve a specific embedding task
• Improve/extend the C-API if necessary (e.g. export currently hidden symbols)
• Write/improve the documentation

There are some things I am not yet familiar with. Dealing with the GC for instance. Would need some help in these areas.

Should I make a PR early to push this to master or wait until this is more complete?

[StefanKarpinski]

Thanks for doing this. This was badly in need of documentation – I'm enjoying reading it. Very clear and nicely written!

[tknopp]

Thanks, at some point some native speaker should revise this (I am one of the people that can provide you german git messages :-) ). But this can wait until it is a little bit more mature.

[ViralBShah]

I think this should be a PR, as a chapter in the Julia manual. Of course, we also need to make the relevant symbols visible in libjulia, for which you have another PR.