summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--docs/jsbinding.md17
1 files changed, 16 insertions, 1 deletions
diff --git a/docs/jsbinding.md b/docs/jsbinding.md
index cf3bc5a09..59d569114 100644
--- a/docs/jsbinding.md
+++ b/docs/jsbinding.md
@@ -20,7 +20,10 @@ outlining the remaining unimplemented API bindings.
WebIDL
------
-The WebIDL specification defines the interface description language used.
+The [WebIDL specification](http://www.w3.org/TR/WebIDL/) defines the
+interface description language used. The WebIDL is being updated and
+an [editors draft](https://heycam.github.io/webidl/) is available but
+use is inconsistant.
These descriptions should be periodicaly updated to keep the browser
interfaces current.
@@ -32,6 +35,18 @@ This tool needs a great deal of hand holding, not least because many of the
source documents list the IDL fragments multiple times, some even have
appendicies with the entrire IDL repeated.
+The IDL uses some slightly different terms than other object orientated
+ systems.
+
+ WebIDL | JavaScript | Common OOP | Note
+ ------- | ---------- | ---------- | ----
+ interface | prototype | class | The data definition of the object
+ constants | read-only value property on the prototype | class variable | Belong to class, one copy
+ operation | method | method | functions that can be called
+ attribute | property | property | Variables set per instance
+
+
+
Interface binding introduction
------------------------------