diff --git a/doc/python_api/examples/bpy.types.FileHandler.1.py b/doc/python_api/examples/bpy.types.FileHandler.1.py index fac02e49f40..4b50c426edd 100644 --- a/doc/python_api/examples/bpy.types.FileHandler.1.py +++ b/doc/python_api/examples/bpy.types.FileHandler.1.py @@ -2,12 +2,12 @@ Basic FileHandler for importing a single file --------------------------------------------- -A file handler allows custom 'drag-and-drop' behavior to be associated with a given ``Operator`` +A file handler allows custom drag-and-drop behavior to be associated with a given ``Operator`` (:class:`FileHandler.bl_import_operator`) and set of file extensions (:class:`FileHandler.bl_file_extensions`). Control over which area of the UI accepts the -`drag-in-drop` action is specified using the :class:`FileHandler.poll_drop` method. +drag-in-drop action is specified using the :class:`FileHandler.poll_drop` method. -Similar to operators that use a file select window, operators participating in 'drag-and-drop', and +Similar to operators that use a file select window, operators participating in drag-and-drop, and only accepting a single file, must define the following property: .. code-block:: python diff --git a/doc/python_api/examples/bpy.types.FileHandler.2.py b/doc/python_api/examples/bpy.types.FileHandler.2.py index f3f4090ba84..21b98cf8d87 100644 --- a/doc/python_api/examples/bpy.types.FileHandler.2.py +++ b/doc/python_api/examples/bpy.types.FileHandler.2.py @@ -2,7 +2,7 @@ FileHandler for Importing multiple files and exposing Operator options ---------------------------------------------------------------------- -Operators which support being executed with multiple files from 'drag-and-drop' require the +Operators which support being executed with multiple files from drag-and-drop require the following properties be defined: .. code-block:: python @@ -11,7 +11,7 @@ following properties be defined: files: CollectionProperty(type=OperatorFileListElement, options={'SKIP_SAVE', 'HIDDEN'}) These ``directory`` and ``files`` properties will be set with the necessary data from the -`drag-and-drop` operation. +drag-and-drop operation. Additionally, if the operator provides operator properties that need to be accessible to the user, the :class:`ImportHelper.invoke_popup` method can be used to show a dialog leveraging the standard diff --git a/doc/python_api/sphinx_doc_gen.py b/doc/python_api/sphinx_doc_gen.py index 906a0b05e2a..1f6e81937d9 100644 --- a/doc/python_api/sphinx_doc_gen.py +++ b/doc/python_api/sphinx_doc_gen.py @@ -1741,7 +1741,7 @@ def pyrna2sphinx(basepath): if not descr: descr = prop.name # In rare cases `descr` may be empty. - fw(" `{:s}`, {:s}\n\n".format( + fw(" ``{:s}``, {:s}\n\n".format( prop.identifier, ", ".join((val for val in (descr, type_descr) if val)) )) diff --git a/scripts/modules/_bpy_types.py b/scripts/modules/_bpy_types.py index 43a5a9c2e29..17ce0cf0a36 100644 --- a/scripts/modules/_bpy_types.py +++ b/scripts/modules/_bpy_types.py @@ -1448,7 +1448,7 @@ class HydraRenderEngine(RenderEngine): def get_render_settings(self, engine_type: str): """ - Provide render settings for `HdRenderDelegate`. + Provide render settings for ``HdRenderDelegate``. """ return {} @@ -1510,9 +1510,9 @@ class GreasePencilDrawing(_StructRNA): .. note:: - When point/curves count of a drawing is changed, the slice returned by this - call prior to the change is no longer valid. You need to get the new stroke - slice via `drawing.strokes[n]`. + When point/curves count of a drawing is changed, the slice returned by this + call prior to the change is no longer valid. You need to get the new stroke + slice via ``drawing.strokes[n]``. """ from _bpy_internal.grease_pencil.stroke import GreasePencilStrokeSlice num_strokes = self.attributes.domain_size('CURVE') diff --git a/source/blender/editors/sculpt_paint/paint_vertex.cc b/source/blender/editors/sculpt_paint/paint_vertex.cc index b3d8a102113..07beacd854c 100644 --- a/source/blender/editors/sculpt_paint/paint_vertex.cc +++ b/source/blender/editors/sculpt_paint/paint_vertex.cc @@ -2178,8 +2178,8 @@ void PAINT_OT_vertex_paint(wmOperatorType *ot) "override_location", false, "Override Location", - "Override the given `location` array by recalculating object space positions from the " - "provided `mouse_event` positions"); + "Override the given \"location\" array by recalculating object space positions from the " + "provided \"mouse_event\" positions"); RNA_def_property_flag(prop, PROP_HIDDEN | PROP_SKIP_SAVE); } diff --git a/source/blender/editors/sculpt_paint/paint_weight.cc b/source/blender/editors/sculpt_paint/paint_weight.cc index 3ec79d938ef..7a3968a93ad 100644 --- a/source/blender/editors/sculpt_paint/paint_weight.cc +++ b/source/blender/editors/sculpt_paint/paint_weight.cc @@ -1967,8 +1967,8 @@ void PAINT_OT_weight_paint(wmOperatorType *ot) "override_location", false, "Override Location", - "Override the given `location` array by recalculating object space positions from the " - "provided `mouse_event` positions"); + "Override the given \"location\" array by recalculating object space positions from the " + "provided \"mouse_event\" positions"); RNA_def_property_flag(prop, PROP_HIDDEN | PROP_SKIP_SAVE); } diff --git a/source/blender/editors/sculpt_paint/sculpt.cc b/source/blender/editors/sculpt_paint/sculpt.cc index e1347e9ad67..2e9ac472983 100644 --- a/source/blender/editors/sculpt_paint/sculpt.cc +++ b/source/blender/editors/sculpt_paint/sculpt.cc @@ -5788,8 +5788,8 @@ void SCULPT_OT_brush_stroke(wmOperatorType *ot) "override_location", false, "Override Location", - "Override the given `location` array by recalculating object space positions from the " - "provided `mouse_event` positions"); + "Override the given \"location\" array by recalculating object space positions from the " + "provided \"mouse_event\" positions"); RNA_def_property_flag(prop, PROP_HIDDEN | PROP_SKIP_SAVE); RNA_def_boolean(ot->srna, diff --git a/source/blender/makesrna/intern/rna_blendfile_import.cc b/source/blender/makesrna/intern/rna_blendfile_import.cc index a6df335da05..7cc48822819 100644 --- a/source/blender/makesrna/intern/rna_blendfile_import.cc +++ b/source/blender/makesrna/intern/rna_blendfile_import.cc @@ -536,7 +536,7 @@ static void rna_def_blendfile_import_context(BlenderRNA *brna) "DONE", 0, "", - "All data has been imported and is available in the list of ``import_items``"}, + "All data has been imported and is available in the list of \"import_items\""}, {0, nullptr, 0, nullptr, nullptr}, }; prop = RNA_def_property(srna, "process_stage", PROP_ENUM, PROP_NONE); diff --git a/source/blender/makesrna/intern/rna_mesh_api.cc b/source/blender/makesrna/intern/rna_mesh_api.cc index dccf570dc73..024cb9013c7 100644 --- a/source/blender/makesrna/intern/rna_mesh_api.cc +++ b/source/blender/makesrna/intern/rna_mesh_api.cc @@ -314,8 +314,9 @@ void RNA_api_mesh(StructRNA *srna) "", "Also consider different smoothgroups sharing only vertices (but without any common edge) " "as neighbors, preventing them from sharing the same bitflag value. Only effective when " - "`use_bitflags` is set. WARNING: Will overflow (run out of available bits) easily with some " - "types of topology, e.g. large fans of sharp edges"); + "``use_bitflags`` is set. " + "WARNING: Will overflow (run out of available bits) easily with some types of topology, " + "e.g. large fans of sharp edges"); /* return values */ parm = RNA_def_int_array(func, "poly_groups", 1, nullptr, 0, 0, "", "Smooth Groups", 0, 0); RNA_def_parameter_flags(parm, PROP_DYNAMIC, PARM_OUTPUT); diff --git a/source/blender/makesrna/intern/rna_pose_api.cc b/source/blender/makesrna/intern/rna_pose_api.cc index 3e30881cd1b..15ba1281322 100644 --- a/source/blender/makesrna/intern/rna_pose_api.cc +++ b/source/blender/makesrna/intern/rna_pose_api.cc @@ -243,7 +243,7 @@ void RNA_api_pose(StructRNA *srna) func, "Create a backup of the current pose. Only those bones that are animated in the Action are " "backed up. The object owns the backup, and each object can have only one backup at a time. " - "When you no longer need it, it must be freed use `backup_clear()`."); + "When you no longer need it, it must be freed use ``backup_clear()``."); RNA_def_function_flag(func, FUNC_USE_SELF_ID | FUNC_NO_SELF); parm = RNA_def_pointer(func, "action", @@ -258,19 +258,19 @@ void RNA_api_pose(StructRNA *srna) RNA_def_function_ui_description( func, "Restore the previously made pose backup. " - "This can be called multiple times. See `Pose.backup_create()` for more info."); + "This can be called multiple times. See ``Pose.backup_create()`` for more info."); /* return value */ parm = RNA_def_boolean( func, "success", false, "", - "`True` when the backup was restored, `False` if there was no backup to restore"); + "``True`` when the backup was restored, ``False`` if there was no backup to restore"); RNA_def_function_return(func, parm); func = RNA_def_function(srna, "backup_clear", "rna_Pose_backup_clear"); RNA_def_function_ui_description( - func, "Free a previously made pose backup. See `Pose.backup_create()` for more info."); + func, "Free a previously made pose backup. See ``Pose.backup_create()`` for more info."); RNA_def_function_flag(func, FUNC_USE_SELF_ID | FUNC_NO_SELF); } diff --git a/source/blender/makesrna/intern/rna_ui.cc b/source/blender/makesrna/intern/rna_ui.cc index f53e9833529..143778681cd 100644 --- a/source/blender/makesrna/intern/rna_ui.cc +++ b/source/blender/makesrna/intern/rna_ui.cc @@ -2505,7 +2505,7 @@ static void rna_def_file_handler(BlenderRNA *brna) "File Extensions", "Formatted string of file extensions supported by the file handler, each extension should " "start with a \".\" and be separated by \";\"." - "\nFor Example: `\".blend;.ble\"`"); + "\nFor Example: ``\".blend;.ble\"``"); PropertyRNA *parm; FunctionRNA *func; diff --git a/source/blender/makesrna/intern/rna_ui_api.cc b/source/blender/makesrna/intern/rna_ui_api.cc index 258e13feb2a..385920bf0f7 100644 --- a/source/blender/makesrna/intern/rna_ui_api.cc +++ b/source/blender/makesrna/intern/rna_ui_api.cc @@ -1263,7 +1263,7 @@ void RNA_api_ui_layout(StructRNA *srna) func = RNA_def_function(srna, "panel_prop", "rna_uiLayoutPanelProp"); RNA_def_function_ui_description( func, - "Similar to `.panel(...)` but instead of storing whether it is open or closed in the " + "Similar to ``.panel(...)`` but instead of storing whether it is open or closed in the " "region, it is stored in the provided boolean property. This should be used when multiple " "instances of the same panel can exist. For example one for every item in a collection " "property or list. This can only be used when the panel has the full width of the panel " diff --git a/source/blender/makesrna/intern/rna_userdef.cc b/source/blender/makesrna/intern/rna_userdef.cc index f37d64fac19..08dba09f23e 100644 --- a/source/blender/makesrna/intern/rna_userdef.cc +++ b/source/blender/makesrna/intern/rna_userdef.cc @@ -7367,7 +7367,7 @@ static void rna_def_userdef_experimental(BlenderRNA *brna) "No Override Auto Resync", "Disable library overrides automatic resync detection and process on " "file load (can be useful to help fixing broken files). Also see the " - "`--disable-liboverride-auto-resync` command line option"); + "\"--disable-liboverride-auto-resync\" command line option"); prop = RNA_def_property(srna, "use_new_curves_tools", PROP_BOOLEAN, PROP_NONE); RNA_def_property_boolean_sdna(prop, nullptr, "use_new_curves_tools", 1); diff --git a/source/blender/python/gpu/gpu_py_batch.cc b/source/blender/python/gpu/gpu_py_batch.cc index 85249a0967b..1101ce8d1bc 100644 --- a/source/blender/python/gpu/gpu_py_batch.cc +++ b/source/blender/python/gpu/gpu_py_batch.cc @@ -394,7 +394,7 @@ PyDoc_STRVAR( ".. method:: draw_instanced(program, *, instance_start=0, instance_count=0)\n" "\n" " Draw multiple instances of the drawing program with the parameters assigned\n" - " to the batch. In the vertex shader, `gl_InstanceID` will contain the instance\n" + " to the batch. In the vertex shader, ``gl_InstanceID`` will contain the instance\n" " number being drawn.\n" "\n" " :arg program: Program that performs the drawing operations.\n" @@ -575,8 +575,8 @@ PyDoc_STRVAR( " Reusable container for drawable geometry.\n" "\n" " :arg type: The primitive type of geometry to be drawn.\n" - " Possible values are `POINTS`, `LINES`, `TRIS`, `LINE_STRIP`, `LINE_LOOP`, `TRI_STRIP`, " - "`TRI_FAN`, `LINES_ADJ`, `TRIS_ADJ` and `LINE_STRIP_ADJ`.\n" + " Possible values are ``POINTS``, ``LINES``, ``TRIS``, ``LINE_STRIP``, ``LINE_LOOP``, " + "``TRI_STRIP``, ``TRI_FAN``, ``LINES_ADJ``, ``TRIS_ADJ`` and ``LINE_STRIP_ADJ``.\n" " :type type: str\n" " :arg buf: Vertex buffer containing all or some of the attributes required for drawing.\n" " :type buf: :class:`gpu.types.GPUVertBuf`\n" diff --git a/source/blender/python/gpu/gpu_py_buffer.cc b/source/blender/python/gpu/gpu_py_buffer.cc index 81f844ee9bc..f24dc109fb2 100644 --- a/source/blender/python/gpu/gpu_py_buffer.cc +++ b/source/blender/python/gpu/gpu_py_buffer.cc @@ -678,8 +678,9 @@ PyDoc_STRVAR( " For Python access to GPU functions requiring a pointer.\n" "\n" " :arg format: Format type to interpret the buffer.\n" - " Possible values are `FLOAT`, `INT`, `UINT`, `UBYTE`, `UINT_24_8` and `10_11_11_REV`.\n" - " `UINT_24_8` is deprecated, use `FLOAT` instead.\n" + " Possible values are ``FLOAT``, ``INT``, ``UINT``, ``UBYTE``, ``UINT_24_8`` & " + "``10_11_11_REV``.\n" + " ``UINT_24_8`` is deprecated, use ``FLOAT`` instead.\n" " :type format: str\n" " :arg dimensions: Array describing the dimensions.\n" " :type dimensions: int\n" diff --git a/source/blender/python/gpu/gpu_py_framebuffer.cc b/source/blender/python/gpu/gpu_py_framebuffer.cc index 01a739c4f99..96983ed8d03 100644 --- a/source/blender/python/gpu/gpu_py_framebuffer.cc +++ b/source/blender/python/gpu/gpu_py_framebuffer.cc @@ -549,8 +549,9 @@ PyDoc_STRVAR( " :arg slot: The framebuffer slot to read data from.\n" " :type slot: int\n" " :arg format: The format that describes the content of a single channel.\n" - " Possible values are `FLOAT`, `INT`, `UINT`, `UBYTE`, `UINT_24_8` and `10_11_11_REV`.\n" - " `UINT_24_8` is deprecated, use `FLOAT` instead.\n" + " Possible values are ``FLOAT``, ``INT``, ``UINT``, ``UBYTE``, ``UINT_24_8`` & " + "``10_11_11_REV``.\n" + " ``UINT_24_8`` is deprecated, use ``FLOAT`` instead.\n" " :type format: str\n" " :arg data: Optional Buffer object to fill with the pixels values.\n" " :type data: :class:`gpu.types.Buffer`\n" @@ -810,10 +811,10 @@ PyDoc_STRVAR( "texture is attached to the frame-buffer.\n" " For cube map textures, layer is translated into a cube map face.\n" "\n" - " :arg depth_slot: GPUTexture to attach or a `dict` containing keywords: " + " :arg depth_slot: GPUTexture to attach or a ``dict`` containing keywords: " "'texture', 'layer' and 'mip'.\n" " :type depth_slot: :class:`gpu.types.GPUTexture` | dict[] | None\n" - " :arg color_slots: Tuple where each item can be a GPUTexture or a `dict` " + " :arg color_slots: Tuple where each item can be a GPUTexture or a ``dict`` " "containing keywords: 'texture', 'layer' and 'mip'.\n" " :type color_slots: :class:`gpu.types.GPUTexture` | " "dict[str, int | :class:`gpu.types.GPUTexture`] | " diff --git a/source/blender/python/gpu/gpu_py_offscreen.cc b/source/blender/python/gpu/gpu_py_offscreen.cc index 1e795834fde..212cb96e48b 100644 --- a/source/blender/python/gpu/gpu_py_offscreen.cc +++ b/source/blender/python/gpu/gpu_py_offscreen.cc @@ -598,10 +598,10 @@ PyDoc_STRVAR( " :type height: int\n" " :arg format: Internal data format inside GPU memory for color attachment " "texture. Possible values are:\n" - " `RGBA8`,\n" - " `RGBA16`,\n" - " `RGBA16F`,\n" - " `RGBA32F`,\n" + " ``RGBA8``,\n" + " ``RGBA16``,\n" + " ``RGBA16F``,\n" + " ``RGBA32F``.\n" " :type format: str\n"); PyTypeObject BPyGPUOffScreen_Type = { /*ob_base*/ PyVarObject_HEAD_INIT(nullptr, 0) diff --git a/source/blender/python/gpu/gpu_py_state.cc b/source/blender/python/gpu/gpu_py_state.cc index 3e46328c20b..737d83bb1f2 100644 --- a/source/blender/python/gpu/gpu_py_state.cc +++ b/source/blender/python/gpu/gpu_py_state.cc @@ -125,7 +125,7 @@ PyDoc_STRVAR( pygpu_state_clip_distances_set_doc, ".. function:: clip_distances_set(distances_enabled)\n" "\n" - " Sets the number of `gl_ClipDistance` planes used for clip geometry.\n" + " Sets the number of ``gl_ClipDistance`` planes used for clip geometry.\n" "\n" " :arg distances_enabled: Number of clip distances enabled.\n" " :type distances_enabled: int\n"); @@ -154,8 +154,8 @@ PyDoc_STRVAR( " Defines the depth_test equation.\n" "\n" " :arg mode: The depth test equation name.\n" - " Possible values are `NONE`, `ALWAYS`, `LESS`, `LESS_EQUAL`, `EQUAL`, " - "`GREATER` and `GREATER_EQUAL`.\n" + " Possible values are ``NONE``, ``ALWAYS``, ``LESS``, ``LESS_EQUAL``, ``EQUAL``, " + "``GREATER`` and ``GREATER_EQUAL``.\n" " :type mode: str\n"); static PyObject *pygpu_state_depth_test_set(PyObject * /*self*/, PyObject *value) { @@ -430,7 +430,7 @@ PyDoc_STRVAR( "\n" " Specify whether none, front-facing or back-facing facets can be culled.\n" "\n" - " :arg mode: `NONE`, `FRONT` or `BACK`.\n" + " :arg mode: ``NONE``, ``FRONT`` or ``BACK``.\n" " :type mode: str\n"); static PyObject *pygpu_state_face_culling_set(PyObject * /*self*/, PyObject *value) { diff --git a/source/blender/python/gpu/gpu_py_texture.cc b/source/blender/python/gpu/gpu_py_texture.cc index e17a3f6e354..0f23f543a1a 100644 --- a/source/blender/python/gpu/gpu_py_texture.cc +++ b/source/blender/python/gpu/gpu_py_texture.cc @@ -354,8 +354,9 @@ PyDoc_STRVAR( " Fill texture with specific value.\n" "\n" " :arg format: The format that describes the content of a single item.\n" - " Possible values are `FLOAT`, `INT`, `UINT`, `UBYTE`, `UINT_24_8` and `10_11_11_REV`.\n" - " `UINT_24_8` is deprecated, use `FLOAT` instead.\n" + " Possible values are ``FLOAT``, ``INT``, ``UINT``, ``UBYTE``, ``UINT_24_8`` & " + "``10_11_11_REV``.\n" + " ``UINT_24_8`` is deprecated, use ``FLOAT`` instead.\n" " :type format: str\n" " :arg value: Sequence each representing the value to fill. Sizes 1..4 are supported.\n" " :type value: Sequence[float]\n"); @@ -576,50 +577,50 @@ PyDoc_STRVAR( " :arg is_cubemap: Indicates the creation of a cubemap texture.\n" " :type is_cubemap: int\n" " :arg format: Internal data format inside GPU memory. Possible values are:\n" - " `RGBA8UI`,\n" - " `RGBA8I`,\n" - " `RGBA8`,\n" - " `RGBA32UI`,\n" - " `RGBA32I`,\n" - " `RGBA32F`,\n" - " `RGBA16UI`,\n" - " `RGBA16I`,\n" - " `RGBA16F`,\n" - " `RGBA16`,\n" - " `RG8UI`,\n" - " `RG8I`,\n" - " `RG8`,\n" - " `RG32UI`,\n" - " `RG32I`,\n" - " `RG32F`,\n" - " `RG16UI`,\n" - " `RG16I`,\n" - " `RG16F`,\n" - " `RG16`,\n" - " `R8UI`,\n" - " `R8I`,\n" - " `R8`,\n" - " `R32UI`,\n" - " `R32I`,\n" - " `R32F`,\n" - " `R16UI`,\n" - " `R16I`,\n" - " `R16F`,\n" - " `R16`,\n" - " `R11F_G11F_B10F`,\n" - " `DEPTH32F_STENCIL8`,\n" - " `DEPTH24_STENCIL8` (deprecated, use `DEPTH32F_STENCIL8`),\n" - " `SRGB8_A8`,\n" - " `RGB16F`,\n" - " `SRGB8_A8_DXT1`,\n" - " `SRGB8_A8_DXT3`,\n" - " `SRGB8_A8_DXT5`,\n" - " `RGBA8_DXT1`,\n" - " `RGBA8_DXT3`,\n" - " `RGBA8_DXT5`,\n" - " `DEPTH_COMPONENT32F`,\n" - " `DEPTH_COMPONENT24`, (deprecated, use `DEPTH_COMPONENT32F`),\n" - " `DEPTH_COMPONENT16`,\n" + " ``RGBA8UI``,\n" + " ``RGBA8I``,\n" + " ``RGBA8``,\n" + " ``RGBA32UI``,\n" + " ``RGBA32I``,\n" + " ``RGBA32F``,\n" + " ``RGBA16UI``,\n" + " ``RGBA16I``,\n" + " ``RGBA16F``,\n" + " ``RGBA16``,\n" + " ``RG8UI``,\n" + " ``RG8I``,\n" + " ``RG8``,\n" + " ``RG32UI``,\n" + " ``RG32I``,\n" + " ``RG32F``,\n" + " ``RG16UI``,\n" + " ``RG16I``,\n" + " ``RG16F``,\n" + " ``RG16``,\n" + " ``R8UI``,\n" + " ``R8I``,\n" + " ``R8``,\n" + " ``R32UI``,\n" + " ``R32I``,\n" + " ``R32F``,\n" + " ``R16UI``,\n" + " ``R16I``,\n" + " ``R16F``,\n" + " ``R16``,\n" + " ``R11F_G11F_B10F``,\n" + " ``DEPTH32F_STENCIL8``,\n" + " ``DEPTH24_STENCIL8`` (deprecated, use ``DEPTH32F_STENCIL8``),\n" + " ``SRGB8_A8``,\n" + " ``RGB16F``,\n" + " ``SRGB8_A8_DXT1``,\n" + " ``SRGB8_A8_DXT3``,\n" + " ``SRGB8_A8_DXT5``,\n" + " ``RGBA8_DXT1``,\n" + " ``RGBA8_DXT3``,\n" + " ``RGBA8_DXT5``,\n" + " ``DEPTH_COMPONENT32F``,\n" + " ``DEPTH_COMPONENT24``, (deprecated, use ``DEPTH_COMPONENT32F``),\n" + " ``DEPTH_COMPONENT16``.\n" " :type format: str\n" " :arg data: Buffer object to fill the texture.\n" " :type data: :class:`gpu.types.Buffer`\n"); diff --git a/source/blender/python/gpu/gpu_py_vertex_format.cc b/source/blender/python/gpu/gpu_py_vertex_format.cc index a69dd31fb09..95c358f1c41 100644 --- a/source/blender/python/gpu/gpu_py_vertex_format.cc +++ b/source/blender/python/gpu/gpu_py_vertex_format.cc @@ -76,10 +76,11 @@ PyDoc_STRVAR( "\n" " Add a new attribute to the format.\n" "\n" - " :arg id: Name the attribute. Often `position`, `normal`, ...\n" + " :arg id: Name the attribute. Often ``position``, ``normal``, ...\n" " :type id: str\n" " :arg comp_type: The data type that will be used store the value in memory.\n" - " Possible values are `I8`, `U8`, `I16`, `U16`, `I32`, `U32`, `F32` and `I10`.\n" + " Possible values are ``I8``, ``U8``, ``I16``, ``U16``, ``I32``, ``U32``, ``F32`` & " + "``I10``.\n" " :type comp_type: str\n" " :arg len: How many individual values the attribute consists of\n" " (e.g. 2 for uv coordinates).\n" @@ -88,7 +89,7 @@ PyDoc_STRVAR( " This is mainly useful for memory optimizations when you want to store values with\n" " reduced precision. E.g. you can store a float in only 1 byte but it will be\n" " converted to a normal 4 byte float when used.\n" - " Possible values are `FLOAT`, `INT` or `INT_TO_FLOAT_UNIT`.\n" + " Possible values are ``FLOAT``, ``INT`` or ``INT_TO_FLOAT_UNIT``.\n" " :type fetch_mode: str\n"); static PyObject *pygpu_vertformat_attr_add(BPyGPUVertFormat *self, PyObject *args, PyObject *kwds) { diff --git a/source/blender/python/intern/bpy_app.cc b/source/blender/python/intern/bpy_app.cc index bab643ecd5f..05e5317fedb 100644 --- a/source/blender/python/intern/bpy_app.cc +++ b/source/blender/python/intern/bpy_app.cc @@ -83,7 +83,7 @@ static PyStructSequence_Field app_info_fields[] = { "The Blender File version, as a tuple of 3 numbers (major, minor, file sub-version), that " "will be used to save a .blend file. The last item in this tuple indicates the file " "sub-version, which is different from the release micro version (the last item of the " - "`bpy.app.version` tuple). The file sub-version can be incremented multiple times while a " + "``bpy.app.version`` tuple). The file sub-version can be incremented multiple times while a " "Blender version is under development. This value is, and should be, used for handling " "compatibility changes between Blender versions"}, {"version_string", "The Blender version formatted as a string"}, diff --git a/source/blender/python/intern/bpy_props.cc b/source/blender/python/intern/bpy_props.cc index 271c20b87fa..54d48cb0b5a 100644 --- a/source/blender/python/intern/bpy_props.cc +++ b/source/blender/python/intern/bpy_props.cc @@ -4118,7 +4118,7 @@ PyDoc_STRVAR( BPY_PROPDEF_TAGS_DOC BPY_PROPDEF_POLL_DOC BPY_PROPDEF_UPDATE_DOC "\n" ".. note:: Pointer properties do not support storing references to embedded IDs " - "(e.g. `bpy.types.Scene.collection`, `bpy.types.Material.node_tree`).\n" + "(e.g. :class:`bpy.types.Scene.collection`, :class:`bpy.types.Material.node_tree`).\n" " These should exclusively be referenced and accessed through their owner ID " "(e.g. the scene or material).\n"); PyObject *BPy_PointerProperty(PyObject *self, PyObject *args, PyObject *kw) diff --git a/source/blender/python/mathutils/mathutils_geometry.cc b/source/blender/python/mathutils/mathutils_geometry.cc index a880d6c4d2f..0376f2b1815 100644 --- a/source/blender/python/mathutils/mathutils_geometry.cc +++ b/source/blender/python/mathutils/mathutils_geometry.cc @@ -1634,7 +1634,7 @@ PyDoc_STRVAR( " :type vert_coords: Sequence[:class:`mathutils.Vector`]\n" " :arg edges: Edges, as pairs of indices in ``vert_coords``\n" " :type edges: Sequence[Sequence[int, int]]\n" - " :arg faces: Faces, each sublist is a face, as indices in `vert_coords` (CCW oriented)\n" + " :arg faces: Faces, each sublist is a face, as indices in ``vert_coords`` (CCW oriented).\n" " :type faces: Sequence[Sequence[int]]\n" " :arg output_type: What output looks like. 0 => triangles with convex hull. " "1 => triangles inside constraints. "