Doc: correct descriptions (mainly operators)

Corrections:

- Copy-paste errors where descriptions were from other operators.
- Descriptions that only mentioned one direction/action when both apply.
- Descriptions referencing wrong element types.
- Improve unclear or oddly worded descriptions.
- Replace placeholder text.

Ref !154424
This commit is contained in:
Campbell Barton 2026-02-15 12:20:23 +00:00
parent 9a5ae8d9a9
commit ba48286c3a
19 changed files with 36 additions and 27 deletions

View file

@ -606,8 +606,8 @@ class LightMapPack(Operator):
PREF_CONTEXT: bpy.props.EnumProperty(
name="Selection",
items=(
('SEL_FACES', "Selected Faces", "Space all UVs evenly"),
('ALL_FACES', "All Faces", "Average space UVs edge length of each loop"),
('SEL_FACES', "Selected Faces", "Pack only selected faces"),
('ALL_FACES', "All Faces", "Pack all faces in the mesh"),
),
)

View file

@ -86,7 +86,7 @@ class VIEW3D_OT_edit_mesh_extrude_move(Operator):
bl_idname = "view3d.edit_mesh_extrude_move_normal"
dissolve_and_intersect: BoolProperty(
name="dissolve_and_intersect",
name="Dissolve and Intersect",
default=False,
description="Dissolves adjacent faces and intersects new geometry",
)

View file

@ -227,8 +227,8 @@ class UILIST_OT_entry_move(GenericUIListOperator, Operator):
direction: EnumProperty(
name="Direction",
items=(
('UP', 'UP', 'UP'),
('DOWN', 'DOWN', 'DOWN'),
('UP', "Up", "Move the active entry up"),
('DOWN', "Down", "Move the active entry down"),
),
default='UP',
)

View file

@ -1864,7 +1864,8 @@ void CURVE_OT_pen(wmOperatorType *ot)
RNA_def_boolean(ot->srna, "delete_point", false, "Delete Point", "Delete an existing point");
RNA_def_boolean(
ot->srna, "insert_point", false, "Insert Point", "Insert Point into a curve segment");
RNA_def_boolean(ot->srna, "move_segment", false, "Move Segment", "Delete an existing point");
RNA_def_boolean(
ot->srna, "move_segment", false, "Move Segment", "Move an existing curve segment");
RNA_def_boolean(
ot->srna, "select_point", false, "Select Point", "Select a point or its handles");
RNA_def_boolean(ot->srna, "move_point", false, "Move Point", "Move a point or its handles");

View file

@ -1448,7 +1448,8 @@ void pen_tool_common_props(wmOperatorType *ot)
RNA_def_boolean(ot->srna, "delete_point", false, "Delete Point", "Delete an existing point");
RNA_def_boolean(
ot->srna, "insert_point", false, "Insert Point", "Insert Point into a curve segment");
RNA_def_boolean(ot->srna, "move_segment", false, "Move Segment", "Delete an existing point");
RNA_def_boolean(
ot->srna, "move_segment", false, "Move Segment", "Move an existing curve segment");
RNA_def_boolean(
ot->srna, "select_point", false, "Select Point", "Select a point or its handles");
RNA_def_boolean(ot->srna, "move_point", false, "Move Point", "Move a point or its handles");

View file

@ -317,7 +317,7 @@ void CACHEFILE_OT_layer_move(wmOperatorType *ot)
layer_slot_move,
0,
"Direction",
"Direction to move the active vertex group towards");
"Direction to move the active layer towards");
}
} // namespace blender

View file

