diff --git a/CMakeLists.txt b/CMakeLists.txt index 59208882437..68c60ab3a25 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -51,7 +51,7 @@ if(NOT DEFINED CMAKE_INSTALL_MESSAGE) set(CMAKE_INSTALL_MESSAGE "LAZY") endif() -# quiet output for Makefiles, 'make -s' helps too +# quiet output for Makefiles, `make -s` helps too # set_property(GLOBAL PROPERTY RULE_MESSAGES OFF) # ----------------------------------------------------------------------------- @@ -533,7 +533,7 @@ option(WITH_LIBMV "Enable Libmv structure from motion library" ON) option(WITH_LIBMV_SCHUR_SPECIALIZATIONS "Enable fixed-size schur specializations." ON) mark_as_advanced(WITH_LIBMV_SCHUR_SPECIALIZATIONS) -# Logging/unbit test libraries. +# Logging/unit test libraries. option(WITH_SYSTEM_GFLAGS "Use system-wide Gflags instead of a bundled one" OFF) option(WITH_SYSTEM_GLOG "Use system-wide Glog instead of a bundled one" OFF) mark_as_advanced(WITH_SYSTEM_GFLAGS) @@ -908,7 +908,7 @@ mark_as_advanced(WITH_SYSTEM_PYTHON_TESTS) # We could use `find_package (Python3 COMPONENTS Interpreter)` to set that value automatically. # However, on some buildbots this will give the default Python version of the current virtual # environment, which may differ from the OS default Python version. -# And it would set that global 'python3 exec path' CMake value for all CMake scripts, +# And it would set that global `python3 exec path` CMake value for all CMake scripts, # which could have unexpected and dangerous side effects. # So this has to be set explicitly for all builders. set(TEST_SYSTEM_PYTHON_EXE "" CACHE PATH "Python executable used to run 'system python' tests") @@ -1348,7 +1348,7 @@ set_and_warn_dependency(WITH_TBB WITH_MOD_FLUID OFF) # NanoVDB requires OpenVDB to convert the data structure set_and_warn_dependency(WITH_OPENVDB WITH_NANOVDB OFF) -# OpenVDB, Alembic and OSL uses 'half' or 'imath' from OpenEXR +# OpenVDB, Alembic and OSL uses `half` or `imath` from OpenEXR set_and_warn_dependency(WITH_IMAGE_OPENEXR WITH_OPENVDB OFF) set_and_warn_dependency(WITH_IMAGE_OPENEXR WITH_ALEMBIC OFF) set_and_warn_dependency(WITH_IMAGE_OPENEXR WITH_CYCLES_OSL OFF) @@ -1653,8 +1653,8 @@ if(WITH_METAL_BACKEND) add_definitions(-DWITH_METAL_BACKEND) # No need to add frameworks here, all the ones we need for Metal and - # Metal-OpenGL Interop are already being added by - # build_files/cmake/platform/platform_apple.cmake + # Metal-OpenGL Interoperability are already being added by + # `build_files/cmake/platform/platform_apple.cmake`. endif() @@ -1729,7 +1729,7 @@ include(dependency_targets) # ----------------------------------------------------------------------------- # Ninja Job Limiting -# Extra limits to number of jobs running in parallel for some kind os tasks. +# Extra limits to number of jobs running in parallel for some kind OS tasks. # Only supported by Ninja build system currently. if("${CMAKE_GENERATOR}" MATCHES "Ninja" AND WITH_NINJA_POOL_JOBS) @@ -1977,8 +1977,8 @@ if(CMAKE_COMPILER_IS_GNUCC) C_WARN_REDUNDANT_DECLS -Wredundant-decls C_WARN_SHADOW -Wshadow - # Disable because it gives warnings for printf() & friends. - # C_WARN_DOUBLE_PROMOTION "-Wdouble-promotion -Wno-error=double-promotion" + # Disable because it gives warnings for `printf()` & friends. + # C_WARN_DOUBLE_PROMOTION `-Wdouble-promotion -Wno-error=double-promotion` # Use `ATTR_FALLTHROUGH` macro to suppress. C_WARN_IMPLICIT_FALLTHROUGH -Wimplicit-fallthrough=5 @@ -2127,7 +2127,7 @@ elseif(CMAKE_C_COMPILER_ID MATCHES "Clang") CXX_WARN_NO_UNKNOWN_PRAGMAS -Wno-unknown-pragmas CXX_WARN_NO_CHAR_SUBSCRIPTS -Wno-char-subscripts - # We get a lot of these, if its a problem a dev needs to look into it. + # We get a lot of these, if its a problem a developer needs to look into it. CXX_WARN_NO_OVERLOADED_VIRTUAL -Wno-overloaded-virtual CXX_WARN_NO_SIGN_COMPARE -Wno-sign-compare @@ -2623,7 +2623,7 @@ if(CMAKE_COMPILER_IS_GNUCC OR endif() if(WITH_COMPILER_SHORT_FILE_MACRO) - # Use '-fmacro-prefix-map' for Clang and GCC (MSVC doesn't support this). + # Use `-fmacro-prefix-map` for Clang and GCC (MSVC doesn't support this). set(C_PREFIX_MAP_FLAGS "") set(CXX_PREFIX_MAP_FLAGS "") add_check_c_compiler_flags( diff --git a/build_files/build_environment/install_linux_packages.py b/build_files/build_environment/install_linux_packages.py index eec2c448ff5..3ba47df7d46 100755 --- a/build_files/build_environment/install_linux_packages.py +++ b/build_files/build_environment/install_linux_packages.py @@ -307,7 +307,7 @@ DEPS_CRITICAL_SUBPACKAGES = ( ) -# Basic mandatory set of common libraries to build Blender, which are also available as pre-conmpiled libraries. +# Basic mandatory set of common libraries to build Blender, which are also available as pre-compiled libraries. DEPS_MANDATORY_SUBPACKAGES = ( Package(name="JPEG Library", distro_package_names={DISTRO_ID_DEBIAN: "libjpeg-dev", @@ -403,7 +403,7 @@ DEPS_MANDATORY_SUBPACKAGES = ( ) -# Basic optional set of common libraries to build Blender, which are also available as pre-conmpiled libraries. +# Basic optional set of common libraries to build Blender, which are also available as pre-compiled libraries. DEPS_OPTIONAL_SUBPACKAGES = ( Package(name="OpenJPG Library", distro_package_names={DISTRO_ID_DEBIAN: "libopenjp2-7-dev", diff --git a/intern/cycles/kernel/CMakeLists.txt b/intern/cycles/kernel/CMakeLists.txt index 7c5e2602b88..24a9beeae29 100644 --- a/intern/cycles/kernel/CMakeLists.txt +++ b/intern/cycles/kernel/CMakeLists.txt @@ -859,7 +859,7 @@ if(WITH_CYCLES_CUDA_BINARIES AND WITH_CYCLES_DEVICE_OPTIX) set(cuda_version ${CUDA_VERSION}) if("${CUDA_VERSION}" GREATER_EQUAL 130) # Support for Maxwell, Pascal and Volta was dropped in CUDA 13 if(DEFINED CUDA11_NVCC_EXECUTABLE) - # Use CUDA 11 for the OptiX PTX kernel, to retain support for older achitectures + # Use CUDA 11 for the OptiX PTX kernel, to retain support for older architectures. set(cuda_nvcc_executable ${CUDA11_NVCC_EXECUTABLE}) set(cuda_version 110) else() diff --git a/intern/ghost/CMakeLists.txt b/intern/ghost/CMakeLists.txt index 5208095a16d..52081956bc1 100644 --- a/intern/ghost/CMakeLists.txt +++ b/intern/ghost/CMakeLists.txt @@ -388,7 +388,7 @@ elseif(WITH_GHOST_X11 OR WITH_GHOST_WAYLAND) generate_protocol_bindings( "${WAYLAND_PROTOCOLS_DIR}/staging/fractional-scale/fractional-scale-v1.xml" ) - # Viewport (only required when fractional scale is in use). + # ViewPorter (only required when fractional scale is in use). generate_protocol_bindings( "${WAYLAND_PROTOCOLS_DIR}/stable/viewporter/viewporter.xml" ) diff --git a/intern/guardedalloc/MEM_guardedalloc.h b/intern/guardedalloc/MEM_guardedalloc.h index 0aa7c40895f..5dbd01bac46 100644 --- a/intern/guardedalloc/MEM_guardedalloc.h +++ b/intern/guardedalloc/MEM_guardedalloc.h @@ -382,8 +382,8 @@ inline T *MEM_new(const char *allocation_name, Args &&...args) * * \note This function uses 'default initialization' on zero-initialized memory, _not_ 'value * initialization'. This means that even if a user-defined default constructor is provided, - * non-explicitely initialized data will be zero-initialized. For POD types (e.g. pure C-style - * structs), its behavior is functionnally identical to using `MEM_callocN()`. + * non-explicitly initialized data will be zero-initialized. For POD types (e.g. pure C-style + * structs), its behavior is functionally identical to using `MEM_callocN()`. * * \warning This function is intended as a temporary work-around during the process of converting * Blender data management from C-style (alloc/free) to C++-style (new/delete). It will be removed diff --git a/source/blender/blenloader/intern/writefile.cc b/source/blender/blenloader/intern/writefile.cc index bdab6285cc4..575dd7a78b0 100644 --- a/source/blender/blenloader/intern/writefile.cc +++ b/source/blender/blenloader/intern/writefile.cc @@ -1309,7 +1309,7 @@ BLO_Write_IDBuffer::BLO_Write_IDBuffer(ID &id, const bool is_undo, const bool is /* Copy ID data itself into buffer, to be able to freely modify it. */ if (is_placeholder) { - /* For placeholders (references to linked data), zero-initialize, and only explicitely copy the + /* For placeholders (references to linked data), zero-initialize, and only explicitly copy the * very small subset of required data. */ *temp_id = ID{}; temp_id->lib = id.lib; @@ -1473,8 +1473,8 @@ static blender::Vector gather_local_ids_to_write(Main *bmain, const bool i continue; } - /* XXX Special handling for ShapeKeys, as having unused shapekeys is not a good thing - * (and reported as error by e.g. `BLO_main_validate_shapekeys`), skip writing shapekeys + /* XXX Special handling for ShapeKeys, as having unused shape-keys is not a good thing + * (and reported as error by e.g. `BLO_main_validate_shapekeys`), skip writing shape-keys * when their 'owner' is not written. * * NOTE: Since ShapeKeys are conceptually embedded IDs (like root node trees e.g.), this diff --git a/source/blender/makesdna/DNA_ipo_types.h b/source/blender/makesdna/DNA_ipo_types.h index 82c6d8bf65b..689670b654d 100644 --- a/source/blender/makesdna/DNA_ipo_types.h +++ b/source/blender/makesdna/DNA_ipo_types.h @@ -502,7 +502,7 @@ typedef struct Ipo { /* ---------- IPO Drivers ----------- */ -/* Offset in driver->name for finding second posechannel for rot-diff. */ +/** Offset in driver->name for finding second pose-channel for rot-diff. */ #define DRIVER_NAME_OFFS 32 /* driver->type */ @@ -510,5 +510,5 @@ typedef struct Ipo { #define IPO_DRIVER_TYPE_PYTHON 1 /* driver->flag */ -/* invalid flag: currently only used for buggy pydriver expressions */ +/** Invalid flag: currently only used for invalid Python-driver expressions. */ #define IPO_DRIVER_FLAG_INVALID (1 << 0) diff --git a/source/blender/modifiers/CMakeLists.txt b/source/blender/modifiers/CMakeLists.txt index 149f473ac8f..07d33f39bc3 100644 --- a/source/blender/modifiers/CMakeLists.txt +++ b/source/blender/modifiers/CMakeLists.txt @@ -197,7 +197,7 @@ if(WITH_BULLET) add_definitions(-DWITH_BULLET) endif() -# To disable adaptive subdivision test in subsurf UI without cycles +# To disable adaptive subdivision test in subdivision-surface UI without cycles. if(WITH_CYCLES) add_definitions(-DWITH_CYCLES) endif() diff --git a/source/blender/windowmanager/intern/wm_files_colorspace.cc b/source/blender/windowmanager/intern/wm_files_colorspace.cc index 5a0318ee448..995819c3e89 100644 --- a/source/blender/windowmanager/intern/wm_files_colorspace.cc +++ b/source/blender/windowmanager/intern/wm_files_colorspace.cc @@ -72,7 +72,7 @@ static bool wm_set_working_space_check_safe(bContext *C, wmOperator *op) if (WM_jobs_test(wm, scene, WM_JOB_TYPE_ANY)) { BKE_report( - op->reports, RPT_WARNING, RPT_("Can't change working space while josb are running")); + op->reports, RPT_WARNING, RPT_("Can't change working space while jobs are running")); return false; }