about summary refs log tree commit diff
path: root/src/test
diff options
context:
space:
mode:
authorYuki Okushi <jtitor@2k36.org>2021-06-22 07:37:48 +0900
committerGitHub <noreply@github.com>2021-06-22 07:37:48 +0900
commit7dca2e276df7f2babce704f9b757bcfdb788fee1 (patch)
treef93eb03573978b1d2553dfd0764d47ae40042c81 /src/test
parent7ee6b8bc439501e8690af80b9995aa53c856e9e8 (diff)
parent95c1bf60005085a5c83cc63b33319d6b484a704a (diff)
downloadrust-7dca2e276df7f2babce704f9b757bcfdb788fee1.tar.gz
rust-7dca2e276df7f2babce704f9b757bcfdb788fee1.zip
Rollup merge of #86297 - GuillaumeGomez:rustdoc-gui-args, r=Mark-Simulacrum
Allow to pass arguments to rustdoc-gui tool

Very convenient for testing. This is another part of https://github.com/rust-lang/rust/pull/86293

cc ``@jsha``
r? ``@Mark-Simulacrum``
Diffstat (limited to 'src/test')
-rw-r--r--src/test/rustdoc-gui/README.md12
1 files changed, 12 insertions, 0 deletions
diff --git a/src/test/rustdoc-gui/README.md b/src/test/rustdoc-gui/README.md
index 499a98a3d22..8efe7a578b8 100644
--- a/src/test/rustdoc-gui/README.md
+++ b/src/test/rustdoc-gui/README.md
@@ -8,5 +8,17 @@ test what's being currently displayed in the web page.
 
 You can find more information and its documentation in its [repository][browser-ui-test].
 
+If you need to have more information on the tests run, you can use `--test-args`:
+
+```bash
+$ ./x.py test src/test/rustdoc-gui --stage 1 --jobs 8 --test-args --debug
+```
+
+There are three options supported:
+
+ * `--debug`: allows to see puppeteer commands.
+ * `--no-headless`: disable headless mode so you can see what's going on.
+ * `--show-text`: by default, text isn't rendered because of issues with fonts, it enables it back.
+
 [browser-ui-test]: https://github.com/GuillaumeGomez/browser-UI-test/
 [puppeteer]: https://pptr.dev/