summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorVincent Sanders <vince@kyllikki.org>2019-05-04 10:50:31 +0100
committerVincent Sanders <vince@kyllikki.org>2019-05-04 22:48:50 +0100
commit5dca74b911df9dae01c7f0b77b6bdce6ece94bcf (patch)
treeb663f5a583655b37ad8f8bfd284e8e95dc7d402d /docs
parent274b4a2d2eb1375f611b846a53e0cf13501574fe (diff)
downloadnetsurf-5dca74b911df9dae01c7f0b77b6bdce6ece94bcf.tar.gz
netsurf-5dca74b911df9dae01c7f0b77b6bdce6ece94bcf.tar.bz2
add webidl spec reference
Diffstat (limited to 'docs')
-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
------------------------------