document optimized builds and add helper script

docs/linux.md

@@ -59,6 +59,17 @@ dependencies. When the build is complete, Anki will automatically start.
 To play audio, install mpv. At the time of writing, recording is
 not yet supported, as currently pyaudio is not being installed.
 
+## Optimized builds
+
+The `./run` command will create a non-optimized build by default. This is faster
+to compile, but will mean Anki will run considerably slower.
+
+To run Anki in optimized mode, use:
+
+```
+./scripts/runopt
+```
+
 ## More
 
 For info on running tests, building wheels and so on, please see [Development](./development.md).

docs/mac.md

@@ -53,6 +53,17 @@ dependencies. When the build is complete, Anki will automatically start.
 To play audio, use Homebrew to install mpv. At the time of writing, recording is
 not yet supported, as currently pyaudio is not being installed.
 
+## Optimized builds
+
+The `./run` command will create a non-optimized build by default. This is faster
+to compile, but will mean Anki will run considerably slower.
+
+To run Anki in optimized mode, use:
+
+```
+./scripts/runopt
+```
+
 ## More
 
 For info on running tests, building wheels and so on, please see [Development](./development.md).

docs/windows.md

@@ -85,6 +85,17 @@ To play audio, mpv.exe or mplayer.exe must be on the path. At the time
 of writing, recording is not yet supported, as currently pyaudio is
 not being installed.
 
+## Optimized builds
+
+The `.\run` command will create a non-optimized build by default. This is faster
+to compile, but will mean Anki will run considerably slower.
+
+To run Anki in optimized mode, use:
+
+```
+.\scripts\runopt
+```
+
 ## More
 
 For info on running tests, building wheels and so on, please see

run

@@ -3,14 +3,14 @@
 set -e
 
 run_linux() {
-    bazel run //qt:runanki -- $*
+    bazel run $BUILDARGS //qt:runanki -- $*
 }
 
 run_mac() {
     # QtWebEngineProcess is unable to locate icudtl.dat from a symlinked tree,
     # so we need to copy the files into a working folder before running on a Mac.
     workspace=$(dirname $0)
-    bazel build //qt:runanki && \
+    bazel build $BUILDARGS //qt:runanki && \
         rsync -aiL --exclude=anki/external --exclude=__pycache__ --delete \
             $workspace/bazel-bin/qt/runanki* $workspace/bazel-copy/ && \
         $workspace/bazel-copy/runanki $*

run.bat

@@ -1 +1 @@
-call .\bazel.bat run //qt:runanki -k -- %*
+call .\bazel.bat run %BUILDARGS% //qt:runanki -k -- %*

scripts/runopt

@@ -0,0 +1,5 @@
+#!/bin/bash
+
+set -e
+
+BUILDARGS="-c opt" $(dirname $0)/../run

scripts/runopt.bat

@@ -0,0 +1,2 @@
+set BUILDARGS=-c opt
+call .\run.bat %*