docs: remove placeholder application-lifecycle page and complete first draft of embedding docs

- Delete the empty "Application Lifecycle" page (was just a TODO placeholder)
- Expand "Storing C Data" from stub to full documentation covering foreign classes, initialization, access, and finalization
- Add note that VM is not re-entrant; warn against calling wrenCall/wrenInterpret from foreign methods
- Fix broken cross-reference links (configuring-the-vm.html, wren.hpp include)
- Clarify slot API usage: remove confusing sentence about implicit return of receiver
- Fix grammar: "each VM them differently" → "each VM differently", "is only be called" → "is only called"
- Improve phrasing throughout for clarity and consistency
This commit is contained in:
Bob Nystrom
2017-10-17 15:26:06 +00:00
parent 8bd5b85df5
commit 4018d42c39
8 changed files with 388 additions and 104 deletions
@@ -7,7 +7,7 @@ compiler, but that's still a good bit of work.
It's also not an effective way to communicate. You can't pass arguments to
Wren—at least, not without doing something nasty like converting them to
literals in a string of source code—and we can't get a result value back.
literals in a string of source code—and you can't get a result value back.
`wrenInterpret()` is great for loading code into the VM, but it's not the best
way to execute code that's already been loaded. What we want to do is invoke
@@ -26,7 +26,7 @@ C, first we need a few things:
[signature]: ../method-calls.html#signature
* **The receiver to invoke the method on.** It's the receiver's class that
* **The receiver object to invoke the method on.** The receiver's class
determines which method is actually called.
* **The arguments to pass to the method.**