native API documentation

Lukas Stadler
 

Hi,

also, in the meantime, Karl took the time to push additional API documentation (mostly done by Andrew Runnalls) to my github “API documentation” repository.
The automatically generated html documentation is available at https://lukasstadler.github.io/RAPI/html/
The list of functions is a good starting point: https://lukasstadler.github.io/RAPI/html/globals_func.html

This repo now contains documentation for ~100 functions and adds parameter names for 172 functions (almost all provided by Karl).
Even though it doesn’t cover all of the API, this would already be very helpful for someone looking at native code that interfaces with R.

I know that there’s differing opinions as to whether doxygen is the right technology, and what exactly the documentation of functions should contain, but the documentation in this form exists and is already useful.
So I’d ultimately like to bring this topic up with r-devel as well, separated into the parameter names and doxygen comments.

Best,
 Lukas

Join Rconsortium-wg-api@lists.r-consortium.org to automatically receive all group messages.