Hi All

The public API for Emscripten is now documented, and ready for review - see 
it here 
<https://dl.dropboxusercontent.com/u/3067678/emscripten-site/docs/docs/api-reference/index.html>
.

Please review emscripten.h, preamble.js, html5.h and the "Advanced" APIs 
document. Note that the API currently reflects incoming branch, so html5.h 
uses typdef'd function pointer callbacks rather than having these in the 
registration function.

Feel free to email me directly with responses.

What I'm looking for:
- Descriptions that are unclear
- Typographic errors
- Structure that doesn't "make sense"
- Missing APIs - APIs that should be public but aren't documented, or 
internal APIs that might reasonably be mistaken as public and should appear 
in the "advanced/internal API document.
- Missing exceptions - unexpected fail cases
- APIs that really need an code fragment as part of their API reference 
description (please provide if you have one)

Another nice feature of this release is that the wiki snapshot now fixes 
links to the other wiki snapshot articles, and all wiki "inline code 
markup" which corresponds to a public API item is now linked to those API 
items. The makes the wiki snapshot very much more usable and searchable 
than the "real" wiki.

Your review thoughts appreciated.

Regards
Hamish

On Tuesday, 15 July 2014 16:53:41 UTC+10, Hamish Willee wrote:
Hi All

emscripten.h documentation is ready for review: 
https://dl.dropboxusercontent.com/u/3067678/emscripten-site/docs/docs/api-reference/emscripten.h.html

This is a manually created document. It includes changes to the function 
prototypes currently in incoming branch to make the function signatures 
simpler. 

I'm not completely convinced about the docs for 
emscripten_get_preloaded_image_data and there will need to be additional 
links to documents about EXPORTED_FUNCTIONS and other guide material when 
it exists.

All feedback welcomed! For example, you might reasonably feel that the 
functions are the most important information in any section, and hence 
typedefs and defines should be defined after these.

Regards
H


>

-- 
You received this message because you are subscribed to the Google Groups 
"emscripten-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
For more options, visit https://groups.google.com/d/optout.

Reply via email to