add documentation and CHANGELOG entry

wirthi · wirthi · commit 70a8f0a90fea · 2018-10-01T18:02:22.000+02:00
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -3,6 +3,9 @@
 This changelog summarizes major changes between GraalVM versions of the Graal JavaScript (ECMAScript) language runtime.
 The main focus is on user-observable behavior of the engine.
 
+## Version 1.0.0 RC8
+* Provide simplified implementations for methods of the global `console` object.
+
 ## Version 1.0.0 RC7
 * Improved support for sharing of shapes between Contexts with the same Engine.
 * BigInteger TypedArrays.
diff --git a/docs/user/JavaScriptCompatibility.md b/docs/user/JavaScriptCompatibility.md
@@ -113,13 +113,26 @@ Source can be of type:
 * a JavaScript object: the object is queried for a `name` and a `script` property, which represent the source name and code, respectively.
 * all other types: the source is converted to a String.
 
-#### `print(...arg)` and `console.log(...arg)`
+#### `print(...arg)`
 
 Prints the arguments on the console.
 Provides a best-effort human readable output.
 
-Note that `console.log` behaves differently when Graal JavaScript is executed in Node.js mode (i.e., the `node` executable is started instead of `js`).
-While normally, `console.log` is just an alias for `print`, on Node.js Node's own implementation is executed.
+#### Methods of the `console` global object
+
+A global `console` object is provided that offers several methods for debugging purposes.
+These methods strive to provide similar functionality as provided in other engines, but do not guarantee identical results.
+
+Note that those methods behave differently when Graal JavaScript is executed in Node.js mode (i.e., the `node` executable is started instead of `js`).
+Node.js provides its own implementation that is used instead.
+
+* `console.log`, `console.info`, and `console.debug`: an alias for `print(...arg)`
+* `console.error`, and `console.warn`: similar to `print`, but using the error IO stream
+* `console.assert(check, message)`: prints `message` when `check` is falsy
+* `console.clear`: clears the console window if possible
+* `console.count()`, and `console.countReset()`: counts and print how many times it has been called, or resets this counter
+* `console.group`, and `console.groupEnd`: increases or decreases the indentation for succeeding outputs to the console
+* `console.time()`, `console.timeLog()`, and `console.timeEnd()`: starts a timer, prints the duration the timer has been active, or prints the duration and stops the timer, respectively
 
 #### `read(file)` or `readFully(file)`
 