@ -837,8 +837,15 @@ static wmOperatorStatus primitive_add_invoke(bContext *C,
static void define_primitive_add_properties(wmOperatorType *ot)
{
RNA_def_float(
ot->srna, "size", 100, -FLT_MAX, FLT_MAX, "Size", "Size of new circle", -FLT_MAX, FLT_MAX);
RNA_def_float(ot->srna,
"size",
100,
-FLT_MAX,
FLT_MAX,
"Size",
"Size of new primitive",
-FLT_MAX,
FLT_MAX);
RNA_def_float_vector(ot->srna,
"location",
2,
@ -846,7 +853,7 @@ static void define_primitive_add_properties(wmOperatorType *ot)
-FLT_MAX,
FLT_MAX,
"Location",
"Location of new circle",
"Location of new primitive",
-FLT_MAX,
FLT_MAX);
}

View file

@ -1611,9 +1611,9 @@ void MESH_OT_select_mode(wmOperatorType *ot)
PropertyRNA *prop;
static const EnumPropertyItem actions_items[] = {
{0, "DISABLE", false, "Disable", "Disable selected markers"},
{1, "ENABLE", false, "Enable", "Enable selected markers"},
{2, "TOGGLE", false, "Toggle", "Toggle disabled flag for selected markers"},
{0, "DISABLE", false, "Disable", "Disable the selection mode"},
{1, "ENABLE", false, "Enable", "Enable the selection mode"},
{2, "TOGGLE", false, "Toggle", "Toggle the selection mode"},
{0, nullptr, 0, nullptr, nullptr},
};

View file

@ -1707,7 +1707,7 @@ void MESH_OT_vert_connect_concave(wmOperatorType *ot)
/* identifiers */
ot->name = "Split Concave Faces";
ot->idname = "MESH_OT_vert_connect_concave";
ot->description = "Make all faces convex";
ot->description = "Split concave faces by connecting vertices to make them convex";
/* API callbacks. */
ot->exec = edbm_vert_connect_concave_exec;

View file

@ -130,7 +130,7 @@ static void POINTCLOUD_OT_select_all(wmOperatorType *ot)
{
ot->name = "(De)select All";
ot->idname = "POINTCLOUD_OT_select_all";
ot->description = "(De)select all point cloud";
ot->description = "(De)select all points";
ot->exec = select_all_exec;
ot->poll = editable_pointcloud_poll;

View file

@ -3157,7 +3157,7 @@ void TEXTURE_OT_slot_paste(wmOperatorType *ot)
/* identifiers */
ot->name = "Paste Texture Slot Settings";
ot->idname = "TEXTURE_OT_slot_paste";
ot->description = "Copy the texture settings and nodes";
ot->description = "Paste the texture settings and nodes";
/* API callbacks. */
ot->exec = paste_mtex_exec;

View file

@ -562,8 +562,8 @@ static wmOperatorStatus set_axis_exec(bContext *C, wmOperator *op)
void CLIP_OT_set_axis(wmOperatorType *ot)
{
static const EnumPropertyItem axis_actions[] = {
{0, "X", 0, "X", "Align bundle align X axis"},
{1, "Y", 0, "Y", "Align bundle align Y axis"},
{0, "X", 0, "X", "Align bundle to X axis"},
{1, "Y", 0, "Y", "Align bundle to Y axis"},
{0, nullptr, 0, nullptr, nullptr},
};

View file

@ -942,7 +942,7 @@ void IMAGE_OT_view_cursor_center(wmOperatorType *ot)
/* identifiers */
ot->name = "Cursor To Center View";
ot->description = "Set 2D Cursor To Center View location";
ot->description = "Set 2D cursor to center view location";
ot->idname = "IMAGE_OT_view_cursor_center";
/* API callbacks. */
@ -1798,7 +1798,7 @@ void IMAGE_OT_match_movie_length(wmOperatorType *ot)
{
/* identifiers */
ot->name = "Match Movie Length";
ot->description = "Set image's user's length to the one of this video";
ot->description = "Set the image's frame range to match the video's duration";
ot->idname = "IMAGE_OT_match_movie_length";
/* API callbacks. */

View file

@ -305,7 +305,7 @@ void OUTLINER_OT_item_openclose(wmOperatorType *ot)
{
ot->name = "Open/Close";
ot->idname = "OUTLINER_OT_item_openclose";
ot->description = "Toggle whether item under cursor is enabled or closed";
ot->description = "Toggle whether item under cursor is open or closed";
ot->invoke = outliner_item_openclose_invoke;
ot->modal = outliner_item_openclose_modal;

View file

@ -3014,7 +3014,7 @@ void SEQUENCER_OT_strip_jump(wmOperatorType *ot)
/* Identifiers. */
ot->name = "Jump to Strip";
ot->idname = "SEQUENCER_OT_strip_jump";
ot->description = "Move frame to previous edit point";
ot->description = "Move frame to next or previous edit point";
/* API callbacks. */
ot->exec = sequencer_strip_jump_exec;

View file

@ -753,7 +753,7 @@ void ED_OT_undo_history(wmOperatorType *ot)
{
/* identifiers */
ot->name = "Undo History";
ot->description = "Redo specific action in history";
ot->description = "Undo or redo specific action in history";
ot->idname = "ED_OT_undo_history";
/* API callbacks. */

View file

@ -830,7 +830,7 @@ static void UV_OT_arrange_islands(wmOperatorType *ot)
"MAX",
0,
"Max",
"Align the islands to the left side of the island"},
"Align the islands to the max side of the island"},
{int(UVAlignIslandMode::Center),
"CENTER",
0,

View file

@ -1878,7 +1878,7 @@ static void rna_def_panel(BlenderRNA *brna)
prop = RNA_def_property(srna, "text", PROP_STRING, PROP_NONE);
RNA_def_property_string_sdna(prop, nullptr, "drawname");
RNA_def_property_ui_text(prop, "Text", "XXX todo");
RNA_def_property_ui_text(prop, "Text", "Override for the panel label in the UI");
prop = RNA_def_property(srna, "custom_data", PROP_POINTER, PROP_NONE);
RNA_def_property_struct_type(prop, "Constraint");

View file

@ -141,7 +141,7 @@ void WM_operator_properties_filesel(wmOperatorType *ot,
prop = RNA_def_boolean(ot->srna,
"filter_backup",
(filter & FILE_TYPE_BLENDER_BACKUP) != 0,
"Filter .blend files",
"Filter backup .blend files",
"");
RNA_def_property_flag(prop, PROP_HIDDEN | PROP_SKIP_SAVE);
prop = RNA_def_boolean(