diff options
Diffstat (limited to 'docs/markdown')
-rw-r--r-- | docs/markdown/Builtin-options.md | 11 | ||||
-rw-r--r-- | docs/markdown/snippets/python_bytecompile.md | 4 |
2 files changed, 15 insertions, 0 deletions
diff --git a/docs/markdown/Builtin-options.md b/docs/markdown/Builtin-options.md index c0a8a0d..2764798 100644 --- a/docs/markdown/Builtin-options.md +++ b/docs/markdown/Builtin-options.md @@ -351,6 +351,7 @@ install prefix. For example: if the install prefix is `/usr` and the | Option | Default value | Possible values | Description | | ------ | ------------- | ----------------- | ----------- | +| bytecompile | 0 | integer from -1 to 2 | What bytecode optimization level to use (Since 1.2.0) | | install_env | prefix | {auto,prefix,system,venv} | Which python environment to install to (Since 0.62.0) | | platlibdir | | Directory path | Directory for site-specific, platform-specific files (Since 0.60.0) | | purelibdir | | Directory path | Directory for site-specific, non-platform-specific files (Since 0.60.0) | @@ -373,3 +374,13 @@ installation is a virtualenv, and use `venv` or `system` as appropriate (but never `prefix`). This option is mutually exclusive with the `platlibdir`/`purelibdir`. For backwards compatibility purposes, the default `install_env` is `prefix`. + +*Since 1.2.0* The `python.bytecompile` option can be used to enable compiling +python bytecode. Bytecode has 3 optimization levels: + +- 0, bytecode without optimizations +- 1, bytecode with some optimizations +- 2, bytecode with some more optimizations + +To this, Meson adds level `-1`, which is to not attempt to compile bytecode at +all. diff --git a/docs/markdown/snippets/python_bytecompile.md b/docs/markdown/snippets/python_bytecompile.md new file mode 100644 index 0000000..0240c9d --- /dev/null +++ b/docs/markdown/snippets/python_bytecompile.md @@ -0,0 +1,4 @@ +## Python module can now compile bytecode + +A new builtin option is available: `-Dpython.bytecompile=2`. It can be used to +compile bytecode for all pure python files installed via the python module. |