File tree Expand file tree Collapse file tree 1 file changed +21
-0
lines changed
contributing/development/compiling Expand file tree Collapse file tree 1 file changed +21
-0
lines changed Original file line number Diff line number Diff line change @@ -365,6 +365,27 @@ aforementioned ``-j`` option for all future builds:
365365
366366 $env:SCONSFLAGS="-j4"
367367
368+ SCU (single compilation unit) build
369+ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
370+
371+ Regular builds tend to be bottlenecked by including large numbers of headers
372+ in each compilation translation unit. Primarily to speed up development (rather
373+ than for production builds), Godot offers a "single compilation unit" build
374+ (aka "Unity / Jumbo" build).
375+
376+ For the folders accelerated by this option, multiple ``.cpp `` files are
377+ compiled in each translation unit, so headers can be shared between multiple
378+ files, which can dramatically decrease build times.
379+
380+ To make a SCU build, use the ``scu_build=yes `` SCons option.
381+
382+ .. note :: When developing a Pull Request using SCU builds, be sure to make a
383+ regular build prior to submitting the PR. This is because SCU builds
384+ by nature include headers from earlier ``.cpp `` files in the
385+ translation unit, therefore won't catch all the includes you will
386+ need in a regular build. The CI will catch these errors but it will
387+ usually be faster to catch them on a local build on your machine.
388+
368389Export templates
369390----------------
370391
You can’t perform that action at this time.
0 commit comments