Clarify header comments in the Emscripten frontend's source files to

mention that the HTML pages generated by html/jspage.pl are also an
integral part of this front end. (The NestedVM frontend is more
self-contained, needing only an appropriate <applet> tag, but this one
expects quite a few components to exist on the page and have the right
ids.)

[originally from svn r9803]

diff --git a/emcc.c b/emcc.c
index 3cb92f00d7feaad1085f64ceb20bd5c77cf912e7..7c436c175ccffd4dec735c43ea81cd1dc27bf9c5 100644 (file)
--- a/emcc.c
+++ b/emcc.c
@@ -3,7 +3,10 @@
  * end for Puzzles.
  *
  * The Javascript parts of this system live in emcclib.js and
- * emccpre.js.
+ * emccpre.js. It also depends on being run in the context of a web
+ * page containing an appropriate collection of bits and pieces (a
+ * canvas, some buttons and links etc), which is generated for each
+ * puzzle by the script html/jspage.pl.
  */
 
 /*

diff --git a/emcclib.js b/emcclib.js
index 6c37c9bef68f6c3144c25782371387f31a576c4f..cbdd668d04c67699f4fce5496f96046bfd9381de 100644 (file)
--- a/emcclib.js
+++ b/emcclib.js
@@ -2,7 +2,11 @@
  * emcclib.js: one of the Javascript components of an Emscripten-based
  * web/Javascript front end for Puzzles.
  *
- * The other parts of this system live in emcc.c and emccpre.js.
+ * The other parts of this system live in emcc.c and emccpre.js. It
+ * also depends on being run in the context of a web page containing
+ * an appropriate collection of bits and pieces (a canvas, some
+ * buttons and links etc), which is generated for each puzzle by the
+ * script html/jspage.pl.
  *
  * This file contains a set of Javascript functions which we insert
  * into Emscripten's library object via the --js-library option; this

diff --git a/emccpre.js b/emccpre.js
index e2986da0fb4ccdac128f2aa13f29a3f8404790f0..fb58a6a935adb1b2daeb301cca05f23edd5f98a8 100644 (file)
--- a/emccpre.js
+++ b/emccpre.js
@@ -2,7 +2,11 @@
  * emccpre.js: one of the Javascript components of an Emscripten-based
  * web/Javascript front end for Puzzles.
  *
- * The other parts of this system live in emcc.c and emcclib.js.
+ * The other parts of this system live in emcc.c and emcclib.js. It
+ * also depends on being run in the context of a web page containing
+ * an appropriate collection of bits and pieces (a canvas, some
+ * buttons and links etc), which is generated for each puzzle by the
+ * script html/jspage.pl.
  *
  * This file contains the Javascript code which is prefixed unmodified
  * to Emscripten's output via the --pre-js option. It declares all our