Updates:
Mergedinto:
Comment #4 on issue 304 by [email protected]: Is there any documentation
on v8?
http://code.google.com/p/v8/issues/detail?id=304
Examples of things that aren't explained in the docs that I've been burned
by:
* How the global context works
* HandleScope's Close() method, and the fiddly mechanics of HandleScope
(e.g. when you need to close a ref)
* How Persistent handles work
* FunctionTemplate vs. ObjectTemplate, especially the InstanceTemplate vs.
PrototypeTemplate, and how your native data gets associated with it
* How to wire the JS construct/destruct mechanisms up to your native
backing object ctor/dtor (Persistent.MakeWeak etc.)
* What the chain of events is when a property is looked up, including ones
with Set, SetAccessor, and SetNamedPropertyHandler (do the Set/SetAccessor
ones override the named one?)
These all seem like exceptionally BASIC THINGS to talk about in any sort of
v8 embedding guide, and the only actual usage information is scattered in
hundreds of forum and mailing list posts, and usually based on other
peoples' trial-and-error which just leads everyone else to have to go
through the trial-and-error process as well.
V8 is a great engine but the docs (including doxygen comments) are very
nearly worthless.
--
v8-dev mailing list
[email protected]
http://groups.google.com/group/v8-dev
