diff --git a/source/blender/blenfont/intern/blf_font_win32_compat.cc b/source/blender/blenfont/intern/blf_font_win32_compat.cc index 849aa51857c..a0cc10a556f 100644 --- a/source/blender/blenfont/intern/blf_font_win32_compat.cc +++ b/source/blender/blenfont/intern/blf_font_win32_compat.cc @@ -72,7 +72,7 @@ static FT_Error FT_Stream_Open__win32_compat(FT_Stream stream, const char *filep if (!file) { fprintf(stderr, "FT_Stream_Open: " - "could not open `%s'\n", + "could not open '%s'\n", filepathname); return FT_THROW(Cannot_Open_Resource); } @@ -82,7 +82,7 @@ static FT_Error FT_Stream_Open__win32_compat(FT_Stream stream, const char *filep if (!stream->size) { fprintf(stderr, "FT_Stream_Open: " - "opened `%s' but zero-sized\n", + "opened '%s' but zero-sized\n", filepathname); fclose(file); return FT_THROW(Cannot_Open_Stream); diff --git a/source/blender/blenkernel/BKE_lib_query.hh b/source/blender/blenkernel/BKE_lib_query.hh index 99871ed8813..d28cba8b4e0 100644 --- a/source/blender/blenkernel/BKE_lib_query.hh +++ b/source/blender/blenkernel/BKE_lib_query.hh @@ -451,7 +451,7 @@ struct LibQueryUnusedIDsData { * * By default only consider IDs with `0` user count. * If `do_recursive` is set, it will check dependencies to detect all IDs that are not actually - * used in current file, including 'archipelagos` (i.e. set of IDs referencing each other in + * used in current file, including `archipelagos` (i.e. set of IDs referencing each other in * loops, but without any 'external' valid usages. * * Valid usages here are defined as ref-counting usages, which are not towards embedded or @@ -473,7 +473,7 @@ void BKE_lib_query_unused_ids_amounts(Main *bmain, LibQueryUnusedIDsData ¶me * * By default only tag IDs with `0` user count. * If `do_recursive` is set, it will check dependencies to detect all IDs that are not actually - * used in current file, including 'archipelagos` (i.e. set of IDs referencing each other in + * used in current file, including `archipelagos` (i.e. set of IDs referencing each other in * loops, but without any 'external' valid usages. * * Valid usages here are defined as ref-counting usages, which are not towards embedded or diff --git a/source/blender/blenkernel/BKE_node_socket_value.hh b/source/blender/blenkernel/BKE_node_socket_value.hh index 9181db425fa..a4519a701a9 100644 --- a/source/blender/blenkernel/BKE_node_socket_value.hh +++ b/source/blender/blenkernel/BKE_node_socket_value.hh @@ -150,7 +150,7 @@ class SocketValueVariant { /** * Convert the stored value into a single value. For simple value access, this is not necessary, - * because #get` does the conversion implicitly. However, it is necessary if one wants to use + * because #get does the conversion implicitly. However, it is necessary if one wants to use * #get_single_ptr. Context-dependent fields or grids will just result in a fallback value. * * The caller has to make sure that the stored value is a single value, field or grid. diff --git a/source/blender/blenkernel/BKE_path_templates.hh b/source/blender/blenkernel/BKE_path_templates.hh index a94f894be86..988ac213905 100644 --- a/source/blender/blenkernel/BKE_path_templates.hh +++ b/source/blender/blenkernel/BKE_path_templates.hh @@ -19,14 +19,14 @@ * * An example of what step 3 might look like: * - * ``` + * \code{.cc} * VariableMap template_variables; * BKE_add_template_variables_general(template_variables, owner_id); * BKE_add_template_variables_for_render_path(template_variables, scene); * BKE_add_template_variables_for_node(template_variables, owner_node); * * BKE_path_apply_template(filepath, FILE_MAX, template_variables); - * ``` + * \endcode * * This calls three functions to build the #VariableMap, one for each "kind" of * variable (see below). @@ -359,7 +359,7 @@ blender::Vector BKE_path_validate_template( * This mutates the path in-place. `path` must be a null-terminated string. * * The syntax for template expressions is `{variable_name}` or - * {variable_name:format_spec}`. The format specification syntax currently only + * `{variable_name:format_spec}`. The format specification syntax currently only * applies to numerical values (integer or float), and uses hash symbols (#) to * indicate the number of digits to print the number with. It can be in any of * the following forms: diff --git a/source/blender/blenkernel/BKE_screen.hh b/source/blender/blenkernel/BKE_screen.hh index edb3b8b97ed..d0b2dfdf08b 100644 --- a/source/blender/blenkernel/BKE_screen.hh +++ b/source/blender/blenkernel/BKE_screen.hh @@ -275,7 +275,7 @@ struct ARegionType { * performed. * * This callback is not called on indirect changes of the current viewport (which could happen - * when the `v2d->tot is changed and `cur` is adopted accordingly). + * when the `v2d->tot` is changed and `cur` is adopted accordingly). */ void (*on_view2d_changed)(const bContext *C, ARegion *region); diff --git a/source/blender/blenkernel/intern/blendfile.cc b/source/blender/blenkernel/intern/blendfile.cc index dff992d0598..dc8106676ad 100644 --- a/source/blender/blenkernel/intern/blendfile.cc +++ b/source/blender/blenkernel/intern/blendfile.cc @@ -570,7 +570,7 @@ static void unpin_file_local_grease_pencil_brush_materials(const ReuseOldBMainDa } /** - * Does a complete replacement of data in `new_bmain` by data from `old_bmain. Original new data + * Does a complete replacement of data in `new_bmain` by data from `old_bmain`. Original new data * are moved to the `old_bmain`, and will be freed together with it. * * WARNING: Currently only expects to work on local data, won't work properly if some of the IDs of diff --git a/source/blender/blenkernel/intern/grease_pencil.cc b/source/blender/blenkernel/intern/grease_pencil.cc index 88d65daa988..c018fa60981 100644 --- a/source/blender/blenkernel/intern/grease_pencil.cc +++ b/source/blender/blenkernel/intern/grease_pencil.cc @@ -727,8 +727,9 @@ void Drawing::set_texture_matrices(Span matrices, const IndexMask &sel const double4x3 strokemat4x3 = double4x3(expand_4x2_mat(strokemat)); /* - * We want to solve for `texture_matrix` in the equation: `texspace = texture_matrix * - * strokemat4x3` Because these matrices are not square we can not use a standard inverse. + * We want to solve for `texture_matrix` in the equation: + * `texspace = texture_matrix * strokemat4x3` + * Because these matrices are not square we can not use a standard inverse. * * Our problem has the form of: `X = A * Y` * We can solve for `A` using: `A = X * B` diff --git a/source/blender/blenkernel/intern/scene.cc b/source/blender/blenkernel/intern/scene.cc index 9b8f5be802b..b23a1a15922 100644 --- a/source/blender/blenkernel/intern/scene.cc +++ b/source/blender/blenkernel/intern/scene.cc @@ -516,9 +516,11 @@ static void scene_foreach_toolsettings_id_pointer_process( } } -/* Special handling is needed here, as `scene_foreach_toolsettings` (and its dependency - * `scene_foreach_paint`) are also used by `scene_undo_preserve`, where `LibraryForeachIDData - * *data` is nullptr. */ +/** + * Special handling is needed here, as `scene_foreach_toolsettings` (and its dependency + * `scene_foreach_paint`) are also used by `scene_undo_preserve`, + * where `LibraryForeachIDData *data` is nullptr. + */ #define BKE_LIB_FOREACHID_UNDO_PRESERVE_PROCESS_IDSUPER_P( \ _data, _id_p, _do_undo_restore, _action, _reader, _id_old_p, _cb_flag) \ { \ diff --git a/source/blender/blenlib/BLI_math_base.h b/source/blender/blenlib/BLI_math_base.h index f39a81af32a..de0991da17a 100644 --- a/source/blender/blenlib/BLI_math_base.h +++ b/source/blender/blenlib/BLI_math_base.h @@ -14,7 +14,7 @@ * - `v2` = `vec2` = vector 2. * - `v3` = `vec3` = vector 3. * - `v4` = `vec4` = vector 4. - * - `vn` = `vec4q = vector N dimensions, *passed as an arg, after the vector*.. + * - `vn` = `vec4q` = vector N dimensions, *passed as an arg, after the vector*.. * - `qt` = `quat` = quaternion. * - `dq` = `dquat` = dual quaternion. * - `m2` = `mat2` = matrix 2x2. diff --git a/source/blender/blenlib/BLI_string_utils.hh b/source/blender/blenlib/BLI_string_utils.hh index 156cc9489a3..2cb4115a9b7 100644 --- a/source/blender/blenlib/BLI_string_utils.hh +++ b/source/blender/blenlib/BLI_string_utils.hh @@ -92,9 +92,9 @@ size_t BLI_string_replace_range( * Returning the length of "Foo" * * \param left: Where to return copy of part preceding `delim`. - * \param nr: Where to return value of numeric suffix`. - * \param name: String to split`. - * \param delim: Delimiter character`. + * \param nr: Where to return value of numeric suffix. + * \param name: String to split. + * \param delim: Delimiter character. * \return Length of \a left. */ size_t BLI_string_split_name_number(const char *name, char delim, char *r_name_left, int *r_number) diff --git a/source/blender/blenlib/intern/math_boolean.cc b/source/blender/blenlib/intern/math_boolean.cc index 278a0742e8a..f8e7c68e529 100644 --- a/source/blender/blenlib/intern/math_boolean.cc +++ b/source/blender/blenlib/intern/math_boolean.cc @@ -181,11 +181,11 @@ static RobustInitCaller init_caller; * The operations Fast_Two_Sum(), Fast_Two_Diff(), Two_Sum(), Two_Diff(), * Split(), and Two_Product() are all implemented as described in the * reference. Each of these macros requires certain variables to be - * defined in the calling routine. The variables `bvirt', `c', `abig', - * `_i', `_j', `_k', `_l', `_m', and `_n' are declared `INEXACT' because + * defined in the calling routine. The variables `bvirt`, `c`, `abig`, + * `_i`, `_j`, `_k`, `_l`, `_m`, and `_n` are declared `INEXACT' because * they store the result of an operation that may incur round-off error. - * The input parameter `x' (or the highest numbered `x_' parameter) must - * also be declared `INEXACT'. + * The input parameter `x` (or the highest numbered `x_` parameter) must + * also be declared `INEXACT`. */ #define Fast_Two_Sum_Tail(a, b, x, y) \ @@ -397,20 +397,20 @@ static double iccerrboundA, iccerrboundB, iccerrboundC; static double isperrboundA, isperrboundB, isperrboundC; /** - * exactinit() Initialize the variables used for exact arithmetic. + * exactinit() Initialize the variables used for exact arithmetic. * - * `epsilon' is the largest power of two such that 1.0 + epsilon = 1.0 in - * floating-point arithmetic. `epsilon' bounds the relative round-off - * error. It is used for floating-point error analysis. + * `epsilon` is the largest power of two such that 1.0 + epsilon = 1.0 in + * floating-point arithmetic. `epsilon` bounds the relative round-off + * error. It is used for floating-point error analysis. * - * `splitter' is used to split floating-point numbers into two half-length - * significant for exact multiplication. + * `splitter` is used to split floating-point numbers into two half-length + * significant for exact multiplication. * - * I imagine that a highly optimizing compiler might be too smart for its - * own good, and somehow cause this routine to fail, if it pretends that - * floating-point arithmetic is too much like real arithmetic. + * I imagine that a highly optimizing compiler might be too smart for its + * own good, and somehow cause this routine to fail, if it pretends that + * floating-point arithmetic is too much like real arithmetic. * - * Don't change this routine unless you fully understand it. + * Don't change this routine unless you fully understand it. */ void exactinit() { @@ -423,7 +423,7 @@ void exactinit() epsilon = 1.0; splitter = 1.0; check = 1.0; - /* Repeatedly divide `epsilon' by two until it is too small to add to + /* Repeatedly divide `epsilon` by two until it is too small to add to * one without causing round-off. (Also check if the sum is equal to * the previous sum, for machines that round up instead of using exact * rounding. Not that this library will work on such machines anyway. */ diff --git a/source/blender/blenloader/intern/versioning_400.cc b/source/blender/blenloader/intern/versioning_400.cc index c2066fedec6..8137b1e09b0 100644 --- a/source/blender/blenloader/intern/versioning_400.cc +++ b/source/blender/blenloader/intern/versioning_400.cc @@ -318,7 +318,7 @@ void do_versions_after_linking_400(FileData *fd, Main *bmain) } } - /* XXX This was added several years ago in 'lib_link` code of Scene... Should be safe enough + /* XXX This was added several years ago in `lib_link` code of Scene... Should be safe enough * here. */ LISTBASE_FOREACH (Scene *, scene, &bmain->scenes) { if (scene->nodetree) { @@ -326,7 +326,7 @@ void do_versions_after_linking_400(FileData *fd, Main *bmain) } } - /* XXX This was added many years ago (1c19940198) in 'lib_link` code of particles as a bug-fix. + /* XXX This was added many years ago (1c19940198) in `lib_link` code of particles as a bug-fix. * But this is actually versioning. Should be safe enough here. */ LISTBASE_FOREACH (ParticleSettings *, part, &bmain->particles) { if (!part->effector_weights) { diff --git a/source/blender/bmesh/operators/bmo_dupe.cc b/source/blender/bmesh/operators/bmo_dupe.cc index e3edec4da33..9bce365ef3d 100644 --- a/source/blender/bmesh/operators/bmo_dupe.cc +++ b/source/blender/bmesh/operators/bmo_dupe.cc @@ -501,7 +501,7 @@ void bmo_split_exec(BMesh *bm, BMOperator *op) [&bm, &dupeop, &splitop]() { /* Now we make our outputs by copying the dupe output. */ - /* NOTE: `boundary_map.out` can't use #BMO_slot_copy` because some of the "source" + /* NOTE: `boundary_map.out` can't use #BMO_slot_copy because some of the "source" * geometry has been removed. In this case the (source -> destination) map doesn't work. * In this case there is isn't an especially good option. * The geometry needs to be included so the boundary is accessible. diff --git a/source/blender/draw/engines/gpencil/gpencil_render.cc b/source/blender/draw/engines/gpencil/gpencil_render.cc index 5ebf75749cd..bfeb2a7dfeb 100644 --- a/source/blender/draw/engines/gpencil/gpencil_render.cc +++ b/source/blender/draw/engines/gpencil/gpencil_render.cc @@ -392,8 +392,8 @@ static void render_frame(RenderEngine *engine, /* Render the gpencil object and merge the result to the underlying render. */ inst.draw(manager); - /* Weight of this render SSAA sample. The sum of previous samples is weighted by `1 - - * weight`. This diminishes after each new sample as we want all samples to be equally + /* Weight of this render SSAA sample. The sum of previous samples is weighted by + * `1 - weight`. This diminishes after each new sample as we want all samples to be equally * weighted inside the final result (inside the combined buffer). This weighting scheme * allows to always store the resolved result making it ready for in-progress display or * read-back. */ diff --git a/source/blender/draw/intern/draw_cache_impl.hh b/source/blender/draw/intern/draw_cache_impl.hh index 0ae72fb1a5b..c91f54e3d29 100644 --- a/source/blender/draw/intern/draw_cache_impl.hh +++ b/source/blender/draw/intern/draw_cache_impl.hh @@ -251,7 +251,7 @@ blender::gpu::Batch *DRW_mesh_batch_cache_get_wireframes_face(Mesh &mesh); * Creates the #blender::gpu::Batch for drawing the UV Stretching Area Overlay. * Optional retrieves the total area or total uv area of the mesh. * - * The `cache->tot_area` and cache->tot_uv_area` update are calculation are + * The `cache->tot_area` and `cache->tot_uv_area` update are calculation are * only valid after calling `DRW_mesh_batch_cache_create_requested`. */ blender::gpu::Batch *DRW_mesh_batch_cache_get_edituv_faces_stretch_area(Object &object, diff --git a/source/blender/editors/asset/ED_asset_list.hh b/source/blender/editors/asset/ED_asset_list.hh index 840b0d9c540..0aae4ccd9c6 100644 --- a/source/blender/editors/asset/ED_asset_list.hh +++ b/source/blender/editors/asset/ED_asset_list.hh @@ -29,9 +29,9 @@ void asset_reading_region_listen_fn(const wmRegionListenerParams *params); * Get the asset library being read into an asset-list and identified using \a library_reference. * * \note The asset library may be allocated and loaded asynchronously, so it's not available right - * after fetching, and this function will return null. The asset list code sends `NC_ASSET | - * ND_ASSET_LIST_READING` notifiers until loading is done, they can be used to continuously - * call this function to retrieve the asset library once available. + * after fetching, and this function will return null. The asset list code sends + * `NC_ASSET | ND_ASSET_LIST_READING` notifiers until loading is done, they can be used + * to continuously call this function to retrieve the asset library once available. */ asset_system::AssetLibrary *library_get_once_available( const AssetLibraryReference &library_reference); diff --git a/source/blender/editors/space_file/filelist/filelist.cc b/source/blender/editors/space_file/filelist/filelist.cc index 9ae2ac13567..f4c402650bd 100644 --- a/source/blender/editors/space_file/filelist/filelist.cc +++ b/source/blender/editors/space_file/filelist/filelist.cc @@ -2080,10 +2080,13 @@ struct FileListReadJob { Main *current_main = nullptr; FileList *filelist = nullptr; - /** The path currently being read, relative to the filelist root directory. Needed for recursive - * reading. The full file path is then composed like: `//. + /** + * The path currently being read, relative to the filelist root directory. + * Needed for recursive reading. The full file path is then composed like: + * `//`. * (whereby the file name may also be a library path within a .blend, e.g. - * `Materials/Material.001`). */ + * `Materials/Material.001`). + */ char cur_relbase[FILE_MAX_LIBEXTRA] = ""; /** The current asset library to load. Usually the same as #FileList.asset_library, however diff --git a/source/blender/editors/space_outliner/outliner_tree.cc b/source/blender/editors/space_outliner/outliner_tree.cc index 52352a3b191..5b6cfa0312e 100644 --- a/source/blender/editors/space_outliner/outliner_tree.cc +++ b/source/blender/editors/space_outliner/outliner_tree.cc @@ -249,7 +249,7 @@ TreeElement *AbstractTreeDisplay::add_element(ListBase *lb, * on file read. */ /* FIXME: This is may be an arbitrary void pointer that is cast to an ID pointer. Could be a * temporary stack pointer even. Often works reliably enough at runtime, and file reading handles - * cases where data can't be reconstructed just fine (pointer is null`ed). This is still + * cases where data can't be reconstructed just fine (pointer is null'ed). This is still * completely type unsafe and error-prone. */ ID *persistent_dataptr = owner_id ? owner_id : static_cast(create_data); diff --git a/source/blender/geometry/intern/mesh_boolean.cc b/source/blender/geometry/intern/mesh_boolean.cc index 37dc71c7513..6e03a183af0 100644 --- a/source/blender/geometry/intern/mesh_boolean.cc +++ b/source/blender/geometry/intern/mesh_boolean.cc @@ -910,8 +910,8 @@ static Mesh *mesh_boolean_mesh_arr(Span meshes, #define BM_FACE_TAG BM_ELEM_DRAW /** - * Function use to say what operand a face is part of, based on the `BM_FACE_TAG`,` - * which is set in `bm_mesh_create`. + * Function use to say what operand a face is part of, based on the `BM_FACE_TAG` + * which is set in `bm_mesh_create`. */ static int face_boolean_operand(BMFace *f, void * /*user_data*/) { diff --git a/source/blender/gpu/glsl_preprocess/glsl_preprocess.hh b/source/blender/gpu/glsl_preprocess/glsl_preprocess.hh index 57f5e2f992e..a7031d94103 100644 --- a/source/blender/gpu/glsl_preprocess/glsl_preprocess.hh +++ b/source/blender/gpu/glsl_preprocess/glsl_preprocess.hh @@ -850,7 +850,7 @@ class Preprocessor { std::string preprocessor_directive_mutation(const std::string &str) { - /* Remove unsupported directives.` */ + /* Remove unsupported directives. */ std::regex regex(R"(#\s*(?:include|pragma once|pragma runtime_generated)[^\n]*)"); return std::regex_replace(str, regex, ""); } diff --git a/source/blender/gpu/vulkan/render_graph/vk_render_graph_node.hh b/source/blender/gpu/vulkan/render_graph/vk_render_graph_node.hh index f217cec7f66..6e511fb8f3f 100644 --- a/source/blender/gpu/vulkan/render_graph/vk_render_graph_node.hh +++ b/source/blender/gpu/vulkan/render_graph/vk_render_graph_node.hh @@ -201,7 +201,7 @@ struct VKRenderGraphNode { * Build commands for this node and record them in the given command_buffer. * * NOTE: Pipeline barriers should already be added. See - * `VKCommandBuilder::build_node` and `VKCommandBuilder::build_pipeline_barriers. + * `VKCommandBuilder::build_node` and `VKCommandBuilder::build_pipeline_barriers`. */ void build_commands(VKCommandBufferInterface &command_buffer, VKRenderGraphStorage &storage, diff --git a/source/blender/gpu/vulkan/render_graph/vk_scheduler.hh b/source/blender/gpu/vulkan/render_graph/vk_scheduler.hh index a93acd55e2d..fb9c1891f35 100644 --- a/source/blender/gpu/vulkan/render_graph/vk_scheduler.hh +++ b/source/blender/gpu/vulkan/render_graph/vk_scheduler.hh @@ -36,9 +36,10 @@ class VKRenderGraph; * eventually not been displayed on screen. These branches should be pruned. The challenge is * that we need to know for certain that it isn't used in a not submitted part of the graph. * - * TODO: Walking the render graph isn't implemented yet. The idea is to have a - * `Map> consumers` and `Map - * producers`. These attributes can be stored in the render graph and created when building the + * TODO: Walking the render graph isn't implemented yet. + * The idea is to have a `Map> consumers` and + * `Map producers`. + * These attributes can be stored in the render graph and created when building the * links, or can be created inside the VKScheduler as a variable. The exact detail which one would * be better is unclear as there aren't any users yet. At the moment the scheduler would need them * we need to figure out the best way to store and retrieve the consumers/producers. diff --git a/source/blender/makesdna/DNA_action_types.h b/source/blender/makesdna/DNA_action_types.h index 01a5c8cf365..cc42928e80d 100644 --- a/source/blender/makesdna/DNA_action_types.h +++ b/source/blender/makesdna/DNA_action_types.h @@ -779,11 +779,13 @@ typedef struct bAction { /** ID-serialization for relinking. */ ID id; - struct ActionLayer **layer_array; /* Array of 'layer_array_num' layers. */ + /** Array of `layer_array_num` layers. */ + struct ActionLayer **layer_array; int layer_array_num; int layer_active_index; /* Index into layer_array, -1 means 'no active'. */ - struct ActionSlot **slot_array; /* Array of 'slot_array_num` slots. */ + /** Array of `slot_array_num` slots. */ + struct ActionSlot **slot_array; int slot_array_num; int32_t last_slot_handle; diff --git a/source/blender/makesdna/DNA_layer_types.h b/source/blender/makesdna/DNA_layer_types.h index 5554d364fc5..16afa4b6e8a 100644 --- a/source/blender/makesdna/DNA_layer_types.h +++ b/source/blender/makesdna/DNA_layer_types.h @@ -184,11 +184,11 @@ typedef struct ViewLayer { struct FreestyleConfig freestyle_config; struct ViewLayerEEVEE eevee; - /* List containing the `ViewLayerAOV`s */ + /** List containing #ViewLayerAOV. */ ListBase aovs; ViewLayerAOV *active_aov; - /* List containing the 'ViewLayerLightgroup`s */ + /** List containing #ViewLayerLightgroup. */ ListBase lightgroups; ViewLayerLightgroup *active_lightgroup; diff --git a/source/blender/makesdna/DNA_modifier_types.h b/source/blender/makesdna/DNA_modifier_types.h index 1e0a4084e1e..cc31fd29a93 100644 --- a/source/blender/makesdna/DNA_modifier_types.h +++ b/source/blender/makesdna/DNA_modifier_types.h @@ -2771,7 +2771,7 @@ typedef enum GreasePencilTintModifierFlag { typedef struct GreasePencilSmoothModifierData { ModifierData modifier; GreasePencilModifierInfluenceData influence; - /** `eGreasePencilSmooth_Flag. */ + /** #eGreasePencilSmooth_Flag. */ int flag; /** Factor of smooth. */ float factor; diff --git a/source/blender/makesrna/intern/rna_access.cc b/source/blender/makesrna/intern/rna_access.cc index 7442dffe020..78f75354be1 100644 --- a/source/blender/makesrna/intern/rna_access.cc +++ b/source/blender/makesrna/intern/rna_access.cc @@ -3758,9 +3758,9 @@ std::string RNA_property_string_get(PointerRNA *ptr, PropertyRNA *prop) } std::string string_ret{}; - /* Note: after `resize()` the underlying buffer is actually at least `length + - * 1` bytes long, because (since C++11) `std::string` guarantees a terminating - * null byte, but that is not considered part of the length. */ + /* Note: after `resize()` the underlying buffer is actually at least + * `length + 1` bytes long, because (since C++11) `std::string` guarantees + * a terminating null byte, but that is not considered part of the length. */ string_ret.resize(length); if (sprop->get) { diff --git a/source/blender/python/gpu/gpu_py_batch.cc b/source/blender/python/gpu/gpu_py_batch.cc index d291c800f40..c3f458ebdac 100644 --- a/source/blender/python/gpu/gpu_py_batch.cc +++ b/source/blender/python/gpu/gpu_py_batch.cc @@ -417,7 +417,7 @@ static PyObject *pygpu_batch_draw_instanced(BPyGPUBatch *self, PyObject *args, P "O!" /* `program` */ "|$" /* Optional keyword only arguments. */ "i" /* `instance_start` */ - "i" /* `instance_count' */ + "i" /* `instance_count` */ ":GPUBatch.draw_instanced", _keywords, nullptr, @@ -461,8 +461,8 @@ static PyObject *pygpu_batch_draw_range(BPyGPUBatch *self, PyObject *args, PyObj PY_ARG_PARSER_HEAD_COMPAT() "O!" /* `program` */ "|$" /* Optional keyword only arguments. */ - "i" /* `elem_start' */ - "i" /* `elem_count' */ + "i" /* `elem_start` */ + "i" /* `elem_count` */ ":GPUBatch.draw_range", _keywords, nullptr, diff --git a/source/blender/python/gpu/gpu_py_framebuffer.cc b/source/blender/python/gpu/gpu_py_framebuffer.cc index e5514304d76..bea324ee6ca 100644 --- a/source/blender/python/gpu/gpu_py_framebuffer.cc +++ b/source/blender/python/gpu/gpu_py_framebuffer.cc @@ -798,8 +798,8 @@ static PyMethodDef pygpu_framebuffer__tp_methods[] = { # endif #endif -/* Ideally type aliases would de-duplicate: `blender::gpu::Texture | dict[str, int | - * blender::gpu::Texture]` in this doc-string. */ +/* Ideally type aliases would de-duplicate: + * `blender::gpu::Texture | dict[str, int | blender::gpu::Texture]` in this doc-string. */ PyDoc_STRVAR( /* Wrap. */ pygpu_framebuffer__tp_doc, diff --git a/source/blender/python/intern/bpy_props.cc b/source/blender/python/intern/bpy_props.cc index 51e470ec53c..8324af58c86 100644 --- a/source/blender/python/intern/bpy_props.cc +++ b/source/blender/python/intern/bpy_props.cc @@ -2273,7 +2273,7 @@ static StructRNA *bpy_prop_deferred_data_or_srna(PyObject *self, self = PyTuple_GET_ITEM(args, 0); args = PyTuple_New(0); - /* This will be #BPy_BoolProperty` or one of the functions that define a type. */ + /* This will be #BPy_BoolProperty or one of the functions that define a type. */ PyCFunctionWithKeywords method_fn = (PyCFunctionWithKeywords)(void *)method_def->ml_meth; *r_deferred_result = method_fn(self, args, kw); Py_DECREF(args); diff --git a/source/blender/python/intern/bpy_traceback.cc b/source/blender/python/intern/bpy_traceback.cc index 753d0620bb4..734da60281b 100644 --- a/source/blender/python/intern/bpy_traceback.cc +++ b/source/blender/python/intern/bpy_traceback.cc @@ -83,7 +83,7 @@ static int parse_syntax_error(PyObject *err, *message = nullptr; *filename = nullptr; - /* new style errors. `err' is an instance */ + /* New style errors. `err` is an instance. */ *message = _PyObject_GetAttrId(err, &PyId_msg); if (!*message) { goto finally; diff --git a/source/blender/windowmanager/WM_types.hh b/source/blender/windowmanager/WM_types.hh index f3dc1ea4673..cf57849711e 100644 --- a/source/blender/windowmanager/WM_types.hh +++ b/source/blender/windowmanager/WM_types.hh @@ -993,8 +993,8 @@ enum wmPopupPosition { * Communication/status data owned by the wmJob, and passed to the worker code when calling * `startjob` callback. * - * 'OUTPUT' members mean that they are defined by the worker thread, and read/used by the wmJob - * management code from the main thread. And vice-versa for `INPUT' members. + * `OUTPUT` members mean that they are defined by the worker thread, and read/used by the wmJob + * management code from the main thread. And vice-versa for `INPUT` members. * * \warning There is currently no thread-safety or synchronization when accessing these values. * This is fine as long as: