native API documentation
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.
E.g. https://lukasstadler.github.io/RAPI/html/_rinternals_8h.html#aa8657876d8bab4aa84918f8c25bc878d when looking at a call to Rf_copyMostAttrib.
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.