From 4ab0820bbcb7f11f7306c0922705961db3aec499 Mon Sep 17 00:00:00 2001 From: Damien Elmes Date: Mon, 21 Jun 2021 13:23:03 +1000 Subject: [PATCH] mention JS flakiness in Mac/Linux instructions --- docs/linux.md | 4 ++++ docs/mac.md | 4 ++++ docs/windows.md | 10 ++++------ 3 files changed, 12 insertions(+), 6 deletions(-) diff --git a/docs/linux.md b/docs/linux.md index 275991dd0..4769aa91c 100644 --- a/docs/linux.md +++ b/docs/linux.md @@ -81,6 +81,10 @@ This will build Anki and run it in place. The first build will take a while, as it downloads and builds a bunch of dependencies. When the build is complete, Anki will automatically start. +The Javascript build code is currently a bit flaky, so the initial +build may fail with an error. If you get an error when running/building, +try repeating the command once or twice - it should pick up where it left off. + To play and record audio, install mpv and lame. If you or your distro has made ccache the standard compiler, you will need to diff --git a/docs/mac.md b/docs/mac.md index 6551eb1cf..db9a2f9dc 100644 --- a/docs/mac.md +++ b/docs/mac.md @@ -51,6 +51,10 @@ This will build Anki and run it in place. The first build will take a while, as it downloads and builds a bunch of dependencies. When the build is complete, Anki will automatically start. +The Javascript build code is currently a bit flaky, so the initial +build may fail with an error. If you get an error when running/building, +try repeating the command once or twice - it should pick up where it left off. + To play audio, use Homebrew to install mpv and lame. ## Optimized builds diff --git a/docs/windows.md b/docs/windows.md index afa9d0521..3f659b83a 100644 --- a/docs/windows.md +++ b/docs/windows.md @@ -61,12 +61,6 @@ Anki's source files do not need to be in a specific location other than on the same drive as `\bazel`, but it's best to avoid long paths, as they can cause problems. -## Build failures - -The Javascript bundling on Windows is currently a bit flaky, so the initial -build will likely fail with an error about a missing rollup module. If you -get an error when running the commands below, try repeating them once or twice. - ## Running Anki during development Open PowerShell and change to the top level of Anki's source folder, @@ -81,6 +75,10 @@ This will build Anki and run it in place. The first build will take a while, as it downloads and builds a bunch of dependencies. When the build is complete, Anki will automatically start. +The Javascript build code is currently a bit flaky, so the initial +build may fail with an error. If you get an error when running/building, +try repeating the command once or twice - it should pick up where it left off. + To play and record audio, mpv.exe and lame.exe must be on the path. ## Optimized builds