[gjs: 1/2] doc: document the existence of the console object in GJS
- From: Philip Chimento <pchimento src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gjs: 1/2] doc: document the existence of the console object in GJS
- Date: Tue, 5 Jul 2022 05:17:43 +0000 (UTC)
commit 8cb9822a421ccf0c8c3e5c1e5214ead99faeb2ed
Author: Andy Holmes <andyholmes gnome org>
Date: Tue Jul 5 05:17:15 2022 +0000
doc: document the existence of the console object in GJS
doc/Logging.md | 11 ++++++++++-
1 file changed, 10 insertions(+), 1 deletion(-)
---
diff --git a/doc/Logging.md b/doc/Logging.md
index fafae3854..f72be9cc0 100644
--- a/doc/Logging.md
+++ b/doc/Logging.md
@@ -1,7 +1,14 @@
GJS includes a number of built-in functions for logging and aiding debugging, in
addition to those available as a part of the GNOME APIs.
-# Built-in Functions
+## `console` Functions
+
+As of GJS 1.70 (GNOME 41), the `console` collection of functions are available
+as described in the WHATWG [Console Standard][console-standard]. The `console`
+object is available globally (i.e. without import) and the implementation source
+is found in [console.js][console-js].
+
+## Built-in Functions
GJS includes four built-in logging functions: `log()`, `logError()`, `print()`
and `printerr()`. These functions are available globally (ie. without import)
@@ -110,6 +117,8 @@ if (GLib.log_writer_is_journald(2))
GLib.setenv('G_MESSAGES_DEBUG', LOG_DOMAIN, false);
```
+[console-js]: https://gitlab.gnome.org/GNOME/gjs/-/blob/HEAD/modules/esm/console.js
+[console-standard]: https://console.spec.whatwg.org/
[global-cpp]: https://gitlab.gnome.org/GNOME/gjs/blob/HEAD/gjs/global.cpp
[polari]: https://gitlab.gnome.org/GNOME/polari/blob/HEAD/src/main.js
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]