GNUmakefile

   1 # SPDX-FileCopyrightText: 2011-2023 Blender Authors
   2 #
   3 # SPDX-License-Identifier: GPL-2.0-or-later
   4
   5 # This Makefile does an out-of-source CMake build in ../build_`OS`_`CPU`
   6 # eg:
   7 #   ../build_linux_i386
   8 # This is for users who like to configure & build blender with a single command.
   9
  10 define HELP_TEXT
  11
  12 Blender Convenience Targets
  13    Provided for building Blender (multiple targets can be used at once).
  14
  15    * debug:         Build a debug binary.
  16    * full:          Enable all supported dependencies & options.
  17    * lite:          Disable non essential features for a smaller binary and faster build.
  18    * release:       Complete build with all options enabled including CUDA and Optix, matching the releases on blender.org
  19    * headless:      Build without an interface (renderfarm or server automation).
  20    * cycles:        Build Cycles standalone only, without Blender.
  21    * bpy:           Build as a python module which can be loaded from python directly.
  22    * developer:     Enable faster builds, error checking and tests, recommended for developers.
  23    * ninja:         Use ninja build tool for faster builds.
  24    * ccache:        Use ccache for faster rebuilds.
  25
  26    Note: when passing in multiple targets their order is not important.
  27    So for a fast build you can for e.g. run 'make lite ccache ninja'.
  28    Note: passing the argument 'BUILD_DIR=path' when calling make will override the default build dir.
  29    Note: passing the argument 'BUILD_CMAKE_ARGS=args' lets you add cmake arguments.
  30
  31 Other Convenience Targets
  32    Provided for other building operations.
  33
  34    * config:        Run cmake configuration tool to set build options.
  35    * deps:          Build library dependencies (intended only for platform maintainers).
  36
  37                     The existence of locally build dependencies overrides the pre-built dependencies from subversion.
  38                     These must be manually removed from '../lib/' to go back to using the pre-compiled libraries.
  39
  40 Project Files
  41    Generate project files for development environments.
  42
  43    * project_qtcreator:     QtCreator Project Files.
  44    * project_netbeans:      NetBeans Project Files.
  45    * project_eclipse:       Eclipse CDT4 Project Files.
  46
  47 Package Targets
  48
  49    * package_archive:   Build an archive package.
  50
  51 Testing Targets
  52    Not associated with building Blender.
  53
  54    * test:
  55      Run automated tests with ctest.
  56
  57 Static Source Code Checking
  58    Not associated with building Blender.
  59
  60    * check_cppcheck:        Run blender source through cppcheck (C & C++).
  61    * check_clang_array:     Run blender source through clang array checking script (C & C++).
  62    * check_struct_comments: Check struct member comments are correct (C & C++).
  63    * check_deprecated:      Check if there is any deprecated code to remove.
  64    * check_descriptions:    Check for duplicate/invalid descriptions.
  65    * check_licenses:        Check license headers follow the SPDX license specification,
  66                             using one of the accepted licenses in 'doc/license/SPDX-license-identifiers.txt'
  67                             Append with 'SHOW_HEADERS=1' to show all unique headers
  68                             which can be useful for spotting license irregularities.
  69    * check_cmake:           Runs our own cmake file checker which detects errors in the cmake file list definitions.
  70    * check_pep8:            Checks all Python script are pep8 which are tagged to use the stricter formatting.
  71    * check_mypy:            Checks all Python scripts using mypy,
  72                             see: tools/check_source/check_mypy_config.py scripts which are included.
  73
  74 Documentation Checking
  75
  76    * check_docs_file_structure:
  77      Check the documentation for the source-tree's file structure
  78      matches Blender's source-code.
  79      See: https://developer.blender.org/docs/features/code_layout/
  80
  81 Spell Checkers
  82    This runs the spell checker from the developer tools repositor.
  83
  84    * check_spelling_c:       Check for spelling errors (C/C++ only),
  85    * check_spelling_py:      Check for spelling errors (Python only).
  86    * check_spelling_shaders: Check for spelling errors (GLSL,OSL & MSL only).
  87
  88    Note: an additional word-list is maintained at: 'tools/check_source/check_spelling_c_config.py'
  89
  90    Note: that spell checkers can take a 'CHECK_SPELLING_CACHE' filepath argument,
  91    so re-running does not need to re-check unchanged files.
  92
  93    Example:
  94       make check_spelling_c CHECK_SPELLING_CACHE=../spelling_cache.data
  95
  96 Utilities
  97    Not associated with building Blender.
  98
  99    * icons:
 100      Updates PNG icons from SVG files.
 101
 102      Optionally pass in variables: 'BLENDER_BIN', 'INKSCAPE_BIN'
 103      otherwise default paths are used.
 104
 105      Example
 106         make icons INKSCAPE_BIN=/path/to/inkscape
 107
 108    * icons_geom:
 109      Updates Geometry icons from BLEND file.
 110
 111      Optionally pass in variable: 'BLENDER_BIN'
 112      otherwise default paths are used.
 113
 114      Example
 115         make icons_geom BLENDER_BIN=/path/to/blender
 116
 117    * source_archive:
 118      Create a compressed archive of the source code.
 119
 120    * source_archive_complete:
 121      Create a compressed archive of the source code and all the libraries of dependencies.
 122
 123    * update:
 124      Updates git and all submodules and svn.
 125
 126    * update_code:
 127      Updates git and all submodules but not svn.
 128
 129    * format:
 130      Format source code using clang-format & autopep8 (uses PATHS if passed in). For example::
 131
 132         make format PATHS="source/blender/blenlib source/blender/blenkernel"
 133
 134 Environment Variables
 135
 136    * BUILD_CMAKE_ARGS:      Arguments passed to CMake.
 137    * BUILD_DIR:             Override default build path.
 138    * PYTHON:                Use this for the Python command (used for checking tools).
 139    * NPROCS:                Number of processes to use building (auto-detect when omitted).
 140    * AUTOPEP8:              Command used for Python code-formatting (used for the format target).
 141
 142 Documentation Targets
 143    Not associated with building Blender.
 144
 145    * doc_py:        Generate sphinx python api docs.
 146    * doc_doxy:      Generate doxygen C/C++ docs.
 147    * doc_dna:       Generate blender file format reference.
 148    * doc_man:       Generate manpage.
 149
 150 Information
 151
 152    * help:              This help message.
 153    * help_features:     Show a list of optional features when building.
 154
 155 endef
 156 # HELP_TEXT (end)
 157
 158 # This makefile is not meant for Windows
 159 ifeq ($(OS),Windows_NT)
 160         $(error On Windows, use "cmd //c make.bat" instead of "make")
 161 endif
 162
 163 # System Vars
 164 OS:=$(shell uname -s)
 165 OS_NCASE:=$(shell uname -s | tr '[A-Z]' '[a-z]')
 166 CPU:=$(shell uname -m)
 167
 168
 169 # Source and Build DIR's
 170 BLENDER_DIR:=$(shell pwd -P)
 171 BUILD_TYPE:=Release
 172 BLENDER_IS_PYTHON_MODULE:=
 173
 174 # CMake arguments, assigned to local variable to make it mutable.
 175 CMAKE_CONFIG_ARGS := $(BUILD_CMAKE_ARGS)
 176
 177 ifndef BUILD_DIR
 178         BUILD_DIR:=$(shell dirname "$(BLENDER_DIR)")/build_$(OS_NCASE)
 179 endif
 180
 181 # Dependencies DIR's
 182 DEPS_SOURCE_DIR:=$(BLENDER_DIR)/build_files/build_environment
 183
 184 ifndef DEPS_BUILD_DIR
 185         DEPS_BUILD_DIR:=$(BUILD_DIR)/deps
 186 endif
 187
 188 ifndef DEPS_INSTALL_DIR
 189         DEPS_INSTALL_DIR:=$(shell dirname "$(BLENDER_DIR)")/lib/$(OS_NCASE)
 190
 191         # Add processor type to directory name, except for darwin x86_64
 192         # which by convention does not have it.
 193         ifeq ($(OS_NCASE),darwin)
 194                 ifneq ($(CPU),x86_64)
 195                         DEPS_INSTALL_DIR:=$(DEPS_INSTALL_DIR)_$(CPU)
 196                 endif
 197         else
 198                 DEPS_INSTALL_DIR:=$(DEPS_INSTALL_DIR)_$(CPU)
 199         endif
 200 endif
 201
 202 # Set the LIBDIR, an empty string when not found.
 203 LIBDIR:=$(wildcard ../lib/${OS_NCASE}_${CPU})
 204 ifeq (, $(LIBDIR))
 205         LIBDIR:=$(wildcard ../lib/${OS_NCASE}_${CPU}_glibc_228)
 206 endif
 207 ifeq (, $(LIBDIR))
 208         LIBDIR:=$(wildcard ../lib/${OS_NCASE})
 209 endif
 210
 211 # Find the newest Python version bundled in `LIBDIR`.
 212 PY_LIB_VERSION:=3.15
 213 ifeq (, $(wildcard $(LIBDIR)/python/bin/python$(PY_LIB_VERSION)))
 214         PY_LIB_VERSION:=3.14
 215         ifeq (, $(wildcard $(LIBDIR)/python/bin/python$(PY_LIB_VERSION)))
 216                 PY_LIB_VERSION:=3.13
 217                 ifeq (, $(wildcard $(LIBDIR)/python/bin/python$(PY_LIB_VERSION)))
 218                         PY_LIB_VERSION:=3.12
 219                         ifeq (, $(wildcard $(LIBDIR)/python/bin/python$(PY_LIB_VERSION)))
 220                                 PY_LIB_VERSION:=3.11
 221                                 ifeq (, $(wildcard $(LIBDIR)/python/bin/python$(PY_LIB_VERSION)))
 222                                         PY_LIB_VERSION:=3.10
 223                                 endif
 224                         endif
 225                 endif
 226         endif
 227 endif
 228
 229 # Allow to use alternative binary (pypy3, etc)
 230 ifndef PYTHON
 231         # If not overriden, first try using Python from LIBDIR.
 232         PYTHON:=$(LIBDIR)/python/bin/python$(PY_LIB_VERSION)
 233         ifeq (, $(wildcard $(PYTHON)))
 234                 # If not available, use system python3 or python command.
 235                 PYTHON:=python3
 236                 ifeq (, $(shell command -v $(PYTHON)))
 237                         PYTHON:=python
 238                 endif
 239         else
 240                 # Don't generate __pycache__ files in lib folder, they
 241                 # can interfere with updates.
 242                 PYTHON:=$(PYTHON) -B
 243         endif
 244 endif
 245
 246 # Use the autopep8 module in ../lib/ (which can be executed via Python directly).
 247 # Otherwise the "autopep8" command can be used.
 248 ifndef AUTOPEP8
 249         ifneq (, $(LIBDIR))
 250                 AUTOPEP8:=$(wildcard $(LIBDIR)/python/lib/python$(PY_LIB_VERSION)/site-packages/autopep8.py)
 251         endif
 252         ifeq (, $(AUTOPEP8))
 253                 AUTOPEP8:=autopep8
 254         endif
 255 endif
 256
 257
 258 # -----------------------------------------------------------------------------
 259 # Additional targets for the build configuration
 260
 261 # NOTE: These targets can be combined and are applied in reverse order listed here.
 262 # So it's important that `bpy` comes before `release` (for example)
 263 # `make bpy release` first loads `release` configuration, then `bpy`.
 264 # This is important as `bpy` will turn off some settings enabled by release.
 265
 266 ifneq "$(findstring bpy, $(MAKECMDGOALS))" ""
 267         BUILD_DIR:=$(BUILD_DIR)_bpy
 268         CMAKE_CONFIG_ARGS:=-C"$(BLENDER_DIR)/build_files/cmake/config/bpy_module.cmake" $(CMAKE_CONFIG_ARGS)
 269         BLENDER_IS_PYTHON_MODULE:=1
 270 endif
 271 ifneq "$(findstring debug, $(MAKECMDGOALS))" ""
 272         BUILD_DIR:=$(BUILD_DIR)_debug
 273         BUILD_TYPE:=Debug
 274 endif
 275 ifneq "$(findstring full, $(MAKECMDGOALS))" ""
 276         BUILD_DIR:=$(BUILD_DIR)_full
 277         CMAKE_CONFIG_ARGS:=-C"$(BLENDER_DIR)/build_files/cmake/config/blender_full.cmake" $(CMAKE_CONFIG_ARGS)
 278 endif
 279 ifneq "$(findstring lite, $(MAKECMDGOALS))" ""
 280         BUILD_DIR:=$(BUILD_DIR)_lite
 281         CMAKE_CONFIG_ARGS:=-C"$(BLENDER_DIR)/build_files/cmake/config/blender_lite.cmake" $(CMAKE_CONFIG_ARGS)
 282 endif
 283 ifneq "$(findstring release, $(MAKECMDGOALS))" ""
 284         BUILD_DIR:=$(BUILD_DIR)_release
 285         CMAKE_CONFIG_ARGS:=-C"$(BLENDER_DIR)/build_files/cmake/config/blender_release.cmake" $(CMAKE_CONFIG_ARGS)
 286 endif
 287 ifneq "$(findstring cycles, $(MAKECMDGOALS))" ""
 288         BUILD_DIR:=$(BUILD_DIR)_cycles
 289         CMAKE_CONFIG_ARGS:=-C"$(BLENDER_DIR)/build_files/cmake/config/cycles_standalone.cmake" $(CMAKE_CONFIG_ARGS)
 290 endif
 291 ifneq "$(findstring headless, $(MAKECMDGOALS))" ""
 292         BUILD_DIR:=$(BUILD_DIR)_headless
 293         CMAKE_CONFIG_ARGS:=-C"$(BLENDER_DIR)/build_files/cmake/config/blender_headless.cmake" $(CMAKE_CONFIG_ARGS)
 294 endif
 295
 296 ifneq "$(findstring developer, $(MAKECMDGOALS))" ""
 297         CMAKE_CONFIG_ARGS:=-C"$(BLENDER_DIR)/build_files/cmake/config/blender_developer.cmake" $(CMAKE_CONFIG_ARGS)
 298 endif
 299
 300 ifneq "$(findstring ccache, $(MAKECMDGOALS))" ""
 301         CMAKE_CONFIG_ARGS:=-DWITH_COMPILER_CCACHE=YES $(CMAKE_CONFIG_ARGS)
 302 endif
 303
 304 # -----------------------------------------------------------------------------
 305 # build tool
 306
 307 ifneq "$(findstring ninja, $(MAKECMDGOALS))" ""
 308         CMAKE_CONFIG_ARGS:=$(CMAKE_CONFIG_ARGS) -G Ninja
 309         BUILD_COMMAND:=ninja
 310         DEPS_BUILD_COMMAND:=ninja
 311 else
 312         ifneq ("$(wildcard $(BUILD_DIR)/build.ninja)","")
 313                 BUILD_COMMAND:=ninja
 314         else
 315                 BUILD_COMMAND:=make -s
 316         endif
 317
 318         ifneq ("$(wildcard $(DEPS_BUILD_DIR)/build.ninja)","")
 319                 DEPS_BUILD_COMMAND:=ninja
 320         else
 321                 ifeq ($(OS), Darwin)
 322                         DEPS_BUILD_COMMAND:=make -s
 323                 else
 324                         DEPS_BUILD_COMMAND:="$(BLENDER_DIR)/build_files/build_environment/linux/make_deps_wrapper.sh" -s
 325                 endif
 326         endif
 327 endif
 328
 329 # -----------------------------------------------------------------------------
 330 # Blender binary path
 331
 332 # Allow passing in own BLENDER_BIN so developers who don't
 333 # use the default build path can still use utility helpers.
 334 ifeq ($(OS), Darwin)
 335         BLENDER_BIN?="$(BUILD_DIR)/bin/Blender.app/Contents/MacOS/Blender"
 336         BLENDER_BIN_DIR?="$(BUILD_DIR)/bin/Blender.app/Contents/MacOS/Blender"
 337 else
 338         BLENDER_BIN?="$(BUILD_DIR)/bin/blender"
 339         BLENDER_BIN_DIR?="$(BUILD_DIR)/bin"
 340 endif
 341
 342
 343 # -----------------------------------------------------------------------------
 344 # Get the number of cores for threaded build
 345 ifndef NPROCS
 346         NPROCS:=1
 347         ifeq ($(OS), Linux)
 348                 NPROCS:=$(shell nproc)
 349         endif
 350         ifeq ($(OS), NetBSD)
 351                 NPROCS:=$(shell getconf NPROCESSORS_ONLN)
 352         endif
 353         ifneq (,$(filter $(OS),Darwin FreeBSD))
 354                 NPROCS:=$(shell sysctl -n hw.ncpu)
 355         endif
 356 endif
 357
 358
 359 # -----------------------------------------------------------------------------
 360 # Macro for configuring cmake
 361
 362 CMAKE_CONFIG = cmake $(CMAKE_CONFIG_ARGS) \
 363                      -H"$(BLENDER_DIR)" \
 364                      -B"$(BUILD_DIR)" \
 365                      -DCMAKE_BUILD_TYPE_INIT:STRING=$(BUILD_TYPE)
 366
 367
 368 # -----------------------------------------------------------------------------
 369 # Tool for 'make config'
 370
 371 # X11 specific.
 372 ifdef DISPLAY
 373         CMAKE_CONFIG_TOOL = cmake-gui
 374 else
 375         CMAKE_CONFIG_TOOL = ccmake
 376 endif
 377
 378
 379 # -----------------------------------------------------------------------------
 380 # Build Blender
 381 all: .FORCE
 382         @echo
 383         @echo Configuring Blender in \"$(BUILD_DIR)\" ...
 384
 385 #       # if test ! -f $(BUILD_DIR)/CMakeCache.txt ; then \
 386 #       #       $(CMAKE_CONFIG); \
 387 #       # fi
 388
 389 #       # do this always incase of failed initial build, could be smarter here...
 390         @$(CMAKE_CONFIG)
 391
 392         @echo
 393         @echo Building Blender ...
 394         $(BUILD_COMMAND) -C "$(BUILD_DIR)" -j $(NPROCS) install
 395         @echo
 396         @echo Edit build configuration with: \"$(BUILD_DIR)/CMakeCache.txt\" run make again to rebuild.
 397         @if test -z "$(BLENDER_IS_PYTHON_MODULE)"; then \
 398                 echo Blender successfully built, run from: $(BLENDER_BIN); \
 399         else \
 400                 echo Blender successfully built as a Python module, \"bpy\" can be imported from: $(BLENDER_BIN_DIR); \
 401         fi
 402         @echo
 403
 404 debug: all
 405 full: all
 406 lite: all
 407 release: all
 408 cycles: all
 409 headless: all
 410 bpy: all
 411 developer: all
 412 ninja: all
 413 ccache: all
 414
 415 # -----------------------------------------------------------------------------
 416 # Build dependencies
 417 DEPS_TARGET = install
 418 ifneq "$(findstring clean, $(MAKECMDGOALS))" ""
 419         DEPS_TARGET = clean
 420 endif
 421
 422 deps: .FORCE
 423         @echo
 424         @echo Configuring dependencies in \"$(DEPS_BUILD_DIR)\", install to \"$(DEPS_INSTALL_DIR)\"
 425
 426         @cmake -H"$(DEPS_SOURCE_DIR)" \
 427                -B"$(DEPS_BUILD_DIR)" \
 428                -DHARVEST_TARGET=$(DEPS_INSTALL_DIR)
 429
 430         @echo
 431         @echo Building dependencies ...
 432         $(DEPS_BUILD_COMMAND) -C "$(DEPS_BUILD_DIR)" -j $(NPROCS) $(DEPS_TARGET)
 433         @echo
 434         @echo Dependencies successfully built and installed to $(DEPS_INSTALL_DIR).
 435         @echo
 436
 437 # -----------------------------------------------------------------------------
 438 # Configuration (save some cd'ing around)
 439 config: .FORCE
 440         $(CMAKE_CONFIG_TOOL) "$(BUILD_DIR)"
 441
 442
 443 # -----------------------------------------------------------------------------
 444 # Help for build targets
 445 export HELP_TEXT
 446 help: .FORCE
 447         @echo "$$HELP_TEXT"
 448
 449 # -----------------------------------------------------------------------------
 450 # Packages
 451 #
 452
 453 package_archive: .FORCE
 454         make -C "$(BUILD_DIR)" -s package_archive
 455         @echo archive in "$(BUILD_DIR)/release"
 456
 457
 458 # -----------------------------------------------------------------------------
 459 # Tests
 460 #
 461 test: .FORCE
 462         @$(PYTHON) ./build_files/utils/make_test.py "$(BUILD_DIR)"
 463
 464
 465 # -----------------------------------------------------------------------------
 466 # Project Files
 467 #
 468
 469 project_qtcreator: .FORCE
 470         $(PYTHON) build_files/cmake/cmake_qtcreator_project.py --build-dir "$(BUILD_DIR)"
 471
 472 project_netbeans: .FORCE
 473         $(PYTHON) build_files/cmake/cmake_netbeans_project.py "$(BUILD_DIR)"
 474
 475 project_eclipse: .FORCE
 476         cmake -G"Eclipse CDT4 - Unix Makefiles" -H"$(BLENDER_DIR)" -B"$(BUILD_DIR)"
 477
 478
 479 # -----------------------------------------------------------------------------
 480 # Static Checking
 481 #
 482
 483 check_cppcheck: .FORCE
 484         @$(CMAKE_CONFIG)
 485         @cd "$(BUILD_DIR)" ; \
 486         $(PYTHON) \
 487             "$(BLENDER_DIR)/build_files/cmake/cmake_static_check_cppcheck.py" 2> \
 488             "$(BLENDER_DIR)/check_cppcheck.txt"
 489         @echo "written: check_cppcheck.txt"
 490
 491 check_struct_comments: .FORCE
 492         @$(CMAKE_CONFIG)
 493         @cd "$(BUILD_DIR)" ; \
 494         $(PYTHON) \
 495             "$(BLENDER_DIR)/build_files/cmake/cmake_static_check_clang.py" \
 496             --checks=struct_comments --match=".*" --jobs=$(NPROCS)
 497
 498 check_clang_array: .FORCE
 499         @$(CMAKE_CONFIG)
 500         @cd "$(BUILD_DIR)" ; \
 501         $(PYTHON) "$(BLENDER_DIR)/build_files/cmake/cmake_static_check_clang_array.py"
 502
 503 check_mypy: .FORCE
 504         @$(PYTHON) "$(BLENDER_DIR)/tools/check_source/check_mypy.py"
 505
 506 check_docs_file_structure: .FORCE
 507         @PYTHONIOENCODING=utf_8 $(PYTHON) \
 508             "$(BLENDER_DIR)/tools/check_docs/check_docs_code_layout.py"
 509
 510 check_spelling_py: .FORCE
 511         @PYTHONIOENCODING=utf_8 $(PYTHON) \
 512             "$(BLENDER_DIR)/tools/check_source/check_spelling.py" \
 513             --cache-file=$(CHECK_SPELLING_CACHE) \
 514             --match=".*\.(py)$$" \
 515             "$(BLENDER_DIR)/scripts" \
 516             "$(BLENDER_DIR)/source" \
 517             "$(BLENDER_DIR)/tools"
 518
 519 check_spelling_c: .FORCE
 520         @PYTHONIOENCODING=utf_8 $(PYTHON) \
 521             "$(BLENDER_DIR)/tools/check_source/check_spelling.py" \
 522             --cache-file=$(CHECK_SPELLING_CACHE) \
 523             --match=".*\.(c|cc|cpp|cxx|h|hh|hpp|hxx|inl|m|mm)$$" \
 524             "$(BLENDER_DIR)/source" \
 525             "$(BLENDER_DIR)/intern/cycles" \
 526             "$(BLENDER_DIR)/intern/guardedalloc" \
 527             "$(BLENDER_DIR)/intern/ghost"
 528
 529 check_spelling_shaders: .FORCE
 530         @PYTHONIOENCODING=utf_8 $(PYTHON) \
 531             "$(BLENDER_DIR)/tools/check_source/check_spelling.py" \
 532             --cache-file=$(CHECK_SPELLING_CACHE) \
 533             --match=".*\.(osl|metal|msl|glsl)$$" \
 534             "$(BLENDER_DIR)/intern/" \
 535             "$(BLENDER_DIR)/source/"
 536
 537 check_descriptions: .FORCE
 538         @$(BLENDER_BIN) --background -noaudio --factory-startup --python \
 539             "$(BLENDER_DIR)/tools/check_source/check_descriptions.py"
 540
 541 check_deprecated: .FORCE
 542         @PYTHONIOENCODING=utf_8 $(PYTHON) \
 543             tools/check_source/check_deprecated.py
 544
 545 check_licenses: .FORCE
 546         @PYTHONIOENCODING=utf_8 $(PYTHON) \
 547             "$(BLENDER_DIR)/tools/check_source/check_licenses.py" \
 548             "--show-headers=$(SHOW_HEADERS)"
 549
 550 check_pep8: .FORCE
 551         @PYTHONIOENCODING=utf_8 $(PYTHON) \
 552             tests/python/pep8.py
 553
 554 check_cmake: .FORCE
 555         @PYTHONIOENCODING=utf_8 $(PYTHON) \
 556             tools/check_source/check_cmake_consistency.py
 557
 558
 559 # -----------------------------------------------------------------------------
 560 # Utilities
 561 #
 562
 563 source_archive: .FORCE
 564         @$(PYTHON) ./build_files/utils/make_source_archive.py
 565
 566 source_archive_complete: .FORCE
 567         @cmake \
 568             -S "$(BLENDER_DIR)/build_files/build_environment" -B"$(BUILD_DIR)/source_archive" \
 569             -DCMAKE_BUILD_TYPE_INIT:STRING=$(BUILD_TYPE) -DPACKAGE_USE_UPSTREAM_SOURCES=OFF
 570 # This assumes CMake is still using a default `PACKAGE_DIR` variable:
 571         @$(PYTHON) ./build_files/utils/make_source_archive.py --include-packages "$(BUILD_DIR)/source_archive/packages"
 572
 573 icons: .FORCE
 574         @BLENDER_BIN=$(BLENDER_BIN) "$(BLENDER_DIR)/release/datafiles/blender_icons_update.py"
 575         "$(BLENDER_DIR)/release/datafiles/prvicons_update.py"
 576         "$(BLENDER_DIR)/release/datafiles/alert_icons_update.py"
 577
 578 icons_geom: .FORCE
 579         @BLENDER_BIN=$(BLENDER_BIN) \
 580             "$(BLENDER_DIR)/release/datafiles/blender_icons_geom_update.py"
 581
 582 update: .FORCE
 583         @$(PYTHON) ./build_files/utils/make_update.py
 584
 585 update_code: .FORCE
 586         @$(PYTHON) ./build_files/utils/make_update.py --no-libraries
 587
 588 format: .FORCE
 589         @PATH="${LIBDIR}/llvm/bin/:$(PATH)" $(PYTHON) tools/utils_maintenance/clang_format_paths.py $(PATHS)
 590         @$(PYTHON) tools/utils_maintenance/autopep8_format_paths.py --autopep8-command="$(AUTOPEP8)" $(PATHS)
 591
 592
 593 # -----------------------------------------------------------------------------
 594 # Documentation
 595 #
 596
 597 # Simple version of ./doc/python_api/sphinx_doc_gen.sh with no PDF generation.
 598 doc_py: .FORCE
 599         @ASAN_OPTIONS=halt_on_error=0:${ASAN_OPTIONS} \
 600         $(BLENDER_BIN) \
 601             --background -noaudio --factory-startup \
 602             --python doc/python_api/sphinx_doc_gen.py
 603         @sphinx-build -b html -j $(NPROCS) doc/python_api/sphinx-in doc/python_api/sphinx-out
 604         @echo "docs written into: '$(BLENDER_DIR)/doc/python_api/sphinx-out/index.html'"
 605
 606 doc_doxy: .FORCE
 607         @cd doc/doxygen; doxygen Doxyfile
 608         @echo "docs written into: '$(BLENDER_DIR)/doc/doxygen/html/index.html'"
 609
 610 doc_dna: .FORCE
 611         @$(BLENDER_BIN) \
 612             --background -noaudio --factory-startup \
 613             --python doc/blender_file_format/BlendFileDnaExporter_25.py
 614         @echo "docs written into: '$(BLENDER_DIR)/doc/blender_file_format/dna.html'"
 615
 616 doc_man: .FORCE
 617         @$(PYTHON) doc/manpage/blender.1.py --blender="$(BLENDER_BIN)" --output=blender.1 --verbose
 618
 619 help_features: .FORCE
 620         @$(PYTHON) "$(BLENDER_DIR)/build_files/cmake/cmake_print_build_options.py" $(BLENDER_DIR)"/CMakeLists.txt"
 621
 622 clean: .FORCE
 623         $(BUILD_COMMAND) -C "$(BUILD_DIR)" clean
 624
 625 .PHONY: all
 626
 627 .FORCE: